このガイドでは、GMA Next-Gen SDK を使用して Moloco の広告を読み込んで表示する方法を説明します。AdMob メディエーション を使用し、入札の統合についても説明します。また、広告ユニットのメディエーション設定に Moloco を追加する方法と、Moloco SDK とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
Moloco のメディエーション アダプタには次の機能があります。
| 統合 | |
|---|---|
| 入札 | |
| ウォーターフォール | |
| フォーマット | |
| アプリの起動 | |
| バナー | |
| インタースティシャル | |
| リワード | |
| リワード インタースティシャル | |
| ネイティブ | |
要件
最新の GMA Next-Gen SDK
メディエーションのスタートガイドを完了していること。
ステップ 1: Moloco の UI で設定を行う
ログインして Moloco パブリッシャー ポータルにアクセスします。
[Overview] > [Apps] タブに移動し、[Add App] ボタンをクリックして新しいアプリを作成します。
アプリの [OS] と [Privacy Settings] を選択し、フォームの残りの部分を入力して、[Create] をクリックします。
アプリを作成したら、[Apps] タブからアプリを選択して詳細を表示し、アプリキー をメモします。
[Overview] > [Ad Units] タブに移動し、プルダウン メニューからアプリを選択して、[New Ad Unit] をクリックします。
オークション方法 として [In-app bidding] を選択し、フォームの残りの部分を入力します。次に、[Create] をクリックします。
[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.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
implementation("com.google.ads.mediation:moloco:4.6.0.0")
}
configurations {
all {
exclude(group = "com.google.android.gms", module = "play-services-ads")
exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}
}
ステップ 4: Moloco SDK にプライバシー設定を実装する
EU ユーザーからの同意と GDPR
Google の EU ユーザーの同意ポリシーに準拠する には、欧州経済領域(EEA)、英国、スイスの ユーザーに対して特定の情報を開示し、法律で 義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告の パーソナライズを目的とした個人データの収集、共有、使用について ユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則(GDPR)の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
Moloco SDK には、同意情報を Moloco SDK に渡すための
isUserConsent
フラグが含まれています。
次のサンプルコードは、同意情報を Moloco SDK に渡す方法を示しています。これらのフラグを設定する場合は、 を通じて広告をリクエストする前に設定することをおすすめします。GMA Next-Gen 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 に渡す方法を示しています。これらのフラグを設定する場合は、 を通じて広告をリクエストする前に設定することをおすすめします。GMA Next-Gen 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.getAdSourceResponses()
次のクラスで確認できます。
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 です。