Apple Search Ads对接配置指南

概要:Apple Search Ads(ASA)是AppsFlyer的SRN对接渠道。用户在App Store使用关键词搜索时,ASA能让他们看到您的应用。

用户在App Store搜索后是否会出现您的广告取决于广告相关性。用户对于广告的反应是广告相关性的一种体现,因此ASA会通过用户对广告的反应来判定最常显示哪些广告。

ASA提供点击型移动归因和用户再营销功能,您还可以通过API获取其成本数据(需要购买Xpend)。

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

ASA对接设置指南

上手指南

前期准备

  • 对于iOS 14.3及以上版本的应用,您必须接入V6.1.3及以上版本的AppsFlyer SDK。
  • 如果您使用的SDK是V6.1.3之前的版本:请确保您已在应用中添加原生广告框架

请按以下步骤在AppsFlyer后台设置ASA归因:

  1. 从AppsFlyer后台进入配置>合作伙伴配置
  2. 选择Apple Search Ads。
  3. 进入对接选项卡。
  4. 打开激活渠道开关
  5. 点击保存
  6. 根据实际情况配置对接、成本和渠道权限。

扩展阅读:渠道配置指南

对接选项卡

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

对接设置
板块 细节
对接激活

激活渠道

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

  1. 打开激活渠道开关。
  2. 点击保存
激活归因

用于归因激活的点击回溯窗口

设置点击回溯窗口,即从点击到激活的最长时间跨度。这样,AppsFlyer就能将在该窗口期内发生的激活归因到ASA。

范围:1–30天

相关文档:点击回溯窗口

重装激活

重装激活归因

打开重装激活归因开关后,AppsFlyer就可以将重装激活归因到ASA。

重装激活归因回溯窗口沿用激活归因的设置。

AF会将用户在再归因窗口期内完成的重装激活归因到ASA。

您可以在数据总览面板的再营销视图中查看重装激活数据。

原始数据中的Store reinstall(来自商店的重装激活) 字段为true。

目前ASA的再营销不支持再互动。

不活跃窗口期

您可以通过设置用户的不活跃窗口期(以天为单位)来调整再营销广告的投放范围。

成本选项卡

如何启用ASA成本对接

如果您启用了成本API,AppsFlyer就会通过API接收ASA的成本点击、展示和关键词数据。详情请见广告平台成本对接表,其中包含完整的适用维度、指标和功能。请注意:您需要购买Xpend才能获得成本数据。如果没有Xpend,AF只能接收点击和展示数据。

ASA成本对接支持同时使用多个ASA账户。也就是说,如果您使用不同的ASA账户投放同一个应用的广告,AppsFlyer能够接收所有相关账户的数据。

注意事项

  • ASA的报告API不上报“campaign groups”(广告系列组)的成本数据,因此AppsFlyer后台没有该数据。
  • 如需使用Apple账户登录,您需要有ASA管理员权限(只读或读写权限都可以)。
  • 通过Apple登录时,您之前提供的所有API证书都会停止拉取数据。

如何启用成本API

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

设置代理和ASA营销伙伴

基本原理

Apple Search Ads:
营销伙伴与代理商对比

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

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

  代理商 营销合作伙伴
AppsFlyer发送回传
技术 广告代投 可通过附加值技术方案优化投放
代理商与营销合作伙伴对比表

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

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

配置方 与代理商对接 与营销合作伙伴对接
广告主
  1. 从AppsFlyer后台进入ASA对接选项卡,打开激活渠道开关。
  2. 选择相关代理商,并打开代理商授权选项卡中的代理商权限开关。
  1. 在ASA对接选项卡中打开激活渠道开关。
  2. 从ASA后台获取营销合作伙伴的Campaign Group ID
  3. 在营销合作伙伴的对接选项卡中执行以下操作:
    1. 打开激活渠道开关
    2. 设置Campaign Group。
    3. 配置应用内事件回传。
代理商

在ASA对接选项卡中设置Apple Search Ads Campaign Group

不适用
配置操作清单

营销合作伙伴的设置方式

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

  1. 请根据实际需要激活Apple Search Ads对接
    1. 从AppsFlyer后台进入配置 > 合作伙伴配置 > Apple Search Ads
    2. 打开激活渠道开关。
    3. 点击保存
  2. 从Apple Search Ads后台获取该营销合作伙伴的Apple Search Ads Campaign Group ID参数。您可以按下图指示的位置在ASA后台找到该ID。

    ASACGroupID.png

  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. SDK event name(SDK事件名称):AppsFlyer接收到的来自SDK或S2S事件的事件名称。提示:如果列表中没有显示您想要查看的事件,请确保以非自然方式激活应用,并完成该事件,然后再次检查该事件是否在列表中。
      2. Send revenue(发送收入):请根据需要选择“不发送值与收入”、“仅发送值”或“发送值与收入”。
  5. 点击保存对接

