Resumo: Como uma ad network, você pode definir o conteúdo e os endpoints dos postbacks enviados a você como parte da sua 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.
Guias relacionados a postbacks para parceiros integrados:
Postbacks para ad networks
- Configuração do postback: para solicitar alterações em suas configurações de postback, use o widget partner assistant ou entre em contato com seu partner development manager da AppsFlyer.
- Tipo de postback: os postbacks estão disponíveis para eventos de instalação e eventos in-app e para instalações e eventos in-app bloqueados por conta de fraudes identificadas pelo Protect360 ou que violam as Regras de Validação de Direcionamento.
Fontes de dados de postback
Fonte | Descrição |
---|---|
Parâmetros do link de atribuição |
Parâmetros oferecidos pelo parceiro em URLs de clique e de impressão Exemplo: parâmetro do click ID no link de atribuição - "&click_id=CLICK_ID" |
IDs de parceiros na AppsFlyer |
IDs exclusivos oferecidos ao anunciante pelo parceiro Exemplos: App ID, Account ID, User ID, Network ID. |
Informações derivadas do SDK |
Informações extraídas do dispositivo pelo SDK da AppsFlyer. Exemplo: device IDs do iOS podem ser extraídas usando "&IDFA=(idfa)" no postback |
Derivada da plataforma AppsFlyer | Informações derivadas da plataforma AppsFlyer. |
Protect360 e regras de validação | Informações sobre instalações identificadas como fraudes e instalações que violam regras de segmentação de campanhas e seus eventos in-app associados. |
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:
As colunas na tabela abaixo têm o seguinte significado:
-
Fonte: de onde os dados vêm.
- Link: links de atribuição
- SDK: SDK da AppsFlyer incorporado no aplicativo ou na S2S API
- AF: após o processamento pela AppsFlyer.
- Enviar tudo: se sim, você pode receber os dados de instalações e eventos atribuídos a outras redes ou orgânicos (ou seja, não atribuídos a você).
- [Base] Macros para todos os postbacks: macros relevantes para postbacks de instalação, eventos no aplicativo e eventos rejeitados
- [Opcional] para eventos in-app e eventos rejeitados conforme indicado na coluna (rejeitado, in-app)
Macros—instalações, eventos in-app e eventos rejeitados
Macro do postback (nome) | Fonte | Enviar tudo | Descrição | [Base] Macros para todos os postbacks | [Opcional] Eventos in-app e rejeitados |
---|---|---|---|---|---|
advertising_id | SDK | Sim | device ID que pode ser resetado pelo usuário, conhecido também como GAID. Também disponível como: (sha1-advertiserId) | Sim | |
app_name | SDK | Sim | Nome do aplicativo definido pelo anunciante | Sim | |
appsflyer_id | SDK | Sim | Identificador exclusivo da AppsFlyer registrado na conversão | Sim | |
attributed_touch_type | SDK | Não | Valores possíveis: clique, impressão, TV, pré-instalação | Sim | |
blocked_reason | AF | Não | Fraude/motivo das regras de validação | Não | Rejeitado |
blocked_reason_value | AF | Não | Valor da fraude ou do motivo das regras de validação (como site ID) | Não | Rejeitado |
blocked_sub_reason | AF | Não | Submotivo das regras de fraude e validação | Não | Rejeitado |
bundle_id | SDK | Sim | iOS: identificação para corresponder a um único aplicativo ou a um grupo de aplicativos no iOS (consulte bundle ID de desenvolvedor da Apple) Android: o nome do aplicativo | Sim | |
country_code | AF | Sim | Código do país usando ISO 3166 (alfa-2) Exemplo: EUA, CN. | Sim | |
event_name | SDK | Sim | Nome escolhido para um evento | Não | No aplicativo |
event_revenue_USD | AF | Sim | Valor do evento em USD | Não | No aplicativo |
event_revenue | SDK | Sim | Valor do evento reportado pelo SDK usando event_revenue_currency ou a moeda selecionada por você. | Não | No aplicativo |
event_revenue _moeda |
SDK | Sim | O código da moeda da receita do evento reportada no evento, ou a moeda selecionada por você | Não | No aplicativo |
event_time | SDK | Sim | Hora do evento | Não | No aplicativo |
event_value | SDK | Sim | Eventos in-app incluem atributos com valores, que podem ser enviados inteiramente no postback em formato JSON. URL codificada usando a macro (codificada). | Não | No aplicativo |
idfa | SDK | Sim | User advertising ID reconfigurável encontrado em dispositivos iOS. Também disponível como: (sha1-idfa) | Sim | |
idfv | SDK | Sim | Identificador exclusivo para cada usuário e fornecedor em dispositivos iOS | Sim | |
install_time | SDK | Sim | Timestamp de data/hora da instalação | Sim | |
install_unix_ts | SDK | Sim | Timestamp de data/hora de instalação no formato unix | Sim | |
is_attributed | AF | Sim | Uma flag que indica se a instalação ou evento foi atribuído a essa fonte de mídia | Sim | |
is_contrib | AF | Sim | Indica se a ad network estava entre os 3 principais contribuintes para uma instalação.
|
Sim | |
is_lat | SDK | Sim | 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. | Sim | |
is_primary_attribution | AF | Sim | Se false, veja is_retargeting. | Não | No aplicativo |
is_retargeting | Link | Não |
Use junto com is_primary_attribution. Saiba mais sobre a atribuição duplicada de eventos de retargeting. Se true (1), o evento é relatado como parte de uma campanha de retargeting e a fonte de mídia é a fonte de mídia de retargeting. Se false (0) e is_primary_attribution for false, o evento fará parte de uma campanha de retargeting, mas a fonte de mídia referenciada é a fonte de mídia de atribuição do usuário
|
Não | |
language | SDK | Sim | Idioma relatado pelo dispositivo e definido pelo sistema operacional do dispositivo. | Sim | |
oaid | SDK | Sim | User ID reconfigurável em alguns dispositivos Android, geralmente como alternativa ao GAID | Sim | |
partner_event_id | AF | Sim | Nome/ID do evento correspondente na plataforma do parceiro | Não | No aplicativo |
platform | SDK | Sim | Plataforma do dispositivo: iOS, Android ou Windows Mobile | Sim | |
retargeting_ conversion_type |
AF | Não | Uma flag aparecerá se for uma reatribuição ou reengajamento | Somente retargeting | |
app_version | SDK | Sim | Nome da versão do aplicativo definido pelo desenvolvedor no código do aplicativo | Sim | |
app_id | SDK | Sim | O ID do aplicativo conforme relatado pelo aplicativo | Sim | |
att-0-1 | SDK | Sim | Valores possíveis:
|
Sim | |
att-status | SDK | Sim |
O status da ATT relatado pelo iOS. Como authorized, not_determined. Em alguns casos, não há valor e "" é retornado. |
Sim | |
af_ad | LINK | Não | Nome do anúncio (ver mais) fornecido pelo anunciante/publisher. | Sim | Sim |
af_ad_id | LINK | Não | Fornecido pelo anunciante/publisher. | Sim | Sim |
af_adset | Link | Não |
|
Sim | Sim |
af_adset_id | Link | Não | Fornecido pelo anunciante/publisher. | Sim | Sim |
c | Link | Não | Fornecido pelo anunciante/publisher. Os nomes de campanhas que excedem 100 caracteres são exibidos no dashboard como 'c_name_exceeded_max_length' | Sim | Sim |
af_c_id | Link | Não | Fornecido pelo anunciante/publisher. | Sim | Sim |
af_siteid | Link | Não |
|
Sim | Sim |
af_subsite_id | Link | Não |
|
Sim | Sim |
af_ad_type | Link | Não | Use a seguinte convenção de nomenclatura:
|
Sim | Sim |
imei | SDK | Sim | Um número exclusivo usado para identificar telefones celulares | Sim | |
is_organic | AF | Sim |
Se um postback de instalação for enviado para todas as fontes de mídia, incluindo orgânicas, a ad network receberá uma indicação se a instalação foi orgânica ou não orgânica.
|
Somente instalações |
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 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 descriptografado de JSON deste 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 URL da AppsFlyer criptografa valores não-alfa-numéricos.
Para descriptografar ou criptografar um postback, use um serviço web de criptografia.
Postbacks de amostra
Exemplos gerais de postbacks de instalação
http://YourCompanyDomain.com?site_id=(publisher_id) &advertising_id=(advertiser_id)&android_id=(android_id) &install_time=(install_unix_ts)
http://YourCompanyDomain.com?&site_id=(publisher_id)& device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)
Exemplos gerais de postbacks de eventos in-app
http://YourCompanyDomain.com?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)
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?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