苹果 Apple Search Ads

资料

苹果广告后台
Apple Search Ads 的运作原理
Apple Ads 归因 API
Apple Search Ads 广告管理API

适用 iOS 14.3+
AdServices归因 4步骤

适用iOS 10及更高版本的设备衡量归因，仅适用于未启用“限制广告跟踪 (LAT)”的用户
设置 Apple Search Ads 归因

iOS 14 ATT和SKAdNetwork

术语

• LAT
  LAT是 Limit Ad Tracking 的简称, 意思是限制广告追踪。用户打开此设置后，其IDFA在广告追踪时将显示为空白。这意味着他们不会看到针对自己的特定广告，因为在渠道看来，该设备没有标识符。
  当打开 LAT 时，归因和转化事件（以及其他功能）会被关闭
  在iOS 14之前，iOS设备上的APP都拥有跟踪用户数据的许可，用户虽然可以选择启用“限制广告追踪”功能来限制IDFA对个人信息的追踪，但这项功能是默认关闭的
  如何开启？设置->隐私->广告-限制广告跟踪

• ATT
  iOS 14发布后，LAT被ATT取代。ATT是App Tracking Transparency Framework的简称。ATT框架要求所有App开发者通过一个弹出窗口，询问用户是否同意广告追踪。只有当用户选择 ‘允许追踪’ 的时候，其IDFA才会被分享。

iOS操作流程

添加框架

注意：添加的框架，均设置为Optional

• AdServices.framework
  用于ASA归因，不受ATT约束，无论是否允许跟踪，都可以归因
  注意：<font color=red>仅支持iOS14.3及更高版本，XCode需要12.3及更高版本，只适用Apple Search Ads广告</font>

• iAd.framework
  用于ASA归因，受ATT以及LAT约束，如果用户【允许跟踪】，就可以归因
  目前支持所有iOS版本(iOS 4.0+)

  • iOS 13以及更低版本的设备中，隐私设置中的【限制广告追踪】为关闭状态
  • iOS 14以及更高版本的设备中，隐私设置中的【允许应用程序请求跟踪】为开启状态
  • iOS 14.5以及更高版本的设备中，要求app通过ATT框架，征求用户的跟踪许可

• AppTrackingTransparency.framework
  在iOS14及更高版本用于征求用户跟踪许可的框架，就是弹窗询问用户是否同意跟踪
  在iOS14.5上苹果将强制要求加入，获取IDFA的前提

• AdSupport.framework
  获取IDFA，以及在低于iOS 14的版本中获取LAT信息

归因方案

iOS 14.3及更高版本采用AdServices归因
iOS 14~14.3采用iAd归因，仅限【允许广告跟踪】
iOS 10~14采用iAd归因
iOS 10及更低版本，采用idfa归因

iOS 14.3以上

通过AdServices.framework API获取到token，不需要获取用户隐私，也不需要授权
AdServices获取token API

image.png

token解析后的数据
经测试，idfa允许后，得到的数据是详细数据包，未允许，得到的数据是标准数据包
标准数据包

{
  "attribution": true,
  "orgId": 40669820,
  "campaignId": 542370539,
  "conversionType": "Download",
  "adGroupId": 542317095,
  "countryOrRegion": "US",
  "keywordId": 87675432,
  "creativeSetId": 542317136
}

详细数据包

{
  "attribution": true,
  "orgId": 40669820,
  "campaignId": 542370539,
  "conversionType": "Download",
  "clickDate": "2020-04-08T17:17Z",
  "adGroupId": 542317095,
  "countryOrRegion": "US",
  "keywordId": 87675432,
  "creativeSetId": 542317136
}

iOS 14.3以下

iAd开发者文档
设置 Apple Search Ads 归因

检索归因字典
归因词典包含从用户与源自Apple Search Ads广告系列的广告的互动中检索到的归因数据
检索包含属性对象的字典的条件参见方法。接下来，检查 Apple Search Ads 的归属，例如在应用首次打开时或注册完成时。将数据存储在本地，因此无需重复方法调用。

报告归因数据

• 所有操作都必须在同一设备上进行
• 归因仅适用于运行iOS 10或更高版本且在过去30天内下载该应用程序的用户
• Apple Search Ads会在下载发生时报告下载，最多可在30天后报告
• 必须从App Store列表或Apple Search Ads展示中下载或重新下载

{
"Version3.1" = {
"iad-attribution" = true;
"iad-org-name" = "org name";
"iad-org-id" = "555555";
"iad-campaign-id" = "12345678";
"iad-campaign-name" = "campaign name";
"iad-purchase-date" = "2020-08-04T17:18:07Z"
"iad-conversion-date" = "2020-08-04T17:18:07Z";
"iad-conversion-type" = "newdownload";
"iad-click-date" = "2020-08-04T17:17:00Z";
"iad-adgroup-id" = "12345678";
"iad-adgroup-name" = "adgroup name";
"iad-country-or-region" = "US";
"iad-keyword" = "keyword";
"iad-keyword-id" = "12345678";
"iad-keyword-matchtype" = "Broad";
"iad-creativeset-id" = "12345678";
"iad-creativeset-name" = "Creative Set name";
}
}

字段说明

iAd字段名	AdServices字段名 <iOS 14.3+>	数据类型	描述
iad-attribution	attribution	布尔值	true/false 如果用户在应用下载前最多30天点击Apple Search Ads展示，返回true；如果API找不到匹配的归因记录，则为false
iad-org-id	orgId	整型	Organization ID，跟Apple Search Ads UI中的账户相同
iad-campaign-id	campaignId	整型	相应广告所属的广告系列ID
iad-conversion-type	conversionType	字符串	是否首次下载 AdServices值【Download 和 Redownload 】 IAd值【newdownload和redownload】，redownload表示以前安装过
iad-click-date	clickDate	日期/时间字符串	用户点击相应广告系列中的广告的日期和时间 <font color=red>注意：在AdServices框架中，此字段仅仅出现在详细的归因响应负载中</font>
iad-adgroup-id	adGroupId	整型	相应广告所属的广告组ID
iad-country-or-region	countryOrRegion	字符串	国家或地区 两位编码
iad-keyword-id	keywordId	整型	触发广告展示的关键词ID
iad-creativeset-id	creativeSetId	整型	相应广告所属的Creative Set的ID
iad-org-name		字符串	账户organization名称
iad-campaign-name		字符串	相应广告所属的广告系列名称
iad-purchase-date		日期/时间字符串	用户首次下载应用程序的日期和时间，当值iad-conversion-type是redownload，这个字符串代表原始购买日期。购买可能与 Apple Search Ad 相关，也可能不相关
iad-conversion-date		日期/时间字符串	用户通过点击 Apple Search Ad 下载的 app 的日期和时间
iad-adgroup-name		字符串	相应广告所属的广告组名称
iad-keyword		字符串	触发广告展示的关键词
iad-keyword-matchtype		字符串	触发广告展示的关键字的匹配类型，值为广泛、精确或搜索匹配
iad-creativeset-name		字符串	相应广告所属的Creative Set的名称