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

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

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

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

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

統合
入札単価
ウォーターフォール
フォーマット
バナー
インタースティシャル
特典
ネイティブ

要件

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

ステップ 1: maio の管理画面で構成を設定する

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

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

インタースティシャル

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

Android

iOS

特典

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

Android

iOS

[アプリケーション管理] ページで、メディア ID をメモします。次のセクションで AdMob 広告ユニットを設定するために必要です。

Android

iOS

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

Android

iOS

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

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

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

Android

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

iOS

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

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

pub.dev を介した統合

パッケージの pubspec.yaml ファイルに、maio SDK とアダプタの最新バージョンを含む次の依存関係を追加します。

dependencies:
  gma_mediation_maio: ^

手動による統合

maio 向けの Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ（およびそのコンテンツ）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

dependencies:
  gma_mediation_maio:
    path: path/to/local/package

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

Android

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

iOS

SKAdNetwork の統合

maio のドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの 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 Flutter メディエーション アダプタの変更履歴

バージョン 1.0.3

バージョン 1.0.2

バージョン 1.0.1

バージョン 1.0.0