Guía de privacidad avanzada y macros de postback para redes de publicidad

De un vistazo: intercambio de datos con partners cuando la privacidad avanzada está habilitada. Instrucciones para las redes de publicidad sobre cómo configurar postbacks de privacidad avanzada. Nota: Este artículo no está relacionado con los postbacks de SKAdNetwork ni está destinado a ser utilizado por anunciantes. 

Noticias sobre privacidad avanzada para redes de publicidad

El mecanismo de postback de privacidad avanzada que se describe en este artículo funciona cuando se cumplen todas las condiciones siguientes:

  • El dispositivo del usuario ejecuta iOS 14.5+.
  • La privacidad avanzada está activada.

AdvancedPrivacy.png

En este artículo se explica lo siguiente: 

  • El impacto del uso compartido de datos de privacidad avanzada en los partners
  • Los requisitos de la URL de clic para poder optar a la atribución
  • La configuración de tus postbacks de privacidad avanzada en el panel de control de AppsFlyer
  • La diferencia entre privacidad avanzada y SKAdNetwork

Principios del uso compartido de datos de privacidad avanzada en redes de publicidad

A partir de iOS 14.5+, el Marco de privacidad avanzada agregada (AAP) de AppsFlyer brinda a los anunciantes la capacidad de controlar la disponibilidad de los datos de atribución a nivel de usuario proporcionados a través de la plataforma de AppsFlyer. 

En el contexto de las redes de publicidad, el marco de AAP se implementa con privacidad avanzada (AP). Para facilitar la comprensión, los términos privacidad avanzada y AP se utilizan indistintamente en este artículo. 

La privacidad avanzada (AP) no afecta la disponibilidad de datos agregados para partners o redes de publicidad.  

Qué datos se ven afectados por la AP

Cuando la AP se encuentra activa, los datos a nivel de usuario para usuarios sin consentimiento que ejecutan iOS 14.5+ no están disponibles a través de postbacks u otros métodos de reporte, incluidos los que están relacionados con el fraude de Protect360.

En el contexto de postbacks, significa que se utilizan diferentes tipos de postbacks según el estado de consentimiento de ATT de un usuario y otros factores. 

Puedes ver la configuración de AP actual, por aplicación, en el panel de control de AppsFlyer. Ve a Configuración > Integraciones activas > selecciona tu red de publicidad > pestaña Integración. La configuración predeterminada está activada. 

APforPartners2.png

Tipos de plantillas para enviar postbacks

  • Plantilla normal: tu plantilla de integración existente con AppsFlyer. Contiene macros de identificación de usuario y de datos de atribución. Esta plantilla se utiliza para enviar postbacks que contienen datos de atribución a nivel de usuario. 
  • Plantilla de Privacidad Avanzada: una plantilla sin macros de identificador de usuario. Esta plantilla se utiliza para enviar postbacks que contienen datos de atribución agregados. 
    Nota: Si se requiere un postback AP y no has completado la integración de AP, no se envía ningún postback. Puedes configurar la integración de AP utilizando nuestra herramienta de administración de postbacks.

 Nota

  • Si un usuario otorga el consentimiento de ATT en las aplicaciones tanto del anunciante como del publisher ("doble consentimiento"), se envían postbacks periódicos a las redes de publicidad atribuidas y no atribuidas.
  • Excepción: Para las instalaciones atribuidas a Apple Search Ads (ASA), ASA envía postbacks de instalación a la red de publicidad incluso cuando la privacidad avanzada está activada para el anunciante en las siguientes condiciones:
    • el usuario no dio su consentimiento
    • el postback de instalación de la red de publicidad está configurado en Todas las fuentes de medios, incluyendo las orgánicas 
    • la red de publicidad no es compatible con la privacidad avanzada

Tipo de postback utilizado 

La siguiente tabla se aplica a los datos de los usuarios que ejecutan iOS 14.5+.

Nota: Si la versión de iOS es 14.4 o anterior, la siguiente tabla no se aplica. Significa que los postbacks que utilizan la plantilla regular se envían tanto a la red de publicidad atribuida como a la no atribuida. 

Tipo de postback para iOS 14.5+

Estado de AP

Estado de ATT Tipo de plantilla de postback al partner atribuido* que admite AP  Tipo de plantilla de postback al partner atribuido* que no admite AP  Partner de postback no atribuido*

Aplicación de publisher

Aplicación de anunciante

en

Autorizado

No autorizado

Plantilla AP (datos agregados)

Sin postback

Ninguna

en

No autorizado

Autorizado

Plantilla AP (datos agregados)

Sin postback

Plantilla normal

Los campos de atribución no están disponibles.*

en

Autorizado

Autorizado

Plantilla normal. Esto incluye ID disponibles como: IDFA, IDFV, CUID, ID de clic y campos de atribución. 

