GMA Next-Gen SDK についてのフィードバックは、広告と測定に関する Google コミュニティサーバーの #gma-next-gen-sdk Discord チャンネルにお寄せください。

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

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

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

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

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

統合
入札
ウォーターフォール
フォーマット
バナー
インタースティシャル
リワード
ネイティブ

要件

Android API レベル 24 以降

maio SDK 1.0.7 以降

最新の GMA Next-Gen SDK。
メディエーションのスタートガイドの手順を完了していること

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

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

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

インタースティシャル

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

特典

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

[Application Management] ページで、メディア ID をメモします。次のセクションでアドマネージャーの広告ユニットを設定するために必要です。

[ゾーン管理] ページで、ゾーン ID をメモします。次のセクションでアドマネージャーの広告ユニットを設定する必要もあります。

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

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

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

アドマネージャーアカウントにログインします。

[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。

収益グループの固有の名前を入力し、[ステータス] を [有効] に設定して、広告フォーマットを選択し、[広告枠タイプ] を [モバイルアプリ] に設定します。 [ターゲティング > 広告枠] セクションで、メディエーションを追加する [広告枠] と [モバイルアプリ] の広告ユニットを選択します。

次に、[収益パートナーを追加] ボタンをクリックします。

maio のイールドパートナーがすでにある場合は、それを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。

[広告ネットワーク] として [maio] を選択し、一意の名前を入力して、[メディエーション] を有効にします。

[自動データ収集] をオンにして、前のセクションで取得した API ID と API キーを入力します。

収益パートナーを選択したら、統合タイプとして [モバイル SDK メディエーション]、プラットフォームとして [Android]、ステータスとして [有効] を選択します。前のセクションで取得したメディア ID とゾーン ID を入力します。次に、[デフォルト CPM] の値を入力します。

完了したら、ページの下部にある [保存] をクリックします。

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

Android Studio の統合（推奨）

プロジェクトレベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

アプリレベルの Gradle ファイルに、次の実装依存関係と構成を追加します。

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:maio:2.0.8.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手動による統合

maio Android SDK の最新バージョンをダウンロードして、プロジェクトに追加します。
Google の Maven リポジトリで maio アダプタアーティファクトに移動します。最新バージョンを選択し、maio アダプタの .aar ファイルをダウンロードして、プロジェクトに追加します。

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

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

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

テスト広告を有効にする

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

GMA Next-Gen SDK のバージョン 11.6.0 以降を使用しているパブリッシャーは、リクエストを行う際に、テストデバイスとして登録されているスマートフォンやタブレットで、maio からテスト広告を自動的に受け取ります。

テスト広告を確認する

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

エラーコード

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

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

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

エラーコード	理由
0-10	maio が SDK 固有のエラーを返しました。詳しくは、コードと maio のドキュメントをご覧ください。
101	Maio に利用可能な広告がありません。
102	サーバーパラメータが無効です（配置 ID がないなど）。
103	広告の読み込みに使用されたコンテキストが `Activity` インスタンスではありませんでした。