什么是 ASA ？

• Apple Search Ads（苹果搜索广告，简称ASA，国内原来称为ASM）于7月21日在中国大陆地区正式可用，可以简单理解为苹果官方的竞价搜索广告，企业和开发者可以付费以显著提升在App Store的曝光度。在ASA上线后，苹果开放了官方的入口和全套投放工具。
• ASA的广告样式（见下图）：广告展示在App Store搜索结果的首位，区别于之前常见的ASO和积分墙体系

ASA 的五大特点

1. 唯一性：ASA是App Store在国内的唯一广告渠道，在iOS生态中的推广拥有唯一性，
2. 意向词精准搜索：ASA是基于用户本身在App Store中进行的意图词搜索，和信息流基于算法的推荐不同，无需过多的数据即可获取更加精准的意向用户。
3. iOS用户的高质量与高转化：无论是在LTV还是ROI上，iOS设备效果表现相较于安卓都更加优秀
4. 转化链路短：从广告点击到下载，没有过多的跳转，一键完成安装。
5. 归因可溯：如何追踪iOS激活在业内都是一个需要解决的问题，ASA会提供竞价后台和标准的API接口来帮助广告主完成激活归因。

ASA如何归因

Apple search ads是自归因渠道。SensorsDataTracking获取apple的归因结果，再结合其他渠道（如广点通、巨量引擎等）的点击事件做last-click归因。

基于ASA，神策广告投放分析能做什么？

神策已全面兼容客户在 ASA 广告渠道上的投放，只需在待推广的 APP 中接入神策广告SDK，同时将 ASA 后台与神策广告投放分析后台做授权关联，即可实现激活归因与激活后链路分析。具体能力如下：

1. 激活归因能力：神策全面支持ASA激活归因（iAd framework与Ad Services framework），通过接收 ASA 归因结果，能够全链路追踪用户后端行为数据。
2. 数据报表能力：神策支持在广告投放分析报表中查询、下载ASA广告统计数据，包括消费、点击，投放关键词等ASA后台提供的多种指标。

如何集成并使用神策 ASA 功能？

接入神策广告SDK

部署注意事项

ASA归因逻辑依赖神策分析的埋点，需要等SA完成正式环境交付后，才能升级神策广告广告投放分析

客户拟推广的APP需接入神策广告SDK，广告SDK接入文档如下：https://manual.sensorsdata.cn/sa/latest/tech_sdk_client_ad_ios-35685041.html

验证

按照文档完成接入后，需进行以下两步验证：

验证1——APP是否成功集成广告SDK

步骤1：开启 SA log 日志，并初始化广告 SDK

步骤2：首次安装运行 App，点击 IDFA 授权弹窗按钮，在控制台搜索 $AppInstall，信息如下：

由于操作系统版本不同，我们获取到的归因结果中可能包含 asa_iad_info 或 asa_adservices_info 两种结构类型信息，有两种信息其中一种即说明广告 SDK 集成成功。

asa_iad_info结构归因信息

asa_adservice_info结构归因信息

验证2——服务端确认归因信息是否成功处理

1.在“验证APP是否成功集成广告SDK”步骤完整验证后，即sdk上报数据后继续验证服务端处理信息是否成功，打开分析→自定义查询。

2.在自定义查询中使用该语句查询数据：

select event, distinct_id, date, time, $ip, $device_id, $lib, $os, $channel_extra_information from events where event='$AppInstall' and date='2021-11-04'（时间改为当前时间）

3.在查询到的数据中，对比时间、IP、设备号后找到 $channel_extra_information 属性数据

4.包含  asa_iad_info 或 asa_adservices_info 信息即说明有激活事件携带了ASA数据，可进一步进行URL解码查看原始信息，并且与SDK打印日志进行对比

5.如果出现如下报错Could no resolve column/field ，则查看一下事件属性是否隐藏，需设置为可见

APP提交审核

把集成了神策SDK的APP在苹果开发者后台提交审核

在ASA后台创建广告

