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

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

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

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

i-mobile 向けメディエーション アダプタの機能は次のとおりです。

統合
単価設定
滝
フォーマット
バナー
インタースティシャル
特典
ネイティブ

要件

  • Android API レベル 21 以降

ステップ 1: i-mobile UI で設定をセットアップする

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

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

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

新しい広告スポットを作成するには、[サイト / アプリ管理（サイト / アプリケーション管理）] タブでアプリを選択します。

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

create_ad_spot

次に、「広告スポット名（広告スポット名）」や「広告スポットサイズ（広告スポットのサイズ）」などの情報をフォームに記入します。次に、[新規登録] ボタンをクリックします。

new_ad_spot_form

新しい広告スポットの準備ができました。統合の詳細を表示するには、[アプリ設定取得（App settings を取得）] ボタンをクリックします。

ad_spot_list

パブリッシャー ID（パブリッシャー ID）、メディア ID（メディア ID）、スポット ID（スポット ID）をメモします。これらのパラメータは、後で UI でメディエーション用に i-Mobile を設定するときに必要になります。 AdMob

ステップ 2: 管理画面で i-mobile デマンドを設定する AdMob

広告ユニットのメディエーション設定を行う

広告ユニットのメディエーション設定に i-mobile を追加する必要があります。

AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを編集する場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして i-mobile を追加するに進んでください。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。

広告フォーマットとプラットフォームを入力して、[続行] をクリックします。

メディエーション グループに名前を付けて、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、既存の 1 つ以上の広告ユニット（AdMob ）に関連付けます。[完了] をクリックします。

選択した広告ユニットが入力された広告ユニットカードが表示されます。

広告ソースとして i-mobile を追加

[広告ソース] セクションの [ウォーターフォール] カードで、[広告のソースを追加] を選択します。i-mobile を選択します。

[i-mobile] を選択して、[最適化] スイッチを有効にします。前のセクションで取得した Login name and API Passwordを入力して、i-mobileの広告ソースの最適化を設定します。 次に、i-mobile の eCPM の値を入力し、[続行] をクリックします。

i-mobileのマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。

次に、前のセクションで取得した Publisher ID, Media ID and Spot IDを入力します。[完了] をクリックします。

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

プロジェクト レベルの settings.gradle.kts ファイルに、次のコードを追加します。 リポジトリ:

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

次に、アプリレベルの build.gradle.kts ファイルに以下を追加します。 構成について説明します。最新バージョンの i-mobile SDK とアダプター:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

手動による統合

  1. 最新バージョンの i-mobile SDK をダウンロードし、 sdk フォルダの下の android-ad-sdk.aar を開き、プロジェクトに追加します。

  2. i-mobile アダプタ アーティファクトに移動します。 Google の Maven リポジトリにあります最新バージョンを選択して i-mobile をダウンロードしてください アダプタの .aar ファイルを開き、プロジェクトに追加します。

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

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

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

テスト広告を有効にする

AdMob。 i-mobile ではテスト用のスポット ID、メディア ID、パブリッシャー ID を提供しています。こちらで確認できます。

テスト広告を確認する

