Usando esse método, as ad networks encaminham à AppsFlyer cada postback recebido do dispositivo.

A ad network:

• Recebe o postback do dispositivo iOS.
• [Obrigatório] Enriquece o postback com:
  • ID da campanha e nome da campanha da ad network.
  • O carimbo de data/hora do postback enviado pelo dispositivo iOS. 
• [Opcional] Enriquece o postback com:
  • Endereço IP recebido do dispositivo, exigido principalmente para fins de resolução de geolocalização.
  • ID e nome do conjunto de anúncios
  • ID e nome do anúncio
  • Ad network name
  • Código do país
  • ID do aplicativo de origem
  • de criativos
  • Canal
• Envia o postback para a AppsFlyer
• Nota! Before sending the postback to AppsFlyer, validate the Apple attribution signature using the content of the outgoing postback to ensure that you didn't inadvertently corrupt the data.

Protocolo de postback enriquecido da SKAN

Parâmetros JSON do postback enriquecido do SKAN

Exemplo de Curl — postback avançado da SKAN 3

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
  }'

Exemplo de Curl — postback avançado da SKAN 4 com valores de conversão refinados

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="
  }'

Curl example—enriched SKAN 4 postback with coarse conversion values

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="
  }'

Com esse método, a ad network responde ao dispositivo com um comando de redirecionamento HTTP (307), solicitando que o dispositivo envie o postback diretamente para a AppsFlyer. 

O método de redirecionamento tem as seguintes vantagens:

• Increased advertiser trust: The MMP acts on behalf of an advertiser. By providing AppsFlyer access to the postback firsthand, advertisers are confident that postbacks are not manipulated in transit.
   
• No processing required by the ad network: Ad networks respond with the redirect command (to the device), thus eliminating the need to process postbacks. In comparison, the enrich and forward method requires that ad networks consume the postback, enrich it with additional parameters, and finally forward it to AppsFlyer.

Implementação

1. Configure your server to respond with an HTTP 307 response redirecting the postback to https://skadnetworkredirect.appsflyer.com/api/redirects
2. Anexe parâmetros de consulta que contenham detalhes da campanha usando os parâmetros de consulta listados na tabela a seguir. Considere o envio dos detalhes da sua campanha obrigatório. Os detalhes da campanha nos permitem enriquecer os dados do SKAN com custo e outros dados da campanha, além de permitir que os anunciantes otimizem campanhas com eficiência.

Exemplo de URL de redirecionamento

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 detalhes da campanha (não obrigatórios)

• Para cada postback enviado da ad network para a AppsFlyer, a AppsFlyer envia:
  • Um postback de instalação. Os redownloads são sinalizados pelo parâmetro redownload. 
  • De zero a vários postbacks de eventos in-app. O número exato depende da tradução do valor de conversão. See simulated postbacks.
• When you consume postbacks, the same install or event can be attributed by more than one AppsFlyer attribution solution. Use the attribution_source parameter to differentiate between postback types. 

Exemplo de um postback de instalação da SKAN enviado pela 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)

Exemplo de um postback in-app da SKAN enviado pela 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)

Usando este método, a ad network envia à AppsFlyer postbacks reais do SKAN de aplicativos ao vivo. 

Integração de testes

Critérios de teste

• Usando este método, a ad network envia à AppsFlyer postbacks pré-preparados para aplicativos de teste da AppsFlyer, conforme detalhado na tabela abaixo. A AppsFlyer responde à ad network com postbacks decodificados.
• Cada aplicativo de teste tem um mapeamento de valor de conversão diferente, conforme detalhado na tabela.

Etapas de integração

Critérios de teste