Análise de coorte via Data Locker

Visão geral: A análise de coorte no Data Locker contém dados agregados de todos os elementos na hierarquia de publicidade. Os relatórios contêm dados de atribuição de usuários dos 365 dias anteriores. Esse relatório está disponível para anunciantes que têm dados brutos ou a API de Coorte, ou ambos, como parte de sua assinatura. Isso significa que não é necessário ter uma assinatura do Data Locker para este relatório.

Análise de coorte no Data Locker

Em alguns casos, a atribuição de dados brutos na AppsFlyer é restrita devido às políticas de compartilhamento de dados de fontes de mídia ou às suas políticas de preservação de privacidade. A restrição inclui todos os campos relacionados à atribuição, como campanha e conjunto de anúncios. Os relatórios de coorte fornecem dados agregados que podem ser usados como alternativa aos dados brutos. 

Baixe um exemplo de relatório

Ativar o Data Locker

O relatório está disponível para assinantes do Data Locker, da API de Coorte e de dados brutos. Para habilitar o relatório no Data Locker, conclua um dos procedimentos a seguir. 

Você usa o Data Locker?  Procedimento

 

Sim 

AppsFlyerAdmin_us-en.png Para adicionar os relatórios de coorte ao Data Locker:

  1. Na AppsFlyer, no menu lateral, selecione Relatório > Data Locker.
  2. Selecione todos os relatórios na seção Análise de coorte. 
  3. Clique em salvar 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 do Data Locker (anunciante | parceiro).
  2. Adicione os relatórios de coorte ao Data Locker:
    1. Na AppsFlyer, no menu lateral, selecione Relatório > Data Locker.
    2. Selecione todos os relatórios na seção Análise de coorte. 
    3. Clique em salvar configuração
      Os relatórios estarão disponíveis no dia seguinte às 10:00 UTC.

Você pode carregar os dados em seus sistemas de BI e usá-los como parte de seus processos de otimização de campanhas e performance.

Métricas disponíveis

As métricas disponíveis são a receita, os usuários que executam um evento e o número de ocorrências do evento. Para calcular métricas relacionadas a custos, como ROI e ROAS, você precisa de métricas de receita e custo. As métricas de receita estão em Cohort e as métricas de custo são fornecidas pelo ROI360 Cost ETL.

Fatos sobre análise de coorte

Relatórios disponíveis

Os relatórios a seguir estão disponíveis para download. Os tipos de relatório estão descritos com mais detalhes no painel Coorte.

  • Aquisição do usuário: atribuída a um canal de mídia de aquisição de usuários, inclusive LTV, que ocorre durante as janelas de reengajamento.
  • Retargeting: atribuído a um canal de mídia de retargeting para eventos que ocorrem:
    • Durante uma janela de reengajamento
    • Como resultado de reatribuições
  • Unificado: exibe dados sob o canal de mídia que recebeu o último toque e que trouxe o usuário de acordo com as regras de atribuição dupla da AppsFlyer. Isso significa que o LTV que ocorre durante os reengajamentos é exibido sob o canal de mídia de retargeting e não sob o canal de mídia da aquisição de usuários (UA). 
Período coberto pelo relatório Usuários convertendo durante os últimos 365 dias. Em outras palavras, a cada dia, os relatórios incluem os usuários que converteram durante os 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 editado. Veja a estrutura do relatório.
Entrega do relatório  Consulte Habilitar relatórios de coorte no Data Locker.
Atualização dos dados
  • diariamente.
  • As métricas são calculadas usando dados disponíveis à meia-noite UTC. Em outras palavras, no final do dia. 
  • Os relatórios estão disponíveis no Data Locker na pasta date-time (dt) até à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 Segunda-feira. 
Impacto das políticas de retenção de parceiros

