集成 Yandex 聚合

重要

请确保更新到最新的适配器版本(Yandex 移动聚合 及适配器 第三方聚合网络适配器)。否则可能会因适配器集成不当而出现错误,导致广告无法投放。

移动聚合 是一个使用机器学习算法从各种网络自动选择广告的平台,能够最大限度地提高您的收入。所有设置均开箱即用,因此您无需单独设置每个网络。

如果您之前仅在一个 Yandex 网络中使用 Mobile Ads SDK,则无需更改代码中的任何内容即可迁移到 Yandex 聚合。您只需预设第三方广告网络的网页界面的相关部分即可。

Mobile Ads Unity 是一款用于 Unity3d 游戏平台的插件,支持 Yandex Mobile Ads SDK。

前提条件

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

应用要求

  • SDK 需要目标 API 级别为版本 31 或更高版本。
  • 要加载任意类型的广告,iOS 版本需为 13 或更高版本。
  • 使用 Xcode 15 或更高版本。

在您的 Yandex Advertising Network 账户中设置应用

以下是在 Yandex Advertising Network 中注册您的应用的方法:

  1. 在 Yandex Advertising Network 中 登录登录 您的账户。
  2. 在 Yandex Advertising Network 中 注册 您的应用。

集成

重要

yandex-ads-unity-plugin 仅在 Android 和 iOS 环境中运行。广告当前无法在 Unity 编辑器中加载和展示。

集成方式有两种:

  • 单一构建(推荐):所有可用的适配器都会自动连接。
  • 连接单独的适配器:使用 lite 包安装 Yandex SDK,并使用适当的包单独连接特定的适配器。

您可以使用通用的 yandex-mobileads-mediation 包自动连接所有可用的适配器。

  1. 在合作伙伴界面中 设置聚合

  2. 下载 yandex-ads-unity-plugin 目录并添加 yandex-mobileads-mediation-7.5.0.unitypackage 包。系统还会提示您安装 Google 解析器。如果您先前已将 Google 解析器添加到自己的项目中,请清除该复选框。

    如何添加包

    选择所需的插件 (Assets → Import Package → Custom Package),然后单击 Import

  3. 使用 Google 解析器安装依赖项:启用 auto-resolve 或者在菜单中选择 Assets → External Dependency Manager → Android Resolver → Resolve

  4. 要测试 Mobile Ads Unity 插件,请使用 yandex-ads-unity-plugin 存储库中的 samples 目录中的演示脚本。将脚本复制到项目目录并将其作为Component 添加到主摄像头。

  5. Google AdMob (ex. AdMob) 网络的其他设置

    • 对于 Android,通过 File → Build Settings → Android → Player Settings → Publishing Settings → Custom Main Manifest(选择复选框)创建主 AndroidManifest.xml 文件。

      在创建的 AndroidManifest.xml 应用程序文件中,使用名为 com.google.android.gms.ads.APPLICATION_ID<meta-data> 标记添加您的 App ID。

      <manifest>
          <application>
      <!--...-->
              <meta-data
                  android:name="com.google.android.gms.ads.APPLICATION_ID"
                  android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      <!--...-->
          </application>
      </manifest>
      
    • 对于 iOS,在生成的 Xcode 项目的 Info.plist 文件中,添加 GADApplicationIdentifier 键,并将其值设置为您的 App ID

      <key>GADApplicationIdentifier</key>
      <string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>
      

    详细了解在何处可以 找到 Google App ID

要连接单独的适配器,请添加一个包含受支持的 yandex-mobileads-lite-x.x.x.unitypackage 版本的包,并按照这些适配器的说明连接所需的适配器:

  1. 在合作伙伴界面中 设置聚合

  2. 下载 yandex-ads-unity-plugin 目录并添加包 yandex-mobileads-lite-7.5.0.unitypackage。系统还会提示您安装 Google 解析器。如果您先前已将 Google 解析器添加到自己的项目中,请清除该复选框。

    如何添加包

    选择所需的插件 (Assets → Import Package → Custom Package),然后单击 Import

  3. 使用 Google 解析器安装依赖项:启用 auto-resolve 或者在菜单中选择 Assets → External Dependency Manager → Android Resolver → Resolve

  4. 要测试 Mobile Ads Unity 插件,请使用 yandex-ads-unity-plugin 存储库中的 samples 目录中的演示脚本。将脚本复制到项目目录并将其作为Component 添加到主摄像头。

  5. 使用适当的包单独连接所需的 适配器

上一篇