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.