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

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

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

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

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

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

前提条件

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

ステップ 1: i-mobile の UI で設定を行う

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後で AdMob 管理画面でメディエーション用に 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: AdMob の管理画面で i-mobile のデマンドを設定する

広告ユニットのメディエーション設定を構成する

Android

手順については、Android のガイドの手順 2 をご覧ください。

iOS

手順については、iOS のガイドの手順 2 をご覧ください。

ステップ 3: i-mobile SDK とアダプタをインポートする

プロジェクトのルート ディレクトリに、i-mobile 用の Google Mobile Ads SDK for React Native メディエーション アダプターをインストールします。次の手順に沿って操作します。

  1. Google Mobile Ads SDK for React Native アダプタの tar ファイルを gma-sdk-react-native/adapters/imobile/ ディレクトリからプロジェクトの local_packages/ ディレクトリにコピーします。adapters フォルダがない場合は、前提条件をご覧ください。

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/imobile/gma-mediation-imobile-0.1.0.tgz local_packages/

    EXTRACT_DIR は、アーカイブを抽出したディレクトリのパスに置き換えます。

  2. 任意のパッケージ マネージャーを使用して、アダプタ パッケージをインストールします。

    npm

    npm install ./local_packages/gma-mediation-imobile-0.1.0.tgz

    毛糸

    yarn add ./local_packages/gma-mediation-imobile-0.1.0.tgz

  3. Android 向けにビルドする場合は、プロジェクトの android ディレクトリにある build.gradle ファイルに次のリポジトリを追加します。

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

ステップ 4: 必要なコードを追加する

Android

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

iOS

SKAdNetwork の統合

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

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

テスト広告を有効にする

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

iOS

エラーコード 理由
0-10 i-mobile SDK がエラーを返しました。詳しくは、コードをご覧ください。
101 AdMob 管理画面で設定された i-mobile サーバーのパラメータが不足しているか、無効です。
102 リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。
103 i-mobile で広告を表示できませんでした。
104 i-mobile から空のネイティブ広告配列が返されました。
105 i-mobile でネイティブ広告アセットをダウンロードできませんでした。
106 i-mobile では、同じスポット ID を使用して複数のインタースティシャル広告をリクエストすることはできません。

バージョン 0.1.0

  • 初回リリース。