How can we help?

Macros de postback para Partners de analítica

  • Actualización
De un vistazo: Usa macros como parte de los postbacks enviados a Partners de analítica para obtener datos de atribución relevantes.

Postbacks para Partners de analítica

Los Partners de analítica pueden definir el contenido y los endpoints de los postbacks que se les envían como parte de su integración con AppsFlyer. Los postbacks se relacionan con el engagement del usuario de la aplicación, como instalaciones, eventos in-app, re-engagements, etc.

  • Configuración de postback: Para solicitar cambios en la configuración de postback, usa el widget del asistente para Partners para abrir un ticket o contacta con tu gerente de desarrollo de Partners de AppsFlyer. 
  • Tipos de postback: Hay postbacks disponibles para instalación y eventos in-app.

Macros de postbacks

Cuando se incluyen en un postback, las macros se sustituyen por datos relevantes para el usuario. Por ejemplo, para obtener la dirección IP del usuario que instala la aplicación, incluye country_code=(ip) en la estructura del postback. Las macros admitidas se enumeran en la siguiente tabla:

  • Fuente: De dónde proceden los datos:
    • SDK: El SDK de AppsFlyer incorporado en la aplicación o la API de servidor a servidor
    • AF: Tras el procesamiento por parte de AppsFlyer.
  • [Base] Macros para todos los postbacks: Macros relevantes para la instalación y el evento in-app.
  • [Opcional] para eventos in-app, como se indica en la columna.

Macros: instalaciones y eventos in-app

Macro de postback (nombre) Fuente Nota [Base] Macros para todos los postbacks [Opcional] Eventos in-app
advertising_id SDK ID del dispositivo que puede ser restablecido por el usuario, también conocido como GAID. También disponible como: (sha1-advertiserId)  
nombre_del_evento SDK Nombre asignado a un evento  
event_revenue_USD AF Valor del evento en USD  
ingresos_evento SDK Valor de evento reportado por SDK usando event_revenue_currency o la divisa que has seleccionado.  
moneda_ingresos_evento SDK El código de divisa de los ingresos del evento reportado en el evento o la divisa que has seleccionado.  
event_time SDK gp_referrer (Google Play Referrer string)  
event_value SDK El evento in-app incluye atributos con valores, que se pueden enviar por completo en el postback en formato JSON. URL codificada mediante la macro (encode).  
partner_event_id AF Nombre/ID del evento correspondiente en la plataforma del partner  
nombre_aplicación SDK Nombre de la aplicación configurado por el anunciante  
appsflyer_id SDK Identificador único de AppsFlyer, registrado en la conversión  
tipo_táctil_atribuido AF Indicador que marca si la atribución se produjo debido a una impresión (1 = impresión, 0 = clic)  
código_de_país AF Código de país con ISO 3166 (alfa-2) Ejemplo: US, CN.  
idfa SDK ID de publicidad que el usuario puede restablecer y que se encuentra en dispositivos iOS. También disponible como: (sha1-idfa)  
idfv SDK Identificador único por usuario y por proveedor en los dispositivos iOS  
hora_de_instalación SDK Marca de tiempo de instalación  
install_unix_ts SDK Marca de tiempo de instalación en formato unix  
es_lat SDK Limit ad tracking (LAT): iOS: Desde iOS 14, Apple retiró LAT. Determina el estado de privacidad del usuario usando ATT. En este caso, ignora is_lat. Antes de iOS 14, si es verdadero, el IDFA no está disponible y se establece en 0. Android: Cuando es verdadero, el usuario ha optado por no participar en anuncios basados en intereses. Esto no impide que se recopile el ID de publicidad de Google (GAID).  
Indicador de atribución AF SDK Idioma (configuración regional) reportado por el dispositivo y establecido por el sistema operativo del dispositivo.  
id_aplicación SDK Identificador único de aplicación en Appsflyer.  
app-version-name SDK Versión de la aplicación establecida por el desarrollador de la aplicación en el código de la aplicación  
tiempo_de_toque_atribuido AF Hora del toque al que AppsFlyer atribuyó  
tipo_de_dispositivo SDK Nombre del modelo comercial del dispositivo. Ejemplo: SM-GM284 o iPhone7  
ip AF IP del dispositivo del usuario que reporta el evento  
match_type AF Tipo de método de atribución. Por ejemplo, srn, id_matching, probabilistic  
versión_sistema_operativo SDK Versión del sistema operativo del dispositivo  
agente_usuario SDK El agente de usuario de la URL  
wifi SDK Si es true, la conexión era wifi en el momento de la conversión  
oaid SDK ID que el usuario puede restablecer en algunos dispositivos Android, generalmente como alternativa a GAID  
Identificador de origen SDK Plataforma del dispositivo: iOS, Android o Windows Mobile  
tipo_conversion_retargeting SDK Un indicador que marca si se trata de una reatribución o un re-engagement  
PID AF Ad network a la que se atribuye la instalación o el evento in-app  
af_anuncio Atribución Nombre del anuncio (ver más) proporcionado por el anunciante/publisher
id_del_anuncio_af Atribución Proporcionado por el anunciante/publisher
af_conjunto de anuncios Atribución
  • 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
af_adset_id Atribución Proporcionado por el anunciante/publisher
C Atribución Proporcionado por el anunciante/publisher. Los nombres de campaña que superan los 100 caracteres de longitud se muestran en el dashboard como “c_name_exceeded_max_length”
af_c_id Atribución Proporcionado por el anunciante/publisher
af_siteid Atribución
  • ID único que identifica al publisher que muestra el anuncio. Saber más
af_subsite_id Atribución
  • ID de subred publicitaria/ID del publisher. 
  • Si, además del editor principal (ID del sitio), hay un subeditor o deseas incluir información adicional, como tipo de anuncio/ubicación dentro de la aplicación, como banner, intersticial, vídeo, etc., utiliza af_sub_siteid. Por ejemplo: af_sub_siteid =ABCD_4567
af_ad_type Atribución 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.
  • sponsored_content: un enlace incluido en una pieza de contenido patrocinado, como un artículo publicitario
  • audio: un anuncio de audio.

Macros solo para eventos in-app

Los ejemplos a continuación se relacionan con los postbacks de eventos in-app disponibles para los partners.

 Ejemplo

La plantilla de postback de evento &event=(event)&json=(encode) se tradujo al siguiente postback para un evento af_purchase específico:

&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A

El valor JSON decodificado de este postback es {"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Valores codificados

Es posible que los postbacks incluyan caracteres irregulares no alfanuméricos. Para transferir estos valores correctamente a través de postbacks, AppsFlyer codifica en URL los valores no alfanuméricos.
Para decodificar o codificar un postback, usa un servicio web de codificación.

Postbacks de muestra

Ejemplos de postbacks de instalación generales

AndroidiOS
http://YourCompanyDomain.com?pid=(media_source)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)

Ejemplos de postbacks de eventos in-app generales

AndroidiOS
http://YourCompanyDomain.com?pid=(media_source)&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)&event_name=(event-name)&currency=(currency)&json=(event-value)

Ejemplo de postbacks de eventos in-app

Parámetros de evento:

  • Nombre del evento: af_revenue
  • Ingresos por evento: 120.00
  • Moneda del evento: USD
  • Valor del evento: {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Postback:

http://YourCompanyDomain.com?pid=(media_source)&device_ip=38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&android_id=9aaeecc4455xxxxx&install_time=1451923560&event_name=af_purchase&currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.

Share article: