How can we help?

Macros de postback para Parceiros de análise

  • Atualizado
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
  • Fornecido pelo anunciante/publisher.
  • Adset é um nível intermédio entre Campanha e Anúncio. Saiba mais
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
  • ID único que identifica o publisher que exibe o anúncio. Saiba mais
Yes Yes
af_subsite_id Link
  • 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
Yes Yes
af_ad_type Link Tipo de anúncio 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
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)

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)&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?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&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

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.


Share article: