i-mobile をメディエーションと統合する

プラットフォームを選択: Android iOS Unity Flutter Android（以前のバージョン）

このガイドでは、Google Mobile Ads Flutter Plugin を使用して メディエーションで i-mobile の広告を読み込んで表示する方法とウォーターフォール統合について説明します。また、広告ユニットのメディエーション設定に i-mobile を追加する方法と、i-mobile SDK とアダプタを Flutter アプリに統合する方法についても取り上げます。

i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンに対して日本語表記の後に括弧で英語表記を併記しています。

サポートされている統合と広告フォーマット

i-mobile 用のアド マネージャー メディエーション アダプタには、次の機能があります。

統合
入札
ウォーターフォール
フォーマット
アプリの起動
バナー
インタースティシャル
リワード
リワード インタースティシャル
ネイティブ

前提条件

続行する前に、次のことを確認してください。

  • 最新の 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 の UI で設定を行う

    i-mobile アカウントに登録またはログインします。

    [サイト／アプリ管理] タブとアプリのプラットフォームのボタンをクリックして、i-mobile ダッシュボードにアプリを追加します。

    Android

    iOS

    フォームに記入し、[新規登録（Sign up）] ボタンをクリックします。

    Android

    iOS

    新しい広告枠を作成するには、[サイト／アプリ管理] タブでアプリを選択します。

    Android

    iOS

    [広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。

    create_ad_spot

    次に、広告スポット名、広告スポットサイズなどの詳細を入力してフォームに記入します。[新規登録] ボタンをクリックします。

    new_ad_spot_form

    新しい広告スポットが作成されました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。

    ad_spot_list

    パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後でアド マネージャー UI でメディエーション用に i-mobile を設定する際に必要になります。

    Android

    iOS

    app-ads.txt を更新する

    アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告インベントリを販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ作成していない場合は、アド マネージャーの app-ads.txt ファイルを作成します。

    i-mobile で app-ads.txt を実装するには、よくある質問をご覧ください。

    ステップ 2: アド マネージャーの管理画面で 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 Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ（およびそのコンテンツ）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

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

    ステップ 4: 追加のコードが必要

    Android

    i-mobile の統合にコードを追加する必要はありません。

    iOS

    SKAdNetwork の統合

    i-mobile のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。

    ステップ 5: 実装をテストする

    テスト広告を有効にする

    アド マネージャー用のテストデバイスを登録してください。i-mobile はテスト用のスポット 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 アド マネージャーの管理画面で設定された i-mobile サーバーのパラメータが不足しているか、無効です。
    103 リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。
    104 i-mobile のネイティブ広告の読み込み成功コールバックが空のネイティブ広告リストを返しました。

    iOS

    エラーコード 理由
    0-10 i-mobile SDK がエラーを返しました。詳しくはコードをご覧ください。
    101 アド マネージャー UI で設定された 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