Mulai

Panduan ini menunjukkan cara mengintegrasikan adaptor mediasi dengan aplikasi iOS.

Prasyarat

Sebelum dapat mengintegrasikan mediasi untuk format iklan, Anda perlu mengintegrasikan format iklan ke aplikasi Anda:

Baru mengenal mediasi? {i>Read<i} Pengantar mediasi.

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

Menginisialisasi Mobile Ads SDK

Panduan memulai cepat menunjukkan cara melakukan inisialisasi Iklan Seluler SDK. Selama panggilan inisialisasi itu, adaptor mediasi juga melakukan inisialisasi. Sebaiknya tunggu hingga inisialisasi selesai sebelum Anda memuat iklan untuk memastikan partisipasi penuh dari setiap jaringan iklan di permintaan iklan pertama.

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

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    let ads = GADMobileAds.sharedInstance()
    ads.start { status in
      // Optional: Log each adapter's initialization latency.
      let adapterStatuses = status.adapterStatusesByClassName
      for adapter in adapterStatuses {
        let adapterStatus = adapter.value
        NSLog("Adapter Name: %@, Description: %@, Latency: %f", adapter.key,
        adapterStatus.description, adapterStatus.latency)
      }

      // Start loading ads here...
    }

    return true
  }

}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

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

    // Start loading ads here...
  }];
  return YES;
}

@end

Mengetahui jaringan iklan yang menang

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

Swift

func adViewDidReceiveAd(_ bannerView: GAMBannerView) {
  print("Banner adapter class name: \(bannerView.responseInfo.adNetworkClassName)")
}

Objective-C

- (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {
  NSLog(@"Banner adapter class name: %@", bannerView.responseInfo.adNetworkClassName);
}

Lihat Mengambil Informasi tentang Iklan Respons untuk mengetahui detailnya.

Menggunakan iklan banner dengan mediasi

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

Menggunakan iklan native dengan mediasi

Berikut adalah beberapa praktik terbaik yang perlu dipertimbangkan saat mengimplementasikan iklan mediasi.

Kebijakan presentasi iklan Native
Setiap jaringan iklan memiliki kebijakannya sendiri. Saat menggunakan mediasi, penting untuk ingat bahwa aplikasi Anda masih harus mematuhi kebijakan jaringan yang menyediakan iklan.
Menghindari penggunaan class GADMultipleAdsAdLoaderOptions saat membuat permintaan
Permintaan beberapa iklan native hanya menayangkan iklan Google. Beberapa native fitur iklan tidak mendukung mediasi.

Hukum privasi negara bagian Amerika Serikat dan GDPR

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

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