Carregue dados do Google Analytics 4 no BigQuery

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Nota: para receber apoio técnico ou enviar feedback sobre esta funcionalidade, contacte [e-mail]. Não contacte o apoio técnico do Google Analytics para esta funcionalidade.

Pode carregar dados do Google Analytics 4 para o BigQuery através do conetor do Serviço de transferência de dados do BigQuery para o Google Analytics 4. Com o Serviço de transferência de dados do BigQuery, pode agendar tarefas de transferência recorrentes que adicionam os seus dados mais recentes do Google Analytics 4 ao BigQuery.

Relatórios suportados

O Serviço de transferência de dados do BigQuery para o Google Analytics 4 suporta as seguintes opções de relatórios:

Opção de denúncia	Apoio técnico
Frequência de repetição	Diariamente, à hora em que a transferência de dados é criada pela primeira vez (predefinição) Pode configurar a hora do dia.
Atualizar janela	Últimos 4 dias (predefinição) Configurável até 30 dias
Duração máxima do preenchimento	Sem limite Embora o conector do Google Analytics não tenha uma duração máxima de preenchimento, pode encontrar erros ao preencher dados do histórico devido às definições de retenção de dados do Google Analytics.

Para ver informações sobre como os relatórios do Google Analytics 4 são transformados em tabelas e vistas do BigQuery, consulte o artigo Transformação de dados do Google Analytics 4.

Numa transferência do Google Analytics 4, o Serviço de transferência de dados do BigQuery transfere os seguintes relatórios para o BigQuery:

• Audiences
• Demographic details
• Ecommerce purchases
• Events
• Landing page
• Pages and screens
• Promotions
• Tech details
• Traffic Acquisition
• User Acquisition

Para mais informações acerca dos relatórios predefinidos disponíveis para o Google Analytics, consulte o artigo Relatórios predefinidos.

Carregamento de dados de transferências do Google Analytics 4

Quando transfere dados do Google Analytics 4 para o BigQuery, os dados são carregados em tabelas do BigQuery particionadas por data. A partição da tabela na qual os dados são carregados corresponde à data da origem de dados. Se agendar várias transferências para a mesma data, o Serviço de transferência de dados do BigQuery substitui a partição dessa data específica pelos dados mais recentes. As várias transferências no mesmo dia ou a execução de preenchimentos não resultam em dados duplicados, e as partições para outras datas não são afetadas.

Atualize as janelas

Um período de atualização é o número de dias que uma transferência de dados obtém dados quando ocorre uma transferência de dados. Por exemplo, se a janela de atualização for de três dias e ocorrer uma transferência diária, o Serviço de transferência de dados do BigQuery obtém todos os dados da tabela de origem dos últimos três dias. Neste exemplo, quando ocorre uma transferência diária, o Serviço de transferência de dados do BigQuery cria uma nova partição da tabela de destino do BigQuery com uma cópia dos dados da tabela de origem do dia atual e, em seguida, aciona automaticamente execuções de preenchimento para atualizar as partições da tabela de destino do BigQuery com os dados da tabela de origem dos últimos dois dias. As execuções de preenchimento automático acionadas automaticamente substituem ou atualizam incrementalmente a tabela de destino do BigQuery, consoante as atualizações incrementais sejam ou não suportadas no conector do Serviço de transferência de dados do BigQuery.

Quando executa uma transferência de dados pela primeira vez, a transferência de dados obtém todos os dados de origem disponíveis na janela de atualização. Por exemplo, se a janela de atualização for de três dias e executar a transferência de dados pela primeira vez, o Serviço de transferência de dados do BigQuery obtém todos os dados de origem no prazo de três dias.

Para obter dados fora do período de atualização, como dados do histórico, ou para recuperar dados de quaisquer indisponibilidades ou lacunas de transferência, pode iniciar ou agendar uma execução de preenchimento.

Antes de começar

Reveja os seguintes pré-requisitos e informações antes de criar uma transferência de dados do Google Analytics 4.

