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?
- Oferecido através do Data Locker para Parceiros. O relatório é atualizado Diariamente em horário UTC.
- Antes de começarmos a compartilhar os dados com você, os anunciantes devem conceder permissões no dashboard.
Sobre o relatório
Estrutura do relatório
Dimensões
Nome do campo |
Observações |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
app_id |
|||||||||||
media_source |
|||||||||||
conversion_type |
|
||||||||||
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.
|
||||||||||
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:
- Acesse Configuração > Parceiros integrados.
- Selecione o parceiro integrado.
- Acesse a guia Integração.
- Verifique se Ativar parceiro está habilitado. Caso contrário, os dados não são compartilhados.
- Acesse a aba Permissões.
- Ative as seguintes permissões:
- Acessar dados agregados de conversões.
- Acessar dados agregados de eventos in-app.
- Acessar dados agregados de receita.
- Clique em Salvar configurações.
- Notifique a ad network que você concedeu as permissões.
- Se você tiver vários aplicativos, repita o procedimento para cada aplicativo integrado ao parceiro.