Agendar uma transferência do Google Analytics 4

Com o serviço de transferência de dados do BigQuery para o conector do Google Analytics 4, é possível programar e gerenciar automaticamente jobs de carregamento recorrentes para dados de configuração e relatórios do Google Analytics 4.

Relatórios compatíveis

O serviço de transferência de dados do BigQuery para o Google Analytics 4 é compatível com as seguintes opções de relatórios:

Opção de relatório Suporte
Repetir frequência

Diariamente, no horário em que a transferência de dados foi criada pela primeira vez (padrão)

Você pode configurar a hora do dia.
Atualizar janela

Últimos 4 dias (padrão)

Configurável para até 30 dias

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

Em uma 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
  • Conversions
  • Demographic details
  • Ecommerce purchases
  • Events
  • In-app purchases
  • Landing page
  • Pages and screens
  • Promotions
  • Tech details
  • Traffic Acquisition
  • User Acquisition

Para mais informações sobre os relatórios predefinidos disponíveis no Google Analytics, consulte Relatórios predefinidos.

Ingestão de dados de transferências do Google Analytics 4

Ao transferir dados do Google Analytics 4 para o BigQuery, eles são carregados em tabelas do BigQuery particionadas por data. A partição da tabela em que os dados são carregados corresponde à data da fonte de dados. Se você programar várias transferências para a mesma data, o serviço de transferência de dados do BigQuery substituirá a partição dessa data específica pelos dados mais recentes. Várias transferências no mesmo dia ou preenchimentos não resultam em dados duplicados, e as partições de outras datas não são afetadas.

Atualizar janelas

Uma janela de atualização é o número de dias que uma transferência de dados recupera dados quando ocorre uma transferência de dados. Por exemplo, se a janela de atualização for de três dias e uma transferência diária ocorrer, o serviço de transferência de dados do BigQuery vai extrair todos os dados da tabela de origem dos últimos três dias. Nesse exemplo, quando uma transferência diária ocorre, o serviço de transferência de dados do BigQuery cria uma nova partição de tabela de destino do BigQuery com uma cópia dos dados da tabela de origem do dia atual e, em seguida, aciona automaticamente as execuções de preenchimento para atualizar as partições de 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 vão substituir ou atualizar de forma incremental a tabela de destino do BigQuery, dependendo de se as atualizações incrementais são aceitas ou não pelo conector do serviço de transferência de dados do BigQuery.

Quando você executa uma transferência de dados pela primeira vez, ela recupera 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 você executar a transferência de dados pela primeira vez, o serviço de transferência de dados do BigQuery vai extrair todos os dados de origem em três dias.

As janelas de atualização são mapeadas para o campo da APITransferConfig.data_refresh_window_days.

Para recuperar dados fora da janela de atualização, como dados históricos, ou para recuperar dados de interrupções ou lacunas de transferência, inicie ou programe uma execução de preenchimento.

Antes de começar

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

Pré-requisitos

Papéis obrigatórios do BigQuery

Para receber as permissões necessárias para criar uma transferência, peça ao administrador para conceder a você o papel do IAM de Administrador do BigQuery (roles/bigquery.admin). Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para criar uma transferência. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para criar uma transferência:

  • bigquery.transfers.update no usuário
  • bigquery.datasets.update no conjunto de dados de destino

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Configurar uma transferência de dados do Google Analytics 4

Selecione uma das seguintes opções:

