このガイドでは、Google Mobile Ads SDK で AdMob メディエーションを使用して Moloco の広告を読み込んで表示する方法を説明します。入札の統合についても説明します。また、広告ユニットのメディエーション設定に Moloco を追加する方法と、Moloco SDK とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
Moloco 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札単価 | |
| ウォーターフォール | |
| フォーマット | |
| アプリの起動 | |
| バナー | |
| インタースティシャル | |
| 特典 | |
| リワード インタースティシャル | |
| ネイティブ | |
要件
Android API レベル 23 以上
Moloco アダプタのバージョンが 3.8.0.0 以降であること
Google Mobile Ads SDK のバージョンが最新であること
メディエーションのスタートガイドの手順を完了していること
ステップ 1: Moloco の UI で設定を行う
Moloco パブリッシャー ポータルにログインします。
[Overview] > [Apps] タブに移動し、[Add App] ボタンをクリックして新しいアプリを作成します。
アプリの [OS] と [Privacy Settings] を選択し、フォームの残りの部分を入力して、[Create] をクリックします。
アプリを作成したら、[Apps] タブからアプリを選択して詳細を表示し、アプリキーをメモします。
[概要] > [広告ユニット] タブに移動し、プルダウン メニューからアプリを選択して、[新しい広告ユニット] をクリックします。
オークション方法として [In-app bidding] を選択し、フォームの残りの部分を入力します。[作成] をクリックします。
[Ad Units] タブで、新しく作成した広告ユニットに移動して詳細を表示します。広告ユニット ID をメモします。
ステップ 2: AdMob の管理画面で Moloco のデマンドを設定する
広告ユニットのメディエーション設定を構成する
広告ユニットのメディエーション設定に Moloco Ads SDK を追加する必要があります。
まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして Moloco Ads SDK を追加するに進みます。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力し、[続行] をクリックします。
メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。
選択した広告ユニットが広告ユニットカードに表示されます。
広告ソースとして Moloco Ads SDK を追加する
[広告のソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[Moloco Ads SDK] を選択します。[パートナー契約への署名手順] をクリックし、Moloco Ads SDK との入札のパートナーシップを設定します。
[確認して同意する] をクリックし、[続行] をクリックします。
Moloco Ads SDK のマッピングがすでに存在する場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したアプリキーと広告ユニット ID を入力します。[完了] をクリックします。
欧州および米国の州の規制に関する広告パートナーのリストに Moloco Ads を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに Moloco Ads を追加します。
ステップ 3: Moloco SDK とアダプタをインポートする
Android Studio の統合（推奨）
アプリレベルの build.gradle.kts ファイルで、次の実装の依存関係と構成を追加します。Moloco SDK とアダプタの最新バージョンを使用します。
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:moloco:3.12.1.0")
}
ステップ 4: Moloco SDK にプライバシー設定を実装する
EU ユーザーからの同意と GDPR
Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
Moloco SDK には、同意情報を Moloco SDK に渡すための isUserConsent フラグが含まれています。
次のサンプルコードは、同意情報を Moloco SDK に渡す方法を示しています。これらのフラグを設定する場合は、Google Mobile Ads SDK を通じて広告をリクエストする前に設定することをおすすめします。
Kotlin
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ true,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ false);
MolocoPrivacy.setPrivacy(privacySettings);
詳しくは、Moloco SDK Android のドキュメントをご覧ください。
米国のプライバシー関連州法
米国の州のプライバシー法では、ユーザーが「個人情報」の「販売」を拒否する権利を保障することが求められています（用語は法律の定義に基づく）。「販売者」のホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
Moloco SDK には、同意情報を Moloco SDK に渡すための isDoNotSell フラグが含まれています。
次のサンプルコードは、同意情報を Moloco SDK に渡す方法を示しています。これらのフラグを設定する場合は、Google Mobile Ads SDK を通じて広告をリクエストする前に設定することをおすすめします。
Kotlin
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ false,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ true);
MolocoPrivacy.setPrivacy(privacySettings);
詳しくは、Moloco SDK Android のドキュメントをご覧ください。
ステップ 5: 実装をテストする
テスト広告を有効にする
AdMob 用のテストデバイスを登録してください。
テスト広告を確認する
Moloco Ads SDK からテスト広告を受信していることを確認するには、Moloco（入札）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
エラーコード
アダプタが Moloco から広告を受信できなかった場合は、次のクラスの ResponseInfo.getAdapterResponses() を使用して、広告レスポンスから根本原因のエラーを確認できます。
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
広告の読み込みに失敗した場合に Moloco アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | ドメイン | 理由 |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco アプリキーがないか、無効です。 |
| 102 | com.google.ads.mediation.moloco | Moloco 広告ユニット ID がないか、無効です。 |
| 103 | com.google.ads.mediation.moloco | 返された Moloco 広告オブジェクトが null でした。 |
| -1 ～ 5000 | com.moloco.sdk | Moloco SDK がエラーを返しました。詳しくは、Moloco のドキュメントをご覧ください。 |
リワードのサーバーサイド認証
サーバーサイド認証（SSV）コールバックを検証する場合、Moloco 用の広告ソース ID は 8267622065755668722 です。
Moloco Android メディエーション アダプタの変更履歴
バージョン 4.0.0.0（開発中）
バージョン 3.12.1.0
- Moloco SDK 3.12.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.5.0。
- Moloco SDK バージョン 3.12.1。
バージョン 3.12.0.0
- Moloco SDK 3.12.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.4.0。
- Moloco SDK バージョン 3.12.0。
バージョン 3.11.0.0
- Moloco SDK 3.11.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.4.0。
- Moloco SDK バージョン 3.11.0。
バージョン 3.10.0.0
- Moloco SDK 3.10.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.3.0。
- Moloco SDK バージョン 3.10.0。
バージョン 3.9.0.0
- Moloco SDK 3.9.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.2.0。
- Moloco SDK バージョン 3.9.0。
バージョン 3.8.0.1
- ミディアム レクタングルのバナー広告サイズに対するサポートを追加しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.1.0。
- Moloco SDK バージョン 3.8.0。
バージョン 3.8.0.0
- ネイティブ広告フォーマットの入札サポートを追加しました。
- Moloco SDK 3.8.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.1.0。
- Moloco SDK バージョン 3.8.0。
バージョン 3.7.2.0
- Moloco SDK 3.7.2 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.0.0。
- Moloco SDK バージョン 3.7.2。
バージョン 3.7.1.0
- 必要な最小 Android API レベルを 23 に更新しました。
- Google Mobile Ads SDK の必要最小限のバージョンを 24.0.0 に更新しました。
- Moloco SDK 3.7.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.0.0。
- Moloco SDK バージョン 3.7.1。
バージョン 3.7.0.0
- Moloco SDK 3.7.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.6.0。
- Moloco SDK バージョン 3.7.0。
バージョン 3.6.1.0
- Moloco SDK 3.6.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.6.0。
- Moloco SDK バージョン 3.6.1。
バージョン 3.6.0.0
- Moloco SDK 3.6.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.6.0。
- Moloco SDK バージョン 3.6.0。
バージョン 3.5.0.0
- 初回リリース。
- バナー、インタースティシャル、リワードの広告フォーマットの入札サポートを追加しました。
- Moloco SDK 3.5.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.6.0。
- Moloco SDK バージョン 3.5.0。