Plantilla normal. Esto incluye ID disponibles como: IDFA, IDFV, CUID, ID de clic y campos de atribución.  Plantilla normal que incluye los ID disponibles. Los campos de atribución no están disponibles.*

en

No autorizado

No autorizado

Plantilla AP (datos agregados)

Sin postback

Ninguna

Desactivado

No considerado

No considerado

Plantilla normal

Plantilla normal

Plantilla normal.

Los campos de atribución no están disponibles.*

(*) Principios para el intercambio de datos con partners

Para cualquier evento dado, varios partners de la red de publicidad pueden tener derecho a un postback. Los postbacks enviados son los siguientes:

  • Partner atribuido: red de publicidad acreditada con el evento
  • Partner no atribuido: partner integrado no acreditado con el evento, cuando Postback de eventos in-app > Opción de envío está establecido en todas las fuentes de medios, incluidas las orgánicas. Si la aplicación del anunciante tiene el consentimiento de ATT, el postback contiene los ID de usuario sin datos atribuidos. (Esta opción no es compatible con todas las redes de publicidad).

    InAppEventAll.png

Campañas web

La AP se comporta de manera diferente cuando la red de publicidad sirve un anuncio en la web.

Para indicar si un clic proviene de la web o de una aplicación, debes enviar el parámetro af_media_type=web o af_media_type=app en la URL del clic.

Si no envías af_media_type, el valor predeterminado es app.

Tipo de postback utilizado para iOS 14.5+ cuando la AP está activada

Estado de ATT Tipo de postback para un partner atribuido* Tipo de postback para un partner no atribuido*

Aplicación de publisher

Aplicación de anunciante

N/A

No autorizado

Privacidad avanzada

Ninguna

N/A

Autorizado

Normal. Nivel de usuario con los siguientes ID: IDFA, IDFV, CUID, ID de clic.

Normal. Solo ID de nivel de usuario.

Integración

Actualiza las URL de tus clics y completa la integración de privacidad avanzada.

Requisitos de la URL de clic

En muchos casos, según el consentimiento de ATT de usuario, el identificador de anunciante (IDFA) no estará disponible en la aplicación del publisher, la aplicación del anunciante o en ambas. En estos casos, AppsFlyer permite la atribución utilizando la privacidad avanzada agregada y el modelado probabilístico.

[Práctica recomendada] Para maximizar tus atribuciones, envía todos los parámetros enumerados.

  1. Agrega los siguientes parámetros las URL de clic:
    Identificador Parámetro de clic

    Ejemplo

    Campaña

    c

    US_20_30

    ID de campaña

    af_c_id

    12345

    Conjunto de anuncios

    af_adset

    ADSET_1

    ID de conjunto de anuncios

    af_adset_id

    56789

    Anuncio 

    af_ad

    creative_name

    ID de anuncio

    af_ad_id

    34567

    ID de sitio

    af_siteid

    abcdefgh12345678

    ID de sub sitio

    af_sub_siteid

    abcdefgh12345678

    Canal

    af_channel

    channel_name

    Tipo de anuncio

    af_ad_type

    Video

    Modelo de dispositivo iOS*

    af_model

    El modelo del dispositivo. Valores permitidos:

    • iphone (todo en minúsculas)
    • ipad (todo en minúsculas)

    Sistema operativo*

    af_os

    Versión del sistema operativo

    * Es posible que también se proporcione información a través del agente de usuario. En este caso, el valor enviado con el identificador específico tiene prioridad.


    Incorporar detalles de la campaña a la URL de clic

    El ejemplo siguiente muestra cómo agregar los detalles de tu campaña a la URL de clic:

    https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId}
  2. Agrega los siguientes parámetros obligatorios a las URL de clic*:

     Precaución

    Si tu URL de clic no pasa los parámetros obligatorios, no se te acreditará la mayoría de las instalaciones que manejes.

    • IP 
    • Agente de usuario 

    * No se requiere ninguna acción al enviar un clic usando un referente de HTTP simple que redirige a AppsFlyer. 

    Utiliza el método de extracción descrito para incorporar los parámetros a la URL de clic cuando se utilice cualquiera de los siguientes métodos: 

    • Redirigir a través de la aplicación 
    • Clics de servidor a servidor (también conocido como S2S) 

    Parámetros para la atribución de privacidad avanzada

    Parámetro

    Obligatorio

    Método de extracción

    Idioma y configuración regional del dispositivo

    af_lang

    No

    NSString *language = [[NSLocale preferredLanguages] objectAtIndex:0];

    [Recomendado] Proporciona el idioma y la configuración regional; por ejemplo, en-US.

    Agente de usuario

    af_ua

    Extrae el agente de usuario con el formato:

    Mozilla%2F5.0+%28iPhone%3B+CPU+iPhone+OS+13_3_1
    +like+Mac+OS+X%29 AppleWebKit%2F605.1.15+%28KHTML%2C
    +like+Gecko%29+Mobile%2F15E148
    • No extraigas el agente de usuario de CFNetwork, extrae el otro. 
    • El agente de usuario debe estar codificado en URL.

    Dirección IP del dispositivo

    af_ip

    La mejor opción: si está disponible, proporciona la IP del dispositivo en el parámetro af_ip.

    Siguiente opción: si está disponible, AppsFlyer usará la IP en X-Fordered-For.


    Incorporar parámetros a la URL de clic

    Para pasar estos parámetros obligatorios en el enlace de atribución de clics, usa esta referencia: 

    https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad-type}&af_siteid={PublisherId}&af_ua={USER-AGENT}&af_lang={LANGUAGE}&af_ip={IP}

    Ejemplo

    GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}
    &af_ad_type={Ad type}&af_siteid={PublisherId}

    &af_ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_1_4%20
    like%20Mac%20OS%20X%29%20AppleWebKit%

    2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F16D57&af_lang=en-US&af_ip=11.11.1.11

    * Los parámetros de consulta deben estar codificados por URL.

    Pasar datos en encabezados de URL de clics

    Para pasar los campos en el encabezado de la URL de clic, usa la siguiente referencia:

    GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId}

    accept-language: en-US,en;q=0.

    User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 like Mac OS X)

    AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148

    X-Forwarded-For: 11.11.1.11, 222.222.2.222

