Metadata Iklan

Panduan ini ditujukan bagi penayang yang mengintegrasikan metadata iklan dengan Google Mobile Ads iOS SDK.

Prasyarat

Mengambil metadata iklan

Agar aplikasi mengetahui lebih banyak iklan yang ditayangkan, tetapkan iklan ke GADAdMetadataDelegate-nya sendiri. Kemudian, Anda dapat memproses perubahan metadata iklan dengan menerapkan metode adMetadataDidChange: pada GADAdMetadataDelegate. Setelah delegasi ini dipanggil, periksa properti adMetadata pada iklan.

adMetadataDidChange: dipanggil tepat setelah iklan dimuat atau saat metadata iklan berubah secara asinkron setelah iklan dimuat. Tidak ada jaminan bahwa metadata iklan akan tersedia pada waktu pemuatan. Jadi, sebaiknya tunggu callback ini sebelum mengakses metadata iklan.

Berikut adalah contoh kode yang menunjukkan cara mengambil metadata iklan untuk iklan reward:

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

Setelah mengambil metadata, Anda dapat memeriksa Bundle untuk kunci yang penting bagi Anda. Berbagai jenis iklan mungkin memiliki kunci metadata iklan yang berbeda dengan kunci tersebut. Iklan video VAST memiliki kunci berikut:

Kunci Jenis Deskripsi
AdId String ID iklan, atau string kosong jika tidak tersedia.
AdTitle String Judul, kosong jika tidak ditentukan.
CreativeDurationMs Bilangan Bulat Durasi materi iklan yang dipilih dalam milidetik, -1 jika non-linear.
TraffickingParameters String Parameter proses iklan, atau string kosong jika tidak tersedia.
DealId String ID transaksi pertama yang ada di rantai wrapper untuk iklan saat ini, mulai dari atas, atau string kosong jika informasi ini tidak tersedia.
AdSystem String Server iklan sumber iklan, kosong jika tidak tersedia.
CreativeId String ID materi iklan yang dipilih untuk iklan, kosong jika tidak tersedia.
MediaURL String URL media yang dipilih.
Wrappers Array Array diisi dengan elemen yang dimulai dari iklan wrapper terdalam (mendekati iklan inline) yang bergerak keluar ke iklan wrapper terluar. Setiap elemen dalam array adalah kamus yang berisi kunci dan nilai berikut.
AdId
String. ID iklan yang digunakan untuk iklan wrapper, kosong jika tidak tersedia.
AdSystem
String. Sistem iklan yang digunakan untuk iklan wrapper, kosong jika tidak tersedia.
CreativeId
String. ID materi iklan yang digunakan untuk iklan wrapper, kosong jika tidak tersedia.