このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 を使用して i-mobile の広告を表示する AdMob メディエーション ウォーターフォール統合に対応していますここでは、i-mobile を広告ユニットのメディエーション構成に追加する方法と、i-mobile SDK とアダプタをアプリに統合する方法について説明します。 Android
i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されます。このガイドのスクリーンショットは、 表示されます。ただし、このガイドの説明と手順では、ラベルとボタンは翻訳され、英語の同義語がかっこ内に示されています。
サポートされている統合と広告フォーマット
i-mobile 用メディエーション アダプタの機能は次のとおりです。
統合 | |
---|---|
単価設定 | |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
ネイティブ |
要件
- Android API レベル 21 以降
最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了していること
ステップ 1: i-mobile UI で設定をセットアップする
ステップ 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 とアダプタをインポートする
Android Studio の統合(推奨)
プロジェクト レベルの 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.3.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
手動による統合
最新バージョンの i-mobile SDK をダウンロードし、
sdk
フォルダの下のandroid-ad-sdk.aar
を開き、プロジェクトに追加します。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 | AdMob UI で構成された i-mobile サーバー パラメータが存在しないか、無効です。 |
103 | リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。 |
104 | i-mobile のネイティブ コンテンツ広告の読み込み成功コールバックから、空のネイティブ コンテンツ広告リストが返されました。 |
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 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
- 初回リリース
- バナー広告、インタースティシャル広告、ネイティブ広告のサポートを追加しました。