Alguns parceiros possuem uma política de retenção de dados. Nesse caso, os eventos que ocorrem 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 tem uma política de retenção de dados de 180 dias. Eventos de usuário até o dia 180 são atribuídos à SRN A. Eventos que ocorrem após 180 dias 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: String. O comprimento máximo da string é dinâmico e, na maioria dos casos, depende de como você preenche os elementos da hierarquia de publicidade.
  • Métricas: Número: Observação: O formato de campo selected_currency é uma string.

Dimensões

Nome do campo 

Descrição

app_id

--

media_source

--

conversion_type

Valores possíveis: install, install-unified (representando instalações no relatório unificado), re-engagement, re-attribution

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 a data de conversão (não o carimbo de data/hora de conversão específico).
  • Dica! Use isso para calcular os dias de retenção e de KPI. 

event_date 

  • A data em que um usuário executa um determinado evento.
  • Formato: aaaa-mm-dd
  • Exemplo: A data em que um usuário executou um determinado evento no aplicativo. No caso de uma conversão.
  • Atenção! Se o event_name for af_conversion, a data do evento e a data de conversão serão as mesmas. 

conversion_date

  • A data em que a conversão ocorreu
  • Formato: aaaa-mm-dd
  • Exemplo: A data de instalação

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_session Abriu o aplicativo
cohort_uninstalls Desinstalou o aplicativo 
Anunciante definiu evento in-app Realizou um evento in-app.

campanha

Hierarquia da campanha

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

campaign_id

Hierarquia da campanha

adset

Hierarquia da campanha

adset_id

Hierarquia da campanha

anúncio

Hierarquia da campanha

ad_id

Hierarquia da campanha

channel

Hierarquia da campanha

[Atualizado em 27 de outubro de 2021] No momento, o Meta ads não preenche o canal através de dados fornecidos por meio do mecanismo Google Install Referrer.

site_id

Hierarquia da campanha

is_primary_attribution

Use para identificar e desduplicar dados de retargeting

geo

O código de país ISO derivado do endereço IP do usuário.

agency

  • Transparência de agência é compatível.
  • No caso de agências não transparentes, pode haver várias linhas contendo 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 são duplicadas.

install_app_store

Somente aplicativos Android: A loja Android de onde o aplicativo foi baixado. Preenchido por anunciantes implementando a multi-store attribution do Android. Se estiver em branco, é a Google Play Store. 

keywords

Palavra(s) utilizada(s) na pesquisa do usuário. Conforme relatado pela ad network.

keyword_id

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

Métricas

Nome do campo

Descrição Formato

unique_users

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

Número

revenue_usd

  • Valor da receita em USD. Por exemplo, US$100,56 são refletidos como 100,56. 
  • Máximo de 2 dígitos após a vírgula decimal.
Número

event_count

Número de ocorrências de eventos.

Número

selected_currency

Código de moeda de 3 letras (USD, EUR) definido por você nas configurações do aplicativo. Formato : ISO-4217. Essa é a mesma moeda usada para exibir a receita no dashboard de Cohort, na interface do usuário. 

Sequência de caracteres

revenue_selected_currency

  • Valor da receita na moeda selecionada. Por exemplo, se a moeda selecionada for EUR, então €1234,56 é refletido como 1234,56
  • Máximo de 2 dígitos após a vírgula decimal.
Número

Considerações para desenvolvedores de BI

Escopo dos dados no relatório

Os relatórios contêm instalações com aquisição de usuários e retargeting com reatribuições e reengajamentos, além de eventos in-app correlacionados.

Você pode carregar relatórios unificados, de aquisição de usuários e de retargeting separadamente ou de uma só vez em seu BI. Se você carregá-los juntos e quiser filtrar as exibições por conta própria: 

  • Para unificado, use o campo is_primary_attribution=true ou null.
  • Para aquisição de usuários, use conversion_type=Install.
  • Para retargeting, use conversion_type=reengajamento ou re-attribution.

