Guía de integración de SKAN para redes de publicidad

Mediante este método, las redes de publicidad reenvían cada postback recibido del dispositivo a AppsFlyer.

La red de publicidad:

• Recibe el postback desde el dispositivo iOS.
• [Opcional] Enriquece el postback con:
  • Nombre e ID de la campaña de la red de publicidad.
  • Dirección IP recibida del dispositivo, requerida principalmente para fines de resolución de la geolocalización. 
  • Marca de tiempo del postback, enviada desde el dispositivo iOS.
• [Opcional] Enriquece el postback con:
  • ID y nombre del conjunto de anuncios
  • ID y nombre del anuncio
  • Nombre de la red de publicidad
  • Código de país
  • ID de aplicación fuente
  • Creatividad
  • Canal
• Envía el postback a AppsFlyer
• Nota: Antes de enviar el postback a AppsFlyer, valida la firma de atribución de Apple usando el contenido del postback saliente, para asegurarte de que no corrompiste involuntariamente los datos.

Protocolo de postback enriquecido de SKAN

Parámetros JSON de postbacks enriquecidos de SKAN

Ejemplo de curl: postback de SKAN 3 enriquecido

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version":"3.0",
      "app-id": 888707086,
      "ip": "192.0.2.0",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "source-app-id": 888707074,
      "ad-network-id": "abcabcabc.skadnetwork",
      "transaction-id": "68eb3d91-15f5-44ee-9267-25c7655c20b6",
      "redownload": false,
      "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
      "timestamp": "1596525944",
      "ad-network-campaign-id": "222222",
      "conversion-value": 63,
      "campaign-id": 99
  }'

Ejemplo de curl: postback de SKAN 4 enriquecido con valores de conversión precisos

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version": "4.0"
      "ad-network-id": "example123.skadnetwork",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "ad-network-campaign-id": "222222",
      "source-identifer": "5239",
      "app-id": 525463029,
      "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e30",
      "redownload": false,
      "source-app-id": 1234567891,
      "fidelity-type": 1, 
      "did-win": true,
      "conversion-value": 63
      "postback-sequence-index": 0
      "attribution-signature": "MEUCIGRmSMrqedNu6uaHyhVcifs118R5z/AB6cvRaKrRRHWRAiEAv96ne3dKQ5kJpbsfk4eYiePmrZUU6sQmo+7zfP/1Bxo="
  }'

Ejemplo de curl: postback de SKAN 4 enriquecido con valores de conversión aproximados

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version": "4.0"
      "ad-network-id": "example123.skadnetwork",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "ad-network-campaign-id": "222222",
      "source-identifer": "39",
      "app-id": 525463029,
      "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e31",
      "redownload": false,
      "source-app-id": 1234567891,
      "fidelity-type": 1, 
      "did-win": true,
      "coarse-conversion-value": "high"
      "postback-sequence-index": 0
      "attribution-signature": "MEUCIQD4rX6eh38qEhuUKHdap345UbmlzA7KEZ1bhWZuYM8MJwIgMnyiiZe6heabDkGwOaKBYrUXQhKtF3P/ERHqkR/XpuA="
  }'

Mediante este método, la red de publicidad responde al dispositivo con un comando de redireccionamiento HTTP (307), solicitando al dispositivo que envíe el postback directamente a AppsFlyer. 

El método de redireccionamiento tiene las siguientes ventajas:

• Mayor confianza del anunciante: el MMP actúa en nombre de un anunciante. Al proporcionar acceso a AppsFlyer al postback de primera mano, los anunciantes confían en que los postbacks no se manipulan en tránsito.
  
• No requiere procesamiento por parte de la red de publicidad: las redes de publicidad responden con el comando de redireccionamiento (al dispositivo), eliminando así la necesidad de procesar postbacks. En comparación, el método de enriquecer y reenviar requiere que las redes de publicidad consuman el postback, lo enriquezcan con parámetros adicionales y finalmente lo reenvíen a AppsFlyer.

Implementación

1. Configura tu servidor para que responda con una respuesta HTTP 307 que redirija el postback a https://skadredirect.appsflyer.com/api/redirects
2. Anexa los parámetros de consulta que contengan los detalles de la campaña, utilizando los parámetros de consulta enumerados en la tabla que sigue. Considera como obligatorio el envío de los datos de tu campaña. Los detalles de la campaña nos permiten enriquecer los datos de SKAN con datos de costos y otros datos de campaña y permiten que los anunciantes optimicen las campañas de manera efectiva.

Ejemplo de URL de redireccionamiento

https://skadredirect.appsflyer.com/api/redirects?
  &ad-network-campaign-id=243232&ad-network-campaign-name=yarg_campaign_name
  &ad-network-adset-name=dsdsa&creative=examplecreative&channel=channelexample

Parámetros de consulta para los detalles de la campaña (no obligatorio)

• Por cada postback enviado desde la red de publicidad a AppsFlyer, AppsFlyer envía:
  • Un postback de instalación. Las redescargas se señalan mediante el parámetro redownload. 
  • De cero a varios postbacks de eventos in-app. El número exacto depende de la traducción del valor de conversión. Ver postbacks simulados.
• Cuando consumes postbacks, la misma instalación o evento puede atribuirse mediante más de una solución de atribución de AppsFlyer. Utiliza el parámetro atribution_source para diferenciar entre los tipos de postback. 

Ejemplo de postback de instalación de SKAN enviado por AppsFlyer

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
  &skan_ad_network_time=(timestamp)
  &skan_af_received_time=(timestamp)
  &attribution_source=skadnetwork
  &app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
  &campaign_id=(campaign-id)&SKAN_ambiguous_event=(boolean)
&redownload=(boolean)
&af_SKAN_nonce=(uuid)

Ejemplo de postback de in-app de SKAN enviado por AppsFlyer

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
  &skan_ad_network_time=(timestamp)
  &skan_af_received_time=(timestamp)&revenue=(value)
  &currency=(code)&event_name=(event-name)&attribution_source=skadnetwork
  &app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
  &campaign_id=(campaign-id)&SKAN_ambiguous_event=(boolean)
&redownload=(boolean)
&af_SKAN_nonce=(uuid)

Mediante este método, la red de publicidad envía a AppsFlyer los postbacks reales de SKAN desde aplicaciones activas. 

Probar la integración

Criterios de prueba

• Mediante este método, la red de publicidad envía postbacks preparados previamente de AppsFlyer a las aplicaciones de prueba de AppsFlyer, como se detalla en la siguiente tabla. AppsFlyer responde con postbacks decodificados a la red de publicidad.
• Cada aplicación de prueba tiene una asignación de valores de conversión diferente, como se detalla en la tabla.

Pasos de integración

Criterios de prueba