Estructura y parámetros del enlace de atribución

At a glance: AppsFlyer attribution link structure and parameters explained.

Attribution links report user activity related to clicks and mobile ad impressions to AppsFlyer. Clicking on an attribution link redirects the user to download the app. A copy of the URL clicked is sent to AppsFlyer. Portions of the link are used to populate raw data reports. 

Enlace de atribución de base de AppsFlyer

El enlace de atribución de base contiene la información mínima necesaria para registrar el clic y redirigir al usuario para descargar la aplicación. Se pueden agregar más parámetros al enlace después del carácter ? para registrar información adicional.

http://app.appsflyer.com/{app_id}?pid={media_source}


El enlace de atribución de base incluye el {App_id}, que es el ID de la aplicación para la aplicación en Apple iTunes/App Store, o el nombre del paquete para Google Play, así como el pago (fuente de medios). Este es el requisito mínimo para un enlace de atribución.

Nota: Para las aplicaciones de Amazon, usa el nombre del paquete (en lugar del ASIN).

 Ejemplo

El siguiente enlace de atribución para la aplicación com.greatapp emplea varios parámetros, incluida la fuente de medios (pid), el nombre de la campaña (c) y el ID del conjunto de anuncios (af_adset_id). Para ver una lista completa de los parámetros de enlaces de atribución admitidos y sus explicaciones, consulta la tabla a continuación.
http://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822

Parámetros de enlaces de atribución

Los siguientes parámetros pueden usarse dentro del enlace de atribución generado.

El número en la columna 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 Nombre visible en raw data Descripción

Tipo de campo

pid Fuente de medios Identifica de manera única a un partner integrado de AppsFlyer. No lo cambies. Más detalles.

String 50

c Campaña Proporcionado por el anunciante/publisher. Los nombres de campaña que superan los 100–caracteres de longitud se muestran en el panel de control como "c_name_exceeded_max_length".

String 100

af_prt

Agencia

  • El nombre de cuenta de agencia permite atribuir instalaciones a la agencia.
  • Precaución: No uses este parámetro antes de asegurarte de que los Permisos de agencia estén habilitados.

String 50

af_mp

N/A
  • Habilita el envío de postbacks a los partners de marketing del publisher por instalación.
  • Nota: Actualmente, este parámetro solo es pertinente para los partners de marketing de Pinterest.

 

clickid

N/A

Identificador de clics exclusivo de la red de publicidad

 

af_siteid

Site ID

ID de publisher de red de publicidad

String 24

af_sub_siteid

ID de subsitio

ID de publisher/subred de publicidad

String 50

af_c_id

ID de campaña

Proporcionado por el anunciante/publisher.

String 24

af_adset

Conjunto de anuncios

  • Proporcionado por el anunciante/publisher.
  • El conjunto de anuncios representa un nivel intermedio en la jerarquía entre campaña y anuncio. Ver más

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:

  • text: una unidad de anuncio que contiene solo texto, p. ej. un resultado de búsqueda
  • banner: un formato básico que aparece en la parte superior o inferior de la pantalla del dispositivo
  • interstitial: un anuncio de página completa que aparece durante los descansos en la experiencia actual
  • video: un video estándar, es decir, no recompensado
  • rewarded_video: una unidad de anuncio que ofrece recompensas in-app a cambio de ver un video
  • playable: una unidad de anuncio que contiene una vista previa interactiva de la experiencia de la aplicación
  • sponsored_content: un enlace incluido en una pieza de contenido patrocinado, como un artículo publicitario
  • audio: un anuncio de audio

String 24

af_click_lookback

Ventana de atribución retrospectiva

  • Ventana retrospectiva para la atribución de clics.  La duración de la ventana es el CTIT (tiempo del clic a la instalación) máximo para atribuir el nuevo usuario a la fuente que muestra el anuncio/enlace.
  • Cantidad de días configurable para el período de atribución de clics en retrospectiva.   Valores de parámetros disponibles: 1d - 30d (días) O 1h - 23h (horas). El valor predeterminado es 7d.  
  • La ventana retrospectiva puede personalizarse para OneLink y SRN.