代理商的设置方式

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

Apple Search Ads Campaign Group

  • 代理商和广告主同时投放时必须使用不同的Apple Search Ads Campaign Group ID。
  • 请勿在Campaign Group名称中使用特殊则符或空格。

广告主需要完成的操作

前期准备

为代理开放权限

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

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

代理需要完成的操作

  1. 从ASA后台获取Campaign Group ID。您可以按下图指示的位置在ASA后台找到该ID。请仅复制数字部分。

    ASACGroupID.png

  2. 在AppsFlyer选择相关应用。
  3. 前往配置 > 合作伙伴配置
  4. 选择Apple Search Ads
  5. 输入Apple Search Ads Campaign ID参数。请注意:请仅输入数字。
  6. 点击保存

 注意事项

如果代理与Apple Search Ads营销合作伙伴合作,则必须在Apple Search Ads和营销合作伙伴的配置页面中使用相同的Campaign Group ID。

成本、点击和展示数据

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

请按以下步骤启用成本API

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

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

 注意事项

代理必须在后台打开成本按钮并上传证书,才能与AppsFlyer同步成本。

如何停用代理和营销合作伙伴

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

  1. 从AppsFlyer后台进入配置 > 合作伙伴配置
  2. 根据实际情况选择相关的代理或营销合作伙伴。
  3. 删除Apple Search Ads Campaign Group ID字段的内容。
  4. 点击保存对接

其他相关信息

数据差异

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

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

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

再营销相关的数据差异

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

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

再营销启用时

ASA_R_Enabled.png

再营销停用时

ASA_R_Disabled.png

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

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

数据差异 Apple Search Ads AppsFlyer

ASA的初始归因数据可能有数秒延迟

可能有数秒延迟

在iAd框架中,必须有实时数据才能进行正确归因

与AppsFlyer SDK版本有关的差异

转化衡量与AppsFlyer SDK的版本无关

  • iAd需要V5.0+的SDK才能正确归因
  • AdsServices需要V6.1.3+的SDK才能正确归因

LAT(限制广告跟踪)和ATT

总是统计转化。

如果您的广告有年龄和性别限制,则投放时会屏蔽掉启用LAT的用户。

18岁以下的Apple用户默认启用LAT。

LAT用户的转化会归因到自然量。

如果已接入AdServices且用户安装了iOS14.3+,则可对拒绝授权的用户进行正确归因。

统计用户数

根据下载统计用户数

根据首次应用启动统计用户数

重装激活:用户下载某应用后将其卸载,然后在点击某则搜索广告后重新下载该应用

计为一次转化(激活)

  • 如果有IDFA:AppsFlyer可识别出重装激活,但出于UA的目的不统计这类激活。请注意:再营销开启时,重装激活会记录为再营销激活(即再归因)。
  • 如果没有IDFA:AppsFlyer可以通过IDFV来区分新增激活和重装激活。
    1. 如果用户设备上安装了同一个广告主的其他应用,AppsFlyer会给ASA记录一次再归因。
    2. 如果没有其他应用,则AppsFlyer会给ASA记录一次新增激活。

点击回溯窗口

30天固定窗口期

  • iAd中,点击回溯窗口是可配置的。
  • AdServices的标准响应中,点击回溯窗口是固定的(30天)。

获得归因的点击

只要用户与广告互动且下载了应用,就总是归因给ASA

比照多个广告平台的数据,按末次点击原则归因

Install time

应用下载时间

应用首次打开时间

时区

应用商店的本地时区

UTC时区

转化数据

ASA带来的新增激活更新到AppsFlyer后台可能会有5秒钟的延时

在5秒之内完成归因,归因完成时转化数据API立即响应。如果未接收到任何数据,则表示该次响应为自然转化

成本数据

上报所有关键词的成本数据

群组面板或群组API中不上报包含大写字母的成本数据

地理位置

Apple Search Ads允许广告主根据国家和地区来进行定向投放,但支持的国家有限。

AppsFlyer根据IP地址来识别用户的准确地理位置,因此可上报Apple Search Ads中不可用的地理位置信息。

请注意:用户从自己所处国家的应用商店下载并激活应用时,AppsFlyer上报的地理位置数据与ASA一致。

提示

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

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

建议 细节

获取关键词数据

Apple Search Ads与AppsFlyer共享关键词数据。您可以通过原始数据和数据分析工具(数据透视表、留存和群组)查看关键词数据。

请注意:关键词数据可能会延迟8-12小时,且有些情况下仅包含关键词ID,没有关键词内容。

