广告和归因

[GA4] 将 SKAdNetwork 回传发送到 Google Analytics(分析)

下文详细介绍了使用 Measurement Protocol 将 SKAdNetwork 回传发送到 Google Analytics(分析)的步骤。

第 1 步:注册适用于相关 iOS 版本的 SKAdNetwork 回传

如需了解详情,请参阅 Apple 文档。对于使用 Google Analytics for Firebase SDK 的客户,该 SDK 会代表应用自动注册 SKAdNetwork 回传,因此您可以跳过此步骤。

第 2 步:确保您能够接收和解码 SKAdNetwork 回传

如需了解详情,请参阅 Apple 文档。如果您尚未设置 SKAdNetwork 端点,则需要按照 Apple 文档中的说明进行设置。

注意:目前无法将 Google Analytics(分析)4 配置为端点。

如果您已经通过 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}
  • 在 Google Analytics(分析)4 中,依次前往管理 > 数据流 > 选择您的数据流 > Firebase 应用 ID

  • 在载荷之外进行设置。

api_secret: {api_secret}
  • 若要创建新的密钥,请在 Google Analytics(分析)4 中依次前往管理 > 数据流 > 选择您的数据流 > Measurement Protocol > 创建

  • 在载荷之外进行设置。

timestamp_micros: {接收到的 SKAN 回传的时间戳} 
  • 可选;但如果提供,时间戳必须在过去 72 小时内。如果未提供,系统将使用收集时间戳。

  • Google Analytics(分析)4 中流量获取事件的关键事件回溯期为 30 天。请务必尽快发送回传,以获取更准确的报告结果。

app_instance_id: {...}

必需。生成由随机数字组成的唯一字符串。在根据模型估算转化过程中使用此回传数据后,系统将丢弃此特定 ID 字符串,并使用实际的应用实例 ID。



 

GA 事件

事件 更多信息
campaign_details 自定义事件。

GA 参数(现有)

参数 更多信息
source: {source}

这些是在人工标记时使用的参数。Google Analytics(分析)4 报告的结构是按照 Google Analytics(分析)4 默认渠道分组方式设计的。我们建议您在对各个参数进行分类时参考这些参数。请针对所有非 Google 回传发送这些参数。

例如:

Facebook 回传:

  • source: facebook
  • medium: cpc|cpm
  • content: ad_version_name
  • campaign: Facebook Spring 22 Campaign 
  • campaign id:与 SKAN 回传中的广告系列 ID 相同

对于 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(分析)将无法识别这些回传,也无法根据模型估算转化以改进您的 iOS first_open 报告。
  • 您需要在接收 SKAdNetwork 回传后 4 天内发送这些回传,以供 Google Analytics(分析)在根据模型估算转化和生成报告时使用。

不妨详细了解一般验证步骤。

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
主菜单
8090813231496465185
true
搜索支持中心
true
true
true
true
true
69256
false
false