Apple Search Ads对接设置指南

前期准备

• 在您的应用中接入最新版本的AppsFlyer iOS SDK

请按以下步骤在AppsFlyer后台配置ASA对接：

ASA的具体对接配置在活跃对接页面中完成， 但如果您从未使用过ASA，请先在 Partner Marketplace渠道平台中搜索该渠道。 请按照下文说明，在各个选项卡中完成相关的对接配置。 说明。

渠道对接选项卡

Apple Search Ads是一个自归因渠道（即SRN），它是通过 API与AppsFlyer对接的， 因此没有回传设置。请根据您的归因目标 完成以下各板块的设置。 

成本对接可提供下列汇总数据：

• 广告系列、广告组、国家/地区和 关键词维度的成本数据。另请参阅 广告平台成本对接列表， 其中列出了所有的适配维度、指标和 功能。
  请注意：您需要购买ROI360才能获得成本数据。
• 点击、展示和扩充数据——关键词、 广告系列名称和广告组。

如需获取成本、点击、展示和扩充数据：

• 请按照 对接指南进行操作

您可以在成本（和广告收入）对接状态面板或ASA的对接面板中查看Cost API的状态 以及上一次AppsFlyer拉取到 匹配成本数据 的时间。

详情请见广告平台与代理权限设置指南。

Apple Search Ads：平台官方合作渠道与代理的区别

广告主和代理可以通过ASA Marketing Partners（ASA营销合作伙伴）来实现ASA广告的报告和优化。 

下表说明了代理商和营销伙伴之间的区别。 

代理商与营销合作伙伴对比表

如何配置代理商和营销合作伙伴 

请完成以下配置流程清单中列出的所有步骤。后几个章节中详细说明了分渠道类型的配置指南。 

配置操作清单

请按以下方式设置营销合作伙伴：

1. 请根据实际需要激活Apple Search Ads对接： 
   1. 从AppsFlyer后台进入配置 > 活跃对接渠道 > Apple Search Ads。 
   2. 打开激活渠道开关。 
   3. 点击保存。
2. 从Apple Search Ads后台 获取该营销合作伙伴的Apple Search Ads Campaign Group ID参数。您可以按下图指示的位置在ASA后台找到该ID。
3. 在AppsFlyer后台配置ASA营销合作伙伴：
   1. 从AppsFlyer的侧边栏中选择协作 > 活跃对接。
   2. 搜索要配置的Apple Search Ads营销合作伙伴。
      界面会显示营销合作伙伴列表。 
   3. 选择要配置的营销合作伙伴。
   4. 打开激活渠道开关。
   5. 输入该营销合作伙伴的Apple Search Ads Campaign Group ID（见第2步）。请仅输入数字。 
   6. 点击保存。
4. 【可选】配置应用内事件回传：
   1. 打开应用内事件回传开关。
   2. 点击添加事件，将SDK事件添加到列表中。
   3. 请配置以下参数：
      1. AppsFlyer事件：AppsFlyer接收到的来自SDK或S2S事件的事件名称。提示：如果列表中没有您要找的事件，请确保以非自然方式激活应用，并完成该事件，然后再次检查该事件是否在列表中。
      2. 回传内容：请根据需要选择“不发送值与收入”、“仅发送值”或“发送值与收入”。
5. 点击保存对接。

适用场景：广告主允许代理商代替自己投放ASA广告。广告主和代理商都需要在AppsFlyer后台进行设置，具体请见以下说明。 

前期准备

在AppsFlyer中配置代理对接之前，相关代理和广告主都必须在ASA平台中完成以下操作：

• 代理：
  1. 在代理账号中创建单独的Campaign Group。 
  2. 邀请相关广告主担任Campaign Group Manager，或通过Link Accounts角色绑定其App Store Connect账号。
• 广告主：广告主收到绑定账号的邀请后，必须将相关campaign group关联到其App Store Connect账号。

请参阅ASA提供的文档说明，详细了解广告主App Store Connect账号与代理账号的绑定方式。

Apple Search Ads Campaign Group

• 代理商和广告主同时投放时必须使用不同的Apple Search Ads Campaign Group ID。
• 请勿在Campaign Group名称中使用特殊则符或空格。
• 通过Apple登录时，ASA campaign group（广告系列组）的授权无法累积。也就是说当您对接新的应用时，针对以往应用选定的campaign group授权会被撤销，需要重新选定。您需要选择部分权限，并勾选各个相关的campaign group（用于您代替广告主对接的应用）。

