[Beta] Data Locker: relatório de eventos cross-platform realizados por usuários finais

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?

  1. Na AppsFlyer, no menu lateral, selecione Exportar > Data Locker.
  2. No painel de conteúdo do Data Locker, vá até a seção Relatórios avançados.
  3. 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;