資料
蘋果廣告后臺
Apple Search Ads 的運作原理
Apple Ads 歸因 API
Apple Search Ads 廣告管理API
適用 iOS 14.3+
AdServices歸因 4步驟
適用iOS 10及更高版本的設備衡量歸因,僅適用于未啟用“限制廣告跟蹤 (LAT)”的用戶
設置 Apple Search Ads 歸因
術語
LAT
LAT是 Limit Ad Tracking 的簡稱, 意思是限制廣告追蹤。用戶打開此設置后蹦骑,其IDFA在廣告追蹤時將顯示為空白禀酱。這意味著他們不會看到針對自己的特定廣告,因為在渠道看來涛救,該設備沒有標識符畏邢。
當打開 LAT 時,歸因和轉化事件(以及其他功能)會被關閉
在iOS 14之前检吆,iOS設備上的APP都擁有跟蹤用戶數據的許可舒萎,用戶雖然可以選擇啟用“限制廣告追蹤”功能來限制IDFA對個人信息的追蹤,但這項功能是默認關閉的
如何開啟蹭沛?設置->隱私->廣告-限制廣告跟蹤ATT
iOS 14發(fā)布后臂寝,LAT被ATT取代。ATT是App Tracking Transparency Framework的簡稱摊灭。ATT框架要求所有App開發(fā)者通過一個彈出窗口咆贬,詢問用戶是否同意廣告追蹤。只有當用戶選擇 ‘允許追蹤’ 的時候帚呼,其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以及更低版本的設備中,隱私設置中的【限制廣告追蹤】為關閉狀態(tài)
- iOS 14以及更高版本的設備中柔袁,隱私設置中的【允許應用程序請求跟蹤】為開啟狀態(tài)
- 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
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開發(fā)者文檔
設置 Apple Search Ads 歸因
檢索歸因字典
歸因詞典包含從用戶與源自Apple Search Ads廣告系列的廣告的互動中檢索到的歸因數據
檢索包含屬性對象的字典的條件參見方法疏咐。接下來,檢查 Apple Search Ads 的歸屬脐供,例如在應用首次打開時或注冊完成時浑塞。將數據存儲在本地,因此無需重復方法調用患民。
報告歸因數據
- 所有操作都必須在同一設備上進行
- 歸因僅適用于運行iOS 10或更高版本且在過去30天內下載該應用程序的用戶
- Apple Search Ads會在下載發(fā)生時報告下載缩举,最多可在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 | 字符串 | 國家或地區(qū) 兩位編碼 |
iad-keyword-id | keywordId | 整型 | 觸發(fā)廣告展示的關鍵詞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 | 字符串 | 觸發(fā)廣告展示的關鍵詞 | |
iad-keyword-matchtype | 字符串 | 觸發(fā)廣告展示的關鍵字的匹配類型他宛,值為廣泛船侧、精確或搜索匹配 | |
iad-creativeset-name | 字符串 | 相應廣告所屬的Creative Set的名稱 |