Memulai

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 tinggi.

Menginisialisasi Mobile Ads SDK

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

Kode contoh berikut menunjukkan cara memeriksa status inisialisasi setiap 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 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

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 Respons Iklan untuk mengetahui detailnya.

Menggunakan iklan banner dengan mediasi

Pastikan untuk menonaktifkan pembaruan 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 pemuatan ulang 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 mengingat bahwa aplikasi Anda masih harus mematuhi kebijakan jaringan yang dimediasi 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 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 negara bagian Amerika Serikat atau GDPR di Privasi & pesan Ad Manager. Jika hal ini tidak dilakukan, 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.