メディエーションと Moloco を統合する

このガイドでは、Google Mobile Ads SDK でメディエーションを使用して Moloco の広告を読み込んで表示する方法を説明します。入札の統合についても説明します。また、広告ユニットのメディエーション設定に Moloco を追加する方法と、Moloco SDK とアダプタを Unity アプリに統合する方法についても取り上げます。

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

Moloco 用のアド マネージャー メディエーション アダプタには、次の機能があります。

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

要件

  • Google Mobile Ads SDK のバージョンが最新であること
  • Unity 5.6 以降
  • Moloco Unity プラグイン 1.2.0 以降
  • Android にデプロイするには
    • Android API レベル 23 以上
  • iOS にデプロイするには
    • iOS のデプロイ対象のバージョンが 12.0 以降であること
  • Google Mobile Ads SDK が構成された Unity プロジェクトが動作していること。詳しくは、スタートガイドをご覧ください。
  • メディエーションのスタートガイドの手順を完了していること

ステップ 1: Moloco の UI で設定を行う

Moloco パブリッシャー ポータルにログインします。

[Overview] > [Apps] タブに移動し、[Add App] ボタンをクリックして新しいアプリを作成します。

アプリの [OS] と [Privacy Settings] を選択し、フォームの残りの部分を入力して、[Create] をクリックします。

Android

iOS

アプリを作成したら、[Apps] タブからアプリを選択して詳細を表示し、アプリキーをメモします。

Android

iOS

[概要] > [広告ユニット] タブに移動し、プルダウン メニューからアプリを選択して、[新しい広告ユニット] をクリックします。

オークション方法として [In-app bidding] を選択し、フォームの残りの部分を入力します。[作成] をクリックします。

[Ad Units] タブで、新しく作成した広告ユニットに移動して詳細を表示します。広告ユニット ID をメモします。

ステップ 2: アド マネージャーの管理画面で Moloco のデマンドを設定する

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

Android

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

iOS

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

GDPR と米国の州規制の広告パートナー リストに Moloco Ads を追加する

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに Moloco Ads を追加します。

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Google Mobile Ads Moloco Ads SDK Mediation Plugin for Unity をプロジェクトにインストールできます。

openupm add com.google.ads.mobile.mediation.moloco

OpenUPM

Unity プロジェクト エディタで、[Edit] > [Project Settings] > [Package Manager] を選択して、Unity Package Manager Settings を開きます。

[Scoped Registries] タブで、次の詳細を使用して OpenUPM をスコープ付きレジストリとして追加します。

  • 名前: OpenUPM
  • URL: https://package.openupm.com
  • スコープ: com.google

OpenUPM の詳細

次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウン メニューから [My Registries] を選択します。

Unity Registries

[Google Mobile Ads Moloco Mediation] パッケージを選択し、[Install] をクリックします。

OpenUPM からインストールする

Unity パッケージ

変更ログのダウンロード リンクから、Moloco Ads SDK 用の最新バージョンの Google Mobile Ads メディエーション プラグインをダウンロードし、ZIP ファイルから GoogleMobileAdsMolocoMediation.unitypackage を抽出します。

Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsMolocoMediation.unitypackage ファイルを探します。すべてのファイルが選択されていることを確認して、[インポート] をクリックします。

Unity からインポートする

次に、[Assets] > [External Dependency Manager] > [Android Resolver] > [Force Resolve] を選択します。External Dependency Manager ライブラリにより、依存関係の解決が最初から実行され、宣言された依存関係が Unity アプリの Assets/Plugins/Android ディレクトリにコピーされます。

Force Resolve（強制解決）

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

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

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

テスト広告を有効にする

アド マネージャー用のテストデバイスを登録してください。

テスト広告を確認する

Moloco Ads SDK からテスト広告を受信していることを確認するには、Moloco（入札）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

エラーコード

アダプタが Moloco から広告を受信できなかった場合は、次のクラスの ResponseInfo を使用して、広告レスポンスから根本原因のエラーを確認できます。

Android

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

iOS

MolocoSDK.MolocoError
GADMediationAdapterMoloco

広告の読み込みに失敗した場合に Moloco アダプタがスローするコードとメッセージは次のとおりです。

Android

エラーコード ドメイン 理由
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 のドキュメントをご覧ください。

iOS

エラーコード ドメイン 理由
101 com.google.ads.mediation.moloco Moloco SDK は、iOS 12 以前での広告配信をサポートしていません。
102 com.google.ads.mediation.moloco Moloco アプリキーがないか、無効です。
103 com.google.ads.mediation.moloco Moloco 広告ユニット ID がないか、無効です。
104 com.google.ads.mediation.moloco 広告を表示する準備ができていません。
105 com.google.ads.mediation.moloco 広告を表示できませんでした。
106 com.google.ads.mediation.moloco 広告をレンダリングするためのレンダリング データがありません。
-1 ～ 5000 Moloco SDK によって送信されたエラーコード Moloco SDK がエラーを返しました。詳しくは、Moloco のドキュメントをご覧ください。

リワードのサーバーサイド認証

サーバーサイド認証（SSV）コールバックを検証する場合、Moloco 用の広告ソース ID は 8267622065755668722 です。

Moloco Unity メディエーション プラグインの変更履歴

バージョン 1.6.1

バージョン 1.6.0

バージョン 1.5.0

バージョン 1.4.0

バージョン 1.3.1

バージョン 1.3.0

バージョン 1.2.1

バージョン 1.2.0

バージョン 1.1.0

バージョン 1.0.0