Linkly (versión preliminar)
Linkly es un abreviador de vínculos y un rastreador de clics. Cree vínculos cortos con marca con dominios personalizados, agregue parámetros UTM y píxeles de redestinación, conversiones de informes y análisis de clics de extracción agrupados por país, plataforma, referencia o campaña.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Standard | Todas las regiones de Logic Apps excepto las siguientes: - regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Name | Compatibilidad con vínculos |
| Dirección URL | https://linklyhq.com/support |
| Correo electrónico | support@linklyhq.com |
| Metadatos del conector | |
|---|---|
| Publicador | Vincular |
| Sitio web | https://linklyhq.com |
| Directiva de privacidad | https://linklyhq.com/support/privacy |
| Categories | Marketing; Sitio web |
Vincular
Linkly es un abreviador de vínculos y un rastreador de clics. Crea vínculos cortos con marca en su propio dominio, realiza un seguimiento de cada clic con desgloses de país, plataforma y referencia, activa píxeles de redestinación y registra conversiones en el vínculo que los generó. Este conector permite crear y administrar vínculos, extraer conversiones de informes y análisis de clics en un área de trabajo de Linkly.
Publisher: Vincular
Prerequisites
Una cuenta de Linkly . El plan gratuito es suficiente para usar todas las acciones de este conector. Las conversiones de informes y enumeración también requieren que la característica seguimiento de conversión de linkly esté habilitada en el área de trabajo.
Operaciones admitidas
Enumerar áreas de trabajo
Devuelve las áreas de trabajo disponibles para esta conexión. Úselo para buscar el área de trabajo que requieren otras acciones.
Crear o actualizar un vínculo
Crea un nuevo vínculo corto o actualiza uno existente cuando se proporciona un identificador de vínculo. Admite dominios personalizados y slugs, parámetros UTM, píxeles de redestinación y metadatos de Open Graph.
Obtener un vínculo
Recupera un único vínculo por su identificador, incluido su destino, la dirección URL corta y la configuración.
Enumerar vínculos
Devuelve una lista paginada de los vínculos de un área de trabajo, con estadísticas de clic. Admite búsqueda y ordenación.
Eliminar un vínculo
Mueve un vínculo a la papelera. Su dirección URL corta deja de redirigirse y el vínculo se puede restaurar más adelante desde la papelera.
Obtener análisis de clics
Devuelve recuentos de clics con el tiempo para un área de trabajo o para vínculos específicos, filtrados opcionalmente por intervalo de fechas, país, explorador, plataforma, referencia o ISP.
Obtener recuentos de clics por dimensión
Devuelve recuentos de clics agrupados por una dimensión como country, city, platform, referer o parámetro UTM, ordenados por recuento descendente.
Enumeración de dominios personalizados
Devuelve los dominios personalizados configurados para un área de trabajo. Estos nombres de dominio se pueden usar al crear vínculos.
Notificar una conversión
Registra una conversión como una compra, un registro o un evento personalizado, y lo asigna al vínculo al que se hizo clic cuando se proporciona un token de atribución.
Conversiones de lista
Devuelve las conversiones más recientes registradas en el área de trabajo.
Obtención de credenciales
Este conector usa OAuth 2.0. No se necesita ninguna clave de API.
- Si aún no tiene una cuenta de Linkly, regístrese en https://linklyhq.com. El plan gratuito funciona.
- Al crear una conexión, elija Iniciar sesión con Linkly e inicie sesión con su cuenta de Linkly.
- Elija el área de trabajo que debe usar esta conexión cuando se le solicite y, a continuación, apruebe la solicitud.
La conexión está enlazada al área de trabajo que eligió. Para trabajar en otra área de trabajo, cree una segunda conexión.
Getting Started
- Cree una conexión como se ha descrito anteriormente.
- Agregue la acción Crear o actualizar un vínculo a un flujo, escriba la dirección URL de destino y, opcionalmente, un dominio personalizado y un slug. La acción devuelve la dirección URL corta y el identificador de vínculo.
- Use vínculos de lista, Obtener análisis o Obtener recuentos de clics por dimensión para leer los datos de clic. Las acciones que realizan un área de trabajo le permiten elegirla de una lista, que se rellena mediante áreas de trabajo de lista.
- Para atribuir compras o registros a vínculos, pase el valor de la
linkly_ciddirección URL de la página de aterrizaje a Notificar una conversión como token de atribución.
Problemas conocidos y limitaciones
- Una conexión está enlazada a un único área de trabajo de Linkly, la elegida al iniciar sesión. Cree una conexión por área de trabajo.
- Notificar una conversión y enumerar conversiones requieren la característica de seguimiento de conversión de linkly. Las áreas de trabajo sin ella reciben un error de estas acciones.
- Los webhooks de clic en tiempo real no se exponen como desencadenadores. Use la característica de webhook de Linkly con un flujo desencadenado por HTTP en su lugar.
- La creación masiva de vínculos, la exportación de vínculos y la administración de dominios están disponibles en linkly API, pero no se incluyen en este conector.
- La API está limitada a la velocidad. Obtener recuentos de clics por dimensión devuelve un error de límite de velocidad cuando se supera el límite; vuelva a intentarlo después de un breve retraso.
Preguntas más frecuentes
¿En qué área de trabajo se ejecutan mis acciones?
Las acciones que realizan un parámetro Workspace muestran una lista de las áreas de trabajo disponibles para la conexión. Las acciones sin una, como Obtener un vínculo, Notificar una conversión y Conversiones de lista, use el área de trabajo enlazada a la conexión.
¿Cómo uso un dominio personalizado?
Agregue primero el dominio en Linkly y, a continuación, pase su nombre en el campo Dominio de Crear o actualizar un vínculo. Enumerar dominios personalizados devuelve los nombres disponibles en un área de trabajo.
¿Elimina un vínculo quitar el vínculo de forma permanente?
N. º El vínculo se mueve a la papelera y deja de redirigirse. Se puede restaurar desde la papelera en Linkly.
Instrucciones de implementación
- En el portal de creador, abra Conectores personalizados, elija Nuevo conector personalizado y, a continuación, Importe un archivo OpenAPI. Seleccione
apiDefinition.swagger.json. - En la pestaña Seguridad , elija OAuth 2.0 con el proveedor de identidades de Oauth 2 genérico . Escriba el identificador de cliente y el secreto de cliente emitidos por Linkly, establezca la dirección URL
https://app.linklyhq.com/oauth/authorizede autorización en y establezca la dirección URL del token y la dirección URL de actualización enhttps://app.linklyhq.com/oauth/token. - Cree el conector y copie la dirección URL de redireccionamiento que se muestra en la pestaña Seguridad y regístrela con Linkly para ese identificador de cliente.
- Cree una conexión iniciando sesión con la cuenta de Linkly y, a continuación, pruebe una acción como Enumerar áreas de trabajo.
Acciones
| Conversiones de lista |
Devuelve las conversiones más recientes registradas en el área de trabajo. |
| Crear o actualizar un vínculo |
Crea un nuevo vínculo corto o actualiza uno existente cuando se proporciona un identificador de vínculo. Admite dominios personalizados y slugs, parámetros UTM, píxeles de redestinación y metadatos de Open Graph. |
| Eliminar un vínculo |
Mueve un vínculo a la papelera. Su dirección URL corta deja de redirigirse y el vínculo se puede restaurar más adelante desde la papelera. |
| Enumeración de dominios personalizados |
Devuelve los dominios personalizados configurados para un área de trabajo. Estos nombres de dominio se pueden usar al crear vínculos. |
| Enumerar vínculos |
Devuelve una lista paginada de los vínculos de un área de trabajo, con estadísticas de clic. Admite búsqueda y ordenación. |
| Enumerar áreas de trabajo |
Devuelve las áreas de trabajo disponibles para esta conexión. Úselo para buscar el área de trabajo que requieren otras acciones. |
| Notificar una conversión |
Registra una conversión como una compra, un registro o un evento personalizado, y lo asigna al vínculo al que se hizo clic cuando se proporciona un token de atribución. |
| Obtener análisis de clics |
Devuelve recuentos de clics con el tiempo para un área de trabajo o para vínculos específicos, filtrados opcionalmente por intervalo de fechas, país, explorador, plataforma, referencia o ISP. |
| Obtener recuentos de clics por dimensión |
Devuelve recuentos de clics agrupados por una dimensión como country, city, platform, referer o parámetro UTM, ordenados por recuento descendente. |
| Obtener un vínculo |
Recupera un único vínculo por su identificador, incluido su destino, la dirección URL corta y la configuración. |
Conversiones de lista
Devuelve las conversiones más recientes registradas en el área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Número máximo de conversiones que se van a devolver, entre 1 y 1000. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Conversions
|
conversions | array of object |
Las conversiones, más recientes primero. |
|
Importe (centavos)
|
conversions.amount_cents | integer |
Valor de la unidad de moneda más pequeña. Puede ser negativo registrar un reembolso. |
|
Haga clic en Id.
|
conversions.click_id | string |
Identificador del clic con atributos. |
|
Country
|
conversions.country | string |
Un código de país ISO 3166-1 de dos letras, por ejemplo, EE. UU. |
|
Divisa
|
conversions.currency | string |
El código de divisa ISO 4217. El valor predeterminado es USD. |
|
Id. del evento
|
conversions.event_id | string |
Identificador del evento. Notificar el mismo valor dos veces no crea una segunda conversión. |
|
Nombre del evento
|
conversions.event_name | string |
Lo que sucedió, por ejemplo, comprar, registrar o trial_started. |
|
Tipo de evento
|
conversions.event_type | string |
Tipo de evento general. Use el cliente potencial para establecer la identidad del cliente y la venta para registrar los ingresos. El valor predeterminado es personalizado. |
|
Id. de cliente
|
conversions.external_id | string |
Identificador del cliente. Envíelo en cada evento para que las ventas posteriores se puedan vincular al clic original. |
|
Identificador de conversión
|
conversions.id | string |
Identificador único de la conversión. Los identificadores ordenan cronológicamente. |
|
Insertado en
|
conversions.inserted_at | date-time |
Cuando se registró la conversión. |
|
Origen de IP
|
conversions.ip_source | string |
Cuya dirección se registró: visitante, servidor o desconocido. El servidor significa que la dirección de conexión pertenece al back-end o a una retransmisión de plataforma, por lo que se excluye de los informes geográficos. |
|
Id. de vínculo
|
conversions.link_id | integer |
Identificador del vínculo con atributos o null si no se pudo atribuir la conversión a un vínculo. |
|
Metadata
|
conversions.metadata | object |
Metadatos JSON arbitrarios, hasta 10 000 bytes. |
|
Se produjo en
|
conversions.occurred_at | date-time |
Cuando se produjo la conversión, en formato ISO 8601. El valor predeterminado es ahora. |
|
Source
|
conversions.source | string |
Qué integración lo informó. |
Crear o actualizar un vínculo
Crea un nuevo vínculo corto o actualiza uno existente cuando se proporciona un identificador de vínculo. Admite dominios personalizados y slugs, parámetros UTM, píxeles de redestinación y metadatos de Open Graph.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección URL de destino
|
url | uri |
Dirección URL de destino a la que redirige el vínculo corto. Necesario para crear un vínculo. |
|
|
Id. de vínculo
|
id | integer |
Identificador de un vínculo existente que se va a actualizar. Deje en blanco para crear un vínculo. |
|
|
Name
|
name | string |
Alias del vínculo, que se muestra en el panel. |
|
|
Domain
|
domain | string |
Dominio personalizado que se va a usar para el vínculo corto, sin una barra diagonal final. |
|
|
Campo de datos dinámico
|
slug | string |
Ruta de acceso personalizada para el vínculo corto. Debe comenzar con una barra diagonal. |
|
|
Enabled
|
enabled | boolean |
Indica si el vínculo está activo. |
|
|
Note
|
note | string |
Una nota privada sobre el vínculo. |
|
|
Origen UTM
|
utm_source | string |
Parámetro utm_source anexado a la dirección URL de destino. |
|
|
UTM Medium
|
utm_medium | string |
Parámetro utm_medium anexado a la dirección URL de destino. |
|
|
Campaña UTM
|
utm_campaign | string |
Parámetro utm_campaign anexado a la dirección URL de destino. |
|
|
Contenido de UTM
|
utm_content | string |
Parámetro utm_content anexado a la dirección URL de destino. |
|
|
Término UTM
|
utm_term | string |
Parámetro utm_term anexado a la dirección URL de destino. |
|
|
Id. de meta píxel
|
fb_pixel_id | string |
Id. de píxel meta (Facebook) que se activará cuando se haga clic en el vínculo. |
|
|
Identificador de etiqueta de Google Analytics 4
|
ga4_tag_id | string |
Identificador de medida de Google Analytics 4 que se activará cuando se haga clic en el vínculo. |
|
|
Identificador del Administrador de etiquetas de Google
|
gtm_id | string |
Identificador de contenedor de Google Tag Manager que se va a cargar cuando se hace clic en el vínculo. |
|
|
Bloquear bots
|
block_bots | boolean |
Indica si se van a bloquear los bots conocidos siguiendo el vínculo. |
|
|
Etiquetas de cuerpo
|
body_tags | string |
Etiquetas HTML o de seguimiento personalizadas insertadas en el cuerpo de la página de redirección. |
|
|
Encubrimiento
|
cloaking | boolean |
Si desea ocultar el destino abriendolo dentro de un marco. |
|
|
Parámetros de reenvío
|
forward_params | boolean |
Indica si se reenván los parámetros de consulta desde el vínculo corto al destino. |
|
|
Etiquetas principales
|
head_tags | string |
Etiquetas HTML o de seguimiento personalizadas insertadas en el encabezado de la página de redirección. |
|
|
Ocultar el remitente
|
hide_referrer | boolean |
Si se oculta el remitente del sitio de destino. |
|
|
Abrir descripción del grafo
|
og_description | string |
Descripción que se muestra cuando el vínculo se comparte en las redes sociales. |
|
|
Abrir imagen de Graph
|
og_image | string |
Dirección URL de la imagen que se muestra cuando el vínculo se comparte en redes sociales. |
|
|
Abrir título de grafo
|
og_title | string |
Título que se muestra cuando el vínculo se comparte en las redes sociales. |
|
|
Id. de píxel de TikTok
|
tiktok_pixel_id | string |
Identificador de píxel de TikTok que se activará cuando se haga clic en el vínculo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de meta píxel
|
fb_pixel_id | string |
Id. de píxel meta (Facebook) que se activará cuando se haga clic en el vínculo. |
|
id. de asociado de LinkedIn
|
linkedin_partner_id | string |
El LinkedIn identificador de asociado de la etiqueta insight que se activará cuando se haga clic en el vínculo. |
|
id. de etiqueta UET de Microsoft
|
microsoft_uet_tag_id | string |
El Microsoft Advertising identificador de etiqueta UET que se activará cuando se haga clic en el vínculo. |
|
Id. de píxel de Reddit
|
reddit_pixel_id | string |
Id. de píxel de Visio que se activará cuando se haga clic en el vínculo. |
|
Id. de píxel de TikTok
|
tiktok_pixel_id | string |
Identificador de píxel de TikTok que se activará cuando se haga clic en el vínculo. |
|
Ocultar el remitente
|
hide_referrer | boolean |
Si se oculta el remitente del sitio de destino. |
|
Fecha de expiración
|
expiry_datetime | string |
Cuando el vínculo deja de funcionar, en formato ISO 8601. |
|
Destino de expiración
|
expiry_destination | uri |
Dirección URL a la que se redirigirá después de que expire el vínculo. Deje en blanco para devolver una página no encontrada. |
|
Id. de píxel X
|
twitter_pixel_id | string |
Identificador de píxel X (Twitter) que se activará cuando se haga clic en el vínculo. |
|
Encubrimiento
|
cloaking | boolean |
Si desea ocultar el destino abriendolo dentro de un marco. |
|
URL corta
|
full_url | uri |
Dirección URL completa del vínculo corto. |
|
Abrir descripción del grafo
|
og_description | string |
Descripción que se muestra cuando el vínculo se comparte en las redes sociales. |
|
Omitir seguimiento de rastreadores sociales
|
skip_social_crawler_tracking | boolean |
Si se excluyen los rastreadores de vista previa de redes sociales del seguimiento de clics. |
|
Etiquetas de cuerpo
|
body_tags | string |
Etiquetas HTML o de seguimiento personalizadas insertadas en el cuerpo de la página de redirección. |
|
Abrir título de grafo
|
og_title | string |
Título que se muestra cuando el vínculo se comparte en las redes sociales. |
|
Note
|
note | string |
Una nota privada sobre el vínculo. |
|
Name
|
name | string |
Alias del vínculo, que se muestra en el panel. |
|
Id. de vínculo
|
id | integer |
Identificador de un vínculo existente que se va a actualizar. Deje en blanco para crear un vínculo. |
|
Identificador del Administrador de etiquetas de Google
|
gtm_id | string |
Identificador de contenedor de Google Tag Manager que se va a cargar cuando se hace clic en el vínculo. |
|
Abrir imagen de Graph
|
og_image | string |
Dirección URL de la imagen que se muestra cuando el vínculo se comparte en redes sociales. |
|
Bloquear bots
|
block_bots | boolean |
Indica si se van a bloquear los bots conocidos siguiendo el vínculo. |
|
Id. de píxel de Snap
|
snapchat_pixel_id | string |
Id. de píxel de Snap que se activará cuando se haga clic en el vínculo. |
|
Contenido de UTM
|
utm_content | string |
Parámetro utm_content anexado a la dirección URL de destino. |
|
Enabled
|
enabled | boolean |
Indica si el vínculo está activo. |
|
Dirección URL de destino
|
url | uri |
Dirección URL de destino a la que redirige el vínculo corto. Necesario para crear un vínculo. |
|
Deleted
|
deleted | boolean |
Si el enlace está en la papelera. |
|
Webhooks
|
webhooks | array of string |
Las direcciones URL de webhook suscritas a clics en este vínculo. |
|
Clics de expiración
|
expiry_clicks | integer |
Número de clics después del cual el vínculo deja de funcionar. |
|
Notificar a Slack
|
notify_slack | boolean |
Indica si se va a enviar una notificación de Slack cuando se hace clic en el vínculo. |
|
ID del espacio de trabajo
|
workspace_id | integer |
El identificador del área de trabajo. |
|
Análisis públicos
|
public_analytics | boolean |
Indica si la página de análisis del vínculo es visible públicamente. |
|
Id. de etiqueta de Pinterest
|
pinterest_tag_id | string |
Identificador de etiqueta de Pinterest que se activará cuando se haga clic en el vínculo. |
|
Origen UTM
|
utm_source | string |
Parámetro utm_source anexado a la dirección URL de destino. |
|
Campo de datos dinámico
|
slug | string |
Ruta de acceso personalizada para el vínculo corto. Debe comenzar con una barra diagonal. |
|
Domain
|
domain | string |
Dominio personalizado que se va a usar para el vínculo corto, sin una barra diagonal final. |
|
Parámetros de reenvío
|
forward_params | boolean |
Indica si se reenván los parámetros de consulta desde el vínculo corto al destino. |
|
UTM Medium
|
utm_medium | string |
Parámetro utm_medium anexado a la dirección URL de destino. |
|
Etiquetas principales
|
head_tags | string |
Etiquetas HTML o de seguimiento personalizadas insertadas en el encabezado de la página de redirección. |
|
Identificador de etiqueta de Google Analytics 4
|
ga4_tag_id | string |
Identificador de medida de Google Analytics 4 que se activará cuando se haga clic en el vínculo. |
|
Término UTM
|
utm_term | string |
Parámetro utm_term anexado a la dirección URL de destino. |
|
Campaña UTM
|
utm_campaign | string |
Parámetro utm_campaign anexado a la dirección URL de destino. |
Eliminar un vínculo
Mueve un vínculo a la papelera. Su dirección URL corta deja de redirigirse y el vínculo se puede restaurar más adelante desde la papelera.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Área de trabajo en la que se va a trabajar. Selecciónelo en la lista o escriba su identificador. |
|
Id. de vínculo
|
id | True | integer |
Identificador del vínculo. |
Devoluciones
Mensaje de confirmación.
- response
- string
Enumeración de dominios personalizados
Devuelve los dominios personalizados configurados para un área de trabajo. Estos nombres de dominio se pueden usar al crear vínculos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Área de trabajo en la que se va a trabajar. Selecciónelo en la lista o escriba su identificador. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Domains
|
domains | array of object |
Dominios personalizados en el área de trabajo. |
|
Nombre de dominio
|
domains.name | string |
El nombre de dominio, por ejemplo, go.yourcompany.com. |
Enumerar vínculos
Devuelve una lista paginada de los vínculos de un área de trabajo, con estadísticas de clic. Admite búsqueda y ordenación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Área de trabajo en la que se va a trabajar. Selecciónelo en la lista o escriba su identificador. |
|
Search
|
search | string |
Término de búsqueda para filtrar vínculos por nombre, dirección URL o slug. |
|
|
Página
|
page | integer |
Número de página que se va a devolver, a partir de 1. |
|
|
Tamaño de página
|
page_size | integer |
Número de vínculos que se van a devolver por página. |
|
|
Ordenar por
|
sort_by | string |
Campo por el que se va a ordenar, por ejemplo, clicks_total, nombre o inserted_at. |
|
|
Dirección de ordenación
|
sort_dir | string |
Dirección de ordenación, ya sea asc o desc. |
|
|
Deleted
|
deleted | boolean |
Si se devuelven vínculos que se encuentran en la papelera en lugar de vínculos activos. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Links
|
links | array of object |
Los vínculos de esta página. |
|
Id. de meta píxel
|
links.fb_pixel_id | string |
Id. de píxel meta (Facebook) que se activará cuando se haga clic en el vínculo. |
|
Total de clics humanos
|
links.human_clicks_total | integer |
Clics de duración sin señal de bot; el subconjunto de clicks_total en el que no se detectó ningún bot user-agent ni una categoría de bot verificada. Grabado a partir de 2019. |
|
Clics (30 días)
|
links.clicks_thirty_days | integer |
Hace clic en los últimos 30 días, incluido el tráfico del bot. |
|
Id. de píxel de TikTok
|
links.tiktok_pixel_id | string |
Identificador de píxel de TikTok que se activará cuando se haga clic en el vínculo. |
|
Ocultar el remitente
|
links.hide_referrer | boolean |
Si se oculta el remitente del sitio de destino. |
|
Encubrimiento
|
links.cloaking | boolean |
Si desea ocultar el destino abriendolo dentro de un marco. |
|
URL corta
|
links.full_url | uri |
Dirección URL completa del vínculo corto. |
|
Clics hoy
|
links.clicks_today | integer |
Hace clic hasta hoy (UTC), incluido el tráfico del bot. |
|
Abrir descripción del grafo
|
links.og_description | string |
Descripción que se muestra cuando el vínculo se comparte en las redes sociales. |
|
Etiquetas de cuerpo
|
links.body_tags | string |
Etiquetas HTML o de seguimiento personalizadas insertadas en el cuerpo de la página de redirección. |
|
Abrir título de grafo
|
links.og_title | string |
Título que se muestra cuando el vínculo se comparte en las redes sociales. |
|
Note
|
links.note | string |
Una nota privada sobre el vínculo. |
|
Name
|
links.name | string |
Alias del vínculo, que se muestra en el panel. |
|
Id. de vínculo
|
links.id | integer |
Identificador único del vínculo. |
|
Identificador del Administrador de etiquetas de Google
|
links.gtm_id | string |
Identificador de contenedor de Google Tag Manager que se va a cargar cuando se hace clic en el vínculo. |
|
Abrir imagen de Graph
|
links.og_image | string |
Dirección URL de la imagen que se muestra cuando el vínculo se comparte en redes sociales. |
|
Bloquear bots
|
links.block_bots | boolean |
Indica si se van a bloquear los bots conocidos siguiendo el vínculo. |
|
Total de clics
|
links.clicks_total | integer |
Clics de duración, incluido el tráfico del bot. |
|
Clics humanos (30 días)
|
links.human_clicks_thirty_days | integer |
Hace clic en los últimos 30 días sin señal de bot; subconjunto de clicks_thirty_days. |
|
Contenido de UTM
|
links.utm_content | string |
Parámetro utm_content anexado a la dirección URL de destino. |
|
Clics humanos hoy
|
links.human_clicks_today | integer |
Hace clic hasta hoy (UTC) sin señal de bot. |
|
Enabled
|
links.enabled | boolean |
Indica si el vínculo está activo. |
|
Dirección URL de destino
|
links.url | uri |
Dirección URL de destino a la que redirige el vínculo corto. |
|
Deleted
|
links.deleted | boolean |
Si el enlace está en la papelera. |
|
ID del espacio de trabajo
|
links.workspace_id | integer |
El identificador del área de trabajo. |
|
Análisis públicos
|
links.public_analytics | boolean |
Indica si la página de análisis del vínculo es visible públicamente. |
|
Origen UTM
|
links.utm_source | string |
Parámetro utm_source anexado a la dirección URL de destino. |
|
Campo de datos dinámico
|
links.slug | string |
Ruta de acceso personalizada para el vínculo corto. Debe comenzar con una barra diagonal. |
|
Domain
|
links.domain | string |
Dominio personalizado que se va a usar para el vínculo corto, sin una barra diagonal final. |
|
Parámetros de reenvío
|
links.forward_params | boolean |
Indica si se reenván los parámetros de consulta desde el vínculo corto al destino. |
|
UTM Medium
|
links.utm_medium | string |
Parámetro utm_medium anexado a la dirección URL de destino. |
|
Etiquetas principales
|
links.head_tags | string |
Etiquetas HTML o de seguimiento personalizadas insertadas en el encabezado de la página de redirección. |
|
Identificador de etiqueta de Google Analytics 4
|
links.ga4_tag_id | string |
Identificador de medida de Google Analytics 4 que se activará cuando se haga clic en el vínculo. |
|
Término UTM
|
links.utm_term | string |
Parámetro utm_term anexado a la dirección URL de destino. |
|
Campaña UTM
|
links.utm_campaign | string |
Parámetro utm_campaign anexado a la dirección URL de destino. |
|
Clics humanos ayer
|
links.human_clicks_previous_day | integer |
Hace clic ayer (UTC) sin señal de bot. |
|
Número de página
|
page_number | integer |
Número de página actual. |
|
Tamaño de página
|
page_size | integer |
Número de vínculos que se van a devolver por página. |
|
Total de entradas
|
total_entries | integer |
Número total de vínculos que coinciden con la solicitud. |
|
Total de páginas
|
total_pages | integer |
Número total de páginas disponibles. |
|
Filas de totales
|
total_rows | integer |
Número total de filas. |
|
Recuento de vínculos del área de trabajo
|
workspace_link_count | integer |
Número total de vínculos en el área de trabajo. |
Enumerar áreas de trabajo
Devuelve las áreas de trabajo disponibles para esta conexión. Úselo para buscar el área de trabajo que requieren otras acciones.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID del espacio de trabajo
|
id | integer |
Identificador único del área de trabajo. |
|
Nombre del área de trabajo
|
name | string |
Nombre del área de trabajo. |
Notificar una conversión
Registra una conversión como una compra, un registro o un evento personalizado, y lo asigna al vínculo al que se hizo clic cuando se proporciona un token de atribución.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Importe (centavos)
|
amount_cents | integer |
Valor en la unidad de moneda más pequeña. Puede ser negativo registrar un reembolso o un contracargo, que netos frente a ingresos anteriores. |
|
|
Country
|
country | string |
Código de país de dos letras para la conversión. Inferido para las llamadas del lado del explorador; proporcione explícitamente desde una integración del lado servidor, donde la dirección de conexión es su propia infraestructura en lugar de la del cliente. |
|
|
Divisa
|
currency | string |
Código de moneda ISO 4217. El valor predeterminado es USD. |
|
|
Id. del evento
|
event_id | string |
Identificador de este evento. Se usa como clave de idempoencia; notificar el mismo valor dos veces no creará una segunda conversión. Se aplica a cualquier tipo de evento, no solo compras. |
|
|
Nombre del evento
|
event_name | True | string |
Lo que sucedió, por ejemplo, comprar, registrarse, trial_started. |
|
Tipo de evento
|
event_type | string |
Tipo grueso que conduce el embudo. el cliente potencial establece la identidad del cliente, los ingresos de los registros de venta. El valor predeterminado es personalizado. |
|
|
Id. de cliente
|
external_id | string |
Identificador del cliente. Enviarlo en cada evento: es lo que vincula una venta posterior del lado servidor al clic que generó el registro. |
|
|
Token de atribución
|
linkly_cid | string |
Token de atribución capturado desde la dirección URL de la página de aterrizaje. Omitir si no está disponible; Después, la conversión se registra sin una atribución de vínculo. |
|
|
Metadata
|
metadata | object |
JSON arbitrario, hasta 10 000 bytes codificados. |
|
|
Se produjo en
|
occurred_at | date-time |
Cuando se produjo la conversión. El valor predeterminado es ahora. |
|
|
DIRECCIÓN IP del visitante
|
visitor_ip | string |
Dirección IP del cliente final, cuando el servidor lo tiene. Omitir a menos que lo haga; En el caso de las llamadas del lado servidor, Link registra la dirección de conexión como servidor, no el cliente y la excluye de los informes geográficos. Enviar esta aserción tiene una base legal para compartirla. Nunca lo devuelve la API. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Importe (centavos)
|
amount_cents | integer |
Valor de la unidad de moneda más pequeña. Puede ser negativo registrar un reembolso. |
|
Haga clic en Id.
|
click_id | string |
Identificador del clic con atributos. |
|
Country
|
country | string |
Un código de país ISO 3166-1 de dos letras, por ejemplo, EE. UU. |
|
Divisa
|
currency | string |
El código de divisa ISO 4217. El valor predeterminado es USD. |
|
Id. del evento
|
event_id | string |
Identificador del evento. Notificar el mismo valor dos veces no crea una segunda conversión. |
|
Nombre del evento
|
event_name | string |
Lo que sucedió, por ejemplo, comprar, registrar o trial_started. |
|
Tipo de evento
|
event_type | string |
Tipo de evento general. Use el cliente potencial para establecer la identidad del cliente y la venta para registrar los ingresos. El valor predeterminado es personalizado. |
|
Id. de cliente
|
external_id | string |
Identificador del cliente. Envíelo en cada evento para que las ventas posteriores se puedan vincular al clic original. |
|
Identificador de conversión
|
id | string |
Identificador único de la conversión. Los identificadores ordenan cronológicamente. |
|
Insertado en
|
inserted_at | date-time |
Cuando se registró la conversión. |
|
Origen de IP
|
ip_source | string |
Cuya dirección se registró: visitante, servidor o desconocido. El servidor significa que la dirección de conexión pertenece al back-end o a una retransmisión de plataforma, por lo que se excluye de los informes geográficos. |
|
Id. de vínculo
|
link_id | integer |
Identificador del vínculo con atributos o null si no se pudo atribuir la conversión a un vínculo. |
|
Metadata
|
metadata | object |
Metadatos JSON arbitrarios, hasta 10 000 bytes. |
|
Se produjo en
|
occurred_at | date-time |
Cuando se produjo la conversión, en formato ISO 8601. El valor predeterminado es ahora. |
|
Source
|
source | string |
Qué integración lo informó. |
Obtener análisis de clics
Devuelve recuentos de clics con el tiempo para un área de trabajo o para vínculos específicos, filtrados opcionalmente por intervalo de fechas, país, explorador, plataforma, referencia o ISP.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Área de trabajo en la que se va a trabajar. Selecciónelo en la lista o escriba su identificador. |
|
Id. de vínculo
|
link_id | string |
Identificador de un único vínculo por el que se va a filtrar. |
|
|
Identificadores de vínculo
|
link_ids | string |
Lista separada por guiones de identificadores de vínculo por los que filtrar. |
|
|
Fecha de inicio
|
start | string |
Inicio del intervalo de fechas, en formato AAAA-MM-DD. |
|
|
Fecha de finalización
|
end | string |
Final del intervalo de fechas, en formato AAAA-MM-DD. |
|
|
Country
|
country | string |
Un código de país ISO 3166-1 de dos letras, por ejemplo, EE. UU. |
|
|
Navegador
|
browser | string |
Nombre del explorador que se va a filtrar por, por ejemplo, Chrome, Firefox o Safari. |
|
|
Platform
|
platform | string |
Plataforma o sistema operativo para filtrar por, por ejemplo, Windows, Mac, iOS o Android. |
|
|
Origen de referencia
|
referer | string |
Un dominio de referencia por el que se va a filtrar. |
|
|
Proveedor de Servicios de Internet (ISP)
|
isp | string |
Nombre del proveedor de servicios de Internet por el que se va a filtrar. |
|
|
Incluir bots
|
bots | boolean |
Si se deben incluir clics identificados como bots. Establézcalo en false para excluirlos. |
|
|
Solo único
|
unique | boolean |
Indica si solo se deben contar clics únicos. |
|
|
Zona horaria
|
timezone | string |
La zona horaria de IANA usada para los cálculos de fechas, por ejemplo, Europa o Londres. |
|
|
Frecuencia
|
frequency | string |
Granularidad de la serie temporal, ya sea día o hora. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Traffic
|
traffic | array of object |
El clic cuenta con el tiempo. |
|
Inicio del cubo
|
traffic.t | string |
Inicio del cubo: AAAA-MM-DD para depósitos diarios o AAAA-MM-DDTHH:MM:SS para depósitos por hora. |
|
Clics
|
traffic.y | integer |
Número de clics en el cubo. |
Obtener recuentos de clics por dimensión
Devuelve recuentos de clics agrupados por una dimensión como country, city, platform, referer o parámetro UTM, ordenados por recuento descendente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Área de trabajo en la que se va a trabajar. Selecciónelo en la lista o escriba su identificador. |
|
Dimension
|
counter | True | string |
Dimensión para agrupar clics por, por ejemplo, país, ciudad, plataforma, referencia o utm_campaign. |
|
Id. de vínculo
|
link_id | string |
Identificador de un único vínculo por el que se va a filtrar. |
|
|
Identificadores de vínculo
|
link_ids | string |
Lista separada por guiones de identificadores de vínculo por los que filtrar. |
|
|
Fecha de inicio
|
start | string |
Inicio del intervalo de fechas, en formato AAAA-MM-DD. |
|
|
Fecha de finalización
|
end | string |
Final del intervalo de fechas, en formato AAAA-MM-DD. |
|
|
Country
|
country | string |
Un código de país ISO 3166-1 de dos letras, por ejemplo, EE. UU. |
|
|
Incluir bots
|
bots | boolean |
Si se deben incluir clics identificados como bots. Establézcalo en false para excluirlos. |
|
|
Solo único
|
unique | boolean |
Indica si solo se deben contar clics únicos. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Total
|
total | integer |
Total de clics en todos los grupos, incluidos los que no se devuelven en valores. Cuando el resultado se trunca, es mayor que la suma de recuento en valores, por lo que count/total sigue teniendo un porcentaje preciso. |
|
Values
|
values | array of object |
Recuentos agrupados, ordenados por recuento descendente. Truncado a los 10 000 valores principales; si la dimensión tiene más valores distintos de los que, el resto no se devuelve. |
|
Total
|
values.count | integer |
Número de clics para este valor. |
|
Value
|
values.value | string |
Valor de la dimensión, por ejemplo, un código de país. |
Obtener un vínculo
Recupera un único vínculo por su identificador, incluido su destino, la dirección URL corta y la configuración.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de vínculo
|
id | True | string |
Identificador del vínculo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de meta píxel
|
fb_pixel_id | string |
Id. de píxel meta (Facebook) que se activará cuando se haga clic en el vínculo. |
|
id. de asociado de LinkedIn
|
linkedin_partner_id | string |
El LinkedIn identificador de asociado de la etiqueta insight que se activará cuando se haga clic en el vínculo. |
|
id. de etiqueta UET de Microsoft
|
microsoft_uet_tag_id | string |
El Microsoft Advertising identificador de etiqueta UET que se activará cuando se haga clic en el vínculo. |
|
Id. de píxel de Reddit
|
reddit_pixel_id | string |
Id. de píxel de Visio que se activará cuando se haga clic en el vínculo. |
|
Id. de píxel de TikTok
|
tiktok_pixel_id | string |
Identificador de píxel de TikTok que se activará cuando se haga clic en el vínculo. |
|
Ocultar el remitente
|
hide_referrer | boolean |
Si se oculta el remitente del sitio de destino. |
|
Fecha de expiración
|
expiry_datetime | string |
Cuando el vínculo deja de funcionar, en formato ISO 8601. |
|
Destino de expiración
|
expiry_destination | uri |
Dirección URL a la que se redirigirá después de que expire el vínculo. Deje en blanco para devolver una página no encontrada. |
|
Id. de píxel X
|
twitter_pixel_id | string |
Identificador de píxel X (Twitter) que se activará cuando se haga clic en el vínculo. |
|
Encubrimiento
|
cloaking | boolean |
Si desea ocultar el destino abriendolo dentro de un marco. |
|
URL corta
|
full_url | uri |
Dirección URL completa del vínculo corto. |
|
Abrir descripción del grafo
|
og_description | string |
Descripción que se muestra cuando el vínculo se comparte en las redes sociales. |
|
Omitir seguimiento de rastreadores sociales
|
skip_social_crawler_tracking | boolean |
Si se excluyen los rastreadores de vista previa de redes sociales del seguimiento de clics. |
|
Etiquetas de cuerpo
|
body_tags | string |
Etiquetas HTML o de seguimiento personalizadas insertadas en el cuerpo de la página de redirección. |
|
Abrir título de grafo
|
og_title | string |
Título que se muestra cuando el vínculo se comparte en las redes sociales. |
|
Note
|
note | string |
Una nota privada sobre el vínculo. |
|
Name
|
name | string |
Alias del vínculo, que se muestra en el panel. |
|
Id. de vínculo
|
id | integer |
Identificador único del vínculo. |
|
Identificador del Administrador de etiquetas de Google
|
gtm_id | string |
Identificador de contenedor de Google Tag Manager que se va a cargar cuando se hace clic en el vínculo. |
|
Abrir imagen de Graph
|
og_image | string |
Dirección URL de la imagen que se muestra cuando el vínculo se comparte en redes sociales. |
|
Bloquear bots
|
block_bots | boolean |
Indica si se van a bloquear los bots conocidos siguiendo el vínculo. |
|
Id. de píxel de Snap
|
snapchat_pixel_id | string |
Id. de píxel de Snap que se activará cuando se haga clic en el vínculo. |
|
Contenido de UTM
|
utm_content | string |
Parámetro utm_content anexado a la dirección URL de destino. |
|
Enabled
|
enabled | boolean |
Indica si el vínculo está activo. |
|
Dirección URL de destino
|
url | uri |
Dirección URL de destino a la que redirige el vínculo corto. |
|
Deleted
|
deleted | boolean |
Si el enlace está en la papelera. |
|
Webhooks
|
webhooks | array of string |
Las direcciones URL de webhook suscritas a clics en este vínculo. |
|
Clics de expiración
|
expiry_clicks | integer |
Número de clics después del cual el vínculo deja de funcionar. |
|
Notificar a Slack
|
notify_slack | boolean |
Indica si se va a enviar una notificación de Slack cuando se hace clic en el vínculo. |
|
ID del espacio de trabajo
|
workspace_id | integer |
El identificador del área de trabajo. |
|
Análisis públicos
|
public_analytics | boolean |
Indica si la página de análisis del vínculo es visible públicamente. |
|
Id. de etiqueta de Pinterest
|
pinterest_tag_id | string |
Identificador de etiqueta de Pinterest que se activará cuando se haga clic en el vínculo. |
|
Origen UTM
|
utm_source | string |
Parámetro utm_source anexado a la dirección URL de destino. |
|
Campo de datos dinámico
|
slug | string |
Ruta de acceso personalizada para el vínculo corto. Debe comenzar con una barra diagonal. |
|
Domain
|
domain | string |
Dominio personalizado que se va a usar para el vínculo corto, sin una barra diagonal final. |
|
Parámetros de reenvío
|
forward_params | boolean |
Indica si se reenván los parámetros de consulta desde el vínculo corto al destino. |
|
UTM Medium
|
utm_medium | string |
Parámetro utm_medium anexado a la dirección URL de destino. |
|
Etiquetas principales
|
head_tags | string |
Etiquetas HTML o de seguimiento personalizadas insertadas en el encabezado de la página de redirección. |
|
Identificador de etiqueta de Google Analytics 4
|
ga4_tag_id | string |
Identificador de medida de Google Analytics 4 que se activará cuando se haga clic en el vínculo. |
|
Término UTM
|
utm_term | string |
Parámetro utm_term anexado a la dirección URL de destino. |
|
Campaña UTM
|
utm_campaign | string |
Parámetro utm_campaign anexado a la dirección URL de destino. |
Definiciones
string
Este es el tipo de datos básico "string".