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

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

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

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

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

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

要件

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

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

お申し込み または、maio アカウントにログインしてください。左側のサイドバーにある [アプリケーション管理] ボタンをクリックし、[新しいアプリ] をクリックします。

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

インタースティシャル

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

Android

iOS

特典

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

Android

iOS

<ph type="x-smartling-placeholder">

[Application Management] ページで、Media ID をメモします。です。 の設定に必要な手順を説明します。 できます。

Android

iOS

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

Android

iOS

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

ステップ 2: 管理画面で Ad Manager メインのデマンドを設定する

広告ユニットのメディエーション設定を行う

Android

手順については、 Android。

iOS

手順については、 iOS。

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Google Mobile Ads Unity 向けマネージド オプトアウト プラグインをプロジェクトにインストールできます。

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

OpenUPM

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

[スコープ レジストリ] タブで、OpenUPM をスコープ レジストリとして追加し、 以下の詳細を確認できます。

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

OpenUPM の詳細

次に、[ウィンドウ] >[Package Manager] をクリックすると、 Unity Package Manager と プルダウン メニューから [レジストリ] を選択します。

Unity レジストリ

[Google Mobile Ads maio Mediation] パッケージを選択し、 [インストール] をクリックします。

OpenUPM からインストールする

Unity パッケージ

最新バージョンの Google モバイル広告メディエーション プラグイン ダウンロード リンクからアクセスできます。 変更履歴 その 郵便番号で 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: 実装をテストする

テスト広告を有効にする

Ad Manager。

Google Mobile Ads SDK のバージョン 7.26.0 以降を使用している場合、リクエストの送信時に、テストデバイスとして登録されているスマートフォンやタブレットに maio からテスト広告が自動的に送信されます。

テスト広告を確認する

maioからテスト広告を受信していることを確認するには、広告インスペクタで maio (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

エラーコード

アダプターが 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.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

  • 新しいリワード 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 をサポートしています。