广告主需要完成的操作

前期准备：

为代理开放权限。 

请按以下步骤启用ASA归因：

1. 从AppsFlyer的侧边栏中选择协作 > 活跃对接。
2. 选择Apple Search Ads。
3. 进入对接选项卡，打开激活渠道开关。
4. 【可选】对于在再归因窗口期内重新安装并激活应用的用户，您需要打开重装激活归因开关才能对其进行归因。 
5. 点击保存。

代理需要完成的操作

1. 从Apple Search Ads后台获取您的Campaign Group ID。您可以按下图指示的位置在ASA后台找到该ID。请仅复制数字部分。
2. 在AppsFlyer选择相关应用。 
3. 从AppsFlyer的侧边栏中选择协作 > 活跃对接。 
4. 选择Apple Search Ads。
5. 输入Apple Search Ads Campaign ID参数。请注意：请仅输入数字，切勿输入其他字符。
6. 点击保存。 

成本、点击和展示数据

如果您启用了成本API，AppsFlyer就会通过API接收ASA的成本,点击和展示数据。 详情请见广告平台成本对接表，其中详细说明了适用维度、指标和功能。 请注意：您需要购买ROI360才能获得成本数据。 如果没有ROI360，AF只能接收到点击和展示数据。 

Cost API的启用方式如下：

• 请完成对接指南中的操作。登录ASA账户时，请务必在选择权限弹窗中选择以下任意一个选项：
  • Account Read and Write（账户读写权限）
  • Account Read Only（账户只读权限）
    请注意：如果您选择了Limited Access（部分权限）以及某个具体的Campaign Group，可能会出现数据错误。 

您可以在成本（及广告收入）对接状态面板或单独的广告平台面板中查看AppsFlyer最近一次拉取成本数据的时间以及成本API状态。

如需停止记录由代理和营销合作伙伴带来的ASA激活归因，请完成以下操作：

1. 从AppsFlyer后台左侧的菜单栏中选择协作 > 活跃对接。
2. 根据实际情况选择相关的代理或营销合作伙伴。 
3. 删除Apple Search Ads Campaign Group ID字段的内容。
4. 点击保存对接。

Apple Search Ads是独立于SKAdNetwork运作的，且无论用户的ATT授权状态如何，ASA都能对其进行确定性归因。也就是说，对于归因到ASA的用户，AF的LTV归因模型能为您提供完整的一系列功能和衡量数据。

ASA的归因不依赖IDFA，而是通过来自设备的token完成（确定性归因），且在不同的ATT授权情况下有所不同：

由于AppsFlyer和Apple Search Ads使用的归因逻辑不同，因此两个平台之间会有数据差异。Apple Search Ads作为一个SRN，会通过API上报新增激活。 

Apple Search Ads通过API将数据上报给AppsFlyer。

• 广告系列是按国家/地区汇总的。
• 如果某个广告系列的展示次数少于100次，则不会上报其展示、点击或分国家/地区成本数据。
• 在AppsFlyer中按照Geo进行分组时，不会显示数据不可用的Geo，并且不可用的数据总数将显示在N/A下。

再营销相关的数据差异

除了衡量拉新广告以外，AppsFlyer还提供再营销归因机制，可让广告主衡量并分析再营销投放。

下图说明了投放ASA再营销广告时产生数据差异的原因（与再营销控件的设置无关）。

再营销启用时

再营销停用时

其他可能产生数据差异的原因

下表列出了数据差异的主要原因

您在投放ASA广告时可以收集到有价值的营销数据，帮助您提升iOS应用在所有媒体渠道上的拉新效果。

下表所列的建议可提升ASA广告的数据收集效果：

下表列出了原始数据报告和面板中的归因参数可用性。

从iOS 14开始，IDFA的可用性由ATTrackingManager（即ATT）控制。而对于来自ASA的激活，其用户层级归因数据由ASA控制。因此，对于来自ASA的激活，其用户层级数据的可用性不受AAP（汇总层级的高级隐私保护）的影响。

请注意：SKAdNetwork框架中不上报来自ASA的激活。