Mobile Ads SDK 集成

系统：YAN、Adfox

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

前提条件

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

应用要求

• 使用 Android Studio 2021 或更高版本。
• 使用 Android Gradle 插件 7.3.1 或更高版本。
• 检查您的应用的构建文件是否使用以下值：
  • MinSdkVersion 21 或更高。
  • CompileSdkVersion 31 或更高版本。
• 如果您在应用程序中使用 AppMetrica SDK，请确保已安装第 6 个主版本 (6.x.x)。

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

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

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

设置您的应用

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

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

   build.gradle

   settings.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.7.0'
   }
   

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 集成，请在添加依赖项并初始化 SDK 后重建项目。

启动 Logcat 并搜索“Yandex Ads”关键字。

该命令将生成一个日志，其中包含有关 SDK 集成状态的信息。如果集成成功，您将收到通知。如果集成过程中发生错误，日志将包含有关导致错误的原因以及如何修复错误的详细消息。

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

过时库版本的指示器

在初始化库或加载广告时，有关 Yandex Mobile Ads SDK 版本已过时的指示器会以 toast 形式显示。

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

示例日志：

***************************************************************************************
* 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 检查

针对最新 SDK 版本的 Lint 检查会在构建应用的发布版本时运行。

Lint 检查是通过调用 lintVitalRelease gradle 任务来执行的。如果广告 SDK 版本过时，任务将崩溃。

如果已发布较新的 SDK 版本，此检查会阻止构建应用。

要禁用最新的 SDK 版本检查，请使用标准 gradle 代码禁用 lint 检查（详情请参阅 Android 文档）。

android {
    lintOptions {
        disable 'MobileAdsSdkOutdatedVersion'
    }
}

下一步

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

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