集成 Mobile Ads Flutter 插件

系统：Yandex Advertising Network

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

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

应用要求

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

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

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

集成

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

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

集成 Yandex Mobile Ads Flutter 插件

要将 Yandex Mobile Ads SDK 与您的 Flutter 应用集成，请使用 Yandex Mobile Ads Flutter 插件。

为您的项目安装 Yandex Mobile Ads Flutter 插件。从项目根目录执行命令：

flutter pub add yandex_mobileads

添加插件后，包含依赖项的行将添加到 pubspec.yaml：

dependencies:
    yandex_mobileads: ^8.1.0

特定于平台的设置

<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();调用添加到应用小部件的 initState：

@override
void initState() {
  super.initState();
  // 在 init sdk 之前配置用户隐私数据策略
  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 后，您就可以实施广告格式了。

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