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.
-
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" -
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.
-
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
Importante!
Para atualizar a estrutura e as informações nas mensagens de postback, as redes de anúncios devem entrar em contato com a equipe de Desenvolvimento de Parcerias da AppsFlyer correspondente.
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.
Macros de instalações e eventos in-app
Macro | Fonte | Descrição |
---|---|---|
|
SDK |
Identificador único do iOS. |
|
SDK |
Identificador único GAID do Android. |
|
SDK |
Identificador único Android ID. |
|
SDK |
Nome do ID do aplicativo |
|
SDK |
Tipo de conexão de dados usada pelo usuário na conversão ("VERDADEIRO" ou "FALSO") |
|
SDK |
O carimbo de data/hora da instalação (primeira inicialização do aplicativo) no horário UNIX |
|
SDK |
Hora do clique ou da impressão no link de atribuição da AppsFlyer |
|
Link |
Nome da campanha conforme enviado no link de atribuição da AppsFlyer (c=) |
|
Link |
ID do site conforme enviada no link de atribuição da AppsFlyer (af_siteid=) |
|
SDK |
Código do país de dois caracteres registrado na conversão |
|
SDK |
Cidade do dispositivo do usuário registrada na conversão |
|
SDK |
Marca do dispositivo do usuário registrada na conversão |
|
SDK |
Provedor de serviços do dispositivo (por exemplo, "AT&T") |
|
SDK |
IP do dispositivo do usuário registrado na conversão |
|
SDK |
Modelo do dispositivo do usuário registrado na conversão |
|
SDK |
Nome do idioma usado no dispositivo do usuário registrado na conversão |
|
SDK |
Identificador único da AppsFlyer registrado na conversão |
|
SDK |
Versão do SDK da AppsFlyer |
|
SDK |
Configuração de versão do aplicativo pelo desenvolvedor do aplicativo no código do aplicativo |
|
SDK |
O formato usuário-agente (por exemplo, "Mozilla/5.0 (iPad)" |
|
SDK |
ID para fornecedores, como a IDFV para iOS |
|
SDK |
O nome da versão do Sistema Operacional |
|
SDK |
O nome do aplicativo |
|
SDK |
O tipo de correspondência da atribuição (por exemplo, uid (id_matching), ref (gp_referrer) e fp (fingerprint)) |
|
SDK |
A hora em que o Google Play foi aberto |
|
SDK |
A hora que o usuário clica em Instalar no Google Play |
|
SDK |
Um sinalizador que indica se o usuário escolheu habilitar o acompanhamento de anúncios limitado (LAT). Pode ser "VERDADEIRO" ou "FALSO". |
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):
Macro | Descrição |
---|---|
|
Nome do evento ativado a partir do aplicativo |
|
Nome/ID do evento correspondente na plataforma dos parceiros |
|
Valor do evento em USD |
|
Valor do evento na moeda original conforme configurado no aplicativo |
|
Código de moeda do evento |
|
O horário do evento in-app |
|
O evento in-app avançado e aprimorado inclui atributos com valores, que podem ser enviados completamente no postback no formato JSON, com codificação de URL usando a macro (encode). |
Exemplo
O modelo de postback de evento "&event=(event)&json=(encode)" foi convertido para o seguinte postback para um evento específico af_purchase:
&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
O valor decodificado de JSON deste postback é
{"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)¤cy=(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)¤cy=(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