Configuração de postback de eventos in-app

Para:

Profissionais de marketing Desenvolvedores

Última atualização: 11 de Abril de 2025 14:36

Resumo: mensure o engajamento no aplicativo, a qualidade dos seus usuários e otimize campanhas usando dados de eventos in-app.

Visão geral

Os eventos in-app permitem que os profissionais de marketing mensurem o engajamento no aplicativo e a qualidade do usuário de diferentes canais, para que eles criem uma estratégia de aquisição de usuários apropriada. As ad networks usam informações de eventos in-app para otimizar campanhas e executar campanhas de custo por ação/evento. As ad networks recebem dados sobre eventos in-app por meio de postbacks. Saiba mais sobre eventos in-app avançados.

Seleção de eventos in-app em postbacks

Os profissionais de marketing podem selecionar para quais eventos in-app desejam enviar postbacks para ad networks, usando as configurações descritas neste artigo.

Atenção

Eventos in-app incluem eventos rejeitados, ou seja, eventos in-app bloqueados pelo Protect360 ou eventos que não estão em conformidade com as regras de validação de destino.
Se postback de eventos in-app não existir na aba integração, significa que o parceiro ainda não configurou o registro de eventos in-app com a AppsFlyer em sua configuração preliminar. O parceiro pode entrar em contato com a AppsFlyer utilizando o widget do assistente de parceiro para concluir a integração.

Janela de postback de eventos in-app

A janela de postbacks de eventos in-app permite que os profissionais de marketing que trabalham com ad networks em CPA (custo por aquisição) configurem janelas de pós-conversão após as quais os postbacks de eventos não são mais enviados.

Por exemplo, se você for cobrado por eventos que ocorram dentro de 15 dias após a instalação de um usuário, defina a janela da seguinte forma:

Postbacks após esse período não são enviados e a rede não é notificada, mas os eventos ainda são registrados na AppsFlyer e atribuídos à ad network.

Os postbacks são sempre enviados com base na configuração da janela atual. Veja o exemplo a seguir:

1 de janeiro	A janela é de 15 dias. Um usuário instala um aplicativo.
2 de janeiro	A janela é alterada para 10 dias.
14 de janeiro	O usuário faz uma compra. O postback não é enviado para a ad network porque o evento não se enquadra na janela atual (10 dias).
15 de janeiro	A janela é alterada para 20 dias.
18 de janeiro	O usuário faz outra compra. Dessa vez, o postback é enviado, pois o evento está dentro da janela atual (20 dias).

Janela de postback padrão

Quando se começa a configurar os postbacks de eventos in-app, a janela padrão é automaticamente definida para seis meses.

Atenção

Se você começou a usar os postbacks em eventos in-app com um parceiro específico antes de 30 de julho de 2019, a configuração padrão para a janela será Lifetime. Isso significa que postbacks de eventos in-app sempre são enviados.

Quem pode configurar janelas de postback

Profissionais de marketing
Agências que possuem a permissão de configuração de postbacks de eventos in-app.
Atenção: um profissional de marketing e uma agência que trabalham com a mesma ad network podem configurar janelas de postback separadamente uma da outra, com base em seu contrato com a rede.
Os parceiros que possuem a permissão de configuração de postbacks de eventos in-app.

Mapeamento de eventos

Cada profissional de marketing pode dar um nome diferente a um evento do mesmo tipo. Esses nomes de eventos também podem diferir dos nomes dos parceiros.

Por exemplo, quando um usuário compra algo através de um aplicativo, um profissional de marketing pode chamá-lo de purchase, ou uma identificação menos informativa, como event5, enquanto um parceiro pode chamá-lo de purchase_event

Para garantir que os eventos do profissional de marketing correspondam aos mesmos eventos que os parceiros, as nomenclaturas dos eventos devem ser mapeadas.

Atenção

Os eventos mapeados na aba Integração para um parceiro específico são aplicáveis para postbacks padrão e SKAN.

