将 i-mobile 与中介集成

本指南介绍了如何使用 Google Mobile Ads Flutter Plugin 通过中介加载和展示来自 i-mobile 的广告,其中涵盖了瀑布流集成。其中介绍了如何将 i-mobile 添加到广告单元的中介配置,以及如何将 i-mobile SDK 和适配器集成到 Flutter 应用中。

i-mobile 的信息中心界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图未翻译。不过,在本指南的说明和说明中,标签和按钮会翻译成英文,并在括号中注明。

支持的集成和广告格式

i-mobile 的 Ad Manager 中介适配器具有以下功能:

集成
出价
瀑布流
格式
开屏广告
横幅广告
插页式广告
已获得奖励
插页式激励广告
原生

前提条件

在继续操作之前,请验证以下事项:

  • 最新 Google Mobile Ads Flutter Plugin 版本。
  • Flutter 框架 3.7.0 版或更高版本。
  • 如需在 Android 上部署,则要求:
    • Android API 级别 24 或更高级别。
  • 如需在 iOS 上部署,则要求:
    • iOS 部署目标版本为 13.0 或更高版本。
  • 已配置 Google Mobile Ads Flutter Plugin 的 Flutter 项目,该项目应正常运行。如需了解详情,请参阅设置 Google Mobile Ads Flutter Plugin。
  • 设置中介。
  • 第 1 步:在 i-mobile 界面中设置配置

    注册或登录您的 i-mobile 账号。

    点击サイト/アプリ管理(网站/应用管理)标签页和应用平台对应的按钮,将您的应用添加到 i-mobile 信息中心。

    Android

    iOS

    填写表单,然后点击新規登録(注册)按钮。

    Android

    iOS

    如需创建新的广告位,请在サイト/アプリ管理(网站/应用管理)标签页下选择您的应用。

    Android

    iOS

    前往 广告插播位管理 (Ad Spot Management) 标签页,然后点击 新建广告插播位 (New Ad Spot) 按钮。

    create_ad_spot

    接下来,填写表单,提供広告スポット名(广告插播位名称)、広告スポットサイズ(广告插播位尺寸)和其他详细信息。然后,点击 新規登録 (Sign up) 按钮。

    new_ad_spot_form

    您的新广告插播位已准备就绪。如需查看其集成详情,请点击アプリ設定取得(获取应用设置)按钮。

    ad_spot_list

    记下パブリッシャー ID(发布商 ID)、メディア ID(媒体 ID)和スポット ID(广告位 ID)。稍后在 Ad Manager 界面中配置 i-mobile 以进行中介时,您需要用到这些参数。

    Android

    iOS

    更新 app-ads.txt

    应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划,有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入,您需要实施 app-ads.txt 文件。 如果您尚未创建 app-ads.txt 文件,请为 Ad Manager 创建 app-ads.txt 文件。

    如需为 i-mobile 实现 app-ads.txt,请参阅其常见问题解答。

    第 2 步:在 Ad Manager 界面中设置 i-mobile 需求

    为广告单元配置中介设置

    Android

    如需查看相关说明,请参阅 Android 指南中的第 2 步。

    iOS

    如需查看相关说明,请参阅 iOS 指南中的第 2 步。

    第 3 步:导入 i-mobile SDK 和适配器

    通过 pub.dev 进行集成

    (仅限 Android)将以下代码库添加到项目 android 目录下的 build.gradle 文件中:

      repositories {
          google()
          mavenCentral()
          maven {
              url = uri("https://imobile.github.io/adnw-sdk-android")
          }
      }
    

    在软件包的 pubspec.yaml 文件中添加以下依赖项,并确保使用的是 i-mobile SDK 和适配器的最新版本:

    dependencies:
      gma_mediation_imobile: ^1.0.6
    

    手动集成

    下载适用于 i-mobile 的最新版本 Google 移动广告中介插件,解压缩下载的文件,然后将解压缩后的插件文件夹(及其内容)添加到您的 Flutter 项目中。然后,通过添加以下依赖项,在 pubspec.yaml 文件中引用该插件:

    dependencies:
      gma_mediation_imobile:
        path: path/to/local/package
    

    第 4 步:其他必需的代码

    Android

    i-mobile 集成不需要额外的代码。

    iOS

    SKAdNetwork 集成

    按照 i-mobile 的文档中的说明,将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

    第 5 步:测试您的实现

    启用测试广告

    确保针对 Ad Manager 注册测试设备。 i-mobile 提供了测试广告位 ID、媒体 ID 和发布商 ID 供测试使用,您可以在此处找到这些 ID。

    验证测试广告

    若要验证您是否能收到来自 i-mobile 的测试广告,请在广告检查器中启用单个广告来源测试,并选择 i-mobile(瀑布流)作为广告来源。

    错误代码

    如果适配器未能收到来自 i-mobile 的广告,发布商可以使用 ResponseInfo 来检查广告响应中归属于以下类的底层错误:

    Android

    格式 类名称
    横幅 com.google.ads.mediation.imobile.IMobileAdapter
    插页式广告 com.google.ads.mediation.imobile.IMobileAdapter
    原生 com.google.ads.mediation.imobile.IMobileMediationAdapter

    iOS

    格式 类名称
    横幅 IMobileAdapter
    插页式广告 IMobileAdapter
    原生 GADMediationAdapterIMobile

    以下是当广告加载失败时,i-mobile 适配器会抛出的代码和随附的消息:

    Android

    错误代码 原因
    0-99 i-mobile SDK 返回了错误。如需了解详情,请参阅代码。
    101 i-mobile 需要 Activity 上下文才能加载广告。
    102 在 Ad Manager 界面中配置的 i-mobile 服务器参数缺失或无效。
    103 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。
    104 i-mobile 的原生广告加载成功回调返回了空的原生广告列表。

    iOS

    错误代码 原因
    0-10 i-mobile SDK 返回了错误。如需了解详情,请参阅代码。
    101 在 Ad Manager 界面中配置的 i-mobile 服务器参数缺失或无效。
    102 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。
    103 i-mobile 未能展示广告。
    104 i-mobile 返回了空的原生广告数组。
    105 i-mobile 未能下载原生广告素材资源。
    106 i-mobile 不支持使用同一广告位 ID 请求多个插页式广告。

    i-mobile Flutter 中介适配器变更日志

    版本 1.0.6

    版本 1.0.5

    版本 1.0.4

    版本 1.0.3

    版本 1.0.2

    版本 1.0.1

    版本 1.0.0