Se você usar apenas a exibição unificada em seu processo de carregamento de dados, poderá dividir os dados entre os tipos de campanha, ou seja, atribuição de usuário (instalações) e retargeting (reengajamentos). Para fazer isso, use o conversion_type=install, install-unified, re-engagement ou re-attribution. Leia Atribuição dupla de eventos de retargeting.  

Considerações a nível de campo

  • Use os dias após a atribuição para calcular suas métricas de retenção.
  • Calcular usuários usando o nome da campanha e dimensões do ID da campanha: se você puder ignorar a granularidade do nome da campanha, poderá somar a contagem exclusiva no ID da campanha e as métricas estarão corretas. 
  • Você pode agregar os dados usando os campos de hierarquia da campanha.  
  • 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 podem ser atualizados com um atraso de até 3 dias. 

Considerações gerais

Os dados de todos os aplicativos são fornecidos em um único arquivo. Use o campo ID do aplicativo para segregar dados por aplicativo ou defina o Data Locker para segregar por aplicativo.

Casos de uso

A seguir estão exemplos de alguns usos populares e práticos de aplicações de dados de coorte que desenvolvedores de BI pode extrair via Data Locker. Cada exemplo é ilustrado por uma instrução SQL e um exemplo de Excel. 

1. Calculando a retenção

No exemplo a seguir, nós:

  • Calculamos a retenção D1 e D7, assim como o total de instalações por campanha e anúncio.
  • Somamos a contagem de eventos por evento de conversão filtrando event_name para af_conversion.
  • Analisamos as campanhas de aquisição de usuários filtrando os dados de forma que conversion_type=install .

Declaraçã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'
    and conversion_type = 'install'
    and app_id = YOUR_APP
group by 1,2

Exemplo Excel

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

2. Calculando o ARPU de múltiplos eventos in-app

No exemplo a seguir, nós:

  • Calculamos o ARPU de vários eventos in-app por campanha.
  • Analisamos as campanhas de aquisição de usuários filtrando os dados de forma que conversion_type=re-engagement e conversion_type=re-attribution.
  • Somamos a contagem de eventos por evento de conversão filtrando event_name para af_conversion.
  • Somamos a receita de vários eventos. Nesse caso, af_purchase e af_coins.
  • Configuramos days_post_attribution para o mínimo necessário (nesse caso, 7) para reduzir a carga de processamento de dados.

Declaraçã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 reengajamento 6.23 5.11 2,34
98765432 reengajamento 3,57 1,34 4,86
07315466 reatribuição 7,41 6,79 5,29

3. Calculando a taxa de conversão de eventos in-app para um dia específico

No exemplo a seguir, nós:

  • Calculamos a taxa de conversão de eventos in-app em D0 para várias dimensões (nesse caso, data de conversão, geo, campanha, anúncio e site ID).
  • Analisamos dados unificados (UA e campanhas de retargeting) filtrando os dados de forma que is_primary=true.
  • Somamos a contagem de eventos por evento de conversão filtrando event_name para af_conversion.
  • Configuramos days_post_attribution para o mínimo necessário (nesse caso, 7) para reduzir a carga de processamento de dados.

Declaraçã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 = true
    and app_id = YOUR_APP
group by 1,2,3,4,5

Exemplo Excel

Data de conversão Geolocalização

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 null site_654 70%
2022-10-31 KR 07315466 null null 63%

4. Calculando as instalações diárias 

No exemplo a seguir, nós:

  • Calculamos o número de instalações por app ID, data de conversão, canal de mídia, nome do evento e tipo de conversão.
  • Filtramos os dados para mostrar as instalações do UA (sem retargeting), definindo conversion_type como install.
  • Somamos as instalações, configurando event_name como af_conversion.

Declaraçã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'
    and conversion_type = 'install'
    and event_name = 'af_conversion'
    and app_id = YOUR_APP
group by 1,2,3,4,5

Exemplo Excel

App ID Data de conversão

Canal 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 do Facebook Ads 

