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 de eventos in-app por meio de postbacks, que são enviados em tempo real. Saiba mais sobre eventos in-app avançados.

Seleção de eventos in-app em postbacks

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

Janela de postback de eventos in-app

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:

Os postbacks após esse período não são enviados, e a network não é notificada, mas a AppsFlyer ainda registra os eventos e os atribui à ad network.

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

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.

Quem pode configurar janelas de postback

As seguintes funções podem configurar janelas de postback:

• Profissionais de marketing
• Agências, se receberem a permissão de configurar 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, com base em seus contratos com a network.
• Parceiros, se receberem a permissão de configurar 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 ser diferentes 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 dos parceiros, os nomes dos eventos devem ser mapeados.  

Métodos de mapeamento

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

• Inserir o ID do evento do parceiro
• Selecionar o ID do evento na lista
• Enviar eventos como eles estão (não mapeados) 

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, insira o ID do evento conforme recebido do parceiro que corresponde ao seu evento do aplicativo (evento da AppsFlyer)

 Importante!

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

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

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 da forma como são nomeados 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). Isso não inclui desinstalações, sessões (inicializações do aplicativo), e o evento af_app_open.

 Importante!

Para evitar que os anunciantes compartilhem informações demais sem querer com plataformas de plataforma de analytics de terceiros, removemos a opção Enviar todos os eventos (exceto desinstalações e sessões) dessas plataformas a partir 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:

1. Clique em Adicionar evento.
2. 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.
3. Repita esse procedimento para mais eventos. 

Para enviar todos os eventos:

1. Selecione Enviar todos os eventos (exceto desinstalações e sessões).
2. 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):

• Somente este parceiro: Envie postbacks somente quando o evento for atribuído a este parceiro, ou seja, quando o usuário que o realizou vier deste parceiro.
• Todos os canais de mídia, incluindo orgânico: Envie postbacks para todos os canais de mídia em eventos atribuídos a qualquer parceiro e para eventos orgânicos, ou seja, quando o usuário que o realizou vier de qualquer canal de mídia. Observação: Quando Todos os canais de mídia, incluindo orgânico estiver selecionado, os postbacks de outros parceiros não conterão dados de atribuição.

Dados a incluir nos postbacks

Você pode escolher que tipo de dados de eventos você deseja 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).
• Valores, receita & receita líquida: Envie todos os parâmetros do evento, incluindo os valores de receita e receita líquida (se existirem no evento).

É recomendável compartilhar a receita se você quiser que as ad networks otimizem suas campanhas e melhorem os resultados. 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 um valor de receita vazio.

Compartilhar receita

Nos postbacks, af_revenue e af_currency são escritos fora do JSON do event_value 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)

Quando a opção Valores, receita e receita líquida é selecionada, af_net_revenue também pode ser escrita fora do JSON do event_value como net-monetary e enviada separadamente. Exemplo de estrutura de postback:

https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&net-monetary=(net-monetary)&content_id=(af_content_id)

Exemplo

Um profissional de marketing envia um evento de compra com o seguinte event_value:

{"af_currency":"USD","af_content_id":"1234567","af_revenue":50.87,"af_content_type":"category_a"}

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

Postbacks condicionais de eventos in-app

Filtre postbacks de eventos in-app usando várias condições que podem ser mapeadas para diferentes eventos. Somente os eventos que atendem às condições do filtro são enviados aos parceiros, incluindo self-reporting networks (SRNs) e parceiros de 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 gaming quer otimizar campanhas veiculadas por meio de uma ad network, mas apenas para usuários que passam do nível 10 ou do nível 50, ou para usuários que gastam US$3 em compras in-app.

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:

1. Na página de integração do parceiro, configure e mapeie os eventos in-app necessários para enviar a esse parceiro.
2. Clique no ícone Adicionar condição do evento desejado.
3. 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)
4. Você pode adicionar mais condições, certifique-se de inserir todos os campos da condição existente.
5. 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:

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:

1. Selecione os eventos a serem atualizados.
2. Clique em Ações em massa.
3. 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

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, isso pode acontecer 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:

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

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 por conta própria. Para isso, um profissional de marketing deve conceder as permissões relevantes à ad network:

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

Depois que a ad network receber as permissões, ela poderá mapear os eventos seguindo as instruções em Digitar 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:

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

Veja também

• Eventos in-app avançados, visão geral
• Eventos in-app avançados, estrutura do evento