创建广告前，需要等APP审核通过后才可以开始投放，步骤如下（来自 Apple 官方文档）：

投放前准备

1. 将你的 Apple ID 与你的 App Store Connect 帐户关联。
2. 在 App Store 中有一个上架的 app。
3. 选择你希望推广 app 的国家和地区。
4. 了解推广预算。
5. 注册 Apple Search Ads 帐户。
6. 添加有效的信用卡。

创建广告（创建广告这部分是客户自行操作，神策可提供咨询服务）

1. 在 Apple Search Ads Advanced“广告系列”信息中心，点击“创建广告系列”按钮。
2. 选择你要推广的 app。
3. 选择广告将投放的位置。你可以选择在 App Store 搜索结果的顶部还是在建议的 app 列表顶部的“搜索”标签上推广 app。
4. 选择你的广告系列将要投放的一个或多个国家或地区。请注意，如果你打算在多个市场中投放广告，不妨将类似的国家和地区归入一个广告系列，这样更方便管理。你可以根据用户价值、用户个人资料、语言、全球地区、销售额或财务中心所在地对其进行分组。
5. 点击“继续”。
6. 应用广告系列设置：为你的广告系列命名。如果你想根据特定主题整理关键词或 Creative Sets，最好在广告系列名称中包含对相应主题的引用。例如，品牌或发现。
   • 设置广告系列预算 。 你设定的金额可以随时添加，但广告系列开始投放后，就不能降低预算了。广告会持续投放，直到你的预算用尽、到达广告系列结束日期或是广告系列暂停。进一步了解如何管理预算
   • 设置每日预算上限 (可选)。这样做有助于分散你的每日支出，确保你的预算足够在特定的一段时间内使用。
7. 创建广告组：
   • 为你的广告组命名：如果你要创建搜索结果广告系列，最好确保广告组名称与关键词主题相符。进一步了解广告组
   • 设置广告组默认的最高每次点击费用出价或最高每千次展示费用出价。在搜索结果广告系列中，你的最高每次点击费用出价是你愿意为每次广告点击支付的最高金额。在“搜索”标签广告系列中，你的最高每千次展示费用出价是你愿意为一千次广告展示支付的最高金额。你的默认最高每次点击费用或最高每千次展示费用出价是在广告组级别设置的。对于搜索结果广告系列，这意味着相同的出价适用于某个广告组中所有的关键词，除非你在关键词一级指定最高每次点击费用出价。进一步了解搜索结果广告系列出价
   • 如果你要创建搜索结果广告系列，可以选择添加每次转化费用目标，即你在理想状态下为获取一位用户而希望支付的金额。进一步了解每次转化费用目标
8. 针对搜索结果广告系列，开启或关闭搜索匹配。了解搜索匹配如何将你的广告与相关搜索结果匹配
9. 选择搜索结果广告系列的广告组关键词。如果 App Store 用户输入的相关搜索查询包含你的某个关键词，你的广告就会显示。进一步了解关键词选择
10. 按设备类型、用户类型、受众特征和地理位置细分受众群体。进一步了解受众群体细分
11. 为广告系列设置开始日期，以及结束日期（可选）
12. 如果你有偏好，请指定你的广告将会在每个星期几的什么时间投放。进一步了解广告投放时间设置
13. 针对搜索结果广告系列，添加 Creative Sets (可选)，以获得与广告组主题或受众一致的更多广告选项。进一步了解 Creative Sets
14. 点击”创建广告系列“按钮。

在ASA后台授权关联

创建广告和授权关联顺序可以调整。

在ASA后台投放广告后，需将广告后台与神策广告投放分析后台做授权关联，才可以在神策后台使用数据报表查看投放情况。（即 Marketing API授权）

具体步骤如下：

步骤1：通过管理员权限，将“API账号经理”权限授权给操作账号。如果ASA账号通过代理开通的话，需要代理协助开通权限

步骤2：进入神策广告分析/管理与配置的“广告授权管理”页面，在“App搜索广告”点击【账号列表】，在账号列表页面点击【添加授权账户】

