Macros de postback para ad networks

Introdução

Quando usuários de dispositivos móveis instalam ou realizam eventos in-app, a AppsFlyer envia postbacks para as redes de origem ou para outros endpoints. Esses postbacks podem incluir macros.

1. Parâmetros do link de atribuição
   Os parâmetros fornecidos pelo parceiro em URLs de clique ou de impressão podem ser retornados nos URLs de postbacks.
   Exemplo: parâmetro da ID de clique no link de atribuição - "&click_id=CLICK_ID"
2. IDs de parceiros na AppsFlyer
   IDs únicas fornecidas ao anunciante por parte do parceiro podem ser devolvidas via postbacks.
   Exemplos: ID do aplicativo, ID da conta, ID do usuário, ID da rede, chave do SDK, etc.
   

   

3. Informações derivadas do SDK
   Informações extraídas do dispositivo pelo SDK da AppsFlyer 
   Exemplo: IDs de dispositivos iOS podem ser extraídas usando "&IDFA=(idfa)" no postback 

Macros de postbacks compatíveis

Confira abaixo uma lista completa de macros suportadas pela AppsFlyer. Ao serem colocadas em um postback, essas macros são automaticamente substituídas com os dados relevantes do usuário. Por exemplo, para obter o endereço IP dos usuários de instalação, inclua "&ip_address=(ip)" na estrutura do postback. 

• Fonte: indica de onde os dados são recebidos (SDK ou link)
• Enviar tudo: indica se você pode receber esses dados sobre instalações e eventos que não são atribuídos à sua rede (incluindo orgânicos)

Macros de instalações e eventos in-app

Macros somente para eventos in-app

As macros abaixo só estão disponíveis para postbacks enviados para parceiros que seguem um evento in-app (ou evento de servidor para servidor):

&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%22
af_content_type%22%3A%22default_type%22%7D%0A

{"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Valores codificados

Pode ser que os postbacks precisem conter caracteres especiais, que não sejam alfanuméricos. Para transferir corretamente esses valores via postbacks, o URL da AppsFlyer codifica valores não alfanuméricos em postbacks. 

Se você deseja decodificar um postback codificado, ou codificar um postback decodificado, você pode usar qualquer serviço web de codificação gratuito, como este.

Postbacks de amostra

Exemplos de postbacks de instalação geral

http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)

http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install-unix-ts)

Exemplos de postbacks de eventos in-app gerais

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

http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&idfa=(idfa)&install_time=(install-unix-ts)
&event_name=(event-name)&currency=(currency)&json=(event-value)

Exemplos de postbacks de eventos in-app avançados

Parâmetros do evento:

Nome do evento: af_revenue
Receita do evento: 120,00
Moeda do evento: USD
Valor do evento: {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Postback:

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&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