集成 Mobile Ads SDK

系统：YAN、Adfox

将 Yandex Mobile Ads SDK 集成到您的应用中是投放广告和创收的第一步。集成 SDK 后，您可以为应用变现选择一种广告格式（例如横幅广告或激励广告）并进行设置。

前提条件

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

应用要求

• 使用 Android Studio 2021 或更高版本。
• 使用 Android Gradle 插件版本 8.7.0 或更高版本。
• 检查您的应用的构建文件是否使用以下值：
  • minSdkVersion 21 或更高版本。
  • compileSdkVersion 34 或更高版本。
• 如果在应用中使用 AppMetrica SDK，请确保您已安装 7.2.1 或更高版本（主版本 7 以内）。

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

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

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

设置您的应用

1. 将对 Google 和 Maven 中央存储库的支持添加到项目配置中。

   根据构建设置，这些存储库可以添加到项目的 build.gradle 文件或 settings.gradle 的存储库块中，如下所示：

   build.gradle

   设置.gradle

   // 项目级别 build.gradle 文件
   buildscript {
       repositories {
           google()
           mavenCentral()
       }
   }
   
   allprojects {
       repositories {
           google()
           mavenCentral()
       }
   }
   

   // 项目级别 settings.gradle 文件
   pluginManagement {
       repositories {
           google()
           mavenCentral()
           gradlePluginPortal()
       }
   }
   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
       }
   }
   

2. 将 Yandex Mobile Ads SDK 的某个依赖项添加到应用模块级别的 Gradle 文件中（通常为 app/build.gradle）：

   dependencies {
     implementation 'com.yandex.android:mobileads:7.18.5'
   }
   

3. 设置使用广告 ID 的权限（适用于使用 4.5.0 之前版本 SDK 的应用）。

   如何设置使用广告 ID 的权限

   广告 ID 是 Google Play 服务提供的唯一标识符，用于向选择个性化广告的用户展示广告。用户可以选择退出广告个性化设置或在设置中重置其 ID。在这种情况下，广告网络将无法使用该 ID 为用户选择相关广告。

   如果您的应用运行低于 4.5 的 Yandex Mobile Ads SDK 版本，请将 com.google.android.gms.permission.AD_ID 添加到 AndroidManifest.xml 文件中：

   <manifest>
       <application>
       <!-- For apps targeting Android 13 or higher & Yandex Mobile Ads SDK versions lower than 4.5.0 -->
           <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
       </application>
   </manifest>
   

   从版本 4.5.0 开始，Yandex Mobile Ads SDK 默认添加 com.google.android.gms.permission.AD_ID。因此，您不必在应用程序的主清单中指定它。该权限允许您使用广告 ID 从广告网络中选择更相关的广告。

   如果需要，您可以删除该权限。例如，如果政策不允许使用 ID 来选择广告，例如家庭政策。

   要防止将该权限添加到应用程序的主清单中，请将以下代码添加到 AndroidManifest.xml 中：

   <manifest>
       <application>
           <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
       </application>
   </manifest>
   

   重要

   缺少 ID 使用权限和访问权限可能会影响您的收入，因为您的应用可能会投放相关性较低的广告。

初始化 Yandex Mobile Ads SDK

成功初始化Yandex Mobile Ads SDK 是正确集成库的前提条件。默认情况下，SDK 会在您的应用启动时自动初始化。这会加快广告加载速度，从而增加您的变现收入。

如果您需要在应用中设置 个人数据隐私政策，请确保在初始化 Yandex Mobile Ads SDK 之前执行此操作。

您可以使用 AndroidManifest.file 或在手动初始化 SDK 之前设置这些政策。

<manifest>
    <application>
        <!-- Disable the use of child's personal data for app monetization.  -->
        <meta-data
          android:name="@string/yandex_mobileads_age_restricted_user"
          android:value="true" />
    </application>
</manifest>

手动 SDK 初始化

如有必要，您可以禁用自动初始化，并使用 initialize() 方法对库手动进行初始化。

<manifest>
    <application>
        <!-- Disable automatic sdk initialization.  -->
        <meta-data
            android:name="com.yandex.mobile.ads.AUTOMATIC_SDK_INITIALIZATION"
            android:value="false" />
    </application>
</manifest>

我们建议将初始化代码添加到 Application 类的 onCreate 方法中。请确保在初始化 SDK 之前设置 个人数据隐私政策。

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // 在 sdk 初始化之前配置用户数据隐私政策
        MobileAds.initialize(this) {
            // 现在您可以使用广告了
        }
    }
}

public class MyApplication extends Application {
    @Override
    public void onCreate() {
       super.onCreate();
        // 在 sdk 初始化之前配置用户数据隐私政策
        MobileAds.initialize(this, () -> {
            // 现在您可以使用广告了
        });
    }
}

测试 SDK 集成

您可以使用 SDK 的内置集成测试工具验证库集成是否成功。

为此，在添加依赖项并初始化 SDK 后，请重新构建项目。

打开 Logcat 并搜索“Yandex Ads”关键词。

该命令将输出集成状态日志。您将会看到一条消息，显示集成是否成功。如果存在问题，您将会看到详细描述以及解决步骤。示例命令输出：

mobileads$ adb logcat | grep 'Yandex Ads' -i
[Yandex Ads]  I  Yandex Mobile Ads 7.18.5 integrated successfully
[Yandex Ads]  I  Yandex Mobile Ads 7.18.5 initialized successfully

日志显示两个单独的事件：

• “集成成功”：集成检查（SDK 尚未初始化）。
• “初始化成功”：SDK 初始化成功。

过时库版本的指示器

如果 Yandex Mobile Ads SDK 版本已过时，则会在库初始化或加载时显示一个提示条形式的指示器。

问题详细信息也记录到应用日志中。

示例日志：

***************************************************************************************
* The integrated version of the Yandex Mobile Ads SDK is outdated.                    *
* Please update com.yandex.android:mobileads to the latest version.                   *
* Learn more about the latest version of the SDK here:                                *
* https://yandex.ru/dev/mobile-ads/doc/android/quick-start/android-ads-component.html *
* Changelog: https://yandex.ru/dev/mobile-ads/doc/intro/changelog-android.html        *
***************************************************************************************

要禁用指示器，请调用 enableDebugErrorIndicator 方法并将其设置为 false：

MobileAds.enableDebugErrorIndicator(false)

面向最新 SDK 版本的 Lint 检查

构建应用的发布版本时，将运行 lint 检查，以验证您使用的是否为最新 SDK 版本。

Lint 检查是通过调用 lintVitalRelease gradle 任务触发的，如果广告 SDK 版本已过时，该任务会崩溃。

如果有更新的 SDK 版本可用，该检查将不会允许应用构建。

要禁用对最新 SDK 版本的检查，请使用通过 gradle 代码阻止 lint 检查这一标准方法（有关详细信息，请参阅 Android 文档）。

android {
    lintOptions {
        disable 'MobileAdsSdkOutdatedVersion'
    }
}

下一步

成功集成 Yandex Mobile Ads SDK 后，您就可以开始实施广告格式了。

选择以下最适合您的应用的广告类型之一：