Análise de coorte através do Data Locker

Visão geral: A análise de coorte no Data Locker reúne dados agregados de todos os elementos na hierarquia publicitária. Os relatórios incluem dados de utilizadores atribuídos nos últimos 365 dias. Este relatório está disponível para anunciantes que têm dados brutos ou Cohort API, ou ambos, como parte da sua subscrição. Isto significa que não é necessária uma subscrição do Data Locker para aceder a este relatório.

Análise de coorte no Data Locker

Em alguns casos, os dados brutos de atribuição na AppsFlyer são restritos devido às políticas de partilha de dados de fontes de média ou às suas políticas de preservação da privacidade. A restrição abrange todos os campos relacionados com atribuições, como campanhas e conjuntos de anúncios. Os relatórios de coorte oferecem dados agregados que podem ser utilizados como alternativa aos dados brutos. 

Descarregar relatório de exemplo

Ativar Data Locker

O relatório está disponível para subscritores do Data Locker, Cohort API e dados brutos. Para ativar o relatório no Data Locker, conclua um dos seguintes procedimentos. 

Atualmente, obtém dados através do Data Locker?  Procedimento

 

Sim 

AppsFlyerAdmin_us-en.pngPara adicionar relatórios de coorte ao Data Locker:
  1. Na AppsFlyer, a partir do menu lateral, selecione Relatório > Data Locker.
  2. Selecione todos os relatórios na secção Análise de coorte
  3. Clique em Guardar configuração.
    Os relatórios estarão disponíveis no dia seguinte, às 10:00 UTC.
Não AppsFlyerAdmin_us-en.pngPara configurar o Data Locker:
  1. Conclua a configuração inicial do Data Locker (anunciante | parceiro).
  2. Adicione os relatórios de coorte ao Data Locker:
    1. Na AppsFlyer, a partir do menu lateral, selecione Relatório > Data Locker.
    2. Selecione todos os relatórios na secção Análise de coorte
    3. Clique em Guardar configuração.
      Os relatórios estarão disponíveis no dia seguinte, às 10:00 UTC.

Pode carregar os dados nos seus sistemas de BI e utilizá-los para otimizar o desempenho das suas campanhas.

Métricas disponíveis

As métricas disponíveis incluem receita, utilizadores únicos realizando um evento e o número de ocorrências de eventos. Para calcular métricas relacionadas a custos, como ROI e ROAS, são necessárias métricas de receita e custo. As métricas de receita são encontradas na coorte, enquanto as métricas de custo são fornecidas pelo ROI360 Cost ETL.

Factos sobre análise de coorte

Relatórios disponíveis Os seguintes relatórios estão disponíveis para descarregar. Os tipos de relatórios são descritos com mais detalhes no Painel de coorte.
  • Aquisição de utilizadores: atribuída a uma fonte de média de aquisição, incluindo LTV durante as janelas de reengajamento.
  • Retargeting: atribuído a uma fonte de média de retargeting para eventos ocorridos:
    • Durante uma janela de reengajamento
    • Como resultado de reatribuições
  • Unificado: exibe os dados sob a última fonte de média que trouxe o utilizador, conforme as regras de dupla atribuição da AppsFlyer. Assim, o LTV que ocorre durante reengajamentos é apresentado na fonte de média de retargeting e não na de UA. 
Período do relatório Utilizadores que converteram nos últimos 365 dias. Ou seja, diariamente os relatórios incluem as conversões dos 365 dias anteriores. 
Estrutura do relatório O esquema de cada relatório (as dimensões e métricas incluídas) é fixo e não pode ser alterado. Consulte a estrutura do relatório.
Entrega do relatório  Consulte Ativar relatórios de coorte no Data Locker.
Atualização dos dados
  • Diariamente.
  • As métricas são calculadas utilizando os dados disponíveis à meia-noite UTC. Ou seja, no final do dia. 
  • Os relatórios estão disponíveis no Data Locker na pasta data-hora (dt) às 10:00 UTC. Por exemplo, os dados de segunda-feira estão disponíveis na terça-feira às 10:00 UTC na pasta de segunda-feira. 
Impacto das políticas de retenção dos parceiros

Considere que alguns parceiros implementam políticas de retenção de dados. Neste caso, os eventos ocorridos após o término do período de retenção são considerados orgânicos nos relatórios de coorte.

