AdMob メディエーションは、AdMob ネットワークや第三者の広告ソースなど複数のソースからの広告を 1 か所でアプリに配信できる機能です。AdMob メディエーションが複数のネットワークに広告リクエストを送信し、広告配信に最適なネットワークを特定するため、広告掲載率を最大限に高めて収益の向上を図ることができます。事例紹介。
前提条件
特定の広告フォーマットのメディエーションを組み込むには、その広告フォーマットを事前にアプリに統合しておく必要があります。
メディエーションを初めてご利用の場合は、AdMob メディエーションの概要をご覧ください。
入札の場合: 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 インスタンスを使用して広告オブジェクトを初期化する
新しい広告オブジェクト(たとえば AdView
)のコンストラクタで、Context
型のオブジェクトを渡す必要があります。この Context
は、メディエーションの使用時に他の広告ネットワークに渡されます。一部の広告ネットワークでは、より制限の厳しい Context
(タイプ Activity
)が要求され、Activity
インスタンスがないと広告を配信できない場合があります。そのため、メディエーション広告ネットワークでのエクスペリエンスの一貫性を保つために、広告オブジェクトを初期化するときは Activity
インスタンスを渡すことをおすすめします。
AdMob メディエーションでバナー広告を使用する
AdMob メディエーションで使用するバナー広告ユニットについては、すべての第三者広告ソースの管理画面で更新を無効にしてください。AdMob もバナー広告ユニットの更新頻度に基づいて更新をトリガーするため、これにより更新の重複を防ぐことができます。
AdMob メディエーションでネイティブ広告を使用する
AdMob メディエーションにネイティブ広告を実装する際のおすすめの方法は次のとおりです。
- ネイティブ広告の表示に関するポリシー
- 広告ネットワークごとに独自のポリシーがあります。メディエーションを使用する場合は、広告を提供したメディエーション対象ネットワークのポリシーにアプリが準拠している必要があります。
loadAds()
ではなくloadAd()
を使用するloadAds()
メソッドは Google 広告のみを配信します。メディエーション向け広告の場合は、代わりにloadAd()
を使用してください。
米国のプライバシー関連州法と GDPR
米国のプライバシー関連州法または一般データ保護規則(GDPR)を遵守する必要がある場合は、米国の州規制の設定または GDPR の設定の手順に沿って、AdMob の「プライバシーとメッセージ」の米国州または GDPR 広告パートナーのリストにメディエーション パートナーを追加します。実装しないと、パートナーがアプリに広告を配信できなくなる可能性があります。
詳しくは、Google User Messaging Platform(UMP)SDK で制限付きデータ処理(RDP)を有効にして GDPR の同意を得る方法をご覧ください。