第 1 步:注册适用于相关 iOS 版本的 SKAdNetwork 回传
如需了解详情,请参阅 Apple 文档。对于使用 Google Analytics for Firebase SDK 的客户,该 SDK 会代表应用自动注册 SKAdNetwork 回传,因此您可以跳过此步骤。
第 2 步:确保您能够接收和解码 SKAdNetwork 回传
如需了解详情,请参阅 Apple 文档。如果您尚未设置 SKAdNetwork 端点,则需要按照 Apple 文档中的说明进行设置。
如果您已经通过 Google 批准的应用归因合作伙伴 (AAP) 或内部解决方案设置了端点,则可以跳到第 3 步,该步骤将指导您使用 Measurement Protocol 直接将结果发送到 Google Analytics(分析)。
第 3 步:使用 Measurement Protocol 直接将回传结果发送到 Google Analytics(分析)
为此,您需要使用以下架构(Codelab 示例),通过 Measurement Protocol 将自定义 campaign_details
事件发送到 Google Analytics(分析)。
使用 Measurement Protocol 向 Google Analytics(分析)4 发送 SKAdNetwork 回传的实现细节
请求级参数
参数 | 更多信息 |
firebase_app_id: {gmp_app_id} |
|
api_secret: {api_secret} |
|
timestamp_micros: {接收到的 SKAN 回传的时间戳} |
|
app_instance_id: {...} |
必需。生成由随机数字组成的唯一字符串。在根据模型估算转化过程中使用此回传数据后,系统将丢弃此特定 ID 字符串,并使用实际的应用实例 ID。 |
GA 事件
事件 | 更多信息 |
campaign_details | 自定义事件。 |
GA 参数(现有)
参数 | 更多信息 |
source: {source} |
这些是在人工标记时使用的参数。Google Analytics(分析)4 报告的结构是按照 Google Analytics(分析)4 默认渠道分组方式设计的。我们建议您在对各个参数进行分类时参考这些参数。请针对所有非 Google 回传发送这些参数。 例如: Facebook 回传:
对于 Google 回传,我们会根据您的媒体资源与 Google Ads 的集成情况对广告系列进行解码。因此,上述参数对于 Google 回传而言是可选的。您必须确保您的 Google Analytics(分析)4 媒体资源已与您的 Google Ads 广告账号相关联。 注意:请务必将所有 SKAdNetwork 回传(而不仅仅是非 Google 回传)发送到 Google Analytics(分析)4。 |
medium: {medium} | |
term: {term}(可选) | |
content: {content}(可选) | |
campaign_id: {campaign_id} | 值来自 SKAdNetwork 回传。 |
campaign: {campaign};可选,但如果未提供此参数,则会显示为“(未设置)” |
对于 Google Ads 广告系列,我们会根据您的 Google Analytics(分析)与 Google Ads 之间的关联情况来解码 ID 并提供广告系列名称,还会更新来源和媒介参数。如果这两个账号未建立关联,我们便不会解码 Google 广告系列 ID,并且会使用指定的来源和媒介参数。 对于非 Google Ads 广告系列,您可以进行解码并提供广告系列名称。如果您不知道此信息,则可以复制您的 SKAdNetwork campaign_id。 注意:如果未提供此参数,则会显示为“(未设置)”。 |
source_platform: “apple_skan” | 重要提示:您必须确切指定此字符串,并遵循大小写和 _ 字符的用法。 |
app_id: {app_id} |
值来自 SKAdNetwork 回传。这是您的 app bundle ID。 |
transaction_id: {transaction_id} | 值来自 SKAdNetwork 回传。 |
新的必需参数
注意:这些新参数可在 Google Analytics(分析)4 界面中进行设置;但此操作并不是必需的。如果您想要查看基于这些参数的特定自定义维度报告,则需要在 Google Analytics(分析)4 中注册这些参数。
参数 | 更多信息 |
version: {version} | 值来自 SKAdNetwork 回传 |
conversion_value: {conversion_value} | 值来自 SKAdNetwork 回传 |
fidelity_type: {fidelity_type} | 值来自 SKAdNetwork 回传。 |
attribution_signature: {attribution_signature} |
值来自 SKAdNetwork 回传。 注意:这是一项安全功能。SKAdNetwork 回传已进行加密签名。 |
redownload: {redownload} | 值来自 SKAdNetwork 回传。 |
source_app_id: {source_app_id} |
值来自 SKAdNetwork 回传。 注意:这是应用 ID,表示在哪个应用中广告获得了点击,进而促成了安装。 |
did_win: {did_win} |
值来自 SKAdNetwork 回传。 注意:广告客户只会收到胜出的回传,广告技术平台则会收到胜出的回传,以及排名第二的回传/辅助回传。
|
ad_network_id: {ad_network_id} 其中 {ad_network_id} 表示回传中的值。 |
值来自 SKAdNetwork 回传。 这将在报告中显示展示了您广告的广告网络。此信息对于“来源”流量维度也非常有用。 |
第 4 步:验证是否已收到 Marketing Platform 命中数据
campaign_details
事件不会直接显示在 Google Analytics(分析)中。取而代之的是,SKAdNetwork 回传会转换为事件,并整合到 first_open
关键事件和事件报告中。您可以通过添加维度来源平台(来源平台为 SKAN)对其进行细分。
如果您想要确认是否已开始发送命中数据,建议您换一个事件名称(例如 campaign_details_skan_test)来重现 campaign_details
事件,以便将测试事件记入日志。然后,您可以验证测试事件是否会显示在 Google Analytics(分析)4“实时”报告中。如果您注册了测试事件和参数,那么除了“实时”报告之外,这些事件和参数还会显示在临时报告中。
- 如果您希望所有 SKAdNetwork 回传都显示在报告中,那么除了以
campaign.details
事件的形式发送各个回传之外,您还必须注册上述重现的事件及参数。如果您选择执行此操作,则必须仍使用campaign.details
事件来发送 SKAdNetwork 回传。否则,Google Analytics(分析)将无法识别这些回传,也无法根据模型估算转化以改进您的 iOSfirst_open
报告。 - 您需要在接收 SKAdNetwork 回传后 4 天内发送这些回传,以供 Google Analytics(分析)在根据模型估算转化和生成报告时使用。
不妨详细了解一般验证步骤。