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

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

maio のダッシュボードインターフェースでは、ラベル、ボタン、 説明、このガイドのスクリーンショットは翻訳されていません。 ただし、このガイドの説明と手順では、ラベルとボタンは 参照してください。「URL 候補」たとえば 「URL スキーム」です

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

maio 用メディエーション アダプタの機能は次のとおりです。

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

要件

  • Android API レベル 21 以降
  • maio SDK 1.0.7 以降

ステップ 1: maio UI で設定をセットアップする

First, sign up or log in to your maio account. Click the Application management button on the left sidebar and click on New app.

Select the tab corresponding to your preferred Ad Type.

Interstitial

Enter the Name of your app, select the platform and provide your App URL. Select Video interstitial as the Ad Type, and then click Update.

Rewarded

Enter the Name of your app, select the platform and provide your App URL. Select Video Rewards as the Ad Type, and then click Update.

In the Application Management page, make a note of the Media ID. It's needed to set up your Ad Manager ad unit in the next section.

In the Zone Management page, make a note of the Zone ID. It will also be needed to set up your Ad Manager ad unit in the next section.

In addition to Media ID and Zone ID, you will need API ID and API KEY to set up your ad unit ID for mediation. In Reporting API page, make a note of API ID and API KEY.

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

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

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

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

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

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

「maio」の収益パートナーがすでにある場合は、そのパートナーを選択できます。それ以外の場合は、[新しい収益パートナーを作成] を選択します。

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

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

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

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

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

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

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

次に、アプリレベルの build.gradle.kts ファイルに以下を追加します。 構成について説明します。最新バージョンの maio SDK とアダプタ:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

手動による統合

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

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

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

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

テスト広告を有効にする

Ad Manager。

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

テスト広告を確認する

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

エラーコード

アダプタが maio から広告を受け取れなかった場合 広告レスポンスの根本的なエラーを確認するため、 ResponseInfo.getAdapterResponses() 次のクラスに分類されます。

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

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

エラーコード 理由
0-10 maio が SDK 固有のエラーを返しました。コードをご覧ください。 および maio のドキュメント をご覧ください。
101 マイオさんには広告がありません。
102 サーバー パラメータが無効です（プレースメント ID が指定されていないなど）。
103 広告の読み込みに使用されたコンテキストが「Activity」インスタンスではありません。
0-10 maio が SDK 固有のエラーを返しました。詳しくは、 maio のコード をご覧ください。
101 maio にはまだ広告がありません。
102 サーバー パラメータが無効です（プレースメント ID が指定されていないなど）。
103 maio アダプタは、リクエストされた広告フォーマットに対応していません。
104 このネットワーク設定の広告はすでに読み込まれています。

maio Android メディエーション アダプタの変更履歴

バージョン 1.1.16.3

  • 必要な Google Mobile Ads SDK の最小バージョンを 23.0.0 に更新しました。
  • maio SDK バージョン 1.1.16 との互換性を検証しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 23.0.0 にアップデートします。
  • Maio SDK バージョン 1.1.16。

バージョン 1.1.16.2

  • 新しい VersionInfo クラスを使用するようにアダプターを更新しました。
  • 必要な Google Mobile Ads SDK の最小バージョンを 22.0.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 22.0.0 にアップデートします。
  • Maio SDK バージョン 1.1.16。

バージョン 1.1.16.1

  • compileSdkVersion と targetSdkVersion を API 31 に更新しました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 21.0.0 に更新しました。
  • 必要な最小 Android API レベルを 19 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 21.0.0.
  • Maio SDK バージョン 1.1.16。

バージョン 1.1.16.0

  • 追加の maio エラーをキャプチャするようにエラーコードを更新しました。
  • maio SDK バージョン 1.1.16 との互換性を検証しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 20.4.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 20.4.0.
  • Maio SDK バージョン 1.1.16。

バージョン 1.1.15.0

  • maio SDK バージョン 1.1.15 との互換性を検証しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 20.0.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 20.0.0 にアップデートします。
  • Maio SDK バージョン 1.1.15。

バージョン 1.1.14.0

  • 標準化されたアダプターのエラーコードとメッセージを追加しました。
  • maio SDK バージョン 1.1.14 との互換性を検証しました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 19.8.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 19.8.0.
  • Maio SDK バージョン 1.1.14。

バージョン 1.1.13.0

  • maio SDK バージョン 1.1.13 との互換性を検証しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 19.5.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 19.5.0.
  • Maio SDK バージョン 1.1.13。

バージョン 1.1.12.0

  • 最低限必要な Google Mobile Ads SDK のバージョンを 19.4.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 19.4.0.
  • Maio SDK バージョン 1.1.12。

バージョン 1.1.11.1

  • タイムアウトを制限するため、maio に表示可能な広告がない場合に広告リクエストが直ちに失敗するようになりました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 19.1.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 19.1.0.
  • Maio SDK バージョン 1.1.11。

バージョン 1.1.11.0

  • maio SDK バージョン 1.1.11 との互換性を検証しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 18.3.0 に更新しました。

ビルドとテストに使用するツール:

  • Google Mobile Ads SDK バージョン 18.3.0.
  • Maio SDK バージョン 1.1.11。

バージョン 1.1.10.0

  • maio SDK バージョン 1.1.10 との互換性を検証しました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 18.2.0 に更新しました。

バージョン 1.1.8.0

  • maio SDK バージョン 1.1.8 との互換性を検証しました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 18.1.0 に更新しました。

バージョン 1.1.7.0

  • バグを修正しました。
  • maio SDK バージョン 1.1.7 との互換性を検証しました。

バージョン 1.1.6.1

  • 新しい リワード API をサポートするようアダプタを更新しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 17.2.0 に更新しました。

バージョン 1.1.6.0

  • maio SDK バージョン 1.1.6 との互換性を検証しました。

バージョン 1.1.5.0

  • maio SDK バージョン 1.1.5 との互換性を検証しました。

バージョン 1.1.4.0

  • maio SDK バージョン 1.1.4 との互換性を検証しました。

バージョン 1.1.3.1

  • シングルトンではなくインスタンス クラスで動作するようにアダプタを更新しました。

バージョン 1.1.3.0

  • maio SDK バージョン 1.1.3 との互換性を検証しました。

バージョン 1.1.2.1

  • 更新された初期化関数でアダプタを更新しました。

バージョン 1.1.2.0

  • maio SDK バージョン 1.1.2 との互換性を検証しました。

バージョン 1.1.1.1

  • onRewardedVideoComplete() 広告イベントを呼び出すようにアダプタを更新しました。

バージョン 1.1.1.0

  • maio SDK バージョン 1.1.1 との互換性を検証しました。

バージョン 1.1.0.0

  • maio SDK バージョン 1.1.0 との互換性を検証しました。

バージョン 1.0.8.0

  • maio SDK バージョン 1.0.8 との互換性を検証しました。

バージョン 1.0.7.1

  • 広告の失敗時に NullPointerExceptions が発生する可能性がある問題を修正しました 表示されます。

バージョン 1.0.7.0

  • AdRequest にテストデバイス ID を追加してテストモードを有効にする機能を追加しました。
  • maio SDK バージョン 1.0.7 との互換性を検証しました。

バージョン 1.0.6.0

  • 初リリース
  • インタースティシャルと動画リワード広告のサポートが追加されました。