Inspecione dados de personalização com o BigQuery

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.

Dica: você também pode visualizar eventos personalization_assignment na página Eventos do Firebase Analytics e visualizar um gráfico detalhado de resultados na página de resultados de personalização do Configuração remota .

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:

1. Abra a guia Integrações , que você pode acessar em > Configurações do projeto no console do Firebase .
2. Se você já usa o BigQuery com outros serviços do Firebase, clique em Gerenciar . Caso contrário, clique em Link .
3. Revise Sobre como vincular o Firebase ao BigQuery e clique em Avançar .
4. Na seção Configurar integração , ative a alternância do Google Analytics .

5. Selecione uma região e escolha as configurações de exportação.

   Observação: para obter mais informações sobre as configurações do Google Analytics para Firebase, consulte Coleta de dados .

6. 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:

1. 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.

2. Selecione seu projeto do Firebase e expanda-o, depois expanda a entrada analytics_ ANALYTICS_PROPERTY_ID e clique em events_ .

   

3. No menu suspenso Consulta , selecione Em uma nova guia .

   Um exemplo de consulta gerado automaticamente é exibido.

4. 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 10
   

   Dica: 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.

5. No compositor de consulta, selecione Executar consulta. Os resultados aparecem no painel inferior.

Observação: se você não estiver transmitindo dados do Analytics, os dados do Firebase no BigQuery serão atualizados apenas uma vez por dia. Portanto, os dados disponíveis na página do experimento podem estar mais atualizados do que os dados disponíveis no console do BigQuery.

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