Configuração do postback de eventos na aplicação

Para:
Profissionais de marketing Desenvolvedores
Última atualização:

Visão geral: Meça o envolvimento dos utilizadores e a qualidade na sua aplicação, otimizando as campanhas através de dados de eventos na aplicação.

Visão Geral

Os eventos na aplicação permitem aos marketeers medir o envolvimento e a qualidade dos utilizadores a partir de diferentes origens e desenvolver uma estratégia adequada de aquisição de utilizadores. As redes de anúncios utilizam dados de eventos na aplicação para otimizar campanhas e realizar campanhas baseadas no custo por ação/evento. As redes de anúncios recebem informações sobre eventos na aplicação através de postbacks enviados em tempo real. Saiba mais sobre eventos na aplicação enriquecidos.

Seleção de eventos na aplicação para postback

Os marketeers podem selecionar os eventos na aplicação para os quais desejam enviar postbacks para redes de anúncios, usando as configurações descritas neste artigo.

Nota

  • Os eventos na aplicação incluem eventos rejeitados, ou seja, eventos bloqueados pelo Protect360 ou considerados não conformes às regras de validação de destino.
  • Se a secção de postbacks de eventos na aplicação não estiver presente no separador Integração, significa que o parceiro ainda não configurou a gravação de eventos na aplicação com a AppsFlyer na sua configuração inicial. O parceiro pode contactar a AppsFlyer utilizando o widget do assistente de parceiro para concluir a integração.

Janela de postback de eventos na aplicação

A janela de postback de eventos na aplicação permite que marketeers que trabalham com redes baseadas em CPA (custo por ação) configurem períodos pós-conversão após os quais os postbacks de eventos deixam de ser enviados.

Por exemplo, se lhe cobraram por eventos que ocorrem até 15 dias após a instalação de um utilizador, defina a janela da seguinte forma:

definição_de_postback_de_eventos_na_aplicação_15_dias.png

Postbacks após este período não são enviados, e a rede não é notificada, mas os eventos continuam a ser registados na AppsFlyer e atribuídos à rede.

Os postbacks são sempre enviados com base na configuração atual da janela. Consulte o exemplo abaixo:

1 de janeiro

A janela é de 15 dias.

Um utilizador instala uma aplicação.
2 de janeiro A janela é alterada para 10 dias.
14 de janeiro

O utilizador realiza uma compra.

O postback não é enviado para a rede de anúncios porque o evento não se encontra dentro da janela atual (10 dias).
15 de janeiro A janela é alterada para 20 dias.
18 de janeiro

O utilizador faz outra compra.

Desta vez, o postback é enviado, pois o evento está dentro do prazo atual (20 dias).

Janela padrão de postback

Ao iniciar a configuração dos postbacks de eventos na aplicação, a janela padrão é definida automaticamente para seis meses.

Nota

Se começou a usar postbacks de eventos na aplicação com um parceiro específico antes de 30 de julho de 2019, a configuração padrão da janela é Vitalícia. Isto significa que os postbacks de eventos na aplicação são sempre enviados.

Quem pode configurar as janelas de postback

  • Profissionais de marketing
  • Agências, se receberem a permissão Permitir configurar postbacks de eventos na aplicação.
    Nota: Um profissional de marketing e uma agência que trabalhem com a mesma rede de anúncios podem configurar janelas de postback de forma independente, com base no seu contrato com a rede.
  • Parceiros, se receberem a permissão Permitir configurar postbacks de eventos na aplicação.

Mapeamento de eventos

Cada profissional de marketing pode atribuir 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 utilizador faz uma compra através de uma aplicação, um profissional de marketing pode chamá-lo de compra ou usar um ID menos informativo, como evento5, enquanto um parceiro pode chamá-lo de evento_compra.

Para garantir que os eventos do profissional de marketing correspondem aos dos parceiros, os nomes dos eventos devem ser mapeados.  

 Nota

Os eventos mapeados no separador de Integração para um parceiro específico aplicam-se tanto para postbacks padrão quanto para SKAN.

Métodos de mapeamento

Cada parceiro decide quais dos seguintes métodos serão usados para mapear os seus eventos na aplicação:

Nota

  • Nem todos os métodos de mapeamento estão disponíveis para todos os parceiros
  • Pode conceder permissão ao parceiro para fazer o mapeamento por conta própria

Introduza o ID do evento do parceiro

  • Evento da AppsFlyer: Na lista de eventos da sua aplicação, selecione um evento.
  • mapeado para o evento do parceiro: No campo de texto, introduza o ID do evento conforme recebido do parceiro, que corresponde ao evento da sua aplicação (evento AppsFlyer)

Nota

  • 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 da aplicação.
  • Ao introduzir o nome de um evento, pode utilizar sublinhados (traços baixos) antes ou depois do nome do evento. Assegure-se de utilizar sublinhados apenas quando o nome do evento enviado pela AppsFlyer tiver exatamente os mesmos sublinhados.