i-mobileからテスト広告を受信していることを確認するには、広告インスペクタで i-mobile (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

省略可能なステップ

ネイティブ広告を使用する

広告のレンダリング

i-mobile アダプタの入力情報は次のとおりです。 ネイティブ アドバンス広告のフィールドの説明 を NativeAd を選択します。

項目 i-mobile アダプタに常に含まれるアセット
広告見出し
画像
本文
アプリのアイコン 1
行動を促すフレーズ
評価
ストア
価格

1 ネイティブ広告の場合、i-mobile SDK にはアプリアイコン アセットは用意されていません。代わりに i-mobile アダプターによってアプリアイコンに透明な画像が表示されます。

エラーコード

アダプタが i-mobile から広告を受け取れない場合は、 広告レスポンスの根本的なエラーを確認するため、 ResponseInfo.getAdapterResponses() 次のクラスに分類されます。

形式 クラス名
バナー com.google.ads.mediation.imobile.IMobileAdapter
インタースティシャル com.google.ads.mediation.imobile.IMobileAdapter
ネイティブ com.google.ads.mediation.imobile.IMobileMediationAdapter

i-mobile アダプターからスローされるコードとそのメッセージは次のとおりです。 広告の読み込みに失敗した場合

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

i-mobile Android メディエーション アダプタに関する変更履歴

バージョン 2.3.2.0

  • i-mobile SDK v2.3.2 との互換性を検証しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 23.1.0.
  • IMobile SDK バージョン 2.3.2.

バージョン 2.3.1.2

  • 必要な Google Mobile Ads SDK の最小バージョンを 23.0.0 に更新しました。
  • i-mobile SDK v2.3.1 との互換性を検証しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 23.0.0 にアップデートします。
  • IMobile SDK バージョン 2.3.1.

バージョン 2.3.1.1

  • 新しい VersionInfo クラスを使用するようにアダプターを更新しました。
  • 必要な Google Mobile Ads SDK の最小バージョンを 22.0.0 に更新しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 22.0.0 にアップデートします。
  • IMobile SDK バージョン 2.3.1.

バージョン 2.3.1.0

  • i-mobile SDK v2.3.1 との互換性を検証しました。
  • 必要な Google Mobile Ads SDK の最小バージョンを 21.5.0 に更新しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 21.5.0.
  • IMobile SDK バージョン 2.3.1.

バージョン 2.3.0.0

  • i-mobile SDK v2.3.0 との互換性を検証しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 21.3.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 21.3.0.
  • IMobile SDK バージョン 2.3.0.

バージョン 2.0.23.1

  • compileSdkVersion と targetSdkVersion を API 31 に更新しました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 21.0.0 に更新しました。
  • 必要な最小 Android API レベルを 19 に更新しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 21.0.0.
  • IMobile SDK バージョン 2.0.23。

バージョン 2.0.23.0

  • i-mobile SDK v2.0.23 との互換性を検証しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 20.5.0 に更新しました。

Google Kubernetes Engine

  • Google Mobile Ads SDK バージョン 20.5.0.
  • IMobile SDK バージョン 2.0.23。

バージョン 2.0.22.2

  • 標準化されたアダプターのエラーコードとメッセージを追加しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 20.1.0 に更新しました。

Google Kubernetes Engine

  • Google Mobile Ads SDK バージョン 20.1.0.
  • IMobile SDK バージョン 2.0.22。

バージョン 2.0.22.1

  • 必要な最小バージョンの Google Mobile Ads SDK を 20.0.0 に更新しました。

Google Kubernetes Engine

  • Google Mobile Ads SDK バージョン 20.0.0 にアップデートします。
  • IMobile SDK バージョン 2.0.22。

バージョン 2.0.22.0

  • i-mobile SDK v2.0.22 との互換性を検証しました。
  • インライン アダプティブ バナー リクエストをサポートするようにアダプタを更新しました。

Google Kubernetes Engine

  • Google Mobile Ads SDK バージョン 19.1.0.
  • IMobile SDK バージョン 2.0.22。

バージョン 2.0.21.0

  • i-mobile SDK v2.0.21 との互換性を検証しました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 19.1.0 に更新しました。
  • アダプティブ バナー広告のスケーリングのサポートを追加しました。

Google Kubernetes Engine

  • Google Mobile Ads SDK バージョン 19.1.0.
  • IMobile SDK バージョン 2.0.21.

バージョン 2.0.20.2

  • 柔軟なバナー広告のサポートが追加されました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 18.3.0 に更新しました。

Google Kubernetes Engine

  • Google Mobile Ads SDK バージョン 18.3.0.
  • IMobile SDK バージョン 2.0.20.

バージョン 2.0.20.1

  • アダプターがゼロ以外の mediaContent アスペクト比を返すようになりました。

Google Kubernetes Engine

  • Google Mobile Ads SDK バージョン 18.2.0.
  • IMobile SDK バージョン 2.0.20.

バージョン 2.0.20.0

  • 初回リリース
  • バナー広告、インタースティシャル広告、ネイティブ広告のサポートを追加しました。