Relatório de performance agregada de campanhas para ad networks

Visão geral: as ad networks carregam o relatório de performance agregada (também conhecido como relatório de cohort) em seus sistemas de BI para calcular as métricas de performance da campanha, como o KPI de retenção de 7 dias. 

Relatório de performance agregada 

Esse relatório oferece dados sobre a performance da campanha, incluindo o número de usuários exclusivos que realizam um determinado evento. Você (a ad network) usa os dados em seus sistemas de BI para calcular métricas de performance da campanha no contexto dos KPIs dos anunciantes. O relatório está disponível diariamente através do Data Locker para Parceiros 

Por que você precisa desse relatório?

Antes do iOS 14.5, os postbacks enviados pela AppsFlyer continham dados suficientes para calcular métricas exclusivas de eventos do usuário. 

A partir do iOS 14.5, e da adoção do anunciante da Privacidade Avançada Agregada (Aggregated Advanced Privacy, AAP), postbacks de usuários que não consentem não incluem identificadores de usuário. A falta de identificadores impede o cálculo de métricas exclusivas do usuário como, por exemplo, a retenção de 7 dias. A falta de métricas de usuários exclusivos prejudica sua capacidade de otimizar campanhas e de definir metas de retenção comuns com os anunciantes. 

O que o relatório contém?

As métricas são fornecidas com a melhor granularidade possível usando as dimensões relatadas e têm as seguintes métricas de performance:

    • Receita
    • Número de vezes que um determinado evento é executado
    • Número de usuários únicos que realizam um evento
    • Exemplo de relatório

Como você obtém o relatório?

Sobre o relatório

Estrutura do relatório

Dimensões

Nome do campo 

Observações

app_id

 

media_source

 

conversion_type

  • Valores possíveis: instalação, reengajamento, reatribuição
  • Macro de postback equivalente: is_retargeting

attributed_touch_type

Valores possíveis: clique, impressões, pré-instalação, desconhecido, tv, nulo

days_post_attribution

O número de dias decorridos desde o evento de atribuição. 

Dica! Use isso para calcular os dias de retenção e de KPI. 

event_date 

A hora em que o evento ocorreu

Formato: aaaa-mm-dd

conversion_date

Formato: aaaa-mm-dd

event_name

Identifica o evento. Alguns nomes de eventos têm um significado específico, enquanto outros se relacionam com eventos in-app definidos pelo anunciante no aplicativo. 

event_name

O que o usuário fez

af_conversion Usuário convertido. Use conversion_type para identificar se é uma instalação, reengajamento ou reatribuição.
af_sessions Abriu o aplicativo
af_uninstall Desinstalou o aplicativo 
Anunciante definiu evento in-app Realizou um evento in-app. Os nomes de eventos in-app não são mapeados para nomes de eventos de parceiros.

campanha

Hierarquia de campanhas

campaign_id

Hierarquia de campanhas

adset

Hierarquia de campanhas

adset_id

Hierarquia de campanhas

anúncio

Hierarquia de campanhas

ad_id

Hierarquia de campanhas

channel

Hierarquia de campanhas

site_id

Hierarquia de campanhas

is_primary_attribution

Use para identificar e deduplicar dados de retargeting

country_code

Derivado do endereço de IP do usuário

agency

Se estiver em branco, não há agência associada

Palavras-chave

[Disponível a partir de 27 de abril de 2022] Palavra(s) usada(s) na pesquisa online do usuário. Conforme relatado pela ad network.

ID da palavra-chave

[Disponível a partir de 27 de abril de 2022] ID de palavra-chave retornado pela ad network.

Métricas

Nome

Campo

Usuários únicos que executam o evento

Usuários únicos

unique_users

Número de usuários únicos que executam o evento

Receita

revenue_usd

Receita cumulativa em USD. Por exemplo, US$100,00 são refletidos como 100. 

event_count

event_count

Número de ocorrências de eventos

Considerações para desenvolvedores de BI

Escopo dos dados no relatório

O relatório contém atribuições, instalações, reatribuições e reengajamentos do usuário e seus eventos in-app relacionados.

No processo de consumo de dados, você deve usar a lógica para dividir os dados entre tipos de campanha. Significado, atribuição do usuário (instalações) e retargeting (reengajamentos). Para isso, use o campo conversion_type e is_primary_attribution. Leia Atribuição dupla de eventos de retargeting. 

Considerações a nível de campo

  • Use dias pós-atribuição para permitir o cálculo fácil das métricas de retenção.
  • Cálculo de usuários exclusivos usando o nome da campanha e as dimensões de ID da campanha: se você puder ignorar a granularidade do nome da campanha, poderá somar a contagem única no ID da campanha e as métricas estarão corretas. 
  • Você pode agregar os dados usando os campos de hierarquia da campanha. 
  • Os eventos in-app usam o nome do evento do anunciante e não são mapeados para os nomes de eventos. Peça ao anunciante que forneça os mapeamentos ou os visualize no dashboard. Mapeamento de eventos in-app de parceiros
  • A receita está em USD e é calculada usando a taxa de câmbio no dia do evento. 
  • Eventos de receita de anúncios são incluídos quando disponíveis, mas são atualizados com um atraso de até 5 dias. 

Considerações gerais

  • Atualização dos dados: diariamente, a partir das 08:00 UTC. Os dados são registrados na pasta Data Locker h=23.
  • Os dados disponíveis são dados de atribuição de jornada do usuário atribuídos pela AppsFlyer. Ou seja, dados de SKAdNetwork reportados por postbacks do iOS não estão incluídos neste conjunto de dados.
  • Os dados estão contidos em arquivos que contêm vários aplicativos. Use o campo app_id para identificar o aplicativo.
  • Se você não receber os dados de um determinado aplicativo, verifique se o anunciante lhe concedeu as permissões necessárias.

Considerações sobre relatórios de retenção

Para criar métricas de retenção, por exemplo, dia 7 da retenção, faça isso definindo filtros nos seguintes campos:

  • days_post_install=7
  • event_name=af_session
  • conversion_type conforme necessário
  • Para evitar a inclusão de eventos de retargeting duplicados, selecione is_primary_attribution=true ou use conversion_type para limitar o conjunto de dados às instalações. 
  • Agrupar por: campanha e outras dimensões, conforme necessário.
  • Soma: unique_users_count

Ao adicionar ou remover dimensões, você pode obter métricas com granularidades diferentes. 

Permissões

Você (a ad network) deve pedir ao anunciante que lhe dê as permissões listadas aqui. O anunciante deve executar esse procedimento uma vez por aplicativo. 

Permissão para obter dados de performance agregada

Ad networks nomeadas (ativadas) por agências: a agência não pode conceder permissão. A agência deve pedir ao anunciante que dê as permissões para ela. 

Para permitir que a ad network obtenha dados de performance agregada:

  1. Acesse Configuração > Parceiros integrados. 
  2. Selecione o parceiro integrado. 
  3. Acesse a guia Integração.
  4. Verifique se Ativar parceiro está habilitado. Caso contrário, os dados não são compartilhados.
  5. Acesse a aba Permissões.
  6. Ative as seguintes permissões:
    • Acessar dados agregados de conversões.
    • Acessar dados agregados de eventos in-app.
    • Acessar dados agregados de receita.
  7. Clique em Salvar configurações
  8. Notifique a ad network que você concedeu as permissões.
  9. Se você tiver vários aplicativos, repita o procedimento para cada aplicativo integrado ao parceiro.