Flutter广告集成插件yandex_mobileads的使用

Mobile Ads Flutter Plugin

Flutter plugin for the Yandex Mobile Ads SDK. The plugin allows Flutter developers to integrate the Yandex Mobile Ads SDK into Android and iOS apps.

文档

• 官方文档

许可证

• EULA

快速开始

1. 导入项目

2. 构建和运行

集成

配置 pubspec

在 pubspec.yaml 文件中添加 YandexMobileAds SDK：

dependencies:
  yandex_mobileads: ^7.7.0

广告中介 (Mediation)

Android

在 android/app/build.gradle 中配置依赖项：

你可以使用包含所有适配器的通用中介依赖（推荐）：

dependencies {
    // ...
    implementation 'com.yandex.android:mobileads-mediation:7.8.0.0'
}

或者你可以手动选择适配器并仅包含它们的依赖项：

dependencies {
    // ...
    implementation 'com.yandex.android:mobileads:7.8.0'
    implementation 'com.yandex.ads.mediation:mobileads-google:23.5.0.0'
    implementation 'com.yandex.ads.mediation:mobileads-inmobi:10.8.0.0'
    implementation 'com.yandex.ads.mediation:mobileads-mytarget:5.22.1.4'
    implementation 'com.yandex.ads.mediation:mobileads-unityads:4.12.5.0'
    implementation 'com.yandex.ads.mediation:mobileads-applovin:12.6.0.5'
    implementation 'com.yandex.ads.mediation:mobileads-ironsource:8.5.0.0'
    implementation 'com.yandex.ads.mediation:mobileads-chartboost:9.3.1.13'
    implementation 'com.yandex.ads.mediation:mobileads-pangle:6.4.0.2.0'
    implementation 'com.yandex.ads.mediation:mobileads-tapjoy:13.4.1.8'
    implementation 'com.yandex.ads.mediation:mobileads-vungle:7.4.2.0'
    implementation 'com.yandex.ads.mediation:mobileads-mintegral:16.8.61.2'
    implementation 'com.yandex.ads.mediation:mobileads-bigoads:5.0.2.0'
}

如果你计划使用 AdMob，你需要在 AndroidManifest.xml 文件中使用 <meta-data> 标签添加你的 AdMob ID：

<manifest>
    <application>
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

某些适配器还需要添加特定的 Maven URL：

在 android/build.gradle 中：

allprojects {
    repositories {
        // ...
        // IronSource
        maven { url 'https://android-sdk.is.com/' }
        // Pangle
        maven { url 'https://artifact.bytedance.com/repository/pangle' }
        // Tapjoy
        maven { url "https://sdk.tapjoy.com/" }
        // Mintegral
        maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
        // Chartboost
        maven { url "https://cboost.jfrog.io/artifactory/chartboost-ads/" }
        // AppNext
        maven { url "https://dl.appnext.com/" }
    }
}

iOS

在 ios/Podfile 中配置依赖项：

你可以使用包含所有适配器的通用中介依赖（推荐）：

pod 'YandexMobileAdsMediation', '~> 7.8.0'

或者你可以手动选择适配器并仅包含它们的依赖项：

pod 'YandexMobileAds', '~> 7.8.0'
pod 'GoogleYandexMobileAdsAdapters', '11.12.0.0'
pod 'InMobiYandexMobileAdsAdapters', '10.7.8.3'
pod 'MyTargetYandexMobileAdsAdapters', '5.22.0.0'
pod 'UnityAdsYandexMobileAdsAdapters', '4.12.4.0'
pod 'AppLovinYandexMobileAdsAdapters', '13.0.1.0'
pod 'IronSourceYandexMobileAdsAdapters', '8.5.0.0'
pod 'MintegralYandexMobileAdsAdapters', '7.7.3.3'
pod 'ChartboostYandexMobileAdsAdapters', '9.8.0.1'
pod 'BigoADSYandexMobileAdsAdapters', '4.5.1.0'
pod 'zMaticooYandexMobileAdsAdapters', '1.5.0.0'

如果你计划使用 AdMob，添加 GADApplicationIdentifier 键与你的 AdMob ID 到应用程序的 Info.plist 文件：

在 ios/Info.plist 中：

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

网络也需要添加特定的 SKAdNetworkIdentifiers 到 SKAdNetworkItems：

在 ios/Info.plist 中：

<key>SKAdNetworkItems</key>
<array>
    <!-- 添加多个 SKAdNetworkIdentifier -->
</array>

示例代码

以下是集成 Yandex Mobile Ads 的完整示例代码：

/*
 * This file is a part of the Yandex Advertising Network
 *
 * Version for Flutter (C) 2023 YANDEX
 *
 * You may not use this file except in compliance with the License.
 * You may obtain a copy of the License at https://legal.yandex.com/partner_ch/
 */

import 'package:flutter/material.dart';
import 'package:yandex_mobileads_sample/pages/app_open_ad_page.dart';
import 'package:yandex_mobileads_sample/policies/policies_page.dart';

import 'pages/banner_ad_page.dart';
import 'pages/home_page.dart';
import 'pages/interstitial_ad_page.dart';
import 'pages/rewarded_ad_page.dart';

void main() => runApp(const YandexMobileAdsApp());

class YandexMobileAdsApp extends StatelessWidget {
  static const colorSchemeSeed = Colors.green;
  static const inputDecorationTheme = InputDecorationTheme(
    border: OutlineInputBorder(),
  );
  static const listTileTheme = ListTileThemeData(
    horizontalTitleGap: 12.0,
  );

  const YandexMobileAdsApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Yandex Mobile Ads',
      theme: ThemeData(
        useMaterial3: true,
        colorSchemeSeed: colorSchemeSeed,
        inputDecorationTheme: inputDecorationTheme,
        listTileTheme: listTileTheme,
      ),
      darkTheme: ThemeData(
        useMaterial3: true,
        brightness: Brightness.dark,
        colorSchemeSeed: colorSchemeSeed,
        inputDecorationTheme: inputDecorationTheme,
        listTileTheme: listTileTheme,
      ),
      routes: {
        '/': (context) => const HomePage(),
        '/app_open': (context) => const AppOpenAdPage(),
        '/banner_sticky': (context) {
          return const BannerAdPage(
            title: 'Sticky banner ad',
            isSticky: true,
          );
        },
        '/banner_inline': (context) {
          return const BannerAdPage(
            title: 'Inline banner ad',
          );
        },
        '/interstitial': (context) => const InterstitialAdPage(),
        '/rewarded': (context) => const RewardedAdPage(),
        '/policies': (context) => const PoliciesPage(),
      },
    );
  }
}

这个示例展示了如何创建一个包含不同广告类型的 Flutter 应用程序。通过定义不同的路由，可以导航到展示不同广告类型的页面。确保你已经按照前面的步骤正确配置了 Yandex Mobile Ads 插件。