altenter_event_name.pngalt

Selecione um ID de evento na lista

  • Evento da AppsFlyer: Na lista de eventos da sua aplicação, selecione um evento.
  • mapeado para o evento do parceiro: Na lista de eventos predefinidos pelos parceiros, selecione o evento correspondente ao evento da sua aplicação (evento da AppsFlyer).

altIn-app_event_postbacks_en-us.pngalt

Enviar eventos tal como estão (não mapeados)

Alguns parceiros preferem receber postbacks de eventos in-app não mapeados, ou seja, os nomes dos eventos são enviados exatamente como estão na sua aplicação. Não importa se o evento se chama compra, aquisição ou evento5.

Pode escolher quais os eventos não mapeados a enviar ao parceiro:

  • Adicionar manualmente: Selecione eventos específicos.
  • Enviar todos os eventos (exceto desinstalações e sessões): Envie todos os seus eventos. Isto não inclui desinstalações, sessões (inicializações da aplicação) e o evento af_app_opened.

Nota

Para evitar que os anunciantes partilhem inadvertidamente demasiada informação com plataformas de análise de terceiros, removemos a opção Enviar todos os eventos (exclui desinstalações e sessões) para essas plataformas, a partir de março de 2019. As plataformas de análise configuradas antes desta data ainda mantêm esta opção.

Para adicionar eventos manualmente:

  1. Clique em Adicionar evento.
  2. Selecione as opções de postback:
    • Evento da AppsFlyer: Na lista de eventos da sua aplicação, selecione um evento.
    • para utilizadores de: Selecione a opção de envio do evento.
    • incluindo: Selecione quais dados incluir no postback.
  3. Repita este procedimento para mais eventos. 

enviar_postbacks_as_is_en-us.png

Para enviar todos os eventos:

  1. Selecione Enviar todos os eventos (exceto desinstalações e sessões).
  2. Selecione as opções de postback:
     

send_postbacsk_as_is_no_mapping.png

Para mais informações sobre mapeamento de eventos, consulte postbacks de eventos na aplicação. 

Opções para envio de postbacks

Para cada evento, é possível escolher em qual ocasião enviar os postbacks (dentro da janela de postback):

  • Apenas este parceiro: Envie postbacks apenas quando o evento for atribuído a este parceiro, ou seja, quando o utilizador que o realizou tenha vindo deste parceiro.
  • Todas as fontes de media, incluindo orgânicas: Envie postbacks para todas as fontes de media para eventos atribuídos a qualquer parceiro e para eventos orgânicos, ou seja, quando o utilizador que o realizou tenha vindo de qualquer fonte de media. Nota: Quando 'Todas as fontes de media, incluindo orgânicas' é selecionada, os postbacks de outros parceiros não contêm dados de atribuição.

Dados a incluir nos postbacks

Pode decidir que tipo de dados do evento partilhar com o parceiro no postback. Escolha uma das seguintes opções:

  • Sem valores e sem receita: Envie apenas o próprio evento sem qualquer parâmetro (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 existir no evento).

É recomendável partilhar a receita se quiser que as redes de anúncios otimizem as suas campanhas e melhorem os respetivos resultados. No entanto, a partilha de receita não é obrigatória. Certifique-se de ativar a partilha de receita apenas para eventos que tenham af_revenue ou af_projected_revenue definidos no valor do evento. Caso contrário, as redes de anúncios receberão eventos sem valor de receita.

Partilhar receita

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

Nota: Ao escolher as opções Sem valores e sem receita ou Valores e sem receita, os respetivos parâmetros são mascarados com N/A.

Exemplo