Especificación de postbacks de privacidad avanzada

Para recibir los postbacks de privacidad avanzada, debes configurar una integración de privacidad avanzada además de la integración de postbacks regular. Puedes configurar el postback de privacidad avanzada tú mismo en el panel de control de AppsFlyer.

Diferencias entre la plantilla normal y la plantilla de privacidad avanzada

  • Los postbacks se envían en lotes por hora.
    • Los lotes incluyen todos los tipos de eventos.
    • Los lotes incluyen postbacks tanto de atribución como de rechazo.
    • El 0,001 % de los postbacks pueden enviarse en lotes posteriores, con posibles retrasos de hasta 24 horas.
  • La hora del postback no se correlaciona con las horas reales de los eventos.
  • Macros de marca de tiempo:
    • Para las instalaciones y los eventos in-app, las marcas de tiempo se redondean a la hora en que ocurrieron. Por ejemplo, 22:55:30 se reporta como 22:00:00.
    • Se reportan usando la zona horaria UTC. Ejemplo de marca de tiempo: (2020-07-20 20:00:00)
  • Los siguientes parámetros no están disponibles en los postbacks de privacidad avanzada: ID de clic, ID de usuario de cliente, ID de AppsFlyer, identificador de anunciante (IDFA), identificador de proveedor (IDFV), modelo del dispositivo, versión de sistema operativo, operador.

Acción requerida por la red de publicidad para integrar:

  1. Configura tu postback de privacidad avanzada en el panel de control de AppsFlyer. 
  2. Prueba la integración de privacidad avanzada.

 ¡Importante!

  • Para poder distinguir entre postbacks para eventos legítimos y postbacks rechazados, debes configurar las macros de postbacks rechazados.

  • Para habilitar el postback de instalaciones/eventos rechazados, ponte en contacto con nosotros utilizando el widget del asistente para partners.

Punto de conexión de postback de privacidad avanzada [completar según sea necesario]

Tipo de postback
Instalación
In-app

Macros de atribución de privacidad avanzada disponibles

Macro de postback (nombre)

Observaciones Parámetros base para todas los postbacks Parámetros opcionales para eventos in-app  Parámetros opcionales para atribución rechazada
af_ad Nombre de la creatividad    
af_ad_id 34567    
af_ad_type Como: banner, pie de página, video    
af_adset ADSET_1    
af_adset_id 56789    
app_id -    
app_name -    
attributed_touch_hour

Redondeado hacia abajo hasta la hora más cercana. 

Formato: ver nota (1)

   
attributed_touch_type Como: clic, impresión    
blocked_reason Se relaciona con las reglas de validación/Protect360    
blocked_reason_value Se relaciona con las reglas de validación/Protect360    
blocked_sub_reason Se relaciona con las reglas de validación/Protect360    
bundle_id Según lo establecido por el anunciante    
c Nombre de campaña, como US_20_30    
af_c_id ID de campaña, como 12345    
af_channel Nombre del canal    
country_code Código de país ISO registrado en la conversión    
event_hour

Redondeado hacia abajo hasta la hora más cercana. 

Formato: ver nota (1)

   
event_name Según lo reportado por la aplicación    
event_revenue Importe de ingresos en la divisa del evento    
event_revenue_
currency
Código de divisa de los ingresos    
event_revenue_usd Ingresos convertidos a USD    
install_hour