No exemplo a seguir, nós:

  • Calcule a receita D3 do Facebook por data de conversão e ID do aplicativo.
  • Analise os dados do Facebook filtrando os dados para que media_source='Facebook Ads'.
  • Definimos days_post_attribution o mínimo necessário (nesse caso, 3) para reduzir a carga de processamento de dados.

Declaraçã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 App ID

Canal 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 keyword ID no ASA por até 365 dias de cohort 

No exemplo a seguir, nós:

  • Calculamos o ARPU do Apple Search Ads por keyword ID até o 365º dia.
  • Analisamos os dados do Apple Search Ads, filtrando os dados de forma que media_source='Apple Search Ads'.
  • Somamos a contagem de eventos por evento de conversão filtrando event_name para af_conversion.

Declaraçã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

Canal de mídia

Keyword ID

ARPU

Dia 365

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

7. Calculando o ARPU D7 por tempo de atribuição e por geolocalização 

O exemplo a seguir ilustra como usar KPIs por tempo de atribuição. No exemplo, nós

  • Calculamos o ARPU D7 por data de atribuição e por geolocalização.
  • Os resultados são classificados pelo número de conversões, com as 20 principais geolocalizações exibidas.
  • Os dados são filtrados de forma que conversion_type='install'.
  • A primeira coluna mostra geolocalização. A segunda coluna mostra o total de conversões. As colunas subsequentes mostram a receita D7 para cada dia especificado como uma linha no query.

Declaraçã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
    and conversion_type = 'install'
    and app_id = 'YOUR_APP'
group by 1
order by 2 desc
limit 20

Exemplo Excel

Geolocalização

Total de conversões

ARPU D7 para 2023-07-11

ARPU D7 para 2023-07-12

ARPU D7 para 2023-07-13

ARPU D7 para 2023-07-14

ARPU D7 para 2023-07-15

ARPU D7 para 2023-07-16

Coreia do Sul 120.660 $7.798,89 $6.997,37 $8.258,95 $9.050,21 $10.018,04 $13.765,73
Canadá 35,099 $64.867,84 $7.050,19 $5.656,33 $9.553,75 $8.632,41 $11.308,06
Chile 26.750 $48.160,02 $21.249,55 $22.584,57 $24.033,07 $31.118,91 $41.145,22

Informações adicionais

Características e limitações

Característica  
Dados de custo Indisponível. Use o Cost ETL.
Alterações no nome da campanha Não compatível. 
Atualização dos dados UTC diário Os relatórios estão na pasta date-time (dt) do Data Locker do dia do relatório até às 10:00 UTC do dia seguinte. 
Receita de anúncios
  • Disponível
  • Para eventos af_ad_revenue, a métrica de usuários únicos não está disponível para datas entre 5 de outubro de 2022 e 16 de fevereiro de 2023.
Moeda  USD e moeda específica do aplicativo estão disponíveis por linha
Fuso horário
  • UTC
  • O fuso horário específico do aplicativo está disponível com a versão beta.
Dados orgânicos Disponível
Dias após a conversão (instalação, reatribuição, reengajamento)
  • 365 dias de dados pós-instalação estão disponíveis.
  • 1.095 dias estão disponíveis com a versão beta.
Transparência da agência
  • Compatível 
  • Os dados do X Ads e do Meta ads são sempre transparentes
Segregação de aplicativos Compatível
Dados do SKAN Não inclusos. Ou seja, os dados são fornecidos por postbacks do iOS.
Reinstalações
  • Se os eventos pós-reinstalação forem considerados orgânicos não atribuídos:
    • Eles estão incluídos somente a partir de 26 de maio de 2024. Saiba mais
    • A data de instalação atribuída a eventos orgânicos não atribuídos é a data da primeira instalação, com exceção dos eventos de receita. Saiba mais
  • Se eles forem atribuídos à primeira instalação, eles são sempre incluídos. Saiba mais

Veja também