---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/ad-monetization/dev/ios/quick-start-mm.md
  - https://boost.yandex.com/doc/ru/ad-monetization/dev/ios/quick-start-mm.md
  - https://boost.yandex.com/doc/zh/ad-monetization/dev/ios/quick-start-mm.md
  - href: https://boost.yandex.com/doc/zh/ad-monetization/dev/ios/quick-start-mm.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


[//]: # (Эта страница переводится также на бразильский португальский — pt-BR)

# 集成 Yandex Mediation

{% note warning %}

请确保更新到最新的适配器版本（[Yandex 移动聚合](https://boost.yandex.com/doc/zh/ad-monetization/dev/ios/list-network.md) 及适配器 [第三方聚合网络适配器](https://boost.yandex.com/doc/zh/ad-monetization/dev/ios/third-party-mediation.md)）。 否则可能会因适配器集成不当而出现错误，导致广告无法投放。


{% endnote %}

[Yandex Mobile 聚合](https://boost.yandex.com/doc/zh/ad-monetization/monetization/yandex-mediation/index.md) 是一个使用机器学习算法从各种网络自动选择广告的平台，可帮助您最大限度地提高收入。 所有设置均已预配置，您可以立即开始使用，而无需单独设置每个网络。

如果您一直在单一 Yandex 网络中使用 Mobile Ads SDK，则迁移到 Yandex 聚合不需要更改代码。 您只需预设第三方广告网络的网页界面的相关部分即可。


## 前提条件 {#prolog}

要准备您的应用，请按照接下来的章节中描述的步骤进行操作。

### 应用要求 {#requirements}

- 使用 iOS 15 或更高版本。
- 使用 Xcode 16.4 或更高版本。

### 在您的 Yandex Advertising Network 账户中设置应用 {#yan}

<!-- source: zh/ad-monetization/dev/_includes/reg.md -->
在 Yandex Advertising Network 中注册您的应用程序：

1. [登录](https://boost.yandex.com/)。
2. 在 Yandex Advertising Network[注册](https://passport.yandex.com/auth/list?origin=rsy_ligth_out&retpath=https%3A%2F%2Fpartner.yandex.com%2Fform%2F?roles%5B%5D=27)您的应用程序。
<!-- endsource: zh/ad-monetization/dev/_includes/reg.md -->

## 集成 {#integration}

您可以通过以下两种方式集成 Yandex 聚合：

* **统一构建（推荐）**：所有可用适配器都会自动连接。
* **连接单独的适配器**：安装 Yandex Ads SDK 并使用适当的包单独连接特定适配器。

{% list tabs %}

- 统一构建

  您可以使用 `YandexMobileAdsMediation` 共享聚合库自动连接所有可用适配器： 该库已适配依赖项管理器：

  {% list tabs radio %}

  - CocoaPods

      如果您需要静态链接：
      1. 在 Yandex Advertising Network 界面中[设置聚合](https://boost.yandex.com/doc/zh/ad-monetization/monetization/yandex-mediation/setup.md)。
      2. 将 `YandexMobileAdsMediation` 库添加到 Podfile。

          ```
          pod 'YandexMobileAdsMediation', '8.6.0'
          ```
          每个适配器将自动选择最新的兼容版本。

      3. 在您的应用的 Info.plist 文件中，添加 `GADApplicationIdentifier` 键，并将其值设置为您的 `AdMob ID`。 详细了解在何处可以 [找到 AdMob ID](https://support.google.com/admob/answer/7356431)。
          ```xml
          <key>GADApplicationIdentifier</key>
          <string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>
          ```

  - Swift Package Manager

    您可以将此方法用于如下外部广告网络：Mintegral、AppLovin、Google AdMob、VK Ads (ex. myTarget) 和 Liftoff (ex. Vungle)：
    1. 在 Yandex Advertising Network 界面中[设置聚合](https://boost.yandex.com/doc/zh/ad-monetization/monetization/yandex-mediation/setup.md)。
    2. 在您的 Xcode 项目中，使用 **File** → **Add Packages dependencies** 添加依赖项。
    3. 指定包含 Swift 包的存储库的 URL：`https://github.com/yandexmobile/yandex-ads-sdk-mediation-ios/`。
    <img src="https://yastatic.net/s3/doc-binary/src/dev/mobile-ads/ru/images/spm-link-repository-mediation.png">
    4. 前往 **Build Settings** 并在 **Linking** 下添加参数值 `Other Linker Flags = -ObjC`。
     <img src="https://yastatic.net/s3/doc-binary/src/dev/mobile-ads/ru/images/spm-build-settings.png">
    5. 确保目标已链接到 YandexMobileAdsPackage。 如果目标未链接，请通过点击 **+** 在 **Link Binary With Libraries** 下添加库。
     <img src="https://yastatic.net/s3/doc-binary/src/dev/mobile-ads/ru/images/target-link-spm-new.png">
    6. 选择您的适配器。 如果不确定需要哪些适配器，请全部添加。
     <img src="https://yastatic.net/s3/doc-binary/src/dev/mobile-ads/ru/images/spm-mediation-adapters.png">

    {% endlist %}

- 连接单独的适配器

  若要连接单独的适配器，请启用 Yandex Ads SDK，然后按照每个适配器的具体说明进行操作：

    1. 在 Yandex Advertising Network 界面中[设置聚合](https://boost.yandex.com/doc/zh/ad-monetization/monetization/yandex-mediation/setup.md)。
    2. 将 `YandexMobileAds` 库添加到 Podfile 中。

        ```
        pod 'YandexMobileAds', 'x.x.x' // 添加支持的版本
        ```

    3. 使用适当的库单独连接所需的[适配器](https://boost.yandex.com/doc/zh/ad-monetization/dev/ios/list-network.md)


{% note info %}

如果您需要移动聚合来追踪应用安装，请务必配置 Info.plist 文件。 详情请参阅 [SKAdNetwork 支持](https://boost.yandex.com/doc/zh/ad-monetization/dev/ios/quick-start.md#skad)。

{% endnote %}

{% endlist %}