---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/searchads-settings.md
  - https://boost.yandex.com/doc/ru/analytics/content/mobile-tracking/searchads-settings.md
  - https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/searchads-settings.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/searchads-settings.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064

# 跟踪 Apple Search Ads 广告活动

Analytics module 跟踪 Apple Search Ads 广告投放活动。 Apple 会自行将搜索广告中的链接与应用安装关联。

{% note info %}

为了在运行 iOS 14.5 或更高版本的设备上对 Apple Search Ads 进行完整归因，我们建议使用 AppMetrica SDK 3.15.1 或更高版本。

{% endnote %}

对于 iOS 14.5 及更高版本，系统会请求用户允许访问广告 ID 并使用跟踪功能。 对于未授权访问IDFA的用户，会使用新的归因系统：AdServices Framework。

对于 iOS 14.4 及更早版本，支持旧版 iAd Framework 的跟踪方法。 用于此目的适合使用 AppMetrica SDK 2.9.4 或更高版本。

对于 iOS 14.5 及更高版本，您也可以使用 iAd Framework，但未授权访问 IDFA 的用户不会被归属。

**归因系统对比**

#|
||   | **iAd 框架** | **AdServices 框架** ||
|| 支持的 iOS 版本 | 10 及以上 | 14.3 及更高版本 ||
|| 为 iOS 14.4 及更低版本的跟踪 | 访问 IDFA 不需要。 iAd 框架仍将继续工作。 | 访问 IDFA 不需要。 AdServices Framework 在运行 iOS 14.3–14.4 版本的设备上工作。 ||
|| iOS 14.5 及更高版本的跟踪限制 | 仅为同意跟踪的用户提供其 IDFA（若在应用中可用）。