Nota: Solo afecta las URL en las que se hizo clic, no las URL de impresiones.

Máx. de 3 caracteres

af_viewthrough_
lookback

N/A

  • Cantidad de días configurable para el período de atribución por impresiones en retrospectiva.   Valores de parámetros disponibles: 1h - 48h (horas) O 1d - 7d (días). El valor predeterminado es 1d. 
  • La ventana retrospectiva puede personalizarse para las SRN.

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, Facebook 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

  • Modelo de costo: actualmente el costo por instalación o CPI (predeterminado) es el único modelo admitido, cuando se reporta el costo por clic, lo que completa el valor de costo en los reportes de datos agregados de AppsFlyer.
  • Siempre que sea posible, reporta el costo por API. En los casos en que el costo se reporta por enlace y por API, la API tiene prioridad.

String 20

af_cost_currency

Moneda de costo

  • Código de divisa de 3 letras compatible con ISO-4217. Por ejemplo, USD, ZAR, EUR
  • [Predeterminado]: USD

Enumeración: 3 caracteres

af_cost_value

Valor de costo

  • Valor de costo en el uso de la divisa de costo.
  • Hasta 4 dígitos después del punto decimal.
  • Configura SOLO dígitos numéricos (usa un punto decimal si es necesario), ejemplo: "56", "2.85"

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 Preguntas frecuentes.

String 100

af_r N/A

Redirect users to the specified URL for both platforms (Android and iOS).
Note: When af_r is set, you do not need to set the params af_ios_url, af_android_url, and af_web_dp, since those redirections are included in af_r.

 
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).  
af_dp N/A El valor de reserva 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
  • Cuando se configuran como "false", los parámetros incluidos en el enlace de atribución no se reenvían a la página redirigida.
  • Utiliza esta opción para una URL más clara en la página redireccionada, o en el caso de que los parámetros del enlace de atribución, pudieran causar problemas asociados a la administración del parámetro de consulta en la página redireccionada.
 
af_os Versión de OS [Solo para iOS] La versión del sistema operativo del dispositivo  
af_model Tipo de modelo iOS

[Solo para iOS] El modelo del dispositivo. Valores permitidos:

  • iphone (todo en minúsculas)
  • ipad (todo en minúsculas) 
 
Parámetros en enlaces de atribución: UA y retargeting
Parámetros Nombre visible en raw data Descripción

Tipo de campo

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:

  • Días: 1-90 u Horas 1-36
  • Vida útil: Esto significa que la ventana de re-engagement es ilimitada. Ejemplo: &af_reengagement_window=lifetime

Valor predeterminado: 30 días

Ejemplo: el valor &af_reengagement_window=60d configura la ventana de re-engagement en 60 días.

N/A

Parámetros en enlaces de atribución: solo retargeting

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.

Parámetro Formato de valor Descripción
af_video_total_length   La duración total posible del video
af_video_played_length   Cuánto del video se vio
af_playable_played_length   Cuánto tiempo el elemento reproducible se reprodujo una vez que se cargó por completo
af_ad_time_viewed   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   La duración total posible del audio
af_audio_played_length   Cuánto del audio se oyó
Tipo de anuncio (af_ad_type) 

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 Android a una URL distinta a la de la página de la aplicación en Google Play. Usa este parámetro para aplicaciones que no estén en la tienda.

 

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

 

Parámetros específicos de Android

iOS specific parameters

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

Redirecciona a los usuarios de iOS (iPhone o iPad) a una URL distinta a la de la página de la aplicación en iTunes.

Usa este parámetro para redireccionar a la página de aterrizaje.

af_ios_fallback [deprecated]

N/A

Deprecated: Users are redirected based on the iOS URI scheme flow

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

http://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

