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

[プラットフォームを選択]: Android（ベータ版） Android iOS Unity Flutter

このガイドでは、GMA Next-Gen SDK を使用して AdMob メディエーションで 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 アカウントにアクセスします。左側のサイドバーにある [Application management] ボタンをクリックし、[New app] をクリックします。

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

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

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

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

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

広告ユニットのメディエーション設定に maio を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、 そのメディエーション グループの名前をクリックして編集し、 広告のソースとして maio を追加するに進みます。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] をクリックします。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、 メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

広告ユニット カードに選択した広告ユニットが表示されます。

広告のソースとして maio を追加する

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

Android Studio の統合（推奨）

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:maio:2.0.8.1")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:maio:2.0.8.1'
}

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: 実装をテストする

テスト広告を有効にする

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

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

テスト広告を確認する

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

エラーコード

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

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