Macros de postback para ad networks

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.
  • Se a ad network não ganhou a atribuição, mas está entre os 3 principais contribuintes, is_contrib=1.
  • Se a ad network ganhou a atribuição, is_contrib=0.
  • Se a ad network não está entre os 3 principais contribuintes, is_contrib=0.
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:
  • 1: o status da ATT é autorizado ou af_authorized.
  • 0: qualquer outro status da ATT.  
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
  • Fornecido pelo anunciante/publisher.
  • Adset é um nível intermédio entre Campanha e Anúncio. Saiba mais
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
  • ID exclusivo que identifica o publisher que exibe o anúncio. Saiba mais
Sim Sim
af_subsite_id Link Não
  • Ad sub-network/Publisher ID. 
  • Se, além do publisher principal (site ID), houver um sub-publisher, ou você desejar incluir informações adicionais, como tipo de anúncio/posicionamento dentro do aplicativo, como banner, intersticial, vídeo etc, use af_sub_siteid. Exemplo: af_sub_siteid=ABCD_4567
Sim Sim
af_ad_type Link Não Use a seguinte convenção de nomenclatura:
  • text: uma unidade de anúncios contendo apenas texto, por exemplo, um resultado de pesquisa
  • banner: um formato básico que aparece na parte superior ou inferior da tela do dispositivo
  • interstitial: um anúncio de página inteira que aparece durante pausas na experiência vigente
  • video: um vídeo padrão, ou seja, não recompensado
  • rewarded_video: uma unidade de anúncio que oferece recompensas no aplicativo em troca de assistir a um vídeo
  • playable: uma unidade de anúncio que contém uma visualização interativa da experiência do aplicativo
  • sponsored_content: um link incluído em um pedaço de conteúdo patrocinado, como um artigo publicitário
  • audio: um anúncio em áudio
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

Android iOS
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)

Exemplos gerais de postbacks de eventos in-app

Android iOS
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)&currency=(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