设置 Google Analytics 4
Google Analytics 4 是一家已与 Adjust 集成的数据分析合作伙伴。通过我们的集成,Adjust 可以向 Google Analytics 发送跨渠道归因数据。如果您已经在使用 Google Analytics for Firebase SDK 记录转化,请启用该集成。Adjust 利用 Measurement Protocol API 中的 campaign_details
事件发送转化和归因详情。
在本文中了解如何为您的应用设置 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, API Secret
查找您的凭证
要获取 Firebase App ID:
- 前往 Firebase 控制台。
- 找到并选择您的项目。
- 选择 设置 (齿轮图标),然后点击左侧面板中的 项目设置 (Project settings)。
- 在 您的应用 (Your apps) 下选择您的应用,然后找到 应用 ID (App ID)。
- 找到并复制您的 Firebase App ID 。
要获取 API 密钥:
- 前往 Google Analytics 控制面板。
- 选择 管理 (Admin) > 数据收集和修改 (Data collection and modification) > 数据流 (Data streams) 。
- 选择应用的数据流,然后选择 Measurement Protocol API 密钥 (Measurement Protocol API secrets)> 密钥值 (Secret value) 。
- 找到并复制您的 API 密钥 (API secret) 。
- 如果您还没有 API 密钥,请在 Measurement Protocol API 密钥 下选择 创建 (Create) 。
- 输入名称然后选择 创建 。
Firebase SDK 集成
要使用该集成,您需要将 Firebase SDK 集成到应用中,并在 Adjust SDK 中集成会话合作伙伴参数。之所以会有此要求是因为 Google Analytics 4 会为包含 Firebase SDK 的应用的每个安装实例创建一个 app_instance_id
。如果没有正确记录和传递 app_instance_id
,Adjust 将不会向 Google Analytics 发送回传。
按照以下指南使用此功能:
iOS | 安卓 | Unity | Flutter | React Native
通过会话合作伙伴参数,Adjust SDK 可以跟踪 Google Analytics 4 的 app_instance_id
并在向 Google Analytics 4 发送数据时包含该值。您应当在 Adjust SDK 初始化之前设置 app_instance_id
。
此集成不会分享自然流量。由于归因方法的差异,Google Analytics 不接受早于 3 天前的转化。根据您为链接配置的不同归因窗口,Google Analytics 4 可能不会报告部分转化,从而导致数据差异。
在 Campaign Lab 中选择 Google Analytics 4 和应用
- 找到 Campaign Lab ,选择 合作伙伴 。
- 选择 新合作伙伴 > Google Analytics 4 。选择 下一步 进入下一界面。
- 在 应用选择 界面选择要创建链接的应用,启用集成来与 Google Analytics 4 分享数据。
- 选择 下一步 。
启用数据分享
启用数据分享以激活与 Google Analytics 4 的集成。要启用数据分享:
- 输入您的 Firebase App ID, API Secret。
启用与 Google Analytics 4 的数据分享后,Adjust 会默认自动向 Google Analytics 4 发送以下数据:
- install
- reattribution
设置数据分享
如果您的多平台应用启用了多个平台的数据分享,那么可以:
- 通过选择 使用平台特定设置 来在平台层级区分数据共享设置。
- 通过选择 使用全局设置 来为多个平台应用相同的数据共享设置。
映射参数
要与 Google Analytics 4分享自定义数据,您通常需要映射参数。
合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点,并将其发送至 Google Analytics 4。借此,Google Analytics 4 可以接收每个已关联事件的自定义事件详情。
在向 Adjust SDK 添加新的合作伙伴参数之前,请确保现有的合作伙伴参数均不符合您的要求。
如需与 Google Analytics 4 分享合作伙伴参数,请遵循以下步骤。
在 Adjust SDK 中设置合作伙伴参数。
- 在操作前须知部分查看所有 SDK 开发平台链接。
在 设置数据分享 下,选择 参数 。
打开 映射参数 ,选择如何向渠道发送 SDK 中指定的合作伙伴参数。
- 选择 映射参数 。
- 在 SDK 参数 字段中输入要与渠道分享的 SDK 参数名称。
- 在 合作伙伴参数 字段中输入 SDK 参数对应的渠道参数。
如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享,那么 Adjust 会按照 Adjust SDK 中的名称发送参数。
为您的应用启用 Google Analytics 4
在 设置概览 界面,您可以检查自己的选择,也可以返回并更改以下内容:
- 所选应用
- 数据分享选项
选择 启用合作伙伴 ,为您的应用启用 Google Analytics 4 。数据分析合作伙伴不使用推广活动链接。启用合作伙伴后,我们的集成会通过自动回传发送归因和应用内事件数据。
转发给 Google Analytics 4 的所有参数列表
Google Analytics 4 要求 Adjust 在回传中发送以下参数 (数据点):
占位符 | 信息 |
{adgroup_name} | 广告组名称,取自跟踪链接 |
{campaign_name} | 推广活动名称,取自跟踪链接 |
{creative_name} | 素材名称,取自跟踪链接 |
{engagement_time} | 交互时间戳 |
{network_name} | 渠道名称,取自跟踪链接 |