開始する

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

前提条件

広告フォーマットにメディエーションを統合するには、その広告フォーマットをあらかじめアプリに組み込んでおく必要があります。

• バナー広告
• インタースティシャル広告
• ネイティブ広告
• リワード広告
• リワード インタースティシャル広告

メディエーションを初めてご利用の場合は、メディエーションの概要を読む。

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

Mobile Ads SDK を初期化する

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

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

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();
    }
}

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...
      }
    }
  }
}

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

バナー広告の広告ネットワーク クラス名を記録するサンプルコードを次に示します。

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

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 の広告パートナー リストにメディエーション パートナーを追加してください。追加しない場合、アプリに広告が配信されないことがあります。