A personalização do Configuração remota registra um evento personalization_assignment do Analytics quando uma personalização é atribuída a um usuário, permitindo que você use o BigQuery para inspecionar e analisar eventos de personalização e eventos associados.
As seções a seguir descrevem como ativar a exportação do BigQuery para eventos do Analytics, como os eventos de personalização são armazenados e fornecem algumas consultas básicas para você começar.
Ativar a exportação do BigQuery para Google Analytics para Firebase
Se você estiver no plano Spark, poderá usar o sandbox do BigQuery para acessar o BigQuery sem nenhum custo, sujeito aos limites do sandbox . Consulte Preços e sandbox do BigQuery para mais informações.
Primeiro, certifique-se de exportar seus dados do Analytics para o BigQuery:
- Abra a guia Integrações , que você pode acessar em > Configurações do projeto no console do Firebase .
- Se você já usa o BigQuery com outros serviços do Firebase, clique em Gerenciar . Caso contrário, clique em Link .
- Revise Sobre como vincular o Firebase ao BigQuery e clique em Avançar .
- Na seção Configurar integração , ative a alternância do Google Analytics .
Selecione uma região e escolha as configurações de exportação.
Clique em Vincular ao BigQuery .
Dependendo de como você escolheu exportar os dados, pode levar até um dia para que as tabelas fiquem disponíveis. Para obter mais informações sobre como exportar dados do projeto para o BigQuery, consulte Exportar dados do projeto para o BigQuery .
A seguir, vamos acessar e inspecionar nossos eventos de personalização no BigQuery.
Acessar dados de personalização do Configuração remota usando o BigQuery
Para consultar dados analíticos de uma experiência:
- Abra o BigQuery no console do Google Cloud . Você também pode abri-lo diretamente no Analytics Events usando o link visualizar seus eventos brutos no BigQuery na parte inferior da página.
Selecione seu projeto do Firebase e expanda-o, depois expanda a entrada
analytics_ ANALYTICS_PROPERTY_IDe clique emevents_.
No menu suspenso Consulta , selecione Em uma nova guia .
Um exemplo de consulta gerado automaticamente é exibido.
Para visualizar eventos de personalização e dados associados, atualize a consulta para selecionar eventos
personalization_assignment. O exemplo de consulta a seguir retornará um evento de atribuição de personalização completo para um fragmento de data específico, limitando os resultados a 10:# Select all personalization_assignment events SELECT * FROM `PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_DATE_SHARD` WHERE event_name = 'personalization_assignment' LIMIT 10Dica: Para pesquisar todas as tabelas de eventos em vez da tabela fragmentada, você pode substituir a data da tabela de eventos por um asterisco (por exemplo,
PROJECT_NAME .analytics_ ANALYTICS_PROPERTY_ID .events_*). Isso não é recomendado em cenários que não sejam de teste ou para grandes conjuntos de dados.No compositor de consulta, selecione Executar consulta. Os resultados aparecem no painel inferior.
Na próxima seção, discutiremos com mais detalhes o que está incluído em um evento de atribuição de personalização.
Quais dados de personalização são exportados para o BigQuery?
Os dados de personalização são incluídos nas tabelas do Google Analytics no BigQuery e armazenados em eventos personalization_assignment .
Os campos básicos fornecidos em um evento de personalização são iguais a qualquer evento do Analytics, conforme descrito em [GA4] Esquema do BigQuery Export . Você se preocupará principalmente com user_pseudo_id i (que pode ser usado para diferenciar usuários distintos), carimbos de data e hora de eventos e outras propriedades do usuário.
Os detalhes específicos da personalização são armazenados no campo event_params e descritos na tabela a seguir:
| Parâmetro | Tipo de dados | Descrição |
|---|---|---|
| personalização_id | CORDA | Fornece o UUID (identificador universal exclusivo) da personalização atribuída. |
| grupo | CORDA | Indica se o usuário foi atribuído ao grupo de personalização (P13N) ou ao grupo de linha de base (BASELINE). |
| arm_index | INTEIRO | Representa o valor alternativo atribuído ao usuário, um número inteiro entre 0 e 4. |
| arm_key | CORDA | Contém o nome do parâmetro usado pela personalização. |
| valor_braço | CORDA | Contém a sequência de valores alternativa atribuída pela personalização. |
| evento_sessão_engajada | INTEIRO | Inclui o número de sessões nas quais o usuário está envolvido. Consulte Sobre sessões para obter mais informações. |
| firebase_event_origin | CORDA | Indica a origem do evento. Sempre será fp para eventos personalization_assignment . |
| firebase_screen_class | CORDA | Fornece o nome da classe da tela na qual o usuário estava ativo quando ocorreu a atribuição de personalização. Consulte Eventos coletados automaticamente para obter mais informações. |
| firebase_screen_id | INTEIRO | Exibe o ID da tela em que o usuário estava quando ocorreu a atribuição de personalização. Consulte Eventos coletados automaticamente para obter mais informações. |
| first_open_time | CORDA | Fornece o carimbo de data/hora, em milissegundos UTC, da primeira vez que o usuário abriu o aplicativo. Consulte Eventos coletados automaticamente para obter mais informações. |
| ga_session_id | INTEIRO | Fornece o ID da sessão do Google Analytics. Consulte Sobre sessões para obter mais informações. Você pode usar isso para correlacionar o evento personalization_assignment com outros eventos do Analytics. |
| ga_session_number | INTEIRO | Fornece o número da sessão do Google Analytics. Consulte Sobre sessões para obter mais informações. |
Consultas de exemplo
Você pode usar uma instrução SQL como a seguinte para extrair os parâmetros específicos de personalização de eventos personalization_assignment :
# Expand nested personalization parameters
SELECT
timestamp_micros(event_timestamp) AS event_time,
user_pseudo_id,
(
SELECT event_params.value.string_value
FROM UNNEST(event_params) event_params
WHERE event_params.key = 'group'
) AS personalization_group,
(
SELECT event_params.value.string_value
FROM UNNEST(event_params) event_params
WHERE event_params.key = 'personalization_id'
) AS personalization_id,
(
SELECT event_params.value.string_value,
FROM UNNEST(event_params) event_params
WHERE event_params.key = 'arm_key'
) AS arm_key,
(
SELECT event_params.value.string_value
FROM UNNEST(event_params) event_params
WHERE event_params.key = 'arm_value'
) AS arm_value,
(
SELECT event_params.value.int_value
FROM UNNEST(event_params) event_params
WHERE event_params.key = 'ga_session_id'
) AS ga_session_id,
FROM `PROJECT_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
WHERE event_name = 'personalization_assignment'
LIMIT 10