设置 Google Analytics 4

Google Analytics 4 是一家已与 Adjust 集成的数据分析合作伙伴。我们的集成允许 Google Analytics 4 通过自动回传接收 Adjust 监测的数据。您可以使用合作伙伴的工具进行数据分析并获取洞见。

在本文中了解如何为您的应用设置 Google Analytics 4 监测，其中包括激活集成，以及选择 Adjust 可以与 Google Analytics 4 分享的数据。

操作前须知

要求​

• Adjust 中的管理员、编辑员或自定义编辑员权限。
• Adjust SDK v4.0.0 或更新版本，以便将 SDK 参数映射至 Google Analytics 4 参数。按照以下指南使用此功能。

iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

凭证​

Firebase App ID (for mobile apps), Measurement ID (for web apps), API Secret

• 如需帮助查找凭证，请联系您的 Google Analytics 4 代表。

在您的 Google Analytics 4 控制面板中：​

要获取 Firebase App ID：

1. 前往Firebase 控制台
2. 找到并点击您的项目
3. 在左侧面板中点击齿轮图标 > 项目概览 (Project Overview) 旁的项目设置 (Project settings)
4. 在您的应用 (Your apps) 下选择您的应用并在 App ID 下找到 Firebase App ID

要获取 API 密钥:

1. 前往Google Analytics 控制面板
2. 选择管理 (Admin) > 数据收集和修改 (Data collection and modification) > 数据流 (Data streams)
3. 选择应用的数据流，然后在 Measurement Protocol API 密钥 (Measurement Protocol API secrets)> 密钥值 (Secret value) 下找到您的 API 密钥
4. 如果没有 API 密钥，请在 Measurement Protocol API 密钥下选择创建，输入名称并创建

在 Campaign Lab 中选择 Google Analytics 4 和应用

1. 找到 Campaign Lab​ ，选择 合作伙伴​ 。
2. 选择 新合作伙伴​ > Google Analytics 4​ 。选择 下一步​ 进入下一界面。
3. 在 应用选择​ 界面选择要创建链接的应用，启用集成来与 Google Analytics 4 分享数据。
4. 选择 下一步​ 。

启用数据分享

启用数据分享以激活与 Google Analytics 4 的集成。要启用数据分享：

1. 输入您的 Firebase App ID (for mobile apps), Measurement ID (for web apps), API Secret。

启用与 Google Analytics 4 的数据分享后，Adjust 会默认自动向 Google Analytics 4 发送以下数据：

• 安装
• 再归因

设置数据分享

如果您的多平台应用启用了多个平台的数据分享，那么可以：

1. 通过选择 使用平台特定设置​ 来在平台层级区分数据共享设置。
2. 通过选择 使用全局设置​ 来为多个平台应用相同的数据共享设置。

在 哪些数据会默认分享？​ 部分, 查看 Adjust 默认与 Google Analytics 4 分享的活动：

• 安装
• 再归因

发送额外数据

选择您想通过回传与 Google Analytics 4 分享的数据量和数据类型。Google Analytics 4 可能会使用此信息来优化表现。

要发送额外数据，您可以查看并自定义以下选项：

应用内收入 (来自应用内购买)

通过应用内收入分享，Google Analytics 4 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件，才能分享该数据。

映射事件

将您想分享的事件映射到 Google Analytics 4 可以接收的值。未映射事件的数据不会被发送至 Google Analytics 4。

映射单个事件

如果您的应用为多平台应用，则可以选择按平台与 Google Analytics 4 分享不同事件。这有助于您：

• 通过设定单个事件来管理不同平台的推广活动策略。
• 按平台自定义数据分享。

在 映射事件​ 中，按照以下步骤选择要直接发送至 Google Analytics 4 的应用内事件。

1. 选择 映射事件​ 。

2. 在 Adjust 事件​ 列表中，选择要与 Google Analytics 4 分享的 Adjust 事件。

3. 在 合作伙伴事件​ 下，您需要选择与 Adjust 事件对应的 Google Analytics 4 事件。

   1. 对于单平台应用和仅针对一个平台启用了数据共享的多平台应用，您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用，您可以：

      • 选择 使用平台特定映射​ 来在平台层级映射单独事件或不针对某些平台映射事件。
      • 选择 使用全局映射​ 来为所有平台映射相同的事件。

   2. 打开 合作伙伴​ 列表，选择要映射到 Adjust 事件的渠道事件，或输入自定义事件名称。

4. 选择 确认​ 。

