Menyiapkan mediasi

Pilih platform: Android Baru Android iOS Unity Flutter

Panduan ini menunjukkan cara mengintegrasikan adaptor mediasi dengan aplikasi Android Anda.

Prasyarat

Sebelum dapat mengintegrasikan mediasi untuk format iklan, Anda harus mengintegrasikan format iklan tersebut ke dalam aplikasi:

Baru menggunakan mediasi? Baca Pengantar mediasi.

Untuk bidding: Google Mobile Ads SDK 18.3.0 atau yang lebih tinggi.

Menginisialisasi Google Mobile Ads SDK

Panduan memulai cepat menunjukkan cara menginisialisasi Google Mobile Ads SDK. Selama panggilan inisialisasi tersebut, adaptor mediasi juga akan diinisialisasi. Anda harus menunggu inisialisasi selesai sebelum memuat iklan untuk memverifikasi partisipasi penuh dari setiap jaringan iklan pada permintaan iklan pertama.

Kode contoh berikut menunjukkan cara memeriksa status inisialisasi setiap adaptor sebelum membuat permintaan iklan.

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}
MediationSnippets.java

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

MediationSnippets.kt

Memeriksa class adaptor jaringan iklan yang memuat iklan

Berikut adalah beberapa contoh kode yang mencatat nama class jaringan iklan untuk iklan banner:

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);
ResponseInfoSnippets.java

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)
ResponseInfoSnippets.kt

Lihat dokumentasi ResponseInfo di getMediationAdapterClassName() untuk mengetahui detail tentang metode ini.

Menginisialisasi objek iklan dengan instance Aktivitas

Di konstruktor untuk objek iklan baru (misalnya, AdManagerAdView), Anda harus meneruskan objek berjenis Context. Context ini diteruskan ke jaringan iklan lain saat menggunakan mediasi. Beberapa jaringan iklan memerlukan Context yang lebih ketat dan berjenis Activity serta mungkin tidak dapat menayangkan iklan tanpa instance Activity. Oleh karena itu, sebaiknya teruskan instance Activity saat menginisialisasi objek iklan untuk memverifikasi pengalaman yang konsisten dengan jaringan iklan mediasi Anda.

Pastikan untuk menonaktifkan refresh di semua UI sumber iklan pihak ketiga untuk unit iklan banner yang digunakan dalam mediasi. Hal ini mencegah refresh ganda karena Ad Manager juga memicu refresh berdasarkan frekuensi refresh unit iklan banner Anda.

Menggunakan iklan native dengan mediasi

Berikut adalah beberapa praktik terbaik yang perlu dipertimbangkan saat menerapkan mediasi native.

Kebijakan presentasi iklan native
Setiap jaringan iklan memiliki kebijakannya sendiri. Saat menggunakan mediasi, penting untuk diingat bahwa aplikasi Anda tetap harus mematuhi kebijakan jaringan mediasi yang menyediakan iklan.
Menggunakan loadAd() dan bukan loadAds()
Metode loadAds() hanya menayangkan iklan Google. Untuk iklan mediasi, gunakan loadAd().

Hukum privasi negara bagian Amerika Serikat dan GDPR

Jika Anda harus mematuhi hukum privasi negara bagian Amerika Serikat atau Peraturan Perlindungan Data Umum (GDPR), ikuti langkah-langkah di setelan peraturan negara bagian Amerika Serikat atau setelan GDPR untuk menambahkan partner mediasi Anda di daftar partner iklan negara bagian Amerika Serikat atau GDPR di Privasi & pesan Ad Manager. Jika tidak melakukannya, partner dapat gagal menayangkan iklan di aplikasi Anda.

Pelajari lebih lanjut cara mengaktifkan pemrosesan data yang dibatasi (RDP) dan mendapatkan izin GDPR dengan Google User Messaging Platform (UMP) SDK.

Berikutnya
Pilih sumber iklan