Métodos de mapeamento

Cada parceiro decide qual dos métodos a seguir deve ser usado para mapear seus eventos in-app:

Atenção

Nem todos os métodos de mapeamento aparecem para todos os parceiros
Você pode dar permissão ao parceiro para fazer o mapeamento propriamente dito.

ptInserir o ID do evento do parceiro

Evento da AppsFlyer: a partir da lista de eventos do seu aplicativo, selecione um evento.
Mapeado para o evento do parceiro: no campo de texto, digite o ID do evento conforme recebido do parceiro, que corresponde ao seu evento do aplicativo (evento da AppsFlyer)

Atenção

Os nomes dos eventos são sensíveis a maiúsculas e minúsculas. Para evitar discrepâncias, certifique-se de usar o nome de evento correto para todas as fontes de mídia e versões do aplicativo.
Ao digitar um nome de evento, você pode usar espaços sublinhados (underline, ou traços baixos) antes ou depois do nome do evento. Utilize os espaços sublinhados somente se o nome do evento enviado pela AppsFlyer tiver os mesmos espaços sublinhados.

altenter_event_name.pngalt

Selecione um ID de evento a partir da lista

Evento da AppsFlyer: a partir da lista de eventos do seu aplicativo, selecione um evento.
Mapeado para o evento do parceiro: Selecione da lista de eventos de parceiros predefinidos o evento que corresponde ao evento da sua aplicação (o evento AppsFlyer).

altIn-app_event_postbacks_en-us.pngalt

Envie eventos como eles estão (não mapeados)

Alguns parceiros preferem receber postbacks de eventos in-app não mapeados, o que significa que os nomes dos eventos são enviados com o mesmo nome que têm no seu aplicativo. Não importa se o evento é chamado purchase, acquisition ou event5.

Você pode escolher quais eventos não mapeados você quer enviar para o parceiro:

Adicionar manualmente: Selecione eventos específicos.
Enviar todos os eventos (exceto desinstalações e sessões): Envie todos os seus eventos. Isso não inclui desinstalações, sessões (inicializações do aplicativo), e o evento af_app_open.

Atenção

Para evitar que os anunciantes compartilhem muitas informações com plataformas de análises de terceiros sem querer, removemos a opção Enviar todos os eventos (exclui desinstalações e sessões) para as plataformas de análises desde de março de 2019. As plataformas analíticas configuradas antes desta data ainda mantêm essa opção de configuração.

Para adicionar eventos manualmente:

Clique em Adicionar evento.
Selecione as opções de postback:
- Evento da AppsFlyer: a partir da lista de eventos do seu aplicativo, selecione um evento.
- Para usuários de: Selecione a opção de envio para o evento.
- Incluindo: Selecione quais dados incluir no postback.
Repita esse procedimento para mais eventos.

Para enviar todos os eventos:

Selecione Enviar todos os eventos (exceto desinstalações e sessões).
Selecione as opções de postback:
- Para usuários de: Escolha a opção de envio para todos os eventos.
- Incluindo: Escolha quais dados incluir para todos os eventos no postback.

Para mais informações sobre o mapeamento de eventos, veja postbacks de eventos in-app.

Opções para envio de postbacks

Para cada evento, você pode escolher em qual caso enviar os postbacks (dentro da janela do postback):

Apenas este parceiro: envie postbacks somente quando o evento for atribuído a este parceiro—ou seja, o usuário que o executou o evento veio deste parceiro.
Todas as fontes de mídia, incluindo orgânicas: envie postbacks para eventos atribuídos a qualquer parceiro e para eventos orgânicos — ou seja, o usuário que o executou veio de qualquer canal de mídia. Atenção: Quando 'Todas as fontes de mídia, incluindo orgânicas' é selecionada, os postbacks de outros parceiros não contêm dados de atribuição.

Dados a incluir nos postbacks

