Configuração de postback de eventos in-app

Para:

Profissionais de marketing Desenvolvedores

Última atualização: 6 de Agosto de 2023 11:40

Visão geral: meça o engajamento no aplicativo e a qualidade dos usuários e otimize campanhas usando dados de eventos in-app.

Leitura relacionada

Para obter uma visão completa do trabalho com eventos in-app, não deixe de ler estes artigos:

Configuração de postbacks de eventos in-app (este artigo)
Eventos in-app avançados —Visão geral
Eventos avançados in-app — Estrutura do evento

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. Sobre eventos in-app avançados

Seleção de evento in-app de postback

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

Observaçã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 a sessão 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 usando o widget partner assistant 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 à rede.

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. Desta 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.

Observaçã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
As agências que possuem a permissão de configuração de postbacks de eventos in-app.
Observaçã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.

Nota

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:

Você pode dar permissão ao parceiro para fazer o mapeamento propriamente dito.

Insira o ID do evento do parceiro

Evento da AppsFlyer: a partir da lista dos seus eventos do aplicativo, selecione um evento.
Mapeado para 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)

Observação

Os nomes de eventos diferenciam letras maiúsculas e minúsculas. Para evitar discrepâncias, use a nomenclatura do evento correto para todos os canais de mídia e versões de aplicativos.
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.

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 evento parceiro: a partir da lista de eventos de parceiros predefinidos, selecione o evento que corresponde ao seu evento do aplicativo (evento da AppsFlyer).

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: selecionar 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.

Observaçã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: selecione a opção de envio para todos os eventos.
- Incluindo: selecione 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):

Somente este parceiro: enviar postbacks somente quando o evento for atribuído a este parceiro—ou seja, o usuário que o executou o evento veio deste parceiro.
Todos os canais de mídia, incluindo orgânicos: enviar postbacks para todos os canais de mídia 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.

Dados a incluir nos postbacks

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

Sem valores e sem receita: envie apenas o próprio evento sem parâmetros (valores ou receita).
Valores e sem receita: envie todos os parâmetros excluindo o valor da receita.
Valores e receita: envie todos os parâmetros do evento, incluindo o valor da receita (se houver 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 definido em seu valor de evento. Caso contrário, as ad networks recebem eventos com valor de receita vazio.

Em postbacks, af_revenue e af_currency são escritos fora do event_value JSON como monetário e moeda 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)

Observaçã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/D N/D

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/D

Valores e receita

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

"af_revenue":200,"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 do usuário

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.

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

Quando nível é igual a 10, mapeie para fb_mobile_level_achieved
Caso contrário, (OU)
Quando nível é igual a 50, mapeie para fb_mobile_level_achieved 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, defina e mapeie os eventos in-app necessários para enviar a esse parceiro.
Clique no ícone Adicionar condiçãodo evento requerido.
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 matrizes, não são compatíveis.

Várias 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.

Observaçã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, inclusive orgânicas
- incluindo (escolha somente uma opção)
  - Sem dados (padrão)
  - Valores sem receita
  - Com valores e receita

Eventos personalizados

A lista de eventos disponíveis para mapeamento mostra apenas os eventos já relatados pelo SDK ou dos eventos de servidor para servidor 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 mais de duas semanas atrás
Você tem uma grande lista de eventos ativos

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

Digite o nome do evento.
Clique em Criar personalizado
Mapeie o evento para o identificador do parceiro.
Clique em Salvar integração para certificar-se de que o mapeamento será registrado.

Observação

Quando um evento personalizado é adicionado sob um determinado parceiro, o evento é adicionado à lista de eventos para todos os parceiros. Ou seja, você pode ver este evento em qualquer lista suspensa de eventos de parceiros.
Veja dicas e limitações para definir 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.