安排 Google Analytics 4 转移

借助适用于 Google Analytics 4 的 BigQuery Data Transfer Service 连接器，您可以自动安排和管理 Google Analytics 4 报告和配置数据的周期性加载作业。

支持的报告

适用于 Google Analytics 4 的 BigQuery Data Transfer Service 支持以下报告选项：

报告选项 支持
重复频率

每天在首次创建数据转移作业之时（默认值）

您可以配置一天中的具体时间。
刷新时段

过去 4 天（默认）

最多可配置 30 天

如需了解 Google Analytics 4 报告如何转换为 BigQuery 表和视图，请参阅 Google Analytics 4 数据转换。

在 Google Analytics 4 转移中，BigQuery Data Transfer Service 会将以下报告传输到 BigQuery：

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

如需详细了解 Google Analytics 提供的预定义报告，请参阅预定义报告。

从 Google Analytics 4 转移作业中提取数据

当您将数据从 Google Analytics 4 转移到 BigQuery 时，系统会将数据加载到按日期分区的 BigQuery 表中。数据加载到的表分区对应于数据源中的日期。如果您在同一日期安排多次转移，BigQuery Data Transfer Service 会使用最新数据覆盖该特定日期的分区。同一天的多个转移作业或正在运行的回填不会导致重复数据，其他日期的分区不受影响。

刷新时段

刷新时段是指发生数据转移时数据转移检索数据的天数。例如，如果刷新时段为三天，并且每天进行转移，则 BigQuery Data Transfer Service 会从过去三天内的源表中检索所有数据。在此示例中，当每天进行转移时，BigQuery Data Transfer Service 会使用当前日期的源表数据副本创建新的 BigQuery 目标表分区，然后自动触发回填运行作业，以使用过去两天的源表数据来更新 BigQuery 目标表分区。自动触发的回填运行作业会覆盖或以增量方式更新 BigQuery 目标表，具体取决于 BigQuery Data Transfer Service 连接器是否支持增量更新。

首次运行数据转移作业时，数据转移作业会检索刷新时段内可用的所有源数据。例如，如果刷新时段为三天，并且您首次运行数据转移作业，则 BigQuery Data Transfer Service 会检索三天内的所有源数据。

刷新时段会映射到 TransferConfig.data_refresh_window_days API 字段。

如需检索刷新时段之外的数据（例如历史数据），或在出现任何转移中断或缺口时恢复数据，您可以启动或安排回填运行作业。

准备工作

在创建 Google Analytics 4 数据转移作业之前，请查看以下前提条件和信息。

前提条件

所需 BigQuery 角色

如需获得创建转移作业所需的权限，请让管理员向您授予 BigQuery Admin (roles/bigquery.admin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色可提供创建转移作业所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

创建转移作业需要以下权限：

  • 针对用户的 bigquery.transfers.update 权限
  • 针对目标数据集的 bigquery.datasets.update 权限

您也可以使用自定义角色或其他预定义角色来获取这些权限。

设置 Google Analytics 4 数据传输

从下列选项中选择一项：

控制台

  1. 前往 Google Cloud 控制台中的数据传输页面。

    转到“数据传输”

  2. 点击 创建转移作业。

  3. 在创建转移作业页面上，执行以下操作：

    • 在来源类型部分的来源中，选择 Google Analytics 4。

  4. 在数据源详细信息部分，执行以下操作：

    • 在媒体资源 ID 字段中，输入媒体资源 ID。
    • 可选：在刷新时段字段中，输入刷新时段的时长（以天为单位）。刷新时段的默认值为 4 天，最长可设置为 30 天。

  5. 在目标设置部分的目标数据集菜单中，选择您创建用来存储数据的数据集。

  6. 在转移配置名称部分的显示名称中，输入数据转移作业的名称。转移作业名称可以是任何可让您以后在需要修改转移作业时识别该转移作业的值。

  7. 在时间表选项部分中，执行以下操作：

    • 选择立即开始或在设置的时间开始，然后提供开始日期和运行时间。
    • 在重复频率部分，从以下选项中选择数据转移作业的运行频率。如果您选择天，请提供世界协调时间 (UTC) 的有效时间。

  8. 可选：在服务账号菜单中，从与您的 Google Cloud 项目关联的服务账号中选择一个服务账号。所选服务账号必须具有所需的角色才能运行此数据转移作业。

    如果您使用联合身份登录，则需要有服务账号才能创建数据转移作业。如果您使用 Google 账号登录，则数据转移作业的服务账号是可选的。如需详细了解如何将服务账号用于数据转移，请参阅使用服务账号。

  9. 可选：在通知选项部分中，执行以下操作：

    • 点击切换开关以启用电子邮件通知。启用此选项后，转移作业管理员会在转移作业运行失败时收到电子邮件通知。
    • 点击切换开关以启用 Pub/Sub 通知。在选择 Cloud Pub/Sub 主题字段中，选择主题名称或点击创建主题。此选项用于为您的转移作业配置 Pub/Sub 运行通知。

  10. 点击保存。

bq

输入 bq mk 命令并提供转移作业创建标志 --transfer_config。以下标志是必需的：

  • --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

其中：

  • PROJECT_ID：您的项目 ID。 如果未指定 --project_id，系统会使用默认项目。
  • DATASET：数据转移作业配置的目标数据集。
  • NAME：数据转移作业配置的显示名称。转移作业名称可以是任何可让您在需要修改转移作业时识别该转移作业的名称。
  • PARAMETERS：所创建数据转移作业配置的参数（采用 JSON 格式），例如 --params='{"param":"param_value"}'。对于 Google Analytics 4 转移，property_id 参数是必需的。
  • DATA_SOURCE：数据源，ga4。

例如，以下命令使用媒体资源 ID 468039345 和目标数据集 mydataset 创建一个名为 My Transfer 的 Google Analytics 4 数据转移作业。

该数据转移作业将在默认项目中创建：

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

API

使用 projects.locations.transferConfigs.create 方法并提供一个 TransferConfig 资源实例。

使用转移作业指定加密密钥

您可以指定客户管理的加密密钥 (CMEK) 来加密转移作业运行的数据。您可以使用 CMEK 支持来自 Google Analytics 4 的转移作业。

当您使用转移作业指定 CMEK 时，BigQuery Data Transfer Service 会将 CMEK 应用于所注入数据的任何中间磁盘缓存，从而使整个数据转移工作流符合 CMEK 的规定。

如果最初不是使用 CMEK 创建转移作业，则无法更新现有转移作业来添加 CMEK。例如，您无法将最初默认加密的目标表更改为现在使用 CMEK 加密。反之，您也无法将 CMEK 加密的目标表更改为采用其他类型的加密。

如果转移配置最初是使用 CMEK 加密创建的，则可以为转移作业更新 CMEK。当您为转移配置更新 CMEK 时，BigQuery Data Transfer Service 会在下次运行转移作业时将 CMEK 传播到目标表，其中 BigQuery Data Transfer Service 会在转移作业运行期间将所有过时的 CMEK 替换为新的 CMEK。如需了解详情，请参阅更新转移作业。

您也可以使用项目默认密钥。当您使用转移作业指定项目默认密钥时，BigQuery Data Transfer Service 会将项目默认密钥用作任何新转移配置的默认密钥。

价格

运行 Google Analytics 4 转移无需支付费用。

将数据转移到 BigQuery 后，您需要按标准的 BigQuery 存储和查询价格付费。

配额

Google Analytics 4 转移受 Google Analytics 4 强制执行的 Google Analytics 媒体资源配额的约束。如需为每个媒体资源分配更多配额，您可以升级到 Google Analytics 360。