De un vistazo: Descubre la estructura y los parámetros del enlace de atribución de AppsFlyer.
Visión general
Los enlaces de atribución permiten a los anunciantes recopilar datos sobre cómo interactúan los usuarios con un anuncio. Estos enlaces se colocan detrás de los anuncios y notifican a AppsFlyer cuando los usuarios interactúan. La interacción puede ser un clic en un anuncio o simplemente ver el anuncio. AppsFlyer recibe una copia de la URL de atribución.
Los enlaces de atribución se generan usando OneLink o un enlace de plataforma única.
OneLink (enlace multiplataforma) | Enlace de plataforma única | |
---|---|---|
Descripción y cuándo utilizarlos |
Úselo cuando:
|
Úselo cuando:
|
Prerequisitos | Plantilla de OneLink | Ninguno |
Información obligatoria | ||
URL base | {subdominio}.onelink.me | app.appsflyer.com |
Identificador único | ID de plantilla | app_id |
Estructura de URL |
https://{subdomain}.onelink.me/ {templateid}?pid={media_source} &af_siteid={ApplicationID} &c={CampaignName}
|
https://app.appsflyer.com/{app_id}?pid={media_source}&af_siteid={ApplicationID}&c={CampaignName} |
Ejemplo |
https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int &c=GreatCampaign&af_siteid=A1b1
|
https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int& c=GreatCampaign&af_siteid=A1b1
|
Parámetros del enlace de atribución
- Los parámetros enumerados están disponibles para su uso en el enlace de atribución.
- La columna tipo de campo indica el límite de caracteres del valor del parámetro. Para más información sobre las limitaciones de longitud de los valores de los parámetros, haga clic aquí.
Parámetros de enlace de atribución: UA y retargeting
La siguiente tabla se puede descargar como un archivo.
Parámetro | Nombre para mostrar en datos sin procesar | Descripción | Tipo de campo y longitud |
---|---|---|---|
pid | Fuente de medios | Identifica de forma única a un socio integrado de AppsFlyer. No lo cambies. Más detalles. | Cadena 150 |
c | Campaña | Proporcionado por el anunciante o el editor. Consulte los límites en los nombres de campaña. | Cadena 100 |
af_prt | Socio |
|
Cadena 50 |
af_mp | N/A |
|
|
clickid | N/A | Identificador único de clic de la red publicitaria | |
af_siteid | ID del sitio |
|
Cadena 24 |
af_sub_siteid | ID del Subsitio |
|
Cadena 50 |
af_c_id | ID de Campaña | Proporcionado por el anunciante/editor | Cadena 24 |
af_adset | Conjunto de Anuncios |
|
Cadena 100 |
af_adset_id | ID del Conjunto de Anuncios | Proporcionado por el anunciante/editor | Cadena 24 |
af_ad | Anuncio | Nombre del Anuncio (ver más) proporcionado por el anunciante/editor | Cadena 100 |
af_ad_id | ID del Anuncio | Proporcionado por el anunciante/editor | Cadena 24 |
af_ad_type | Tipo de Anuncio | Utiliza las siguientes convenciones de nomenclatura:
|
Cadena 24 |
formato de anuncio af_ad | Formato de anuncio | Utiliza las siguientes convenciones de nomenclatura:
|
|
af_click_lookback | Ventana de retrospectiva de atribución |
|
Máximo 3 caracteres |
af_viewthrough_ lookback |
N/A |
|
Máximo 3 caracteres |
af_channel | Canal | El canal de origen de medios a través del cual se distribuyen los anuncios, por ejemplo, UAC_Search, UAC_Display, Instagram, Meta Audience Network, etc. | Enumeración dinámica. Cadena 20 |
af_keywords | Palabras clave | Lista de palabras clave para campañas dirigidas por texto. | Cadena 100 |
af_cost_model | Modelo de costes |
|
Cadena 20 |
af_costo_moneda | Moneda del costo |
|
Enumeración. 3 caracteres |
af_valor_costo | Valor del costo |
|
Cadena 20 |
af_sub[n] (n=1-5) ejemplo: af_sub1 |
Subparámetro [n] | Parámetro personalizado opcional definido por el anunciante. Para más información sobre el uso de estos parámetros, consulte la sección Características y limitaciones. | Cadena 100 |
af_r | N/A |
Se utiliza para redirigir a los usuarios a la URL especificada en todas las plataformas (Android, iOS y escritorio). En los enlaces multiplataforma (OneLink), este parámetro:
Notas:
|
|
af_web_dp | N/A |
URL para redirigir a los usuarios de escritorio (por ejemplo, Windows o Mac) a una página web diferente a la configurada en la plantilla OneLink. Utilice esto para mantener los datos de atribución de usuarios de escritorio en otras plataformas (por ejemplo, Google Analytics u Omniture). Notas:
|
|
af_dp | N/A |
El valor de respaldo del esquema URI para iniciar la aplicación, que se utilizará si falla el método Universal Link o Android App Link, y para usuarios de Android anteriores a 6.0. Debe apuntar solo a la ruta base, es decir, la actividad predeterminada. Nota: Si utiliza un valor de URL web para este parámetro (no recomendado), asegúrese de que la URL sea válida de acuerdo con los estándares RFC 1738 y que el dominio de esta URL esté en la lista permitida de redireccionamiento. |
|
af_force_deeplink | N/A | Forzar vinculación profunda en la actividad especificada en el valor af_dp | |
af_ref | N/A |
Las redes publicitarias que trabajan con clics S2S pueden enviar un valor de referenciador único usando el siguiente parámetro: &af_ref=ValorReferenciador
El valor af_ref debe consistir en un valor único, estructurado de la siguiente manera:
NombreRed_ValorClicÚnicoParaCadaClic
Ejemplo: af_ref=nombre_red_123456789ABCDEF
El nombre de la red puede ser cualquier cadena válida. Puede ser networkname_int o simplemente el nombre de la red.
AppsFlyer puede utilizar este parámetro para la atribución en dispositivos Android. AppsFlyer no utiliza este parámetro para la atribución en dispositivos iOS o Windows.
|
|
is_incentivized | N/A |
Booleano: verdadero/falso
Campañas con o sin incentivos
|
|
af_param_forwarding | N/A |
|
|
af_base_params_forward | N/A |
|
|
af_partner_account_id | ID de cuenta de red | ID de cuenta del anunciante con el socio | Cadena 100 |
redirect | N/A | Cuando &redirect=false , este parámetro indica a AppsFlyer que se trata de un clic S2S y que el socio es responsable de redirigir al usuario que hizo clic. |
|
af_ua | Agente de usuario |
Relevante para las redes publicitarias que envían clics e impresiones de servidor a servidor. La cadena del 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 debido a sugerencias del cliente. Debe enviarse de todos modos.
|
|
af_ip | IP |
Relevante para las redes publicitarias que envían clics e impresiones de servidor a servidor. Dirección IP del dispositivo Recomendado: Si está disponible, proporcione la dirección IP del dispositivo en el parámetro af_ip. Siguiente opción: Si está disponible, AppsFlyer usará la IP en X-Forwarded-For. |
|
[En desuso] af_os | Versión del sistema operativo |
[Solo para iOS] La versión del sistema operativo del dispositivo. Este parámetro está en desuso, pero AppsFlyer aún lo admite. Recomendación: Use el parámetro af_os_version en lugar de este. |
|
af_os_version | Versión del sistema operativo |
|
|
af_model | Modelo del dispositivo |
|
|
af_media_type | Tipo de medio | Ubicación del anuncio que contiene el enlace de la siguiente manera:
|
|
deep_link_sub1-10 | N/A | Valores adicionales de enlaces profundos. Los desarrolladores implementan el comportamiento deseado de los valores en el código. | |
deep_link_value | N/A | El nombre para el contenido específico dentro de la aplicación al que serán dirigidos los usuarios. Los desarrolladores implementan el comportamiento deseado de deep_link_value en el código. | |
af_og_title | N/A | Cuando se publica un enlace en redes sociales, el título de Open Graph (OG) generará una vista previa del título. | Cadena de 40 caracteres |
af_og_description | N/A | Al publicar un enlace en redes sociales, la descripción de Open Graph (OG) generará una vista previa de la descripción. | Cadena de 300 caracteres |
af_og_image | N/A | Cuando se publica un enlace en redes sociales, la imagen de Open Graph (OG) generará una vista previa de la imagen. |
Parámetros de enlace de atribución—solo para retargeting
Parámetro | Nombre para mostrar en datos sin procesar | Descripción | Tipo de campo y ancho |
---|---|---|---|
es_retargeting | ¿Es retargeting (campaña)? | La URL de clic de todas las campañas de retargeting debe incluir &is_retargeting=true .Si el parámetro no está incluido o su valor es "falso", la campaña se considera una campaña normal de adquisición de usuarios. |
Enumeración de 5 caracteres |
af_reengagement_window | Ventana de reenganche |
Cambie la ventana de atribución de reenganche añadiendo este parámetro al enlace de atribución. Las opciones posibles para el rango de la ventana son:
Valor por defecto: 30 días Ejemplo: |
N/A |
Parámetros de visibilidad
Dependiendo del tipo de anuncio, puedes enviar el parámetro de visibilidad relevante con las especificaciones del engagement.
Parámetro | Formato del valor | Descripción |
---|---|---|
af_video_total_length | segundos | Duración total posible del vídeo |
af_video_played_length | segundos | Tiempo de visualización del vídeo |
af_playable_played_length | segundos | Duración de reproducción del elemento jugable una vez cargado |
af_ad_time_viewed | segundos | Tiempo en que el anuncio estuvo visible en pantalla |
af_ad_displayed_percent | % | Porcentaje máximo de visibilidad del anuncio en pantalla |
af_audio_total_length | segundos | Duración total posible del audio |
af_audio_played_length | segundos | Duración de audio escuchada |
Parámetros específicos de Android
Parámetro | Nombre para mostrar en datos sin procesar | Descripción | Tipo de dato |
---|---|---|---|
advertising_id | ID de publicidad | ID de publicidad de Google: requiere soporte de red publicitaria | Máximo 40 caracteres |
sha1_advertising_id | N/A | ID de publicidad de Google encriptado con SHA1: requiere soporte de red publicitaria | |
md5_advertising_id | N/A | ID de publicidad de Google encriptado con MD5: requiere soporte de red publicitaria | Compatible solo con instalaciones y reatribuciones |
android_id | ID de Android | Dispositivo Android_id: requiere soporte de red publicitaria | Máximo 20 caracteres |
sha1_android_id | N/A | Dispositivo Android_id encriptado con SHA1: requiere soporte de red publicitaria | |
md5_android_id | N/A | Dispositivo Android_id encriptado con MD5: requiere soporte de red publicitaria | Compatible solo con instalaciones y reatribuciones |
imei | IMEI | ID IMEI del dispositivo | |
sha1_imei | N/A | ID IMEI del dispositivo encriptado con SHA1: requiere soporte de red publicitaria | |
md5_imei | N/A | ID IMEI del dispositivo encriptado con MD5: requiere soporte de red publicitaria | |
oaid | OAID | Identificador Abierto Anónimo del Dispositivo | Disponible desde la versión 4.10.3 del SDK de Android |
sha1_oaid | N/A | Identificador Abierto Anónimo del Dispositivo encriptado con SHA1: requiere soporte de red publicitaria | Disponible desde la versión 4.10.3 del SDK de Android |
md5_oaid | N/A | Identificador de dispositivo anónimo abierto codificado con MD5: requiere compatibilidad con redes publicitarias. | Disponible desde la versión 4.10.3 del SDK de Android |
af_android_url | N/A |
Redirige a los usuarios de Android a una URL diferente a la página de la aplicación en Google Play. Úsalo para tiendas de aplicaciones de terceros. Notas:
|
|
sha1_el | N/A | Se utiliza para atribución de escritorio a móvil: correo electrónico codificado con SHA1. Requiere compatibilidad con redes publicitarias. | |
fire_advertising_id | N/A | ID de publicidad de Amazon Fire. | |
af_android_store_csl | store_product_page | Listado de tienda personalizado en Google Console. | string |
Parámetros específicos de iOS.
Parámetros | Nombre para mostrar. | Descripción |
---|---|---|
idfa | IDFA |
Usa mayúsculas. Requiere compatibilidad con redes publicitarias. Tipo de campo: Máximo 40 caracteres |
idfv | IDFV | Usa mayúsculas. |
af_ios_url |
Usa esto para redirigir a usuarios de iOS (iPhone o iPad) a una URL distinta de la página de la aplicación en iTunes. Notas:
|
|
af_ios_store_cpp | store_product_page |
ID de página de producto personalizada (ppid). Nota: En los datos crudos y los informes agregados, se registra el valor del parámetro af_ios_store_cpp (ID de página de producto personalizada) para los clics, pero no para las impresiones. |
af_ios_fallback [obsoleto] | N/A | Obsoleto: Los usuarios son redirigidos según el flujo de esquema de URI de iOS. |
sha1_idfa | N/A | IDFA codificado con SHA1. Requiere compatibilidad con redes publicitarias. |
sha1_idfv | N/A | IDFV codificado con SHA1. |
mac | N/A | Dirección MAC del dispositivo. Requiere compatibilidad con redes publicitarias. |
md5_idfv | N/A | IDFV codificado con MD5. |
sha1_mac | N/A | Dirección MAC del dispositivo codificada con SHA1. Requiere compatibilidad con redes publicitarias. |
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_campaign
Todos los parámetros están disponibles en el Informe de instalación y en Análisis, informes y API.
Parámetros personalizados
Además de los parámetros predeterminados específicos de Android e iOS, también puedes especificar parámetros personalizados. Estos parámetros personalizados pueden ayudarte si deseas personalizar la experiencia del usuario y el contenido de acuerdo con el enlace de atribución que conduce a una instalación.
Puedes añadir 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_value
Dos aspectos importantes que debes conocer sobre los parámetros personalizados:
- Los parámetros personalizados no aparecen en los datos en bruto.
- Puedes recuperar los parámetros personalizados a través de la API del SDK de obtención de datos de conversión.
Parámetro de ID del socio (PID)
De todos los parámetros de enlace de atribución disponibles, el PID es obligatorio. El PID es el identificador único que AppsFlyer asigna a la fuente de medios.
Cada socio integrado tiene su propio valor de PID único. El PID termina con el sufijo _int. Al usar enlaces OneLink, puedes definir el PID con el valor que prefieras, siempre que no esté reservado para un socio integrado. Para evitar conflictos, no utilices el sufijo _int .
Ejemplos de PIDs de editores integrados importantes: orgánico, googleadwords_int (Google AdWords), anuncios de Meta y anuncios X. Puedes utilizar cualquier nombre para fuentes no integradas, como email, SMS o palomas mensajeras.
Evita problemas comunes con el PID:
- Incluye siempre el PID en tus enlaces de atribución. Sin el PID en el enlace de atribución, al usuario se le asigna automáticamente una fuente de medios "Ninguna" y se pierde la fuente original de instalación.
- Para fuentes personalizadas, utiliza PID de socios no integrados. Para cada fuente integrada, utiliza solo el PID designado para garantizar la correcta atribución de sus instalaciones. Para cualquier fuente de medios personalizada, como email, SMS o incluso publicaciones virales no pagadas en Facebook, utiliza otros valores de PID no integrados.
-
Usa únicamente caracteres válidos. Si el parámetro PID en el enlace de atribución incluye alguno de los siguientes caracteres \/<>*&?\
- El clic o la instalación aparecerán en el panel de control bajo af_invalid_param
- Los enlaces de atribución no se atribuirán.
- Las capacidades de enlaces profundos no funcionarán en los clics.
Consejo
Evita utilizar espacios en blanco en el valor del PID o asegúrate de codificar la URL de tus enlaces de atribución antes de utilizarlos.
Parámetro de ID del sitio
El ID del sitio es el identificador único del editor que muestra el anuncio. Es decir, el sitio web o la app que exhibe el anuncio. Las redes de anuncios asignan identificadores únicos de sitio para cada editor.
Este identificador se incluye en el parámetro af_siteid
que se pasa a AppsFlyer en el enlace de atribución y está disponible a través de varios paneles, opciones de informes y devoluciones automáticas de datos.
Es necesario pasar el ID del sitio a AppsFlyer en el enlace de atribución porque:
- Proporciona claridad y transparencia sobre el editor.
- AppsFlyer lo emplea para identificar y eliminar editores fraudulentos y otros grupos de tráfico.
El parámetro de ID del sitio solo incluye el ID del editor que publica el anuncio.
Para incluir información adicional, como el tipo de anuncio, su ubicación o ambos dentro de la aplicación, por ejemplo, banner, intersticial o vídeo, utilice el parámetro de ID de subsitio.
Ejemplo
El siguiente enlace de atribución incluye:
-
af_siteid
(ID del sitio): ID del editor -
af_sub_siteid
(ID del subsitio): Información de ID adicional (en este caso, una fuente afiliada y la ubicación del tipo de anuncio)
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 del editor
- ABCD = Fuente afiliada (subeditor) con la que colabora el editor
- 4567 = Ubicación del tipo de anuncio dentro de la aplicación, como banner, intersticial o vídeo
Preguntas frecuentes: ¿Por qué el tráfico resulta en muchas instalaciones bloqueadas?
Las instalaciones bloqueadas pueden deberse a lo siguiente:
-
ID de sitio inexistente: El parámetro
af_siteid
está vacío en la URL de clic. Los envíos con un ID de sitio vacío indican un problema técnico o un intento deliberado de eludir los mecanismos de detección de fraude. - Diversos IDs de sitios: El mismo editor se envía en múltiples URLs de clic, usando diferentes IDs de sitio. Esto se considera un comportamiento fraudulento que oculta la actividad real del editor y a menudo se asocia con la saturación de clics.
- ID del sitio mal formateado: Enviar un formato incorrecto, junto con otras indicaciones de fraude, podría resultar en el bloqueo no solo del editor específico, sino también de un nivel superior de clúster, y podría afectar mayores volúmenes de actividad del socio.
Para evitar instalaciones bloqueadas, asegúrate de enviar un único parámetro de ID de sitio por editor, tal como se muestra en el ejemplo.
Niveles de granularidad de datos
Puedes utilizar hasta cuatro parámetros de URL para analizar en profundidad el rendimiento de tus anuncios.
Utilizar los 4 parámetros en todos tus enlaces de atribución activos permite:
- Atribuir todas las instalaciones y eventos de usuarios a anuncios específicos.
- Examina detalladamente y compara el rendimiento de todos tus anuncios por conjunto de anuncios, campaña y fuente de medios en informes agregados para optimizar en todos los niveles.
- Compara todos tus anuncios entre todas las fuentes de medios en los informes de datos sin procesar y en la tabla dinámica.
Los parámetros son:
Media source (pid=)
campaign name (c=)
Ad set (af_adset=)
Ad name (af_ad=)
Ejemplo
El siguiente enlace de atribución utiliza 4 niveles de granularidad para registrar el anuncio "cachemira" en el conjunto de anuncios "abrigos" de la campaña "invierno" que se ejecuta en la fuente de medios integrada "red".
https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter& af_adset=coats&af_ad=cashmere
Preguntas frecuentes
¿Debo utilizar letras minúsculas o mayúsculas para los parámetros?
Puedes usar cualquiera de los dos, pero debes ser coherente. Si configuras un parámetro personalizado con caracteres en mayúsculas o minúsculas, asegúrate de usar siempre ese mismo parámetro.
Por ejemplo, si configuras pid=MyMediaSource, asegúrate de usarlo siempre así. Si utilizas pid=MyMediaSource en un enlace de atribución y pid=mymediasource en otro, pueden surgir discrepancias en los datos. Lo mismo aplica para cualquier otro parámetro que configures en el enlace de atribución.
¿El enlace de atribución de AppsFlyer es dinámico o estático?
¿Cómo puedes 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, ), 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 socio integrado o una URL larga para medios propios, no cambiará para ningún cliente potencial que interactúe con él, incluso si modificas los valores del enlace de atribución en el panel de AppsFlyer. Para que el cambio surta efecto, tendrás que utilizar la nueva URL larga desde ahora.
Por otro lado, las URL cortas para medios propios no contienen parámetros directamente. Cuando un cliente potencial interactúa con una URL corta de AppsFlyer, se redirige a AppsFlyer y los parámetros actuales se aplican de manera dinámica.
¿Qué es este mensaje de error de Play Store?
Si alguna vez ves el siguiente mensaje de error en Play Store tras seguir un enlace de atribución:
Esto ocurre porque el enlace de atribución contiene un carácter #. Por ejemplo:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#
Normalmente, estos caracteres están en el enlace porque son macros y se sustituyen dinámicamente por un valor. Así que no es un problema importante y puedes ignorar el mensaje.
¿Para qué sirven los parámetros de suscriptor?
Los parámetros del suscriptor, es decir, af_sub1, af_sub2, ..., af_sub_5, se pueden usar para registrar cualquier indicador clave de rendimiento (KPI) útil. Estos parámetros se interpretan y se muestran en el informe de datos en bruto, lo que los hace muy prácticos para la agregación o el filtrado de datos.
Ejemplo
Una aplicación de transporte, Luber, tiene creatividades con 3 plantillas de colores: azul, amarillo y rojo. Linda, la especialista en marketing móvil de Luber, quiere evaluar qué plantilla de color genera más instalaciones. Para ello, añade &af_sub3=blue
en los enlaces de atribución de todos los anuncios azules en TODAS las fuentes de medios no SRN. Se realiza el mismo procedimiento para los anuncios amarillos y rojos. Con esta información analizada y presentada en los informes de datos en bruto, Linda puede analizar el éxito de los anuncios de diferentes colores y seleccionar el que mejor convierta.
¿Qué límites existen para los nombres de las campañas?
- La longitud máxima del nombre de una 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 modifica a:
c_name_exceeded_max_length
- El nombre de la campaña no debe comenzar ni terminar con un espacio en blanco, ya que podría causar discrepancias en los cuadros de mando e informes.
Rasgos y limitaciones
Rasgo | Observaciones |
---|---|
Caracteres especiales | No se permiten los siguientes caracteres especiales en parámetros o valores: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, \/, {, }, % |
Límite de caracteres de la URL | La longitud total de la URL no debe superar los 2000 caracteres |
Redirección de enlaces profundos en WebView de aplicaciones sociales de Android | Consulta los detalles de las limitaciones aquí |
Los enlaces profundos no son compatibles con la app de Android Naver Blog | Los enlaces profundos no son compatibles con la app Naver Blog en Android. Los usuarios serán redirigidos a Google Play Store o a la web según el enlace establecido. |
Al hacer clic en un enlace de esquema URI desde el navegador Chrome en iOS, aparece una ventana emergente | Debido a un cambio en Chrome iOS, cada vez que un usuario hace clic en un enlace de esquema URI en Chrome en iOS, se muestra una ventana emergente pidiendo al usuario confirmar la apertura de la aplicación o la redirección a la App Store. |
Requisitos de validez para esquemas URI | Recomendamos utilizar un esquema URI válido que cumpla con RFC 3986. Los esquemas que no cumplan con lo anterior pueden no abrir una aplicación y generar un error al hacer clic desde una web view u otros entornos web. |
Atribución de WebView en Telegram | Consulta los detalles de las limitaciones aquí |