步骤3：拷贝公钥信息内容，把内容粘贴到ASA操作账号的后台（注：登陆ASA后台时，需要选择Advance版本登陆，通过界面右上角的”设置“进入到账号设定API页面）

（注：神策投放分析后台的公钥信息，每次打开都不一样，一定要保证将公钥信息复制粘贴到ASA后台，点击保存之后，再进行下一步操作！）

步骤4：拷贝ASA操作账号后台的clientId、teamId、keyId添加到神策后台

查看 ASA 投放数据

进入“广告分析报表”页面，切换到“ASA报表”Tab。

场景1：广告主希望分析自主添加的关键词，前后链路数据效果，并希望确认有消耗的关键词都匹配上了哪些网民搜索词

1.ASA后台查看关键词展点消路径：广告系列组-广告系列-所有关键词-关键词

2.ASA后台查看匹配关键词的搜索词路径：广告系列组-广告系列-所有关键词-搜索词-筛选条件中匹配来源选“关键词匹配”

操作步骤：

1.进入“广告分析报表”页面，切换到“ASA报表”Tab。数据筛选部分选择「关键词」，日期范围、事件维度及数据筛选按需选择。

2.匹配来源选择”关键词”，并选择自定义列选中需要分析的事件指标，即可查看关键词粒度展点消数据及后续事件数据，且支持查看当前投放关键词匹配的所有搜索词。

场景2：广告主希望分析在ASA后台开启搜索匹配功能后，基于搜索匹配来源的搜索词展点消明细数据及归因打通的后续事件明细数据

1.ASA后台查看搜索匹配展点消路径：广告系列组-广告系列-所有关键词-搜索词-筛选条件中匹配来源选“搜索匹配”。

操作步骤：

1.进入“广告分析报表”页面，切换到“ASA报表”Tab。数据筛选部分选择「关键词」，日期范围、事件维度及数据筛选按需选择。

2.匹配来源选择”搜索匹配”，并选择自定义列选中需要分析的事件指标，即可查看搜索匹配来源的搜索词粒度展点消明细数据及后续事件合计数据，且不支持查看分小时数据。

注意：

1.ASA官方政策原因，ASA的AttributionAPI不提供搜索词归因明细数据，且后台及ReportAPI均不提供搜索量低于10的搜索词及展点消明细数据。

2.ASA默认按Low volume terms（简称lvt）表示搜索量低于10的搜索词集合，搜索匹配的lvt及搜索量大于10的搜索词，仅能拉取展点消明细数据。

3.神策广告分析基于AttributionAPI推送归因数据特征，经过特殊处理后，目前支持统计搜索匹配lvt及搜索量大于10的搜索词的后续事件合计数据。

FAQ

   1.为什么ASA归因数据里有asa_iad_info 或 asa_adservices_info两种格式的数据

• Apple在不同操作系统版本里面使用的归因框架是不一样的，导致获取数据格式出现多种，目前神策ASA能够统一做兼容，查询投放分析的时候无需关注。

   2.为什么ASA归因数据里面有些有keyword和keyword_id，有些只有keyword_id，而有些两者都没有或者keyword_id为负数

• 首先区分一下最详情的数据是有keyword和keyword_id的情况，也就是在归因结果里面已经包含了keyword和keyword_id，很直观看到此用户激活是由ASA那个关键词带来的。
• 只有keyword_id没有keyword的情况，按了解主要是操作系统版本的问题导致拿不到，这时候只能结合MarketAPI数据拉取keyword_id与keyword的映射关系才能把关键词报表完整展示出来。
• keyword_id不存在和为负的情况，这种情况主要原因是在投放的时候打开了“搜索词匹配”开关，就会有这个情况出现，原因官方文档有介绍：

   3.为什么通过事件分析查询的ASA的激活事件中keyword关键词带来的激活数比ASA后台的激活数少