Console

  1. Acesse a página Transferências de dados no console do Google Cloud.

    Acesse Transferências de dados

  2. Clique em Criar transferência.

  3. Na página Criar transferência, realize estas ações:

    • Na seção Tipo de origem, em Origem, escolha Google Analytics 4.

  4. Na seção Detalhes da fonte de dados:

    • No campo ID da propriedade, insira um ID da propriedade.
    • Opcional: no campo Período de atualização, insira a duração do período de atualização em dias. A janela de atualização tem um valor padrão de quatro dias e pode ser de até 30 dias.

  5. Na seção Configurações de destino, no menu Conjunto de dados de destino, selecione o conjunto de dados que você criou para armazenar os dados.

  6. No campo Nome de exibição, na seção Nome de configuração da transferência, insira um nome para a transferência de dados. O nome da transferência pode ser qualquer valor que permita identificá-la, caso você precise modificá-la mais tarde.

  7. Na seção Opções de programação, faça o seguinte:

    • Selecione Começar agora ou Começar no horário definido e apresente uma data de início e um horário de execução.
    • Em Repetições, escolha uma opção para a frequência de execução da transferência de dados. Se você selecionar Dias, forneça um horário válido em UTC.

  8. Opcional: no menu Conta de serviço, selecione uma conta de serviço entre aquelas associadas ao seu projeto do Google Cloud . A conta de serviço selecionada precisa ter os papéis necessários para executar essa transferência de dados.

    Se você fez login com uma identidade federada, é necessário uma conta de serviço para criar uma transferência de dados. Se você fez login com uma Conta do Google, uma conta de serviço para a transferência de dados é opcional. Para mais informações sobre o uso de contas de serviço com transferências de dados, consulte Usar contas de serviço.

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

    • Clique no botão para ativar as notificações por e-mail. Quando você ativa essa opção, o administrador de transferência recebe uma notificação por e-mail se uma execução de transferência falhar.
    • 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. Essa opção configura notificações de execução do Pub/Sub para sua transferência.

  10. Clique em Salvar.

bq

Insira o comando bq mk e forneça a sinalização de execução da transferência --transfer_config. As sinalizações a seguir são necessá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

Em que:

  • PROJECT_ID: o ID do projeto. Se --project_id não for especificado, o projeto padrão será usado.
  • DATASET: o conjunto de dados de destino na configuração da transferência de dados.
  • NAME: o nome de exibição da configuração da transferência de dados. O nome da transferência pode ser qualquer valor que permita identificá-la facilmente, caso precise modificá-la 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 fonte de dados — ga4.

Por exemplo, o comando a seguir cria uma transferência de dados do Google Analytics 4 chamada My Transfer usando o ID da propriedade 468039345, com o conjunto de dados de destino mydataset.

A transferência de dados é criada no projeto padrão:

  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.

Especificar a chave de criptografia com transferências

É possível especificar chaves de criptografia gerenciadas pelo cliente (CMEKs, na sigla em inglês) para criptografar dados de uma execução de transferência. É possível usar uma CMEK para dar suporte a transferências do Google Analytics 4.

Quando você especifica uma CMEK com uma transferência, o serviço de transferência de dados do BigQuery aplica a CMEK a qualquer cache intermediário no disco de dados ingeridos para que todo o fluxo de trabalho de transferência de dados fique em conformidade com a CMEK.

Não é possível atualizar uma transferência atual para adicionar uma CMEK se a transferência não tiver sido criada originalmente com uma CMEK. Por exemplo, não é possível alterar uma tabela de destino que, originalmente, estava criptografada por padrão, para ser criptografada com CMEKs. Por outro lado, também não é possível alterar uma tabela de destino criptografada por CMEK para ter um tipo diferente de criptografia.

É possível atualizar uma CMEK para uma transferência se a configuração de transferência tiver sido criada originalmente com uma criptografia CMEK. Quando você 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 próxima execução 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 saber mais, consulte Atualizar uma transferência.

Também é possível usar as chaves padrão do projeto. Quando você especifica uma chave padrão do projeto com uma transferência, o serviço de transferência de dados do BigQuery a usa como padrão para qualquer nova configuração de transferência.

Preços

Não há custo para fazer uma transferência do Google Analytics 4.

Assim que os dados são transferidos para o BigQuery, são aplicados os preços padrão de armazenamento e consulta do BigQuery.

Cota

As transferências do Google Analytics 4 estão sujeitas às cotas de propriedade do Google Analytics, conforme aplicadas pelo Google Analytics 4. Para permitir mais cota por propriedade, faça upgrade para o Google Analytics 360.