Você pode escolher que tipo de dados de eventos você pode compartilhar com o parceiro no postback. Escolha uma das seguintes opções:

Sem valores e sem receita: Envie apenas o evento em si, sem qualquer parâmetro (valores ou receita).
Com valores e sem receita: Envie todos os parâmetros, com exceção do valor da receita.
Valores e receita: Envie todos os parâmetros do evento, incluindo o valor da receita (se existir no evento).

É recomendável compartilhar a receita se você quiser que as ad networks otimizem suas campanhas e melhorem os resultados da campanha. Entretanto, compartilhar a receita não é obrigatório. Certifique-se de permitir o compartilhamento de receitas somente para eventos que tenham af_revenue ouaf_projected_revenue configurados em seu valor de evento. Caso contrário, as ad networks recebem eventos com valor de receita vazio.

Compartilhar receita

Nos postbacks, af_revenue e af_currency são escritos fora do JSON do valor do evento como monetary e currency, e podem ser enviados separadamente. Exemplo de estrutura de postback: https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&content_id=(af_content_id)

Atenção: ao escolher as opções Sem valores e sem receita ou Com valores, sem receita, os respectivos parâmetros são mascarados com N/A.

Exemplo

Um profissional de marketing envia um evento de compra com o seguinte valor event_value:
{af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333}

A tabela abaixo mostra como os parâmetros são enviados:

Nome do campo event_value monetary currency

Sem valores e sem receita N/A N/A N/A

Com valores e sem receita

{"af_currency":"N/A","af_content_id":"1234567",

"af_revenue":"N/A","af_content_type":"category_a"}

&monetary=N/A&content_id=1234567

N/A

Valores e receita

"{af_currency":"USD","af_content_id":"1234567",

"af_revenue":50.87,"af_content_type":"category_a"}

&monetary=1.856918&content_id=1234567

50,87

USD

Postbacks condicionais de eventos in-app

Filtre postbacks de eventos in-app usando várias condições que podem ser mapeadas para diferentes eventos. Apenas os eventos que atendem às condições do filtro são enviados aos parceiros, incluindo os parceiros de SRNs e Analytics. Use esse recurso para:

Otimizar a segmentação, personalização e retenção de usuários
Minimizar dados
Proteger a privacidade dos usuários

Exemplo

Um profissional de marketing com um aplicativo de jogos quer otimizar as campanhas que passam por uma ad network, mas somente para usuários que passam do nível 10 ou 50, ou para usuários que gastam US$3 em compras no aplicativo.

altin_app_event_condition__1_.pngalt

As condições para esse evento são definidas da seguinte maneira:

Quando nível é igual a 10, mapeie para fb_mobile_level_acheived
Caso contrário (OU),
Quando nível é igual a 50, mapeie para fb_mobile_level_acheived
Caso contrário (OU),
Quando custo é igual a 3, mapeie para fb_mobile_purchase

Para configurar condições para um evento:

Na página de integração do parceiro, configure e mapeie os eventos in-app necessários para enviar a esse parceiro.
Clique no ícone Adicionar condição do evento desejado.
Insira os campos de condição, como aparecem no valor do evento:
- Nome da propriedade
- Valor
- Evento parceiro para mapear a condição (usando qualquer uma dessas opções de mapeamento)
Você pode adicionar mais condições, certifique-se de inserir todos os campos da condição existente.
Clique em salvar integração.

Considerações

Ao configurar as condições, certifique-se de que as seguintes considerações sejam atendidas para que o evento seja enviado ao parceiro:

Estrutura da condição

Tanto a propriedade quanto seu valor na condição devem corresponder aos dados do evento.
Atualmente, as condições só podem ser definidas como "iguais".
Estruturas complexas, como arrays, não são suportadas.

Múltiplas condições para um evento

