始める

このガイドでは、メディエーション アダプタを Android アプリに統合する方法について説明します。

前提条件

特定の広告フォーマットのメディエーションを組み込むには、その広告フォーマットを事前にアプリに統合しておく必要があります。

メディエーションを初めてご利用の場合は、メディエーションの概要をご覧ください。

入札の場合: Google Mobile Ads SDK 18.3.0 以降。

Mobile Ads SDK を初期化する

クイック スタートガイドでは、Mobile Ads SDK を初期化する方法を説明します。この初期化の呼び出し中に、メディエーション アダプタと入札アダプタも初期化されます。最初の広告リクエストですべての広告ネットワークからの参加が確実に行われるように、初期化が完了するのを待ってから広告を読み込むことが重要です。

次のサンプルコードは、広告リクエストを行う前に各アダプタの初期化ステータスを確認する方法を示しています。

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        new Thread(
                () ->
                    // Initialize the Google Mobile Ads SDK on a background thread.
                    MobileAds.initialize(
                        this,
                        initializationStatus -> {
                          Map<String, AdapterStatus> statusMap =
                              initializationStatus.getAdapterStatusMap();
                          for (String adapterClass : statusMap.keySet()) {
                            AdapterStatus status = statusMap.get(adapterClass);
                            Log.d(
                                "MyApp",
                                String.format(
                                    "Adapter name: %s, Description: %s, Latency: %d",
                                    adapterClass, status.getDescription(), status.getLatency()));
                          }
                          // Start loading ads here...
                        }))
            .start();
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) { initializationStatus ->
        val statusMap =
          initializationStatus.adapterStatusMap
        for (adapterClass in statusMap.keys) {
          val status = statusMap[adapterClass]
          Log.d(
            "MyApp", String.format(
              "Adapter name: %s, Description: %s, Latency: %d",
              adapterClass, status!!.description, status.latency
            )
          )
        }
        // Start loading ads here...
      }
    }
  }
}

広告を読み込んだ広告ネットワーク アダプタのクラスを確認する

以下は、バナー広告の広告ネットワーク クラス名を記録するサンプルコードです。

Java

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

Kotlin

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

このメソッドの詳細については、getMediationAdapterClassName()ResponseInfo ドキュメントをご覧ください。

広告オブジェクトを Activity インスタンスで初期化する

新しい広告オブジェクトのコンストラクタ(AdManagerAdView など)で、Context タイプのオブジェクトを渡す必要があります。この Context は、メディエーションの使用時に他の広告ネットワークに渡されます。一部の広告ネットワークでは、より制限の厳しい Context(タイプ Activity)が要求され、Activity インスタンスがないと広告を配信できない場合があります。そのため、メディエーション広告ネットワークでのエクスペリエンスの一貫性を保つため、広告オブジェクトを初期化するときは Activity インスタンスを渡すことをおすすめします。

アド マネージャーのメディエーションで使用されているバナー広告ユニットについては、第三者広告ネットワークのすべての管理画面で更新を無効にしてください。アド マネージャーでもバナー広告ユニットの更新頻度に基づいて更新が行われるため、二重に更新されることがなくなります。

ネイティブ広告メディエーション

ネイティブ メディエーションを実装する際に考慮すべきベスト プラクティスは次のとおりです。

ネイティブ広告の表示に関するポリシー
広告ネットワークごとに独自のポリシーがあります。メディエーションを使用する場合、アプリは、広告を配信したメディエーション対象ネットワークのポリシーに引き続き準拠する必要があります。
loadAds() ではなく loadAd() を使用する
loadAds() メソッドは、Google 広告のみを配信します。メディエーション向け広告の場合は、代わりに loadAd() を使用してください。

米国のプライバシー関連州法と GDPR

米国のプライバシー関連州法または一般データ保護規則(GDPR)を遵守する必要がある場合は、米国の州規制の設定または GDPR 設定の手順に沿って、アド マネージャーの「プライバシーとメッセージ」の米国州または GDPR 広告パートナーのリストにメディエーション パートナーを追加します。実装しないと、パートナーがアプリに広告を配信できなくなる可能性があります。

詳しくは、制限付きデータ処理(RDP)を有効にして、Google User Messaging Platform(UMP)SDK を使用して GDPR 同意を取得する方法をご覧ください。