Apple Search Ads对接设置指南

推荐用于
营销人员
最近更新：

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

apple_search_ads.png

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

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

ASA对接设置指南

上手指南

前期准备

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

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

请先进入Partner Marketplace平台搜索该渠道，然后前往活跃对接页面完成其设置操作。请按照下文说明，在各个选项卡中完成相关的对接配置。

 注意

设置对接前，请务必先联系相关渠道并在其平台上开设账户。

对接选项卡

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

板块 细节
对接激活

请按以下方式启用或修改该对接：

  1. 启用方式：从AppsFlyer后台的侧边栏中选择协作 > Partner Marketplace。
    修改方式：从AppsFlyer后台的侧边栏中选择协作 > 活跃对接。
  2. 搜索并选择相关渠道。
  3. 点击设置对接。界面会跳转到对接设置页。
  4. 进入对接选项卡，选择需要对接的应用，并打开启用该渠道开关。
    请注意：在您与该渠道合作期间，请确保该开关总是处于打开（启用）状态。
  5. 请按照下文说明，通过相关选项卡完成对接配置。
激活归因

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

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

范围：1–30天
重装激活

重装激活归因

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

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

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

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

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

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

不活跃窗口期

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

成本选项卡

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

  • 广告系列、广告组、国家/地区和关键词维度的成本数据。详情请见广告平台成本对接表，其中详细说明了适用维度、指标和功能。
    请注意：您需要购买ROI360才能获得成本数据。
  • 点击、展示数据以及扩充数据——关键词、广告系列名称以及广告组。

注意事项

  • ASA成本对接支持同时使用多个ASA账户。也就是说，如果您使用不同的ASA账户投放同一个应用的广告，AppsFlyer能够接收所有相关账户的数据。
  • ASA的报告API不上报“campaign groups”（广告系列组）的成本数据，因此AppsFlyer后台没有该数据。
  • 如需使用Apple账户登录，您需要有ASA管理员权限（只读或读写权限都可以）。
  • 通过Apple登录时，您之前提供的所有API证书都会停止拉取数据。
  • 通过Apple登录时，ASA campaign group（广告系列组）的授权无法累积。也就是说当您对接新的应用时，针对以往应用选定的campaign group授权会被撤销，需要重新选定。
  • 通过Apple登录时，不能使用federated login（联合登录）。

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

您可以在成本（及广告收入）对接状态面板或单独的广告平台面板中查看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名称中使用特殊则符或空格。
  • 通过Apple登录时，ASA campaign group（广告系列组）的授权无法累积。也就是说当您对接新的应用时，针对以往应用选定的campaign group授权会被撤销，需要重新选定。您需要选择部分权限，并勾选各个相关的campaign group（用于您代替广告主对接的应用）。

广告主需要完成的操作

前期准备：

为代理开放权限。

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

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

代理需要完成的操作

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

    ASACGroupID.png

  2. 在AppsFlyer选择相关应用。
  3. 在AppsFlyer后台的侧边栏中选择协作 > 活跃对接。
  4. 选择Apple Search Ads。
  5. 输入Apple Search Ads Campaign ID参数。请注意：请仅输入数字。
  6. 点击保存。

 注意事项

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

成本、点击和展示数据

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

请按以下步骤启用成本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. 点击保存对接。

其他相关信息

ASA归因

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

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

ATT授权

点击时间是否可用

点击回溯窗口

说明

是

是

由广告主设置

使用AppsFlyer末次点击归因原则

否

否

30天
（由ASA设置）

 无点击时间，确定性匹配优先

数据差异

由于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

与AppsFlyer SDK版本有关的差异

转化衡量与AppsFlyer 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天固定窗口期

对于没有点击时间的AdServices响应，点击回溯窗口是固定的（30天）。

获得归因的点击

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

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

Install time

应用下载时间

应用首次打开时间

时区

应用商店的本地时区

UTC或AppsFlyer后台应用配置中的指定时区

转化数据

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，没有关键词内容。
  • 如需获取关键词数据，请务必确保您的“成本”开关已打开。关键词数据通过成本对接提供，无需购买ROI360即可获取。

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

  • 套餐类型： 关键词数据由Apple Search Ads与具有Apple Search Ads 高级 套餐的广告客户共享。
  • 广告系列类型： 您可以在Apple搜索广告中配置不同的广告系列关键词匹配类型。根据匹配类型，Apple Search Ads共享以下关键词：
    • 完全匹配 ：用户搜索的确切关键词
    • 广泛匹配 ：Apple用于执行搜索的关键词。类似于用户的实际搜索词。
    • 搜索匹配 ：Apple不会将这些关键词共享给广告主。

仅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上所有潜在用户的转化，因为这些用户都会通过App Store接触到您的应用。对于ASA带来的激活，AppsFlyer会在原始数据的Ad ID参数中显示广告组ID，这样您就能对比不同广告组的投放效果了。

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

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

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

ASACGroupID.png

ASA对接变更日志

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

2023-02-07

Campaign name（广告系列名称）、Adset name（广告组名称）和Keywords（关键词）这三个扩充归因参数仅在成本功能开启时可用，与您订购的套餐无关。
也就是说，如果您想要在您的面板和原始数据报告中看到广告系列名称、广告组名称和关键词信息，就必须开启成本功能。

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的广告参数可用性

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

原始数据报告参数 可用条件
Campaign name（广告系列名称） 必须在ASA对接配置页面中启用Cost API后才能看到该参数。无论广告主订购了何种套餐，都可使用该API。
Campaign ID（广告系列ID） 总是可用
Adset name（广告组名称） 必须在ASA对接配置页面中启用Cost API后才能看到该参数。无论广告主订购了何种套餐，都可使用该API。
Adset ID（广告组ID） 总是可用
Ad（广告） 目前不可用
Ad ID（广告ID）
该参数仅在同时符合以下两个条件时可用：
  • 用户的操作系统为iOS 15.2及以上
  • 相关广告使用了Custom Product Pages（自定义产品页），且其广告系列投放在以下任一广告位：
    • Today tab
    • Search results 
Keywords（关键词） 必须在ASA对接配置页面中启用Cost API后才能看到该参数。无论广告主订购了何种套餐，都可使用该API。
Keyword ID（关键词ID）

该参数可通过原始数据报告获取。如果您使用Data Locker、Push API和数据导出页，需要在其中手动选择该字段。对于Pull API，则需在调用时在&additional_fields参数中添加keyword_id。
Keyword Match Type（关键词匹配类型）

目前不可用

汇总层级高级隐私保护（AAP）的影响

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

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

ATT授权状态

点击时间是否可用

点击回溯窗口

说明

可用数据

IDFA是否可用

同意授权

是

由广告主设置

使用AppsFlyer末次点击归因原则

*用户级别归因数据

是
拒绝授权

否

30天
（由ASA设置）

确定性匹配优先

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

否

 

另请参见