All parameters are available in the Install report and the Analytics, Reports, and APIs.

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 de acuerdo con el enlace de atribución que conduce a una instalación.

Puedes agregar parámetros personalizados al enlace de atribución en el formato parameter=value. Por ejemplo:

http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_value

Dos cosas importantes que debes saber sobre los parámetros personalizados:

¿Por qué el ID de anunciante (PID) es el parámetro más importante?

Entre todos los parámetros de enlaces de atribución disponibles, PID se destaca como el único parámetro que DEBE incluirse en cada enlace de atribución. 

En efecto, el PID, o ID de publisher, es el nombre de la fuente de medios. Se trata del campo principal para la atribución de la instalación a su fuente.

Los partners integrados tienen su propio valor de ID de anunciante (PID) único, que termina con "_int". Cuando uses enlaces de atribución personalizados, puedes definir cualquier nombre de PID que quieras, siempre que no esté reservado por algún partner integrado.

A continuación, verás algunos ejemplos de ID de publishers importantes integrados: orgánicos, googleadwords_int (Google AdWords), anuncios de Facebook, Twitter. Puedes usar cualquier nombre para fuentes no integradas como correo electrónico, SMS o palomas mensajeras.

Cómo evitar los problemas comunes del ID de anunciante (PID)

Cuando uses este parámetro, ten en cuenta las siguientes reglas de 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 una fuente de medios con el nombre "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 del enlace de atribución contiene alguno de los caracteres ":<>*&?/" , el clic o la instalación aparecerá en el panel de control, debajo de invalid_media_source_name.

 

 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.

Niveles de granularidad de datos

Puedes usar hasta 4 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:

  1. Fuente de medios (pid=)
  2. Nombre de campaña (c=) 
  3. Conjunto de anuncios (af_adset=)
  4. 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".

http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere

Preguntas frecuentes

¿Debo usar letras minúsculas o mayúsculas para los parámetros?

You can use either but you must be consistent. If you set a custom parameter with upper or lower case characters, make sure to always use that parameter.

For example, if you set pid=MyMediaSource make sure to always use it. If you use pid=MyMediaSource on one attribution link and pid=mymediasource on another, discrepancies in data might occur. The same goes for any other param that you set on the attribution link.

Is the AppsFlyer attribution link dynamic or static?

Attribution links can be dynamic or static.
How can you tell if a link is dynamic or static?
If the attribution link contains parameters, it's a long pre-defined attribution link, and therefore static.
Only shortened URLs, used for custom attribution links, are dynamic.
This means that once you start using an attribution Link for an integrated partner, or a long URL for owned media, it would not change for any leads engaging with it, even if you change the attribution link values on AppsFlyer's dashboard. For the change to take place, you need to use the new long URL going forward.
On the other hand, shortened URLs for owned media, don't directly contain parameters. When a lead engages with an AppsFlyer's shortened URL, the lead is redirected to AppsFlyer and the current set parameters take place dynamically.

¿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:

TL_error_message.png

Se debe a que el enlace de atribución contiene un carácter #. Por ejemplo:
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?

The Subscriber Parameters, meaning af_sub1, af_sub2, ..., af_sub_5 can be used to record any useful KPIs. These parameters get parsed and appear in the raw data report, which makes them very handy for performing data aggregation or filtering.

 Ejemplo

Una aplicación de transporte, Luber, cuenta con campañas basadas en plantillas de 3 colores: azul, amarillo y rojo. La comercializadora 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.

¿Cuál es la longitud máxima para un nombre de campaña?

AppsFlyer limita la longitud del nombre de campaña en la URL del enlace de atribución a 100 caracteres. Si se excede dicho límite de caracteres, el nombre de campaña cambia a una secuencia como la siguiente: c_name_exceeded_max_length

 Consejo

Video: Noam Gohary de Playtika revela los 3 mejores métodos para optimizar la estructura de enlaces y los datos.

¿Fue útil este artículo?