集成 Mobile Ads Compose Multiplatform 库

系统：Yandex Advertising Network

Compose Multiplatform 是一项流行的跨平台移动应用开发技术。 它专为软件开发人员编写，可应用于不同操作系统（Android 和 iOS）的通用代码而设计。

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

应用要求

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

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

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

集成

集成 Yandex Mobile Ads SDK 的方式如下：

1. 集成 Yandex Mobile Ads Compose Multiplatform 库。
2. 特定于平台的设置。
3. 初始化库。
4. 测试集成。

集成 Yandex Mobile Ads Compose Multiplatform 库

要将 Yandex Mobile Ads SDK 与您的 Compose Multiplatform 应用集成，请在共享模块中添加 Yandex Mobile Ads Compose Multiplatform 依赖项，并将原生 iOS SDK 与 CocoaPods 连接。

Gradle

在共享模块 build.gradle.kts 的 commonMain 中声明该构件：

commonMain.dependencies {
    implementation("com.yandex.ads.multiplatform:mobileads-compose:8.1.0")
}

iOS (CocoaPods)

将 YandexMobileAds pod 添加到您的 iOS 应用 Podfile 中（如 iosApp/Podfile）。 使用与 Xcode 中相同的目标名称：

source 'https://cdn.cocoapods.org/'

platform :ios, '13.0'

target 'iosApp' do
  use_frameworks!
  pod 'YandexMobileAds', '8.1.0'
end

从包含 Podfile 的目录安装 pod：

cd iosApp && pod install

特定于平台的设置

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

<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>

初始化 Yandex Mobile Ads SDK 库

成功初始化 Yandex Mobile Ads SDK 是正确集成库的重要条件。

默认情况下，对于 Android 系统，SDK 会在您的应用启动时自动初始化。 这会加速广告加载，从而增加您的变现收入。

默认情况下，对于 iOS 系统，SDK 初始化在广告加载之前自动进行，但手动初始化将加快第一个广告加载的速度，从而增加变现收入。

在加载任何广告之前调用 YandexAds.initialize() — 例如，从根可组合项使用 LaunchedEffect：

import com.yandex.mobile.ads.kmp.YandexAds

@Composable
fun App() {
    LaunchedEffect(Unit) {
        YandexAds.initialize()
    }
    // ...
}

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

您可以在初始化 SDK 之前手动或使用 AndroidManifest.file 设置个人数据隐私策略。

测试 SDK 集成

Android

iOS

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

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

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

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

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

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

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

您可以检查日志以确保 SDK 集成正确。

要查看日志，请前往控制台工具并设置 Subsystem = com.mobile.ads.ads.sdk。您可以按类别过滤日志，仅保留与广告 SDK 集成相关的日志。设置 Category = Integration。保存查询，并在需要调试时从过滤行中选择它。

您将看到有关成功集成的消息：启用 YandexMobileAdsBundle.bundle、初始化 SDK 以及连接 SKAdNetwork 和移动聚合适配器（如果您在项目中使用了它们）。

如果 SDK 集成过程中出现任何问题，您将看到详细的问题报告。

后续步骤

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

选择最适合您的应用的广告类型：