Pré-requisitos

• No Google Analytics 4, a conta de utilizador ou a conta de serviço tem de ter acesso de leitor ao ID da propriedade que é usado na configuração de transferência.
• Verifique se concluiu todas as ações necessárias para ativar o Serviço de transferência de dados do BigQuery.
• Crie um conjunto de dados do BigQuery para armazenar os dados do Google Analytics 4.
• Se pretender configurar notificações de execução de transferências para o Pub/Sub, certifique-se de que tem a autorização de pubsub.topics.setIamPolicygestão de identidade e de acesso (IAM). Se configurar apenas notificações por email, não são necessárias autorizações do Pub/Sub. Para mais informações, consulte Notificações de execução do Serviço de transferência de dados do BigQuery.

Funções do BigQuery necessárias

Para obter as autorizações de que precisa para criar uma transferência, peça ao seu administrador que lhe conceda a função de IAM de administrador do BigQuery (roles/bigquery.admin). Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para criar uma transferência. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para criar uma transferência:

• bigquery.transfers.update no utilizador
• bigquery.datasets.update no conjunto de dados de destino

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Configure uma transferência de dados do Google Analytics 4

Selecione uma das seguintes opções:

Consola

1. Aceda à página Transferências de dados na Google Cloud consola.

   Aceda a Transferências de dados

2. Clique em Criar transferência.

3. Na página Criar transferência, faça o seguinte:

   • Na secção Tipo de origem, para Origem, escolha Google Analytics 4.

4. Na secção Detalhes da origem de dados:

   • No campo ID da propriedade, introduza um ID da propriedade.
   • Opcional: no campo Filtro de tabelas, introduza uma lista de tabelas separada por vírgulas para incluir, por exemplo, Audiences, Events. Preceda esta lista com o caráter - para excluir determinadas tabelas, por exemplo, -Audiences, Events. Por predefinição, todas as tabelas são incluídas.
   • Opcional: no campo Período de atualização, introduza uma duração para o período de atualização em dias. O período de atualização tem um valor predefinido de quatro dias e pode ter um valor até 30 dias.

5. Na secção Definições de destino, no menu Conjunto de dados de destino, selecione o conjunto de dados que criou para armazenar os seus dados.

6. Na secção Nome da configuração de transferência, em Nome a apresentar, introduza um nome para a transferência de dados. O nome da transferência pode ser qualquer valor que lhe permita identificar a transferência se precisar de a modificar mais tarde.

7. Na secção Opções de programação:

   • Selecione Começar agora ou Começar à hora definida e, de seguida, indique uma data de início e um tempo de execução.
   • Para Repetições, escolha uma opção para a frequência de execução da transferência de dados. Se selecionar Dias, indique uma hora válida em UTC.

8. Opcional: no menu Conta de serviço, selecione uma conta de serviço nas contas de serviço associadas ao seu Google Cloud projeto. A conta de serviço selecionada tem de ter as funções necessárias para executar esta transferência de dados.

   Se iniciou sessão com uma identidade federada, é necessária uma conta de serviço para criar uma transferência de dados. Se iniciou sessão com uma Conta Google, uma conta de serviço para a transferência de dados é opcional. Para mais informações sobre a utilização de contas de serviço com transferências de dados, consulte o artigo Usar contas de serviço.

9. Opcional: na secção Opções de notificação:

   • Clique no botão para ativar as notificações por email. Quando ativa esta opção, o administrador da transferência recebe uma notificação por email quando uma execução de transferência falha.
   • Clique no botão para ativar as notificações do Pub/Sub. Em Selecionar um tópico do Cloud Pub/Sub, escolha o nome do tópico ou clique em Criar um tópico. Esta opção configura notificações de execução do Pub/Sub para a transferência.

10. Opcional: se usar CMEKs, na secção Opções avançadas, selecione Chave gerida pelo cliente. É apresentada uma lista das CMEKs disponíveis para que possa escolher. Para obter informações sobre como as CMEKs funcionam com o Serviço de transferência de dados do BigQuery, consulte o artigo Especifique a chave de encriptação com transferências.