O número máximo de condições por evento é 5.
Pelo menos uma condição deve ser atendida para que o postback seja enviado, mas apenas uma condição é executada.
Cada condição é verificada por ordem de aparecimento — a primeira condição a ser atendida é executada.
Cada condição é mapeada separadamente. O nome do evento do parceiro é então alterado para Baseado nas condições.
Mais de uma condição pode ter a mesma propriedade ou o mesmo valor, mas nenhuma das duas condições pode ter a mesma propriedade e o mesmo valor.
Mais de uma condição pode ser mapeada para o mesmo evento.

Atenção

É recomendável testar esse recurso com um aplicativo de teste ou eventos menores para entender seu impacto na otimização da campanha.
Para ver o conteúdo do postback, você pode baixar o relatório de postbacks de dados brutos.

Editando vários eventos

Ao mapear eventos, os valores nos campos para usuários de e incluindo podem ser editados para vários eventos em uma única ação.

Para editar vários eventos:

Selecione os eventos a serem atualizados.
Clique em Ações em massa.
Selecione a nova configuração a ser aplicada a todos os eventos selecionados:
- Para usuários de (escolha somente uma opção)
  - Somente este parceiro
  - Todas as fontes de mídia, incluindo orgânicas
- Incluindo (escolha apenas uma opção)
  - Sem dados (padrão)
  - Valores sem receita
  - Valores e receita

altIn-app_event_postbacks_en-us.pngalt

Eventos personalizados

A lista de eventos disponíveis para mapeamento mostra apenas os eventos já relatados pelo SDK ou por eventos S2S enviados para a AppsFlyer. Se o evento que você deseja mapear não aparecer na lista suspensa, pode ser pelos seguintes motivos:

Nenhum usuário realizou o evento ainda
A última vez em que o evento ocorreu foi há mais de duas semanas atrás
Você tem uma grande lista de eventos ativos

Em qualquer um desses casos, para mapear o evento para o ID do parceiro:

Na lista suspensa, clique em + Adicionar item.
Na caixa de texto, insira o nome do evento que deseja adicionar.
Clique no ícone V para confirmar. O evento que você adicionou agora aparece na lista e pode ser selecionado.
Associe o evento ao identificador do parceiro.
Clique em Salvar integração para certificar-se de que o mapeamento será registrado.

Atenção

Adicionar eventos personalizados à página de postback não os extrai automaticamente do seu app. É necessário configurar os eventos no SDK ou S2S para garantir o funcionamento correto. Veja como enviar eventos para a AppsFlyer.
Ao adicionar um evento personalizado sob um determinado parceiro, o evento é adicionado à lista de eventos para todos os parceiros. Ou seja, você pode ver esse evento em qualquer lista suspensa de eventos de parceiros.
Veja dicas e limitações para configurar nomes e parâmetros de eventos.

Agências e ad networks:

Não podem adicionar eventos personalizados
Só podem visualizar e/ou mapear eventos depois que o profissional de marketing adicionou o evento e concedeu as permissões necessárias

Mapeamento de eventos por ad networks

Os profissionais de marketing podem permitir que as ad networks mapeiem os eventos e desativem postbacks por conta própria. Para isso, um profissional de marketing deve dar as permissões relevantes para a ad network:

Na página Integrações ativas, encontre o parceiro para o qual você deseja conceder permissão.
Na aba Permissões, altere o botão Permitir configurar postbacks de eventos in-app para ON.

Assim que a ad network receber as permissões, ela poderá mapear os eventos seguindo as instruções no campo Digite o ID do evento no campo de texto.

Mapeamento de eventos por agências

Os profissionais de marketing podem permitir que as agências configurem postbacks de eventos no aplicativo.

Para dar permissão à agência para configurar postbacks in-app:

Encontre a agência na página Integrações ativas.
Selecione se a agência pode compartilhar todos os eventos ou somente aqueles atribuídos à ad network específica.
Selecione se a agência tem permissão para enviar receitas de eventos.
Selecione os eventos específicos que a agência tem permissão para compartilhar.

Veja também