现在 Google Analytics 4 将接收每个关联事件的应用内事件数据。

映射全部事件

如果 Google Analytics 4 支持自动映射所有事件，则在 映射事件​ 下选择 映射全部事件​ ，这能够省去映射单个事件的时间。

现在 Google Analytics 4 将接收所有关联事件的应用内事件数据。

映射参数

要与 Google Analytics 4分享自定义数据，您通常需要映射参数。

合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点，并将其发送至 Google Analytics 4。借此，Google Analytics 4 可以接收每个已关联事件的自定义事件详情。

在向 Adjust SDK 添加新的合作伙伴参数之前，请确保现有的合作伙伴参数均不符合您的要求。

如需与 Google Analytics 4 分享合作伙伴参数，请遵循以下步骤。

1. 在 Adjust SDK 中设置合作伙伴参数。

   • 在操作前须知部分查看所有 SDK 开发平台链接。

2. 在 设置数据分享​ 下，选择 参数​ 。

3. 打开 映射参数​ ，选择如何向渠道发送 SDK 中指定的合作伙伴参数。

   1. 选择 映射参数​ 。
   2. 在 SDK 参数​ 字段中输入要与渠道分享的 SDK 参数名称。
   3. 在 合作伙伴参数​ 字段中输入 SDK 参数对应的渠道参数。

为您的应用启用 Google Analytics 4

在 设置概览​ 界面，您可以检查自己的选择，也可以返回并更改以下内容：

• 所选应用
• 数据分享选项

选择 启用合作伙伴​ ，为您的应用启用 Google Analytics 4 。数据分析合作伙伴不使用推广活动链接。启用合作伙伴后，我们的集成会通过自动回传发送归因和应用内事件数据。

合作伙伴特定设置说明

通过我们的 Google Analytics 4 (简称 GA4) 集成​ ，Adjust 可以向 Google Analytics 发送跨渠道归因数据。如果您已经在使用 Google Analytics for Firebase SDK​ 或 Google Analytics 4 for web​ 记录转化，请启用该集成。Adjust 利用 Measurement Protocol API​ 中的 campaign_details 事件发送转化和归因详情。

要求

该集成能同时支持 移动应用和基于网页的应用​ ：

• 针对移动应用：​

  • 您必须在应用中集成 Firebase SDK​ 。
  • 须有 Firebase App ID​ 。
  • 必须在 Adjust SDK 中实装 会话合作伙伴参数​ ，才能捕捉和发送 Google Analytics 4 的 app_instance_id。
  • 您应当在 Adjust SDK 初始化之前设置 app_instance_id​ 。

• 针对基于网页的应用：​

  • 须要 GA4 web property 的 Measurement ID​ 。
  • 必须在 Adjust SDK 中实装 会话合作伙伴参数​ ，才能捕捉和发送 Google Analytics 4 的 client_id。
  • 您应当在 Adjust SDK 初始化之前设置 client_id​ 。

Google Analytics 4 需要使用这些标识符 (移动端 app_instance_id 和网页端 client_id) 识别和区分每个用户或应用实例，因此这些标识符必不可少。如果不能正确跟踪并发送这些值，Adjust 就无法向 Google Analytics 触发回传。

按照以下指南使用此功能：

iOS / 安卓 / Unity / Flutter / React Native

受支持的应用内事件

Google Analytics 4 集成支持下列应用内事件：

• 加入购物车​
• 查看购物车​
• 开始结账​
• 登录​
• 购买​
• 加入收藏​
• 注册​

部分事件需要以 SDK 合作伙伴参数​ 形式发送额外的值：

在触发这些事件时，请务必发送必要的 SDK 合作伙伴参数。如果必要合作伙伴参数缺失，Adjust 在向 Google Analytics 4 发送事件时就无法提供集成所需的信息。

备注

• 此集成 不会分享​ 自然流量​ 。
• 由于归因方法的差异， Google Analytics 不接受早于 3 天前的转化​ 。
• GA4 可能不会报告部分转化，因此您或许会发现数据差异问题，具体视您的 Adjust 链接归因窗口而定​ 。

关于 Session ID

您可以通过会话合作伙伴参数 ​ga4_session_id​ 发送 Firebase Session ID。

关于用户 ID

您可以通过会话合作伙伴参数 ​ga4_session_id​ 发送 Firebase User ID。

转发给 Google Analytics 4 的所有参数列表

Google Analytics 4 要求 Adjust 在回传中发送以下参数 (数据点)：