Enlaces de atribución directa de plataforma CTV, PC y consola

En resumen:  Aprende sobre la estructura y los parámetros del enlace de atribución de AppsFlyer para las plataformas de CTV, PC y consola. Nota: Para aplicaciones de Android e iOS, incluidos los juegos de PC Android, sigue las instrucciones del enlace de atribución móvil.

General

Los enlaces de atribución directa de plataformas CTV, PC y consola permiten a los anunciantes redireccionar a los usuarios y recopilar datos después de los clics. Estos enlaces de atribución directa son enlaces de AppsFlyer que admiten la redirección y la atribución de una sola aplicación de destino en una sola plataforma a la vez. El destino de la redirección es el valor del parámetro af_r incluido en el enlace. 

Nota: Para aplicaciones de Android e iOS, incluidos los juegos de PC Android, sigue las instrucciones del enlace de atribución móvil.

Puedes crear enlaces de atribución directamente y colocarlos detrás de los anuncios. Para crear dichos enlaces, sigue las instrucciones de este artículo.

Alternativamente, se pueden crear enlaces a través de S2S utilizando la API de Engagements. Esto requiere algo de trabajo de desarrollo. Nota: Los enlaces creados a través de S2S también pueden recopilar datos de impresiones.

Enlace de atribución

Propiedad Valores
URL base engagements.appsflyer.com/v1.0/c2s/click/app/
Parámetros de ruta obligatorios
  • platform
    Ejemplo: steam
  • app_id
    Ejemplo: 123456
Parámetros obligatorios de la consulta
  • af_media_source
  • af_campaign_id
Otros parámetros Ver todos los parámetros
Estructura de URL https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}
URL de muestra https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=aloha&af_campaign_id=1234&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello

Parámetros

Parámetro Nombre para mostrar en exportación de raw data y en API Pull Descripción Tipo de dato
platform Plataforma
  • Parámetro de ruta que especifica la plataforma de la aplicación.
  • Posibles valores:
    • smartcast
    • tizen
    • roku
    • webos
    • vidaa
    • playstation
    • steam
    • quest
    • battlenet
    • epic
    • switch
    • xbox
    • nativepc 
Cadena
app_id ID de aplicación
  • Parámetro de ruta que especifica el ID de la aplicación para la que estás publicando.
  • Ejemplo: ap123456
  • No agregues un prefijo de plataforma al valor de ID de aplicación. Por ejemplo, si el ID de aplicación es ap123456 y la plataforma es platformX, no uses platformX_ap123456 como valor de app_id.
Cadena
af_media_source Fuente de medios Este es el identificador de parter único según se define en la plataforma de AppsFlyer.
No se permiten los siguientes caracteres especiales: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %.
Cadena
af_campaign Campaña Nombre de la campaña Cadena
af_campaign_id ID de campaña ID de campaña Cadena
af_request_id N/A Identificador que identifica de forma única una solicitud de un socio. Cadena
af_adset Conjunto de anuncios Nombre del conjunto de anuncios Cadena
af_adset_id ID del conjunto de anuncios ID del conjunto de anuncios Cadena
af_ad Anuncio Nombre del anuncio Cadena
af_ad_id ID del anuncio ID del anuncio Cadena
af_campaign_type Tipo de campaña Elige entre:
  • user_acquisition
  • retargeting
Cadena
af_prt Partner
  • Nombre de la cuenta de la agencia que permite atribuir instalaciones a la agencia
  • ¡Importante! No uses este parámetro antes de asegurarte de que los permisos de la agencia estén habilitados.
Cadena
af_siteid ID del sitio

ID único que identifica al publisher que muestra el anuncio.

Cadena
af_sub_siteid ID del subsitio

ID de anunciante/subred de publicidad.

Cadena
af_click_id N/A

Identificador de transacción único de la red publicitaria

Cadena
af_lookback_window N/A
  • Ventana retrospectiva relevante para la atribución a través de coincidencia de ID.
  • Número configurable de días/horas para el período de atribución de la ventana de lookback. Valores de parámetros disponibles: 1d-30d (días) O 1h-23h (horas).
  • Validación: 3 caracteres como máximo, utilizando el esquema anterior.
  • El valor predeterminado es 24 horas para impresiones y 7 días para clics.
Cadena
af_ad_placement N/A

Identificador de transacción único de la red publicitaria

Cadena
af_ad_type Tipo de anuncio
  • Tipo de anuncio. Usa la siguiente convención de nomenclatura:
    • text: una unidad de anuncio que contiene solo texto, por ejemplo, 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.
    • audio: un anuncio de audio.
  • Distingue entre mayúsculas y minúsculas.
Cadena
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.

Cadena
af_model Modelo del dispositivo

Modelo del dispositivo

Cadena 64
af_os_version N/A
  • Versión del sistema operativo del dispositivo
  • Solo se permiten dígitos y puntos
  • Ejemplo: 8.1.0
Cadena
af_device_id_type N/A

Tipo de identificador de dispositivo. Elige entre:

  • vida
  • tifa
  • rida
  • lgudid
  • fire
  • advertising_id
  • fire
  • custom
Cadena
af_device_id_value N/A

Tipo de identificador de dispositivo

Cadena
af_r N/A
  • Contiene el enlace a la tienda de aplicaciones o landing page correcta.
  • Todo dentro del parámetro af_r debe estar codificado. Esto incluye cualquier valor de parámetro UTM, si se adjunta.

Nota: Asegúrate de que el dominio URL de af_r esté incluido en tu lista de redireccionamientos permitidos.

Cadena

Rasgos y limitaciones

Ventana de lookback Con el modelado probabilístico, se utiliza una ventana de lookback fija de 24 horas para clics e impresiones. Se ignora el valor af_lookback_window.
Atribución de agencia
  • Flujo de CTV-PC-consola a móvil: se admite la atribución de agencia.
  • Flujo de móvil a CTV-PC-consola: no se admite la atribución de agencia.