Em resumo: use macros como parte dos postbacks enviados aos Parceiros de análise para obter dados de atribuição relevantes.
Postbacks para Parceiros de análise
Os Parceiros de análise podem definir o conteúdo e os endpoints dos postbacks enviados a eles como parte da integração com a AppsFlyer. Postbacks dizem respeito ao engajamento do usuário do aplicativo, como instalações, eventos in-app, reengajamentos e assim por diante.
- Configuração do postback: Para solicitar alterações nas suas configurações de postback, use o widget de assistente de parceiro para abrir um ticket ou entre em contato com seu gerente de desenvolvimento de parceiros da AppsFlyer.
- Tipos de postback: há postbacks disponíveis para instalação e eventos in-app.
Macros de postback
Quando incluídas em um postback, as macros são substituídas por dados relevantes ao usuário. Por exemplo, para obter o endereço de IP do usuário que instala o aplicativo, inclua country_code=(ip) na estrutura de postback. As macros compatíveis estão listadas na tabela a seguir:
- Fonte: de onde os dados vêm:
- SDK: SDK da AppsFlyer incorporado no aplicativo ou na S2S API
- AF: após o processamento pela AppsFlyer.
- [Base] Macros para todos os postbacks: macros relevantes para instalação e eventos in-app.
- [Opcional] para eventos in-app, conforme indicado na coluna.
Macros — instalações e eventos in-app
| Macro do postback (nome) | Fonte: | A descrição | [Base] Macros para todos os postbacks | [Opcional] Eventos in-app |
|---|---|---|---|---|
| advertising_id | SDK | device ID que pode ser resetado pelo usuário, conhecido também como GAID. Também disponível como: (sha1-advertiserId) | Yes | |
| nome_do_evento | SDK | Nome escolhido para um evento | Yes | |
| event_revenue_USD | AF | Valor do evento em USD | Yes | |
| event_revenue | SDK | Valor do evento reportado pelo SDK usando event_revenue_currency ou a moeda selecionada por você. | Yes | |
| event_currency | SDK | O código da moeda da receita do evento reportada no evento, ou a moeda selecionada por você. | Yes | |
| event_time | SDK | Data/hora do evento | Yes | |
| event_value | SDK | Eventos in-app incluem atributos com valores, que podem ser enviados inteiramente no postback em formato JSON. URL codificada usando a macro (codificada). | Yes | |
| partner_event_id | AF | Nome/ID do evento correspondente na plataforma do parceiro | Yes | |
| ativado | SDK | Nome do aplicativo definido pelo anunciante | Yes | |
| appsflyer_id | SDK | Identificador único da AppsFlyer registrado na conversão | Yes | |
| tipo_de_toque_atribuído | AF | Um sinalizador que indica se a atribuição ocorreu devido a uma exibição (1 = impressão, 0 = clique) | Yes | |
| código_país | AF | Código do país usando ISO 3166 (alfa-2) Exemplo: EUA, CN. | Yes | |
| idfa | SDK | User advertising ID reconfigurável encontrado em dispositivos iOS. Também disponível como: (sha1-idfa) | Yes | |
| idfv | SDK | Identificador exclusivo para cada usuário e fornecedor em dispositivos iOS | Yes | |
| install_time | SDK | Carimbo de data/hora da instalação | Yes | |
| install_unix_ts | SDK | Timestamp de data/hora de instalação no formato unix | Yes | |
| is_lat | SDK | Limit ad tracking (LAT): iOS: A partir do iOS 14, o LAT foi descontinuado pela Apple. Determina o status de privacidade do usuário usando a ATT. Nesse caso, ignore o is_lat. Antes do iOS 14, se true, o IDFA não estava disponível e era definido como 0. Android: Quando true, o usuário optou por não receber anúncios baseados em interesses. Isso não impede a coleta de GAID. | Yes | |
| language | SDK | Idioma relatado pelo dispositivo e definido pelo sistema operacional do dispositivo. | Yes | |
| ativado | SDK | Identificador de aplicativo único na Appsflyer. | Yes | |
| app-version-name | SDK | Versão do aplicativo definido pelo desenvolvedor do aplicativo no código do aplicativo | Yes | |
| attributed_touch time | AF | Horário do toque ao qual a AppsFlyer atribuiu | Yes | |
| device_type | SDK | O nome do modelo comercial do dispositivo. Exemplo: SM-GM284 ou iPhone7 | Yes | |
| ip | AF | IP do dispositivo do usuário que reportou o evento | Yes | |
| match_type | AF | Tipo de método de atribuição. Por exemplo, srn, id_matching, probabilístico | Yes | |
| os_version | SDK | Versão do sistema operacional do dispositivo | Yes | |
| user_agent | SDK | O agente do usuário da URL | Yes | |
| wifi | SDK | Se for verdadeiro, a conexão era uma conexão Wi-Fi no momento da conversão | Yes | |
| OAID | SDK | User ID reconfigurável em alguns dispositivos Android, geralmente como alternativa ao GAID | Yes | |
| platforma | SDK | Plataforma do dispositivo: iOS, Android ou Windows Mobile | Yes | |
| retargeting_conversion_type | SDK | Uma flag aparecerá se for uma reatribuição ou reengajamento | Yes | |
| pid | AF | Ad network à qual a instalação ou o evento in-app é atribuído | Yes | |
| af_ad | Link | Nome do anúncio (ver mais) fornecido pelo anunciante/publisher. | Yes | Yes |
| af_ad_id | Link | Fornecido pelo anunciante/editor | Yes | Yes |
| af_adset | Link |
|
Yes | Yes |
| af_adset_id | Link | Fornecido pelo anunciante/editor | Yes | Yes |
| C | Link | Fornecido pelo anunciante/publisher. Os nomes de campanhas que excedem 100 caracteres são exibidos no dashboard como 'c_name_exceeded_max_length' | Yes | Yes |
| af_c_id | Link | Fornecido pelo anunciante/editor | Yes | Yes |
| af_siteid | Link |
|
Yes | Yes |
| af_subsite_id | Link |
|
Yes | Yes |
| af_ad_type | Link | Tipo de anúncio Use a seguinte convenção de nomenclatura:
|
Yes | Yes |
Macros somente para eventos in-app
Os exemplos abaixo dizem respeito dos postbacks de eventos in-app disponíveis para parceiros.
Exemplo
O modelo de postback de evento &event=(event)&json=(encode) foi convertido no seguinte postback para um evento af_purchase específico:
&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%22af_content_type%22%3A%22default_type%22%7D%0A
O valor JSON decodificado desse postback é {"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}
Valores criptografados
Os postbacks podem conter caracteres irregulares, que não são alfanuméricos. Para transferir esses valores corretamente por meio de postbacks, a AppsFlyer codifica em URL valores não alfanuméricos.
Para decodificar ou codificar um postback, use um serviço web de codificação.
Postbacks de amostra
Exemplos gerais de postbacks de instalação
Android iOS
http://YourCompanyDomain.com?pid=(media_source)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)
Exemplo
http://YourCompanyDomain.com?pid=(media source)&device_ip=(ip)&idfa=(idfa)&install_time=(install-unix-ts)
Exemplos gerais de postbacks de eventos in-app
Android / iOS
http://YourCompanyDomain.com?pid=(media_source)&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)&event_name=(event-name)¤cy=(currency)&json=(event-value)
https://support.appsflyer.com/hc/en-us/articles/4404083608849
http://YourCompanyDomain.com?pid=(media_source)&device_ip=(ip)&idfa=(idfa)&install_time=(install-unix-ts)&event_name=(event-name)¤cy=(currency)&json=(event-value)
Exemplo de postback de evento in-app
Parâmetros do evento:
- Nome do evento: af_revenue
- Receita do evento US$ 120,00
- moeda usada nos eventos. 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?pid=(media_source)&device_ip=38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&android_id=9aaeecc4455xxxxx&install_time=1451923560&event_name=af_purchase¤cy=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