如果AppsFlyer后台出现关键词数据缺失,可能是有以下原因造成的:

  • 套餐类型: 关键词数据由Apple Search Ads与具有Apple Search Ads 高级 套餐的广告客户共享。
  • 广告系列类型: 您可以在Apple搜索广告中配置不同的广告系列关键词匹配类型。根据匹配类型,Apple Search Ads共享以下关键词:
    • 完全匹配 :用户搜索的确切关键词
    • 广泛匹配 :Apple用于执行搜索的关键词。类似于用户的实际搜索词。
    • 搜索匹配 :Apple不会将这些关键词共享给广告主。
  • 区分大小写:ASA营销API会返回区分大小写的数据,而ASA归因APi则会返回全部小写的数据。为避免报告中的数据差异,请仅使用小写关键词。

仅exact match(精准匹配)或broad match(广泛匹配)搜索广告可上报完整的关键词数据。

根据关键词数据比较用户质量

关键词也有优劣之分,即使有些关键词的成本相同,但吸引到的用户质量不同。您可以使用留存数据透视表来找出ROI表现最佳的关键词。

分析关键词成本

当ASA关键词广告配置为exact match(精准匹配)或broad match(广泛匹配)时,AF后台可提供汇总的关键词成本数据。关键词成本数据具有以下特征:

限制

  • 仅可使用上述维度来对成本数据进行筛选和分组。也就是说,您无法使用地理位置等维度对成本数据进行筛选或分组。

 示例

群组示例

以下示例展示了可用于查看成本和ROI信息的群组设置。

群组设置

CohortRequest.png

得到的群组数据表

下表展示了总体成本和群组ROI

CohortTable.png

数据透视表示例

数据透视表设置

Pivot_define.png

得到的数据透视表

Pivot.png

找出效果最好的广告组

creative_sets.png

建议测试潜在用户对不同广告组的反馈。投放效果最好的广告组转化率最高,且转化的用户与应用的互动更多。

广告素材不仅会影响到ASA用户的转化,还包括所有的iOS用户,因为他们都是在应用商店中接触到您的应用的。对于ASA带来的激活,AppsFlyer会在原始数据Ad ID参数中显示广告组ID,这样您就能对比不同广告组的投放效果了。

定向投放到重新下载的用户

将ASA广告定向投放到过去已经使用过您产品的用户,可能会获得最佳的投放效果。

如果一个用户卸载了您的应用,之后因为您的ASA再营销广告而又重新下载、安装、激活了该应用,ASA会将其记录为一次Re-Download(重新下载)。如果该次重装激活发生在再归因窗口期内,那么AppsFlyer将其记录为再归因。如在窗口期外,则记录为新增激活。

ASACGroupID.png

ASA对接变更日志

ASA的对接更新及变更
生效日期 更新/变更

2022-02-16

在ASA对接配置页面启用Cost API后,即可通过Cost API拉取关键词成本数据。请注意:无论广告主订购了何种套餐,都可使用该API。

2021-04-07

Apple Search Ads对接:ASA是独立于SKAdNetwork运作的,能对用户进行确定性归因。也就是说,对于归因到ASA的用户,AF的LTV归因模型能为您提供完整的一系列功能和衡量数据。

2021-03-07

Apple Search Ads推出Campaign Management API V4.0。该API用于成本及其他投放相关数据,不会对归因产生任何影响。我们正在接入更新后的API,您无需进行任何操作。

2021-02-15

此后若启用ASA Cost API,可填充广告系列名称和广告组名称字段。无论广告主订购了何种套餐,都可使用该API。

Apple Search Ads广告字段映射

AppsFlyer原始数据报告字段 说明
Campaign name(广告系列名称) 必须在ASA对接配置页面启用Cost API。请注意:无论广告主订购了何种套餐,都可使用该API。
Campaign ID(广告系列ID)  
Adset name(广告组名称) 必须在ASA对接配置页面启用Cost API。请注意:无论广告主订购了何种套餐,都可使用该API。
Adset ID(广告组ID)  
Ad(广告素材) AdServices API中已弃用
Ad ID(广告素材ID) 在ASA中不是必须配置的字段。如果不配置,AppsFlyer中的对应字段则为空。
Keywords(关键词)

2022年2月16日起上线。必须在ASA对接配置页面启用Cost API。请注意:无论广告主订购了何种套餐,都可使用该API。

AdServices API中已弃用

Keyword ID(关键词ID)

您可通过原始数据报告获取该字段,但需要在Data Locker、Push API和Export中必须明确选择该字段。在调用Pull API时,需要在&additional_fields参数中添加keyword_id

Keyword Match Type(关键词匹配类型)

 

汇总层级高级隐私保护(AAP)的影响

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

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

扩展阅读:汇总层级的高级隐私保护(AAP)

ATT授权状态

点击时间是否可用

点击回溯窗口

说明

可用数据

IDFA是否可用

同意授权

由广告主设置

使用AppsFlyer末次点击归因原则

*用户级别归因数据

拒绝授权

30天
(由ASA设置)

确定性匹配优先

 

用户级别的归因数据,不带点击时间。