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

このガイドでは、Google Mobile Ads SDK を使用して、メディエーションを使用して maio から広告を読み込み、表示する方法について説明します。ウォーターフォール統合についても説明します。広告ユニットのメディエーション構成に maio を追加する方法と、maio SDK とアダプタを Unity アプリに統合する方法について説明します。

maio のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、ここでの説明と手順では、ラベルとボタンは英語の同義語で参照しています。たとえば、「URL スキーム」は「URL Scheme」になります。

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

maio のメディエーション アダプタには、次の機能があります。

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

要件

  • Unity 4 以降
  • 最新の Google Mobile Ads SDK
  • Android にデプロイするには
    • Android API レベル 21 以降
  • iOS にデプロイするには
    • iOS デプロイ ターゲットが 12.0 以降
  • Google Mobile Ads SDK で設定された、動作する Unity プロジェクト。詳しくは、スタートガイドをご覧ください。
  • メディエーションのスタートガイドを完了していること

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

まず、maio アカウントに登録するかログインします。左側のサイドバーにある [アプリケーション管理] ボタンをクリックし、[新しいアプリ] をクリックします。

希望する広告タイプに対応するタブを選択します。

インタースティシャル

アプリの名前を入力し、プラットフォームを選択してアプリの URL を指定します。[広告タイプ] として [動画インタースティシャル] を選択し、[更新] をクリックします。

Android

iOS

特典

アプリの名前を入力し、プラットフォームを選択してアプリの URL を指定します。[広告タイプ] として [動画リワード] を選択し、[更新] をクリックします。

Android

iOS

[Application Management] ページで、Media ID をメモします。次のセクションで AdMob 広告ユニットを設定する必要があります。

Android

iOS

[ゾーン管理] ページで、ゾーン ID をメモします。また、次のセクションで AdMob 広告ユニットを設定するためにも必要になります。

Android

iOS

（ウォーターフォールのみ）メディエーション用の広告ユニット ID を設定するには、メディア ID とゾーン ID に加えて、API ID と API KEY が必要です。[Reporting API ページ] で、API ID と API KEY をメモします。

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

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

Android

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

iOS

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

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Unity 用の Google モバイル広告の maio メディエーション プラグインをプロジェクトにインストールできます。

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

OpenUPM

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

[スコープ付きレジストリ] タブで、OpenUPM をスコープ付きレジストリとして追加し、次の詳細情報を指定します。

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

OpenUPM の詳細

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

Unity レジストリ

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

OpenUPM からインストールする

Unity パッケージ

変更ログのダウンロード リンクから、maio 用 Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsMaioMediation.unitypackage を抽出します。

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

Unity からインポートする

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

強制解決

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

Android

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

iOS

SKAdNetwork の統合

maio のドキュメントに沿って、SKAdNetwork ID をプロジェクトの Info.plist ファイルに追加します。

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

テスト広告を有効にする

AdMob 用にテストデバイスを登録してください。

Google Mobile Ads SDK バージョン 7.26.0 以降を使用しているパブリッシャーは、リクエスト時にテストデバイスとして登録されているスマートフォンとタブレットで、maio からテスト広告を自動的に受け取ります。

テスト広告を確認する

maio からテスト広告が配信されていることを確認するには、広告インスペクタで maio（ウォーターフォール）広告ソースを使用して単一の広告ソースのテストを有効にします。

エラーコード

アダプターが maio から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo を使用して、広告レスポンスから基盤となるエラーを確認できます。

Android

形式 クラス名
インタースティシャル jp.maio.sdk.android.mediation.admob.adapter.Interstitial
特典 jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

形式 クラス名
インタースティシャル GADMMaioInterstitialAdapter
特典 GADMMaioRewardedAdapter

広告の読み込みに失敗したときに、Maio アダプターからスローされるコードと付随するメッセージは次のとおりです。

Android

エラーコード 理由
0-10 maio から SDK 固有のエラーが返されました。詳細については、コードと maio のドキュメントをご覧ください。
101 Maio には広告が表示されません。
102 無効なサーバー パラメータ（プレースメント ID がないなど）。
103 広告の読み込みに使用されたコンテキストが「Activity」インスタンスではありませんでした。

iOS

エラーコード 理由
0-10 maio から SDK 固有のエラーが返されました。詳しくは、maio のコードをご覧ください。
101 maio にはまだ広告がありません。
102 無効なサーバー パラメータ（プレースメント ID がないなど）。
103 リクエストされた広告フォーマットは、maio アダプタでサポートされていません。
104 このネットワーク構成の広告はすでに読み込まれています。

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

バージョン 2.0.4

バージョン 2.0.3

バージョン 2.0.2

バージョン 2.0.1

バージョン 2.0.0

バージョン 1.4.3

バージョン 1.4.2

バージョン 1.4.1

バージョン 1.4.0

バージョン 1.3.6

バージョン 1.3.5

バージョン 1.3.4

バージョン 1.3.3

バージョン 1.3.2

バージョン 1.3.1

バージョン 1.3.0

バージョン 1.2.3

  • 新しい Rewarded API をサポートするようにプラグインを更新しました。
  • maio Android アダプタ バージョン 1.1.7.0 をサポート。
  • maio iOS アダプター バージョン 1.4.6.0 をサポート。

バージョン 1.2.2

  • maio Android アダプタ バージョン 1.1.6.0 をサポートしています。
  • maio iOS アダプター バージョン 1.4.2.0 をサポート。

バージョン 1.2.1

  • maio Android アダプタ バージョン 1.1.6.0 をサポートしています。
  • maio iOS アダプター バージョン 1.4.1.0 をサポート。

バージョン 1.2.0

  • maio Android アダプタ バージョン 1.1.4.1 をサポート。
  • maio iOS アダプター バージョン 1.4.0.0 をサポートしています。

バージョン 1.1.3

  • maio Android アダプタ バージョン 1.1.3.1 をサポート。
  • maio iOS アダプター バージョン 1.3.2.0 をサポート。

バージョン 1.1.2

  • maio Android アダプタ バージョン 1.1.3.0 をサポートしています。
  • maio iOS アダプター バージョン 1.3.2.0 をサポート。

バージョン 1.1.1

  • maio Android アダプタ バージョン 1.1.1.0 をサポートしています。
  • maio iOS アダプター バージョン 1.3.1.1 をサポート。

バージョン 1.1.0

  • maio Android アダプタ バージョン 1.1.0.0 をサポートしています。
  • maio iOS アダプター バージョン 1.3.0.0 をサポートしています。

バージョン 1.0.2

  • maio Android SDK バージョン 1.0.8 をサポートしています。
  • maio iOS SDK バージョン 1.2.19 をサポートしています。

バージョン 1.0.1

  • maio Android SDK バージョン 1.0.7 をサポートしています。
  • maio iOS SDK バージョン 1.2.19 をサポートしています。

バージョン 1.0.0

  • 初回リリース
  • maio Android SDK バージョン 1.0.6 をサポートしています。
  • maio iOS SDK バージョン 1.2.18 をサポートしています。