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

[プラットフォームを選択]: Android（ベータ版） 新規 Android iOS Unity Flutter

このガイドでは、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 レベル 23 以降
  • iOS にデプロイする場合
    • iOS のデプロイ対象のバージョンが 13.0 以降であること
  • Google Mobile Ads Flutter Plugin で構成された正常に動作する Flutter プロジェクト。詳細については、 Set up Google Mobile Ads Flutter Pluginをご覧ください。
  • メディエーションを設定する。

ステップ 1: i-mobile の管理画面で構成を設定する

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

パブリッシャー ID、メディア ID、 およびスポット ID をメモしておきます。これらのパラメータは、後で Ad Manager の管理画面でメディエーション用に i-mobile を設定するときに必要になります。

Android

iOS

app-ads.txt を更新する

アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、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 を使用した統合

パッケージの pubspec.yaml ファイルに、i-mobile SDK とアダプタの最新バージョンを使用して次の依存関係を追加します。

dependencies:
  gma_mediation_imobile: ^1.0.2

手動による統合

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 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.4（開発中）

バージョン 1.0.3（開発中）

  • 最小 Flutter バージョンを 3.35.1 に更新しました
  • Google Mobile Ads Flutter プラグイン バージョン 7.0.0 をサポートするように更新しました

バージョン 1.0.2

バージョン 1.0.1

バージョン 1.0.0