11. Clique em Guardar.

bq

Introduza o comando bq mk e forneça a flag de criação de transferência — --transfer_config. As seguintes flags são obrigatórias:

• --data_source
• --target_dataset
• --display_name
• --params

  bq mk --transfer_config \
  --project_id=PROJECT_ID \
  --target_dataset=DATASET \
  --display_name=NAME \
  --params='PARAMETERS' \
  --data_source=DATA_SOURCE

Onde:

• PROJECT_ID: o ID do seu projeto. Se --project_id não for especificado, é usado o projeto predefinido.
• DATASET: o conjunto de dados de destino para a configuração de transferência de dados.
• NAME: o nome a apresentar da configuração de transferência de dados. O nome da transferência pode ser qualquer valor que lhe permita identificar a transferência se precisar de a modificar mais tarde.
• PARAMETERS: os parâmetros da configuração de transferência de dados criada no formato JSON, por exemplo, --params='{"param":"param_value"}'. Para transferências do Google Analytics 4, o parâmetro property_id é obrigatório.
• DATA_SOURCE: a origem de dados: ga4.

Por exemplo, o comando seguinte cria uma transferência de dados do Google Analytics 4 denominada My Transfer com o ID da propriedade 468039345 e o conjunto de dados de destino mydataset.

A transferência de dados é criada no projeto predefinido:

  bq mk --transfer_config
  --project_id=your_project
  --target_dataset=mydataset
  --display_name=My Transfer
  --params='{"property_id":"468039345"}'
  --data_source=ga4

API

Use o método projects.locations.transferConfigs.create e forneça uma instância do recurso TransferConfig.

Limitações

• Os totais agregados para utilizadores distintos e métricas de sessões podem não ser precisos e podem não corresponder aos valores no Google Analytics.

Especifique a chave de encriptação com transferências

Pode especificar chaves de encriptação geridas pelo cliente (CMEKs) para encriptar dados para uma execução de transferência. Pode usar uma CMEK para suportar transferências do Google Analytics 4.

Quando especifica uma CMEK com uma transferência, o Serviço de transferência de dados do BigQuery aplica a CMEK a qualquer cache intermédia no disco dos dados carregados, para que todo o fluxo de trabalho de transferência de dados esteja em conformidade com a CMEK.

Não é possível atualizar uma transferência existente para adicionar uma CMEK se a transferência não tiver sido criada originalmente com uma CMEK. Por exemplo, não pode alterar uma tabela de destino que foi originalmente encriptada por predefinição para ser encriptada com CMEK. Por outro lado, também não pode alterar uma tabela de destino encriptada com CMEK para ter um tipo de encriptação diferente.

Pode atualizar uma CMEK para uma transferência se a configuração de transferência tiver sido criada originalmente com uma encriptação CMEK. Quando atualiza uma CMEK para uma configuração de transferência, o Serviço de transferência de dados do BigQuery propaga a CMEK para as tabelas de destino na execução seguinte da transferência, em que o Serviço de transferência de dados do BigQuery substitui todas as CMEKs desatualizadas pela nova CMEK durante a execução da transferência. Para mais informações, consulte o artigo Atualize uma transferência.

Também pode usar as chaves predefinidas do projeto. Quando especifica uma chave predefinida do projeto com uma transferência, o Serviço de transferência de dados do BigQuery usa a chave predefinida do projeto como a chave predefinida para quaisquer novas configurações de transferência.

Preços

A execução de uma transferência do Google Analytics 4 não tem qualquer custo.

Depois de os dados serem transferidos para o BigQuery, aplicam-se os preços padrão de armazenamento e consultas do BigQuery.

Quota

As transferências do Google Analytics 4 estão sujeitas às quotas de propriedades do Analytics aplicadas pelo Google Analytics 4. Para permitir mais quota por propriedade, pode atualizar para o Google Analytics 360.