Um responsável de marketing envia um evento de compra com o seguinte valor de evento:
{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 valor_do_evento monetário moeda
Sem valores e sem receita  N/A N/A  N/A
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  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

Partilhar receita projetada

Ao selecionar Valores e receita, pode optar por partilhar a receita projetada das redes de anúncios durante os postbacks. (Contacte o suporte da AppsFlyer para verificar se a sua rede de anúncios suporta a receita projetada).

Quando um evento de receita projetada é partilhado com o parceiro, a AppsFlyer envia um postback com uma estrutura semelhante ao postback de receita real, apresentando duas diferenças:

  • A chave af_projected_revenue substitui a chave af_revenue.
  • O campo revenue_type aceita o valor projected.

Exemplo

Um responsável de marketing envia um evento de receita projetada com o seguinte valor de evento:
{af_projected_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 valor_do_evento monetário moeda tipo_de_receita
Sem valores e sem receita  N/A N/A  N/A N/A
Valores e sem receita

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

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

&monetary=N/A&content_id=1234567

 N/A  N/A N/A
Valores e receita

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

"af_projected_revenue":50.87,"af_content_type":"category_a"}

&monetary=1.856918&content_id=1234567

 50,87 USD projected

Postbacks condicionais de eventos na app

Filtre os postbacks de eventos na app usando várias condições que podem ser mapeadas para diferentes eventos. Apenas eventos que atendem às condições do filtro são enviados para parceiros, incluindo SRNs e parceiros de análise. Utilize esta funcionalidade para:

  • Otimizar a segmentação, personalização e retenção de utilizadores
  • Minimizar dados
  • Proteger a privacidade dos utilizadores

Exemplo

Um responsável de marketing com uma aplicação de jogos pretende otimizar campanhas através de uma rede de publicidade, focando-se apenas em utilizadores que ultrapassam o nível 10 ou 50, ou que gastam 3 dólares em compras na app.

altin_app_event_condition__1_.pngalt

Assim são definidas as condições para este evento:

  • 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, defina e mapeie os eventos na aplicação necessários para enviar ao parceiro.
  2. Clique no ícone Adicionar condição image.png do evento desejado.
  3. Introduza os campos de condição conforme aparecem no valor do evento: 
    • Nome da propriedade
    • Valor
    • Evento de parceiro para mapear a condição (usando qualquer uma destas opções de mapeamento) 
  4. Pode adicionar mais condições, mas certifique-se de preencher primeiro todos os campos da condição existente.
  5. Clique em Guardar integração. 

Considerações

Ao configurar condições, assegure que as seguintes considerações são atendidas para que o evento seja enviado para o parceiro:

Estrutura da condição

  • Tanto a propriedade como o 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 é de 5.
  • Pelo menos uma condição deve ser cumprida para o postback ser enviado, mas somente uma condição é executada.  
  • Cada condição é verificada por ordem de aparecimento; a primeira condição a ser cumprida é executada.
  • Cada condição é mapeada separadamente. O nome do evento do parceiro é alterado para Com base nas condições.
  • Mais de uma condição pode ter a mesma propriedade ou o mesmo valor, mas duas condições não podem ter ambas a mesma propriedade e o mesmo valor.
  • Mais de uma condição pode ser mapeada para o mesmo evento.

Nota

  • Recomenda-se testar esta funcionalidade com uma aplicação de teste ou em eventos menores para entender o impacto na otimização da campanha.
  • Para ver o conteúdo do postback, pode descarregar o relatório de postback de dados brutos. 

Edição de múltiplos eventos

Ao mapear eventos, os valores nos campos para utilizadores de e incluindo podem ser editados para vários eventos numa ú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 aplicar a todos os eventos selecionados:
    • para utilizadores de (escolha apenas uma opção)
      • Apenas este parceiro
      • Todas as fontes de mídia, incluindo as 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 de eventos de servidor para servidor enviados para a AppsFlyer. Se o evento que deseja mapear não aparecer na lista suspensa, isto pode ocorrer pelos seguintes motivos:

  • Nenhum utilizador realizou o evento até agora
  • A última vez que o evento ocorreu foi há mais de duas semanas
  • Existe uma longa lista de eventos ativos

Em qualquer um destes 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 no ícone V para confirmar. O evento que adicionou agora aparece na lista e pode selecioná-lo. add-custom-event-name.jpg
  4. Associe o evento ao identificador do parceiro.
  5. Clique em Guardar Integração para garantir que o mapeamento é registado.

Nota

  • Adicionar eventos personalizados à página de postback não os extrai automaticamente da sua app. É necessário configurar os eventos no SDK ou S2S para garantir o funcionamento correto. Consulte como enviar eventos para o AppsFlyer.
  • Ao adicionar um evento personalizado a um parceiro, este é incluído na lista de eventos de todos os parceiros. Isto significa que pode ver este evento em qualquer lista suspensa de eventos de parceiro.
  • Veja dicas e limitações para definir nomes e parâmetros dos eventos. 

Agências e redes de anúncios:

  • Não podem adicionar eventos personalizados
  • Podem apenas visualizar e/ou mapear eventos após o profissional de marketing adicionar o evento e conceder as permissões necessárias

Mapeamento de eventos por redes de anúncios

Os profissionais de marketing podem permitir que as redes de anúncios mapeiem os eventos e desativem os postbacks autonomamente. Para isso, o profissional de marketing deve conceder as permissões adequadas à rede de anúncios:

  1. Na página Integrações Ativas, localize o parceiro a quem pretende conceder permissão.
  2. Na aba Permissões, ative o botão Permitir configurar postbacks de eventos na app para ON.

adnetwork-permissions-postbacks.png

Após a rede de anúncios receber as permissões, será capaz de mapear os eventos seguindo as instruções em Escreva 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 na app.

Para conceder permissão à agência para configurar postbacks na app:

  1. Encontre a agência na página Integrações Ativas.
  2. Escolha se a agência pode partilhar todos os eventos ou apenas aqueles atribuídos à rede de anúncios específica.
  3. Determine se a agência está autorizada a enviar receitas de eventos.
  4. Escolha os eventos específicos que a agência pode partilhar.

agency-events.png

Veja também