Redondeado hacia abajo hasta la hora más cercana. 

Formato: ver nota (1)

   
is_first Verdadero si esta es la primera vez que un usuario final específico activó este evento in-app    
is_primary

Usar para eliminar datos duplicados

Booleano: 0, 1

   
is_retargeting

Usar para eliminar datos duplicados 

Formato: ver nota (2)

   
is_reengagement

Formato: ver nota (2)

   
is_reattribution

Usar para eliminar datos duplicados 

Formato: ver nota (2)

   
match_type Como: id_matching, probabilistic    
event_id Nombre/ID del evento correspondiente en la plataforma de la red de publicidad    
platform Como: ios, Android    
postback_id ID de postback único    
retargeting_
conversion_type
Como: re-engagement, reatribución    
af_siteid abcdefgh12345678    
af_sub_siteid abcdefgh12345678    

Notas:

(1) Formatos de marca de tiempo disponibles:

  • [Predeterminado] Cadena: AAAA-MM-DD HH:MM:SS
  • Tiempo Epoch: marca de tiempo Unix de 10 dígitos 

(2) Formato booleano disponible

  • [Predeterminado] Numérico: 0, 1 
  • Cadena: false, true

Configuración de tu postback de privacidad avanzada

Configura tu postback de AP con la opción de administración de postbacks en el panel de control de AppsFlyer.

Requisitos previos:

  • Debes tener una integración activa con AppsFlyer para administrar tu postback de privacidad avanzada. Ponte en contacto con nosotros usando el widget del asistente para partners para crear una integración.
  • AppsFlyerAdmin_us-en.png La administración de postbacks la realiza el administrador de la cuenta; los miembros del equipo no tienen acceso.

Para configurar el postback:

  1. Haz clic en el menú desplegable de la parte superior derecha> Administración de postbacks.
  2. Selecciona el tipo de postback: Privacidad avanzada. 
  3. Activa el creador.

    postback-management-enter-endpoint_en-us.png

  4. Introduce la dirección de punto de conexión: la URL del punto de conexión a la que AppsFlyer envía los postbacks. Introduce las URL relevantes para instalaciones y/o eventos in-app.
  5. Introduce los parámetros que se incluirán en los postbacks:
    • Nombre del parámetro: nombre de la pantalla del parámetro de AppsFlyer
    • Tu parámetro de recepción: el parámetro de recepción respectivo de tu lado
    • Valor de parámetro (disponible para algunos parámetros): elige el formato del valor. Por ejemplo, para los valores booleanos, elige si deseas recibirlos como "true"/"false" o 1/0.
    • Instalación: marca la casilla para incluir el parámetro en el postback de instalación.
    • Evento in-app: marca la casilla para incluir el parámetro en el postback de evento in-app.

    postback-management-parameters_en-us.png

    Lista completa de macros de postback de privacidad avanzada.

  6. [Opcional] Agrega parámetros personalizados que no proporcione AppsFlyer:

    postback-management-custom-parameters_en-us.png

  7. Revisa la vista previa final de la plantilla de postback para asegurarte de que todo está correcto.

    postback-management-template_en-us.png

  8. Haz clic en Guardar. Ten en cuenta que cuando guardas el postback, los cambios entran en vigor inmediatamente.

Si tienes algún problema, ponte en contacto con nosotros a través del widget del asistente para partners.

Información adicional

AP para partners de analíticas

Los postbacks se envían a los partners de analíticas de la siguiente manera:

  • AP desactivada: postback a nivel de usuario sin restricciones.
  • AP activada: según la fuente del usuario y el estado de ATT como se detalla en esta tabla; 

Tipo de postback de partner de Analytics según el estado de ATT y la fuente de usuario

Fuente de usuario

Estado de ATT Tipo de postback al partner de analíticas

Aplicación de publisher

 Aplicación de anunciante

No orgánicas 


 


 

Autorizado

Autorizado

Regular

No autorizado

Autorizado

Ninguna

Cualquier valor

No autorizado

Ninguna

Orgánico o web

N/A

Autorizado

Regular

Orgánico o web

N/A

No autorizado

Ninguna

AP frente a SKAdNetwork

SKAdNetwork es una tecnología de atribución proporcionada por Apple para dispositivos iOS. La privacidad avanzada es parte del marco de Privacidad avanzada agregada de AppsFlyer (AAP) y se relaciona con la atribución realizada por AppsFlyer. La AAP ofrece a los anunciantes la capacidad de controlar la disponibilidad de los datos de atribución a nivel de usuario a través de la plataforma de AppsFlyer. Por lo general, las redes de publicidad admiten la integración de AP y SKAdNewtork.