Menyiapkan mediasi

Pilih platform: Android iOS Unity Flutter Android (Legacy)

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 mengenal mediasi? Baca Pengantar mediasi.

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

Melakukan inisialisasi Google Mobile Ads SDK (Legacy)

Panduan memulai cepat menunjukkan cara melakukan inisialisasi Google Mobile Ads SDK (Legacy). Selama panggilan inisialisasi tersebut, adaptor mediasi juga diinisialisasi. Penting untuk menunggu inisialisasi selesai sebelum Anda memuat iklan untuk memverifikasi partisipasi penuh dari setiap jaringan iklan pada panggilan iklan pertama.

Contoh kode berikut menunjukkan cara memeriksa status inisialisasi setiap adapter 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()));
  }
}

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",
    )
  }
}

Memeriksa class adaptor jaringan iklan yang memuat iklan

Berikut adalah beberapa kode contoh 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);

Kotlin

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

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

Melakukan inisialisasi objek iklan dengan instance Aktivitas

Dalam konstruktor untuk objek iklan baru (misalnya, AdManagerAdView), Anda harus meneruskan objek jenis 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 melakukan inisialisasi objek iklan untuk memverifikasi pengalaman yang konsisten dengan jaringan iklan yang dimediasi.

Pastikan untuk menonaktifkan refresh di semua UI sumber iklan pihak ketiga untuk unit iklan banner yang digunakan dalam mediasi. Tindakan ini mencegah refresh ganda karena Ad Manager juga memicu refresh berdasarkan kecepatan 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 masih harus mematuhi kebijakan jaringan yang dimediasi yang menyediakan iklan.
Gunakan loadAd(), bukan loadAds()
Metode loadAds() hanya menayangkan iklan Google. Untuk iklan mediasi, gunakan loadAd().

Hukum privasi negara bagian Amerika Serikat dan GDPR

Jika Anda perlu mematuhi hukum privasi negara bagian Amerika Serikat atau General Data Protection Regulation (GDPR), ikuti langkah-langkah di setelan peraturan negara bagian Amerika Serikat atau setelan GDPR untuk menambahkan partner mediasi Anda di daftar partner iklan GDPR atau negara bagian Amerika Serikat di Privasi & pesan Ad Manager. Jika tidak, partner mungkin 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
Memilih sumber iklan