Exemplo: A SRN A possui uma política de retenção de dados de 180 dias. Os eventos dos utilizadores até ao dia 180 são atribuídos à SRN A. Os eventos após esse período são considerados orgânicos.

Estrutura do relatório

O relatório é composto por dimensões e métricas.

O formato dos campos é o seguinte:

  • Dimensões: Texto. O comprimento máximo da string é dinâmico e, na maioria dos casos, depende de como se preenchem os elementos da hierarquia publicitária.
  • Métricas: Número. Nota: O formato do campo selected_currency é uma cadeia de caracteres.

Dimensões

Nome do campo  Descrição
app_id --
fonte_de_mídia --
tipo_de_conversão Valores possíveis: install, install_unified (representando instalações no relatório unificado), re-engagement, reatribuição
tipo_de_toque_atribuído Valores possíveis: clique, impressões, pré-instalação, desconhecido, tv, nulo
dias_após_atribuição
  • O número de dias decorridos desde a data da conversão (não o carimbo de data/hora específico da conversão).
  • Dica! Use isto para calcular retenção e dias para KPIs
data_do_evento 
  • A data em que um utilizador realiza um determinado evento.
  • Formato: aaaa-mm-dd
  • Exemplo: A data em que um utilizador realizou um determinado evento na app. No caso de uma conversão.
  • Nota! Se event_name for af_conversion, a data do evento e a data de conversão serão iguais. 
data_da_conversão
  • A data em que a conversão ocorreu.
  • Formato: aaaa-mm-dd
  • Exemplo: A data de instalação.
nome_do_evento Identifica o evento. Alguns nomes de eventos têm um significado específico, enquanto outros estão relacionados com eventos definidos pelo anunciante na app. 
nome_do_evento O que o utilizador fez
af_conversion Utilizador convertido. Use o tipo_de_conversão para identificar se é uma instalação, re-engagement ou reatribuição.
af_sessão Abriu a app
coorte_desinstalações Desinstalou a app 
Evento na app definido pelo anunciante Realizou um evento in-app na app
campanha

Hierarquia da campanha

Considere: As alterações no nome da campanha não são suportadas. Consequentemente, podem ser associados vários nomes a um determinado ID de campanha. 

id_da_campanha Hierarquia da campanha
conjunto_de_anúncios Hierarquia da campanha
id_conjunto_de_anúncios Hierarquia da campanha
anúncio Hierarquia da campanha
id_anúncio Hierarquia da campanha
canal

Hierarquia da campanha.

[Atualização de 27 de outubro de 2021] Atualmente, os anúncios Meta não preenchem o canal nos dados fornecidos através do Google Install Referrer.

id_do_site Hierarquia da campanha
é_atribuição_primária Use para identificar e desduplicar dados de retargeting.
geo O código ISO do país derivado do endereço IP do utilizador.
agência
  • Transparência da agência suportada.
  • No caso de agências não transparentes, podem existir várias linhas com o mesmo nome de campanha se o anunciante e a agência executarem campanhas com o mesmo nome. Não se preocupe. As linhas não estão duplicadas.
instalar_app_store Apenas para aplicações Android: A loja Android de onde a app foi descarregada. Preenchido por anunciantes que implementam atribuição Android para várias lojas. Se estiver em branco, significa que é a Google Play Store. 
palavras-chave Palavra(s) utilizada(s) na pesquisa online do utilizador. Tal como reportado pela rede de anúncios
id_palavra-chave [Campo disponível a partir de 27 de abril de 2022] ID da palavra-chave devolvido pela rede de anúncios.

Métricas

Nome do campo Descrição Formato
utilizadores_únicos Número de utilizadores únicos no dia em que realizam o evento. Número
receita_usd
  • Quantia de receita em dólares americanos. Por exemplo, 100,56 dólares são refletidos como 100,56.
  • Máximo de 2 casas após o ponto decimal.
Número
contagem_de_eventos Número de ocorrências de eventos. Número
moeda_selecionada Código de moeda de três letras (USD, EUR) definido por si nas definições da app. Formato ISO-4217. É a mesma moeda utilizada para exibir a receita na Coorte na interface do utilizador.  String
receita_moeda_selecionada
  • Quantia de receita na moeda selecionada. Por exemplo, se a moeda selecionada for EUR, então 1.234,56 euros são refletidos como 1.234,56.
  • Máximo de 2 casas após o ponto decimal
