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
http://YourCompanyDomain.com?pid=(media_source)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)
http://YourCompanyDomain.com?pid=(media source)&device_ip=(ip)&idfa=(idfa)&install_time=(install-unix-ts)
Exemplos gerais de postbacks de eventos in-app
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)
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
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.