• 主要原因是参考FAQ 2中的只有keyword_id没有keyword的情况
• 另一种情况是由于FAQ 2中的这两者都没有的情况，通常为通过搜索词带来的激活，Apple是不会匹配到关键词上的

   4.为什么新建了apple search ads推广活动后没有监测链接？

• Apple search ads是自归因渠道，不提供监测链接，展点数据通过MaketingAPI获得。

    5.为什么SensorsDataTracking数据面板中显示的数据和apple显示的数据不一致？

• SensorsDataTracking结果和apple的结果会有一些差异，有以下几个可能的原因：
  • apple将点击广告后的安装作为激活，而SensorsDataTracking会将第一次打开app作为激活；
  • 归因窗口期的差异，apple的归因窗口期30天，在SensorsDataTracking可以设置归因窗口期为24到48小时；
  • apple无法得知用户是否在点击apple search ads之后是否点击了其他渠道的广告，然后再下载了app；
  • 如果用户启用了限制广告追踪（LAT），SensorsDataTracking就不会从apple search ads的归因API收到归因结果，这种情况下SensorsDataTracking不会归因给apple search ads

    6.神策广告投放分析ASA功能，多久获取一次数据？            

• 每小时点触发拉取上一个小时数据，譬如15触发，拉取14点数据

• 每天8，9，10，11，12点会回溯昨天24个小时的数据。

• 每天2点回溯7天前的数据。

• 每天1,5,9,11,15,19,21回溯之前24个小时的数据；

• 可手动拉取近7天的小时报表数据

     7.客户接入神策广告sdk的作用？    

• 接收苹果点击到激活的归因数据
• 采集用户激活及之后的后端行为
• 关联点击-激活-后端行为，实现目标用户的投放受众分析

     8.客户做Marketing API授权的作用？  

• 是为了拉取用户在ASA投放媒体侧展示，点击，消耗，下载等前链路数据，可以在投放分析报表中查看上述指标。

     9.为什么客户接入神策广告投放分析ASA功能后，后台报表没有数据？  

• markingapi数据相对apple后台数据有9-10个小时的延迟，也就是说1点的数据，10点markingapi才有数据

     10.同一个ASA账号有两个APP投放的权限，为什么后授权的账号不能授权成功？

• ASA的授权验证逻辑中，神策做的工作只是提供密钥相关内容，其中大部分的逻辑都是ASA实现的，在实际使用中发现如果一个账号被授权了一次，再进行授权是不成功的。
• 具体场景类似如下：客户找代理A开了一个账户，找代理B开了另一个帐户，同时为了方便管理都授权给客户的Apple账号C进行操作ASA投放，在做神策广告投放分析拉取MarketAPI授权的时候会同时授权两次，在第二次授权的时候会失败，具体原因未知但是可以明确是ASA授权端的报错，处理办法是让代理B授权另一个操作账号D，然后通过操作账号D在神策MarketAPI中进行授权。

     11.做Marketing API授权时候，如果客户的投放账户是从代理开的，需要将“API账号经理”权限授权给操作账号，如果代理觉得权限太高不配合开启，该怎么处理？

• 两种解决办法：

1. 让代理单独建立代理账户，把客户的账户往新开的权限里迁移，这样权限可控
2. 客户自己申请ASA帐户，我们提供协助

      12.ASA后台的搜索词有几种匹配来源，分别都是怎么匹配的？

• ASA后台的搜索词的匹配来源有：

1. 关键词匹配来源：系统基于广告主主动添加的关键词，会给匹配有一定关联度的网民搜索词。
2. 搜索匹配来源：搜索匹配使用多种资源将广告主的广告与App Store上的相关搜索词进行匹配，其中包括App Store列表中的元数据，同一类型中关于类似app的信息以及其他搜索数据。（如果广告主使用了搜索匹配，建议同时添加否定关键词，以确保广告不会针对特定搜索词进行展示） 

附不同iOS版本对应的归因框架：

ASA广告的两种归因框架iAd framework和Ad Services framework，SensorsDataTracking目前都支持。

归因实现原理及具体实现方式如下：