Número

Considerações para o desenvolvedor de BI

Âmbito dos dados no relatório

Os relatórios contêm instalações de aquisição de utilizadores, reatribuições de retargeting e reengajamentos, além dos seus eventos in-app relacionados.

Pode carregar relatórios unificados, de aquisição de utilizadores e retargeting, separadamente ou em conjunto no seu BI. Se os carregar juntos e quiser filtrar as visualizações por si: 

  • Para unificado, use o campo é_atribuição_primária=true ou nulo.
  • Para aquisição de utilizadores, utilize tipo_de_conversão=instalação.
  • Para retargeting, utilize tipo_de_conversão=re-engagement ou reatribuição.

Se apenas usar a vista unificada no seu processo de carregamento de dados, pode usar lógica para dividir os dados entre tipos de campanha, ou seja, atribuição de utilizadores (instalações) e retargeting (reengajamentos). Para isso, utilize conversion_type=install, install_unified, re-engajamento ou reatribuição. Consulte Atribuição dupla de eventos de retargeting. 

Considerações ao nível do campo

  • Utilize os dias pós-atribuição para facilitar a análise das métricas de retenção.
  • Cálculo de utilizadores únicos usando as dimensões de nome de campanha e ID de campanha: Se puder desconsiderar a granularidade do nome da campanha, pode somar a contagem única no ID da campanha, e as métricas estarão corretas. 
  • Pode agregar os dados utilizando os campos da hierarquia da campanha. 
  • A receita em USD é calculada com base na taxa de câmbio do dia do evento. 
  • Os eventos de receita de anúncios são incluídos quando disponíveis, mas podem ser atualizados com um atraso de até 3 dias.

Considerações gerais

Os dados de todas as aplicações são fornecidos num único ficheiro. Utilize o campo App ID para segregar os dados por aplicação ou configure o Data Locker para segregar por aplicação.

Casos de uso

A seguir, apresentam-se exemplos de algumas aplicações práticas e populares de dados de coorte que os programadores de BI podem extrair através do Data Locker. Cada exemplo é ilustrado por uma instrução SQL e um exemplo visual em Excel. 

1. Calculando a retenção

No exemplo seguinte, realizamos as seguintes ações:

  • Calcular a retenção do Dia 1 e do Dia 7, bem como o número total de instalações por campanha e anúncio.
  • Somar a contagem de eventos por evento de conversão filtrando event_namepara que seja af_conversion.
  • Analisar especificamente as campanhas de aquisição de utilizadores, filtrando os dados para que conversion_type=install.

Instrução SQL

select
    campaign_id, ad_id,
    sum(if(event_name = 'af_conversion', event_count,0)) as installs,
    sum(if(event_name = 'af_session' and days_post_attribution = 1, unique_users,0)) / sum(if(event_name = 'af_conversion', event_count,0)) as retention_day1,
    sum(if(event_name = 'af_session' and days_post_attribution = 7, unique_users,0)) / sum(if(event_name = 'af_conversion', event_count,0)) as retention_day7
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    // If you're querying data from unified reports, edit the line below to: and conversion_type IN ('install', 'install_unified')    
    and conversion_type = 'install'
    and app_id = YOUR_APP
group by 1,2

Exemplo Excel

ID da campanha ID do anúncio Instalações Retenção Dia 1 Retenção Dia 7
12345678 987654 100 30% 10%
98765432 123456 200 25% 15%
07315466 613770 300 20% 12%

2. Calculando o ARPU de múltiplos eventos na aplicação

No exemplo seguinte, realizamos as seguintes ações:

  • Calcular o ARPU de múltiplos eventos na aplicação por campanha.
  • Analisar especificamente as campanhas de retargeting, filtrando os dados de modo a que conversion_type=re-engagement e conversion_type=re-attribution.
  • Somar a contagem de eventos por evento de conversão filtrando event_namepara que seja af_conversion.
  • Somar a receita de múltiplos eventos, neste caso af_purchasee af_coins.
  • Definir days_post_attribution como o mínimo necessário (neste caso, 7) para minimizar a carga de processamento de dados.

Instrução SQL

