De un vistazo: Aprende sobre la estructura y los parámetros de los enlaces de atribución de AppsFlyer.
Información general
Los enlaces de atribución permiten a los anunciantes recopilar datos sobre el engagement de los usuarios con un anuncio. Los enlaces de atribución se colocan detrás de los anuncios y notifican a AppsFlyer cuando los usuarios interactúan con un anuncio. El engagement puede ocurrir a través de un clic en un anuncio o cuando un usuario ve una impresión de un anuncio. Se envía una copia de la URL de atribución a AppsFlyer.
Los enlaces de atribución se generan utilizando OneLink o un enlace de plataforma única.
| OneLink (enlace multiplataforma) | Enlace de plataforma única | |
|---|---|---|
|
Descripción y cuándo usarlo |
Úsalo si:
|
Úsalo si:
|
|
Requisitos previos |
Ninguna | |
|
Información obligatoria |
||
|
URL base |
{subdomain}.onelink.me |
app.appsflyer.com |
|
Identificador único |
ID de plantilla |
app_id |
| Estructura de URL | https://{subdomain}.onelink.me/ |
|
| Ejemplo | https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int |
https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int& |
Parámetros de enlaces de atribución
- Los parámetros enumerados están disponibles para su uso en el enlace de atribución.
- La columna de valor tipo de campo es el límite de caracteres del valor de parámetro. Para ver las limitaciones de longitud de los valores de parámetros, haz clic aquí.
Parámetros de los enlaces de atribución: UA y retargeting
La siguiente tabla puede descargarse como archivo .csv.
| Parámetro | Nombre visible en raw data | Descripción |
Tipo y longitud de campo |
|---|---|---|---|
| pid | Fuente de medios | Identifica de manera única a un partner integrado de AppsFlyer. No lo cambies. Más detalles. |
String 150 |
| c | Campaña | Proporcionado por el anunciante o el publisher. Consulta los límites en los nombres de campañas. |
String 100 |
|
af_prt |
Partner |
|
String 50 |
|
af_mp |
N/A |
|
|
|
clickid |
N/A |
Identificador de clics exclusivo de la red de publicidad |
|
|
af_siteid |
Site ID |
|
String 24 |
|
af_sub_siteid |
ID de subsitio |
|
String 50 |
|
af_c_id |
ID de campaña |
Proporcionado por el anunciante/publisher. |
String 24 |
|
af_adset |
Conjunto de anuncios |
|
String 100 |
|
af_adset_id |
ID de conjunto de anuncios |
Proporcionado por el anunciante/publisher. |
String 24 |
|
af_ad |
Anuncio |
Nombre de anuncio (ver más): provisto por el anunciante/publisher. |
String 100 |
|
af_ad_id |
ID de anuncio | Proporcionado por el anunciante/publisher. |
String 24 |
|
af_ad_type |
Tipo de anuncio |
Usa la siguiente convención de nomenclatura:
|
String 24 |
|
af_click_lookback |
Ventana de atribución retrospectiva |
Nota: Solo afecta las URL en las que se hizo clic, no las URL de impresiones. |
Máx. de 3 caracteres |
|
af_viewthrough_ |
N/A |
Nota: Solo afecta las URL de impresiones, no las URL en las que se hizo clic. |
Máx. de 3 caracteres |
|
af_channel |
Canal |
El canal de la fuente de medios a través del cual se distribuyen los anuncios, p. ej., UAC_Search, UAC_Display, Instagram, Meta Audience Network, etc. |
Enumeración dinámica String 20 |
|
af_keywords |
Palabras clave |
Lista de palabras clave para campañas orientadas a texto |
String 100 |
|
af_cost_model |
Modelo de costo |
|
String 20 |
|
af_cost_currency |
Moneda de costo |
|
Enumeración: 3 caracteres |
|
af_cost_value |
Valor de costo |
|
String 20 |
|
af_sub[n] (n=1-5) ejemplo: af_sub1 |
Subparámetro [n] |
Parámetro personalizado opcional definido por el anunciante. Para obtener más información sobre el uso de estos parámetros, consulta la sección Rasgos y limitaciones. |
String 100 |
| af_r | N/A |
Se utiliza en enlaces de plataforma única para redirigir a los usuarios a la URL especificada para ambas plataformas (Android e iOS).
|
|
| af_web_dp | N/A |
URL para redirigir a los usuarios de escritorio (p. ej., Windows o Mac) a una página web distinta a la configurada en la plantilla de OneLink. Usa este parámetro para mantener los datos de atribución de los usuarios de escritorio en otras plataformas (p. ej., Google Analytics u Omniture). Nota: Si tienes una Lista de permisos de redirección activa, asegúrate de que el dominio de esta URL esté en la lista. |
|
| af_dp | N/A | El valor de alternativa del esquema URI para iniciar la aplicación, que se utilizará si el método de enlace universal o enlace de aplicación de Android falla, y para los usuarios de Android por debajo de 6.0. Solo debe apuntar a la ruta base, es decir, a la actividad por defecto. | |
| af_force_deeplink | N/A | Fuerza conexiones profundas a la actividad especificada en el valor af_dp | |
| af_ref | N/A |
Las redes de publicidad que funcionan con clics S2S pueden enviar un valor único de origen de referencia con el siguiente parámetro: &af_ref=ReferrerValue.
El valor af_ref debe consistir en un valor único, estructurado de la siguiente manera:
NetworkName_UniqueClickValueForEachClick
Ejemplo: af_ref=networkname_123456789ABCDEF
El nombre de la red puede ser cualquier cadena de texto válida. Puede ser nombredered_int o simplemente nombredered.
AppsFlyer puede usar este parámetro para la atribución en dispositivos Android. AppsFlyer no usa este parámetro para la atribución en dispositivos iOS o Windows.
|
|
| is_incentivized | N/A |
Booleano: true/false (verdadero/falso)
Campañas incentivadas o no incentivadas
|
|
| af_param_forwarding | N/A |
|
|
| af_base_params_forward | N/A |
|
|
| af_partner_account_id | ID de cuenta de red | ID de la cuenta del anunciante con el partner | String 100 |
| Redirigir | N/A | Cuando &redirect=false, este parámetro permite a AppsFlyer saber que se trata de un clic de S2S y que el partner es responsable de redirigir al usuario que hizo clic. |
|
| af_ua | Agente de usuario |
Relevante para redes de publicidad que envían clics e impresiones de servidor a servidor. La cadena de agente de usuario se envía como:
El agente de usuario debe ser idéntico tanto en el parámetro URL como en el encabezado HTTP. Nota: En Android, el agente de usuario a veces se reduce a sugerencias de clientes. Se debe enviar igualmente.
|
|
| af_ip | IP |
Relevante para redes de publicidad que envían clics e impresiones de servidor a servidor. Dirección IP del dispositivo Recomendado: Si está disponible, proporciona la IP del dispositivo bajo el parámetro af_ip. Siguiente opción: Si está disponible, AppsFlyer utilizará la IP en X-Forwarded-For. |
|
| [En desuso] af_os | Versión de OS |
[Solo para iOS] La versión del sistema operativo del dispositivo. Este parámetro está en desuso pero aún es compatible con AppsFlyer. Recomendado: Utiliza en su lugar el parámetro af_os_version. |
|
| af_os_version | Versión de OS |
|
|
| af_model | Device model |
|
|
| af_media_type | Media Type |
Colocación del anuncio que lleva el enlace de la siguiente manera:
|
|
| deep_link_sub1-10 | N/A |
Valores adicionales de los enlaces profundos. Los desarrolladores implementan el comportamiento deseado de los valores en el código. |
|
| deep_link_value | N/A |
El nombre del contenido in-app específico al que se dirigirán los usuarios. Los desarrolladores implementan el comportamiento deseado del deep_link_value en el código. |
|
| af_og_title | N/A |
Al publicar un enlace en las redes sociales, el título del open graph (OG) generará una vista previa del título. |
String 40 |
| af_og_description | N/A |
Cuando se publica un enlace en las redes sociales, la descripción de open graph (OG) generará una vista previa de la descripción. |
String 300 |
| af_og_image | N/A |
Al publicar un enlace en las redes sociales, la imagen de open graph (OG) generará una vista previa de la imagen. |
Parámetros de los enlaces de atribución: solo retargeting
| Parámetro | Nombre visible en raw data | Descripción |
Tipo de campo y ancho |
|---|---|---|---|
|
is_retargeting |
Is Retargeting (campaign) | La URL de clic de todas las campañas de retargeting debe incluir &is_retargeting=true.Si el parámetro no está incluido o si su valor es "false", se considera que es una campaña habitual de adquisición de usuarios. |
Enumeración: 5 caracteres |
|
af_reengagement_window |
Ventana de recaptación |
Cambia la ventana de atribución de recaptación (re-engagement) al agregar este parámetro al enlace de atribución. Las posibles opciones de rango de ventana son:
Valor predeterminado: 30 días Ejemplo: el valor |
N/A |
Parámetros de tipo de anuncio
Dependiendo del tipo de anuncio, también puedes enviar el parámetro de visibilidad correspondiente con el detalle de las especificaciones de captación (engagement). A continuación, se muestra una lista de valores posibles para "af_ad_type" junto con los parámetros de visibilidad previstos.
Tipo de anuncio (af_ad_type)
| Parámetro | Formato de valor | Descripción |
|---|---|---|
| af_video_total_length | segundos | La duración total posible del video |
| af_video_played_length | segundos | Cuánto del video se vio |
| af_playable_played_length | segundos | Cuánto tiempo el elemento reproducible se reprodujo una vez que se cargó por completo |
| af_ad_time_viewed | segundos | Cuánto tiempo estuvo visible la unidad de anuncio en la pantalla |
| af_ad_displayed_percent | % | El porcentaje máximo de la unidad de anuncio visible en la pantalla del dispositivo |
| af_audio_total_length | segundos | La duración total posible del audio |
| af_audio_played_length | segundos | Cuánto del audio se oyó |
Parámetros específicos de Android
| Parámetro | Nombre visible en raw data | Descripción |
Tipo de campo |
|---|---|---|---|
|
advertising_id |
Advertising ID |
ID de publicidad de Google : requiere soporte de red de publicidad. |
Máx. de 40 caracteres |
|
sha1_advertising_id |
N/A |
ID de publicidad de Google con hash SHA1 : requiere soporte de red de publicidad. |
|
|
md5_advertising_id |
N/A |
ID de publicidad de Google con hash SHA1 : requiere soporte de red de publicidad. |
Compatible solo con instalaciones y reatribuciones |
|
android_id |
Android ID |
Android_id de dispositivo: requiere soporte de red de publicidad. |
Máx. de 20 caracteres |
|
sha1_android_id |
N/A |
Android_id de dispositivo con hash SHA1 : requiere soporte de red de publicidad. |
|
|
md5_android_id |
N/A |
Android_id de dispositivo con hash MD5: requiere soporte de red de publicidad. |
Compatible solo con instalaciones y reatribuciones |
|
imei |
IMEI |
ID de dispositivo IMEI |
|
|
sha1_imei |
N/A |
ID de dispositivo IMEI con hash SHA1 : requiere soporte de red de publicidad. |
|
|
md5_imei |
N/A |
ID de dispositivo IMEI con hash MD5M : requiere soporte de red de publicidad. |
|
|
oaid |
OAID |
Identificador de dispositivo anónimo abierto |
Disponible a partir del SDK para Android versión 4.10.3 |
|
sha1_oaid |
N/A |
Identificador de dispositivo anónimo abierto con hash SHA1 : requiere soporte de red de publicidad. |
Disponible a partir del SDK para Android versión 4.10.3 |
|
md5_oaid |
N/A | Identificador de dispositivo anónimo abierto con hash MD5 : requiere soporte de red de publicidad. | Disponible a partir del SDK para Android versión 4.10.3 |
|
af_android_url |
N/A |
Redirecciona a los usuarios de Android a una URL distinta a la de la página de la aplicación en Google Play. Usa este parámetro para tiendas de aplicaciones de terceros. Nota: Si tienes una Lista de permisos de redirección activa, asegúrate de que el dominio de esta URL esté en la lista. |
|
|
sha1_el |
N/A |
Se usa para la atribución de dispositivos de escritorio a dispositivos móviles: correo electrónico con el hash SHA1. Requiere soporte de redes de publicidad. |
|
|
fire_advertising_id |
N/A |
ID de publicidad de Fire de Amazon |
|
|
af_android_store_csl |
store_product_page |
Lista personalizada de la tienda en Google Console |
Cadena |
Parámetros específicos de iOS
| Parámetros | Nombre para mostrar | Descripción |
|---|---|---|
|
idfa |
IDFA |
Utiliza mayúsculas. Requiere soporte de redes de publicidad. Tipo de campo: 40 caracteres como máximo |
|
idfv |
IDFV | Utiliza mayúsculas. |
|
af_ios_url |
Usa esto para redireccionamientos de páginas de aterrizaje, para redirigir a los usuarios de iOS (iPhone o iPad) a una URL diferente a la de la página de la aplicación en iTunes Nota: Si tienes una Lista de permisos de redirección activa, asegúrate de que el dominio de esta URL esté en la lista. |
|
| af_ios_store_cpp | store_product_page |
ID de página de producto personalizada (ppid) |
|
af_ios_fallback [En desuso] |
N/A |
En desuso: los usuarios se redirigen según el flujo del esquema de URI de iOS. |
|
sha1_idfa |
N/A |
El identificador de anunciante (IDFA) con hash SHA1. Requiere soporte de redes de publicidad. |
|
sha1_idfv |
N/A |
El identificador de proveedor (IDFV) con hash SHA1 |
|
mac |
N/A |
Dirección mac del dispositivo. Requiere soporte de red de publicidad. |
|
md5_idfv |
N/A |
Identificador de proveedor (IDFV) con hash MD5 |
|
sha1_mac |
N/A |
Dirección mac del dispositivo con hash SHA1. Requiere soporte de red de publicidad. |
Ejemplo
https://app.appsflyer.com/{app_id}/?pid=airpush_int&c=RedBanner&
af_siteid={publisher_id}&af_sub1=1.5&af_sub2=USD&af_sub3=burst_campaignTodos los parámetros están disponibles en el reporte de instalación y en las analíticas, reportes y API.
Parámetros personalizados
Además de los parámetros predeterminados específicos de Android y de iOS, también puedes especificar parámetros personalizados. Estos parámetros personalizados pueden ayudarte si deseas personalizar la experiencia del usuario y el contenido según el enlace de atribución que lleva a una instalación.
Puedes agregar parámetros personalizados al enlace de atribución en el formato parameter=value. Por ejemplo:
https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_valueDos cosas importantes que debes saber sobre los parámetros personalizados:
- Los parámetros personalizados no aparecen en el raw data.
- Los parámetros personalizados se pueden recuperar de obtener datos de conversión de la API del SDK.
Parámetro de ID de partner (PID)
Entre todos los parámetros de enlaces de atribución disponibles, el ID de anunciante (PID) es obligatorio. El PID es el identificador único de la fuente de medios asignada por AppsFlyer.
Cada partner integrado tiene su propio valor de PID único. El PID termina con el sufijo _int. Al usar enlaces de OneLink, puedes establecer el PID en cualquier valor que prefieras, siempre y cuando no esté reservado por un partner integrado. Para evitar conflictos, no uses el sufijo _int.
Ejemplos de ID de publishers importantes integrados: orgánicos, googleadwords_int (Google AdWords), Anuncios de Meta y Twitter. Puedes usar cualquier nombre para las fuentes no integradas, como correo electrónico, SMS o palomas mensajeras.
Evita los problemas habituales de los PID:
- Incluye siempre el ID de anunciante (PID) en tus enlaces de atribución. Sin el PID en el enlace de atribución, el usuario automáticamente se atribuye a una fuente de medios con el nombre "None" (ninguna) y la fuente de instalación original desaparece.
- En el caso de las fuentes personalizadas, usa ID de anunciante (PID) de partners no integrados. Para cada fuente integrada, usa solo el PID designado para la correcta atribución de sus instalaciones. Para cualquier fuente de medios personalizada, como correo electrónico, SMS o incluso publicaciones virales no pagas en Facebook, usa otros valores de PID no integrados.
-
Usa solo caracteres permitidos. Si el parámetro PID en el enlace de atribución contiene uno de los siguientes caracteres /<>*&?\
- El clic o la instalación aparece en el panel de control bajo af_invalid_param.
- Los enlaces de atribución no serán atribuidos.
- Las capacidades de enlaces profundos no funcionarán con clics.
Consejo
Evita usar espacios en blanco en el valor de PID, o asegúrate de codificar tus enlaces de atribución con URL antes de usarlos.
Parámetro de ID de sitio
El ID del sitio es el identificador único del publisher que publica el anuncio. En otras palabras, el sitio web o la aplicación que muestra el anuncio. Las redes de publicidad asignan ID de sitio únicos para cada publisher.
Este ID se incluye en el parámetro af_siteid transmitido a AppsFlyer en el enlace de atribución y se pone a disposición a través de los diversos paneles de control, las opciones de reportes y los postbacks.
El ID de sitio debe pasarse a AppsFlyer en el enlace de atribución porque:
- Proporciona claridad y transparencia sobre el publisher.
- AppsFlyer lo utiliza para identificar y eliminar publishers fraudulentos y otros grupos de tráfico.
El parámetro de ID del sitio solo incluye el ID del publisher que publica el anuncio.
Para incluir información adicional, como el tipo de anuncio, la ubicación o ambos dentro de la aplicación, por ejemplo, banner, intersticial o video, usa el parámetro ID de subsitio.
Ejemplo
El siguiente enlace de atribución incluye:
-
af_siteid(ID de sitio): ID de publisher -
af_sub_siteid(ID de subsitio): información de ID adicional (en este caso, la ubicación del tipo de anuncio y una fuente afiliada)
https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid=1234&af_sub_siteid=ABCD_4567
En el enlace de ejemplo:
- 1234 = ID de publisher
- ABCD = Fuente afiliada (subpublisher) con la que trabaja el publisher
- 4567 = Ubicación del tipo de anuncio dentro de la aplicación, como banner, intersticial o video
Preguntas frecuentes: ¿Por qué el tráfico da lugar a muchas instalaciones bloqueadas?
Las instalaciones bloqueadas pueden deberse a lo siguiente:
-
Falta el ID de sitio: el parámetro
af_siteidestá vacío en la URL del clic. Los engagements enviados con un ID de sitio vacío pueden ser un problema técnico o un intento intencional de eludir los mecanismos de detección de fraude. - Varios ID de sitio: el mismo publisher se envía en varias URL de clic, usando diferentes ID de sitio. Esto se considera un comportamiento fraudulento que enmascara la actividad real del publisher y, a menudo, se asocia con la inundación de clics.
- ID de sitio formateado incorrectamente: enviar el formato incorrecto, combinado con otras indicaciones de fraude, podría originar un bloqueo no solo del publisher específico, sino también de un nivel de clúster más alto, y podría afectar a mayores volúmenes de la actividad del partner.
Para evitar instalaciones bloqueadas, asegúrate de enviar un parámetro de ID de sitio único por publisher, tal como se muestra en el ejemplo.
Niveles de granularidad de datos
Puedes usar hasta cuatro parámetros de URL para un análisis exhaustivo del rendimiento de tus anuncios.
Al utilizar los 4 parámetros en todos tus enlaces de atribución activos, podrás hacer lo siguiente:
- Atribuir todos los eventos e instalaciones de usuarios a anuncios específicos
- Examinar a fondo y comparar el rendimiento de todos tus anuncios por conjunto de anuncios, campaña y fuente de medios en reportes agregados para optimizar cada nivel
- Comparar todos tus anuncios en todas las fuentes de medios empleando reportes de raw data y la tabla dinámica
Los parámetros son:
Fuente de medios (pid=)Nombre de campaña (c=)Conjunto de anuncios (af_adset=)Nombre de anuncio (af_ad=)
Ejemplo
El enlace de atribución que aparece a continuación emplea 4 niveles de granularidad para registrar el anuncio de "cachemira" en el conjunto de anuncios de "abrigos" de la campaña de "invierno" ejecutada en la fuente de medios integrada "networkx".
https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmereRasgos y limitaciones
| Característica | Observaciones |
|---|---|
| Caracteres especiales |
No se permiten los siguientes caracteres especiales en los parámetros o valores: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, % |
| Límite de caracteres de URL |
La longitud total de las URL no debe superar los 2.000 caracteres. |
| Redirección de enlaces profundos WebView a aplicaciones sociales de Android |
Ver detalles de limitación aquí |
¿Debo usar letras minúsculas o mayúsculas para los parámetros?
Puedes usar cualquiera de ambas opciones, pero debes ser coherente. Si defines un parámetro personalizado con caracteres en mayúscula o minúscula, asegúrate de usar siempre ese parámetro.
Por ejemplo, si estableces pid=MyMediaSource, asegúrate de usarlo siempre. Si utilizas pid=MyMediaSource en un enlace de atribución y pid=mymediasource en otro, pueden producirse discrepancias en los datos. Lo mismo ocurre con cualquier otro parámetro que establezcas en el enlace de atribución.
¿El enlace de atribución de AppsFlyer es dinámico o estático?
¿Cómo se puede saber si un enlace es dinámico o estático?
Si el enlace de atribución contiene parámetros, es un enlace de atribución predefinido largo y, por lo tanto, estático.
Solo las URL cortas (por ejemplo,
yourbrand.onelink.me/HaT8/r5c2b371), utilizadas para enlaces de atribución personalizados, son dinámicas.Esto significa que una vez que comiences a usar un enlace de atribución para un partner integrado, o una URL larga para medios propios, no cambiará para ningún usuario potencial que se involucre con él, incluso si cambias los valores del enlace de atribución en el panel de control de AppsFlyer. Para que el cambio se concrete, debes usar la URL larga nueva a futuro.
Por otro lado, las URL cortas para medios propios no contienen parámetros directamente. Cuando un usuario potencial interactúa con una URL corta de AppsFlyer, se redirige al usuario potencial a AppsFlyer y los parámetros definidos se aplican de manera dinámica.
¿Qué significa este mensaje de error de Play Store?
Si alguna vez encuentras el siguiente mensaje de error en Play Store después de seguir un enlace de atribución:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#Por lo general, estos caracteres se incluyen en el enlace porque son macros, y los reemplaza un valor de manera dinámica, de modo que no suelen ocasionar problemas graves. Puedes ignorar este mensaje.
¿Para qué sirven los parámetros de suscriptor?
Ejemplo
Una aplicación de transporte, Luber, cuenta con campañas basadas en plantillas de 3 colores: azul, amarillo y rojo. El marketer móvil de Luber, Linda, quiere probar qué color de plantilla genera más instalaciones. Para hacerlo, agrega &af_sub3=blue a los enlaces de atribución de todos los anuncios azules en TODAS las fuentes de medios que no son SRN. Y hace lo mismo para los anuncios amarillos y rojos. Con esta información analizada y reflejada en los reportes de raw data, Linda puede evaluar el éxito de los distintos colores de anuncios y elegir el más eficaz.
¿Qué límites hay en los nombres de campaña?
- La longitud máxima de un nombre de campaña en la URL del enlace de atribución está limitada a 100 caracteres. Si se excede, el nombre de la campaña se cambia a:
c_name_exceeded_max_length - Ten en cuenta que el nombre de la campaña no debería comenzar ni terminar con un espacio en blanco, ya que puede causar discrepancias en los paneles de control y reportes.