Resumo: O relatório de eventos cross-platform realizados por usuários finais mensura jornadas completas dos usuários, conversões e LTV entre diferentes plataformas e dispositivos
O relatório de eventos cross-platform realizados por usuários finais é um relatório de dados brutos que fornece logs de eventos a nível de sessão e eventos in-app para cada usuário, conectando os dados entre plataformas usando o Customer User ID (CUID). Cada evento inclui o resultado da atribuição cross-platform, permitindo que você analise jornadas completas de usuários.
Para mais informações sobre o fluxo e a configuração da atribuição baseada em usuário, acesse o artigo sobre a atribuição cross-platform baseada em usuário.
Campos do relatório
Para saber quais campos estão contidos no relatório, baixe o relatório de exemplo.
Ele inclui todos os campos do relatório e seus valores. Para as definições dos campos, acesse o dicionário de campos de dados brutos.
Atualização dos dados do relatório
- O relatório executa um lote a cada 4 horas.
- Cada execução de lote processa eventos que entraram no banco de dados durante as últimas 4 horas.
- Exemplo: A execução do lote das 8h processa eventos que foram inseridos no banco de dados entre 3h e 7h.
- Os eventos são distribuídos em seus respectivos buckets por hora.
- Exemplo: Eventos que entraram no banco de dados entre 3h e 4h aparecerão no bucket das 3h.
Importante!
Normalmente, há um pequeno atraso entre o momento em que um evento ocorre e sua entrada no banco de dados. O relatório usa o horário de entrada no banco de dados para garantir um agrupamento horário preciso e consistente.
Exemplo da execução do lote das 8h
| Data | Versão do relatório | Relatório disponível às | O relatório inclui eventos que ocorreram entre | O relatório inclui eventos que entraram no banco de dados entre |
|---|---|---|---|---|
| 01/10/2025 | 3:00 | 9:00 | 2:00-4:00 | 3:00-4:00 |
| 01/10/2025 | 4:00 | 9:00 | 3:00-5:00 | 4:00-5:00 |
| 01/10/2025 | 5:00 | 9:00 | 4:00-6:00 | 5:00-6:00 |
| 01/10/2025 | 6:00 | 9:00 | 5:00-7:00 | 6:00-7:00 |
Observações sobre o exemplo acima:
- Eventos que ocorrem na última hora antes da execução não são processados. O objetivo é que tempo o suficiente passe para enriquecer eventos com o CUID relacionado. No exemplo acima, o processo em lote das 8:00h processa eventos que entraram no banco de dados entre 3:00h e 7:00h. Eventos que entraram no banco de dados entre 7:00h e 8:00h não são processados.
- O relatório está disponível apenas uma hora após a execução do lote, pois um processo interno atualiza o lote durante essa hora. No exemplo acima, o lote das 8:00h está disponível às 9:00h.
Como posso me inscrever para esse relatório?
- Na AppsFlyer, no menu lateral, selecione Exportar > Data Locker.
- No painel de conteúdo do Data Locker, vá até a seção Relatórios avançados.
- Selecione Eventos cross-platform de usuários finais
Como acessar os dados do relatório no seu bucket na nuvem?
O caminho (path) para o relatório consiste na seguinte hierarquia de pastas:
<bucket-name>/<DataLocker connection name>/t=end_user_events_user_level_cross_platform/dt=<dt=yyyy-mm-dd>/h=<hour>/Hierarquia de pastas de relatório
Considerações para o desenvolvedor de BI
- Cada bucket de relatório por hora contém eventos de usuários finais únicos. Certifique-se de extrair todos os relatórios em uma base horária ou diária.
- Eventos de receita de anúncios ainda não estão inclusos.
- Todos os dados do aplicativo são fornecidos em um único arquivo. Use o campo App ID para separar dados por aplicativo ou defina o Data Locker para segregar por aplicativo. É recomendado usar o tipo de segregação unificada.
- Os dados de pré-atribuição, como custo, cliques e impressões, devem ser extraídos do relatório de Cost ETL.
Exemplos de query
Veja a seguir exemplos de alguns usos práticos e populares dos dados via Data Locker. Cada exemplo é ilustrado por uma declaração SQL.
Calculando o total de aquisições de usuários
Conte o número de novos usuários únicos por canal de mídia e campanha.
SELECT DATE (event_time__conversion) AS install_date
,CASE
WHEN media_source IS NULL
OR media_source = ''
OR media_source = 'null'
THEN 'organic'
ELSE media_source
END AS media_source
,campaign_name
,count(DISTINCT customer_user_id) AS user_acquisition
,
FROM end_user_events_user_level_cross_platform
WHERE product_line_name = 'YOUR_PRODUCT_LINE_NAME'
GROUP BY install_date
,media_source
,campaign_name
Calculando o total de ativações de plataforma
Some o total de novos grupos, plataformas, canais de mídia e campanhas trazidos por usuário.
SELECT DATE (event_time__conversion) AS install_date
,CASE
WHEN media_source IS NULL
OR media_source = ''
OR media_source = 'null'
THEN 'organic'
ELSE media_source
END AS media_source
,campaign_name
,count(DISTINCT CASE
WHEN platform_group = 'PC'
THEN customer_user_id
ELSE NULL
END) + count(DISTINCT CASE
WHEN platform_group = 'CONSOLE'
THEN customer_user_id
ELSE NULL
END) + count(DISTINCT CASE
WHEN platform_group = 'CTV'
THEN customer_user_id
ELSE NULL
END) + count(DISTINCT CASE
WHEN platform_group = 'MOBILE'
THEN customer_user_id
ELSE NULL
END) + count(DISTINCT CASE
WHEN platform_group = 'Web'
THEN customer_user_id
ELSE NULL
END) + count(DISTINCT CASE
WHEN platform_group = 'Other'
THEN customer_user_id
ELSE NULL
END) AS total_activations
FROM end_user_events_user_level_cross_platform
WHERE product_line_name = 'YOUR_PRODUCT_LINE_NAME'
GROUP BY install_date
,media_source
,campaign_name
Calculando a receita total
Some a receita total por canal de mídia e campanha.
SELECT DATE (event_time__conversion) AS install_date
,CASE
WHEN media_source IS NULL
OR media_source = ''
OR media_source = 'null'
THEN 'organic'
ELSE media_source
END AS media_source
,campaign_name
,SUM(revenue_value_customer) AS total_revenue
FROM end_user_events_user_level_cross_platform
WHERE product_line_name = ’YOUR_PRODUCT_LINE_NAME’
GROUP BY install_date
,media_source
,campaign_name;