select
    campaign_id,
    sum(if(days_post_attribution <= 1 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day1,
    sum(if(days_post_attribution <= 3 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day3,
    sum(if(days_post_attribution <= 7 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day7
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    and days_post_attribution <= 7
    and conversion_type in ('re-engagement', 're-attribution')
    and app_id = YOUR_APP
group by 1

Exemplo Excel

ID da campanha Tipo de conversão

ARPU

Dia 1

ARPU

Dia 3

ARPU

Dia 7

12345678 re-engajamento 6,23 5,11 2,34
98765432 re-engajamento 3,57 1,34 4,86
07315466 reatribuição 7,41 6,79 5,29

3. Calculando a taxa de conversão de eventos na aplicação para um dia de coorte específico

No exemplo seguinte, realizamos as seguintes ações:

  • Calcular a taxa de conversão de eventos na aplicação no Dia 0 para várias dimensões (neste caso, data de conversão, localização geográfica, campanha, anúncio e ID do site).
  • Analisar dados unificados (campanhas de UA e de retargeting) filtrando-os para que is_primary_attribution=true.
  • Somar a contagem de eventos por evento de conversão filtrando event_namepara que seja af_conversion.
  • Definir days_post_attribution como o mínimo necessário (neste caso, 7) para minimizar a carga de processamento de dados.

Instrução SQL

select
    conversion_date, geo, campaign_id, ad_id, site_id,
    sum(if(days_post_attribution = 0 and event_name = 'af_complete_tutorial', unique_users, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as day0_af_tutorial_conversion
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    and is_primary_attribution = true
    and app_id = YOUR_APP
group by 1,2,3,4,5

Exemplo Excel

Data de conversão Geografia ID da campanha ID do anúncio ID do site Dia 0 af_complete_tutorial
2022-11-07 EUA 12345678 123456 site_123 45%
2022-11-05 Reino Unido 98765432 nulo site_654 70%
2022-10-31 KR 07315466 nulo nulo 63%

4. Calculando instalações diárias

No exemplo seguinte, realizamos as seguintes ações:

  • Calcular o número de instalações por ID da aplicação, data de conversão, fonte de mídia, nome do evento e tipo de conversão.
  • Filtre os dados para mostrar as instalações de UA (não retargeting), definindo conversion_typepara que seja install.
  • Some as instalações definindo event_namepara que seja af_conversion.

Instrução SQL

select
    app_id,
    conversion_date,
    media_source,
    event_name,
    conversion_type,
    sum(events_count) as total
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    // If you're querying data from unified reports, edit the line below to: and conversion_type IN ('install', 'install_unified')
    and conversion_type = 'install'
    and event_name = 'af_conversion'
    and app_id = YOUR_APP
group by 1,2,3,4,5

Exemplo Excel

ID da aplicação Data de conversão Fonte de mídia Nome do evento Total
id123456789 2022-11-07 adnet1_int af_conversion 105
id123456789 2022-11-05 adnet2_int af_conversion 216
id123456789 2022-10-31 adnet3_int af_conversion 327

5. Calculando a receita de anúncios do Facebook

No exemplo seguinte, realizamos as seguintes ações:

  • Calcular a receita do Dia 3 de anúncios do Facebook, com base na data de conversão e ID da aplicação.
  • Analise os dados do Facebook filtrando para que media_source='Facebook Ads'.
  • Definir days_post_attribution como o mínimo necessário (neste caso, 3) para minimizar a carga de processamento de dados.

Instrução SQL

select
    conversion_date,
    app_id,
    media_source,
    sum(if(days_post_attribution <= 3, revenue_usd, 0)) as revenue_day3
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2022-06-01' and '2023-05-31'
    and days_post_attribution <= 3
    and media_source = 'Facebook Ads'
    and app_id in (APP_ID1, APP_ID2, ...)
group by 1,2,3

Exemplo Excel

Data de conversão ID da aplicação Fonte de mídia

Receita

Dia 3

2022-11-07 id123456789 adnet1_int 400,45
2022-11-05 id123456789 adnet2_int 99,23
2022-10-31 id123456789 adnet3_int 13,34

6. Calculando o ARPU por ID de palavra-chave ASA até 365 dias de coorte

No exemplo seguinte, realizamos as seguintes ações:

  • Calcular o ARPU dos anúncios de pesquisa da Apple por ID de palavra-chave até ao dia de coorte 365.
  • Analise os dados do Apple Search Ads filtrando-os de modo a que media_source='Apple Search Ads'.
  • Somar a contagem de eventos por evento de conversão filtrando event_namepara que seja af_conversion.

Instrução SQL

select
    media_source,
    keyword_id,
    sum(if(days_post_attribution <= 365, revenue_usd,0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day365
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2022-06-01' and '2023-05-31'
    and media_source = 'Apple Search Ads'
    and app_id = YOUR_APP
group by 1

Exemplo Excel

Fonte de mídia ID da palavra-chave

ARPU

Dia 365

adnet1_int 123456 57.019,93
adnet2_int 987654 64.867,84
adnet3_int 666854 48.160,02

7. Cálculo do ARPU Dias 7 por tempo de atribuição para cada área geográfica

O exemplo seguinte ilustra como utilizar KPIs por tempo de atribuição. Neste exemplo, nós:

  • Calculamos o ARPU Dias 7 por data de atribuição para cada área geográfica.
  • Os resultados são classificados pelo número de conversões, exibindo as 20 principais regiões geográficas.
  • Os dados são filtrados de maneira que conversion_type='install'.
  • A primeira coluna mostra a área geográfica. A segunda coluna mostra o total de conversões. As colunas seguintes mostram a receita dos 7 dias para cada dia especificado como uma linha na consulta.

Instrução SQL

select
    geo,
    sum(if(event_name = 'af_conversion', event_count, 0)) total_conversions,
    sum(if(cohort_day = '2023-07-11' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-11' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_11,
    sum(if(cohort_day = '2023-07-12' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-12' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_12,
    sum(if(cohort_day = '2023-07-13' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-13' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_13,
    sum(if(cohort_day = '2023-07-14' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-14' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_14,
    sum(if(cohort_day = '2023-07-15' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-15' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_15,
    sum(if(cohort_day = '2023-07-16' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-16' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_16
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-07-11' and '2023-07-16'
    and days_post_attribution <= 7
    // If you're querying data from unified reports, edit the line below to: and conversion_type IN ('install', 'install_unified')
    and conversion_type = 'install'
    and app_id = 'YOUR_APP'
group by 1
order by 2 desc
limit 20

Exemplo Excel

Geografia Total de conversões ARPU Dia 7 para 2023-07-11 ARPU Dia 7 para 2023-07-12 ARPU Dia 7 para 2023-07-13 ARPU Dia 7 para 2023-07-14 ARPU Dia 7 para 2023-07-15 ARPU Dia 7 para 2023-07-16
Coreia do Sul 120.660 US$ 7.798,89 US$ 6.997,37 US$ 8.258,95 US$ 9.050,21 US$ 10.018,04 US$ 13.765,73
Canadá 35.099 US$ 64.867,84 US$ 7.050,19 US$ 5.656,33 US$ 9.553,75 US$ 8.632,41 US$ 11.308,06
Chile 26.750 US$ 48.160,02 US$ 21.249,55 US$ 22.584,57 US$ 24.033,07 US$ 31.118,91 US$ 41.145,22

Informações adicionais

Características e limitações

Características  
Dados de custo
Mudanças no nome da campanha Não suportado. 
Atualização dos dados Diário UTC. Os relatórios estão na pasta de data-hora (dt) do Data Locker do dia do relatório até às 10:00 UTC do dia seguinte. 
Receita de publicidade
  • Disponível.
  • Para eventos af_ad_revenue, a métrica de utilizadores únicos não está disponível para as datas entre 5 de outubro de 2022 e 16 de fevereiro de 2023.
Moeda  USD e moeda específica da aplicação estão disponíveis por linha.
Fuso horário
Dados orgânicos Disponível.
Dias após conversão (instalação, reatribuição, reengajamento)
Transparência das agências
  • Suportado 
  • Os dados dos X Ads e Meta Ads são sempre transparentes.
Segregação de aplicações Suportado
Dados SKAN Não incluído. Ou seja, os dados fornecidos pelos postbacks do iOS não estão incluídos.
Reinstalações
  • Se os eventos após reinstalação forem considerados orgânicos não atribuídos:
    • Estão incluídos apenas a partir de 26 de maio de 2024. Saiba mais
    • O tempo de instalação baseia-se no campo device_download_time.
    • Não são contabilizados para medições de usuários únicos e de retenção.
  • Se os eventos após reinstalação forem atribuídos à primeira instalação, são sempre incluídos. Saiba mais