不会为未授权访问其 IDFA 的用户进行归属：`ATTrackingManager.AuthorizationStatus = denied` 或 `notDetermined` | 没有授权访问其 IDFA 的用户会被分配较少的详细信息（不包括点击日期）。 ||
|| 如何自定义 |
 - The AppMetrica SDK 2.9.4 或更高版本。
 - 将 iAd Framework 库添加到项目中，按照[说明](#iad)进行操作。 | The AppMetrica SDK 3.15.1 或更高版本。 ||
|| 可用的广告活动参数 |

`iad-org-name` — 字符串。 宣传活动所属组织的名称。

`iad-org-id` — 整数。 广告活动所在组织的ID。

`iad-campaign-id` — 整数。 广告所属的推广活动 ID。

`iad-campaign-name` — 字符串。 广告所属的宣传活动名称。

`iad-点击日期` — 日期/时间字符串。 广告点击的日期和时间。

`iad-购买日期` — 日期/时间字符串。 用户首次下载您的应用的日期和时间。 当 `iad-conversion-type` 的值为 `redownload` 时，`iad-purchase-date` 是原始下载的日期。 下载可能与 Apple Search Ads 中的广告无关。

`iad-转换日期` — 日期/时间字符串。 用户点击广告后下载您应用的日期和时间。

`iad-conversion-type` — 字符串。 转换类型。 可能的值：`新下载` — 首次下载，`重新下载` — 已安装您应用的用户的下载。

`iad-adgroup-id` — 整数。 广告组的ID。

`iad-adgroup-name` — 字符串。 广告组的名称。

`iad-country-or-region` — 字符串。 与导致安装的广告投放相关的国家或地区。

`iad-keyword` — 字符串。 导致广告展示和点击的关键词。

`iad-keyword-id` — 整数。 导致广告展示的关键词的ID。

`iad-keyword-matchtype` — 字符串。 导致广告展示的关键词匹配类型。

`iad-creativeset-id` — 整数。 刊物集的ID。

`iad-creativeset-name` — 字符串。 副本集的名称。 |

只支持实体 ID。

`orgId` — 整数。 宣传活动所在组织的ID。

`campaignId` — 整数。 广告所属的活动 ID。

`转换类型` — 字符串。 转换类型。 可能的值：`新下载` — 首次下载，`重新下载` — 已安装过你的应用的用户的下载。

`点击日期` — 日期/时间字符串。 广告点击的日期和时间。

`adGroupId` — 整数。 广告组的ID。

`国家或地区` — 字符串。 与导致安装的广告活动相关的国家或地区。

`keywordId` — 整数。 导致广告展示和点击的关键词的ID。

`creativeSetId` — 整数。 刊物集的ID。

名称不支持。 ||
|#

{% list tabs %}

- iAd Framework

  **步骤 1. 集成 iAd Framework**

  :   将 iAd Framework 集成到已安装 AppMetrica SDK 的应用程序中，以便 Apple Search Ads 能够检测并链接应用安装。 集成说明位于[搜索广告网站](https://developer.apple.com/documentation/iad/setting_up_apple_search_ads_attribution)（请参见**将 iAd Framework 添加到 Xcode 项目**这一段）。

      {% cut "在 Unity 中启用 iAd 框架" %}

      在 Unity 3D 界面中，转到 **设置** → **其他设置** → **脚本定义** → **符号**。 添加 APP_METRICA_ADD_IAD_FRAMEWORK 指令。

      {% note info %}

      如果你在 Xcode 项目中已添加 iAd Framework，就不需要添加指令。

      {% endnote %}

      {% endcut %}

      在添加 iAd Framework 后，AppMetrica SDK 会自动检测来自 Apple Search Ads 的安装。

  **步骤 2. 执行测试安装**

  :   创建一项测试的搜索广告活动，并通过广告位安装应用。 该源的跟踪器会自动出现在Analytics module界面中。

  **步骤 3. (_可选_) 配置归因**

  :   使用跟踪器配置设置搜索广告归因

      1. 转到**跟踪器**部分。 要按媒体源过滤追踪器，请点击左侧菜单中的**媒体源**下拉列表，然后选择**Apple Search Ads**。
      2. 从列表中选择要设置归因的追踪器。 追踪器名称与 Apple Search Ads 广告系列名称相同。
      3. 在**归因设置**部分做出必要的修改，然后点击**保存**。 了解有关设置[归因](add-tracker.md#step4)的更多信息。

  **第4步。 (_可选_) 配置回传**

  :   广告活动参数可以通过回传（类似于宏）发送。 例如，要在 postback URL 中传递活动 ID，请在 `campaign_id` 参数中指定 `campaign_id={iad-campaign-id}`. 您也可以使用所有[系统宏](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-specification.md)。

      在追踪器设置中配置postbacks：

      1. 转到**跟踪器**部分。 要按媒体源过滤跟踪器，请点击左侧菜单中的**媒体源**下拉列表，然后选择**Apple Search Ads**。
      2. 从列表中选择要设置 postback 的追踪器。 跟踪器名称与 Apple Search Ads 广告系列名称一致。
      3. 在**Postback 设置**部分做出必要的修改，然后点击**保存**。 关于设置[回传](add-tracker.md#step5)的更多信息。

- AdServices Framework

  您可以使用 AdServices Framework 来识别未授权访问广告 ID 和跟踪的用户。 要切换到此跟踪系统，请将 AppMetrica SDK 更新至 3.15.1 版本。 无需进一步配置。

  该 AppMetrica SDK 版本 3.15.0 及以下不支持 AdServices Framework，且在无法访问 IDFA 时无法对用户进行归因。

  **步骤 1. 执行测试安装**

  :   创建一项测试广告活动（搜索广告），并通过广告投放安装应用。 该源的跟踪器会自动出现在Analytics module界面中：

      ![测试](../../_images/searchads-zh.png){style="border: solid 1px #cccccc; max-width: 800px;"}

  **步骤 2. (_可选_) 配置归因**

  :   使用跟踪器配置设置搜索广告归因

      1. 转到**跟踪器**部分。 要按媒体源过滤追踪器，请点击左侧菜单中的**媒体源**下拉列表，然后选择**Apple Search Ads**。
      2. 从列表中选择要设置归因的追踪器。 追踪器名称与 Apple Search Ads 广告系列名称相同。
      3. 在**归因设置**部分做出必要的修改，然后点击**保存**。 了解有关设置[归因](add-tracker.md#step4)的更多信息。

  **步骤 3. (_可选_) 配置回传**

  :   广告活动参数可以通过回传（类似于宏）发送。 例如，要在 postback URL 中传递活动 ID，请在 `campaign_id` 参数中指定 `campaign_id={campaignId}`. 您也可以使用所有[系统宏](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-specification.md)。

      在追踪器设置中配置postbacks：

      1. 转到**跟踪器**部分。 要按媒体源过滤追踪器，请点击左侧菜单中的**媒体源**下拉列表，然后选择**Apple Search Ads**。
      2. 从列表中选择要设置 postback 的追踪器。 追踪器名称与 Apple Search Ads 广告系列名称相同。
      3. 在**Postback 设置**部分做出必要的修改，然后点击**保存**。 关于设置[回传](add-tracker.md#step5)的更多信息。

{% endlist %}

<!-- source: zh/analytics/content/_includes/feedback-button.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/analytics/content/_includes/feedback-button.md -->