Menyiapkan mediasi

Panduan ini menunjukkan cara mengintegrasikan adaptor mediasi dengan aplikasi iOS 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 7.53.1 atau yang lebih baru.

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 hingga inisialisasi selesai sebelum memuat iklan untuk memverifikasi partisipasi penuh dari setiap jaringan iklan pada permintaan iklan pertama.

Contoh kode berikut menunjukkan cara memeriksa status inisialisasi setiap adaptor sebelum membuat permintaan iklan.

Swift

MobileAds.shared.start { initializationStatus in
  // Check each adapter's initialization status.
  for (adapterName, status) in initializationStatus.adapterStatusesByClassName {
    print(
      "Adapter: \(adapterName), Description: \(status.description), Latency: \(status.latency)")
  }
}

Objective-C

[[GADMobileAds sharedInstance]
    startWithCompletionHandler:^(GADInitializationStatus *_Nonnull status) {
      // Check each adapter's initialization status.
      NSDictionary<NSString *, GADAdapterStatus *> *adapterStatuses =
          status.adapterStatusesByClassName;
      for (NSString *adapterName in adapterStatuses) {
        GADAdapterStatus *adapterStatus = adapterStatuses[adapterName];
        NSLog(@"Adapter: %@, Description: %@, Latency: %f", adapterName,
              adapterStatus.description, adapterStatus.latency);
      }
    }];

Mengetahui jaringan iklan yang menang

Setiap class format iklan memiliki properti GADResponseInfo yang berisi adNetworkClassName yang menampilkan nama class jaringan iklan untuk iklan saat ini. adNetworkClassName hanya memiliki nilai setelah iklan berhasil dimuat. Kode berikut menunjukkan cara mendapatkan informasi tersebut untuk iklan banner.

Swift

print(
  "Adapter class name: \(ad.responseInfo?.loadedAdNetworkResponseInfo?.adNetworkClassName ?? "Unknown")"
)

Objective-C

NSLog(@"Adapter class name: %@",
      ad.responseInfo.loadedAdNetworkResponseInfo.adNetworkClassName ?: @"Unknown");

Lihat Mengambil Informasi tentang Respons Iklan untuk mengetahui detailnya.

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 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.
Hindari penggunaan class GADMultipleAdsAdLoaderOptions saat membuat permintaan
Permintaan untuk beberapa iklan native hanya menayangkan iklan Google. Fitur beberapa iklan native tidak mendukung mediasi.

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.