Reklam Meta Verileri

Platform seçin: Android iOS

Bu kılavuz, reklam meta verilerini Google Mobile Ads iOS SDK'sı ile entegre eden yayıncılar için hazırlanmıştır.

Ön koşullar

Reklam meta verilerini getirme

Bir uygulamanın sunulan reklamlar hakkında daha fazla bilgi sahibi olması için reklamı kendi GADAdMetadataDelegate olarak ayarlayın. Ardından, GADAdMetadataDelegate üzerinde adMetadataDidChange: yöntemini uygulayarak reklam meta verilerindeki değişiklikleri dinleyebilirsiniz. Bu temsilci çağrıldıktan sonra reklamdaki adMetadata özelliğini kontrol edin.

adMetadataDidChange:, bir reklam yüklendikten hemen sonra veya reklamın meta verileri yüklendikten sonra eşzamansız olarak değiştiğinde çağrılır. Reklam meta verilerinin yükleme sırasında kullanılabilir olacağı garanti edilmez. Bu nedenle, bir reklamın meta verilerine erişmeden önce bu geri çağırma işleminin tamamlanmasını beklemenizi öneririz.

Aşağıda, ödüllü reklamın reklam meta verilerinin nasıl alınacağını gösteren bir kod örneği verilmiştir:

@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"];
}

Meta verileri aldıktan sonra, ilgilendiğiniz anahtarlar için paketi kontrol edebilirsiniz. Farklı reklam türleriyle ilişkili farklı reklam meta verileri anahtarları olabilir. VAST video reklamlarında aşağıdaki anahtarlar bulunur:

Anahtar Tür Açıklama
AdId Dize Reklamın kimliği veya kullanılamıyorsa boş dize.
AdTitle Dize Başlık, belirtilmemişse boş.
CreativeDurationMs Tamsayı Doğrusal olmayan reklam öğeleri için seçilen reklam öğesinin milisaniye cinsinden süresi (-1).
TraffickingParameters Dize Trafik oluşturma parametreleri veya kullanılamıyorsa boş dize.
DealId Dize Geçerli reklam için sarmalayıcı zincirinde en üstten başlayarak bulunan ilk anlaşma kimliği veya bu bilgi mevcut değilse boş dize.
AdSystem Dize Reklamın kaynak reklam sunucusu. Kullanılamıyorsa boş olur.
CreativeId Dize Reklam için seçilen reklam öğesinin kimliği. Kullanılamıyorsa boş.
MediaURL Dize Seçilen medyanın URL'si.
Wrappers Dizi Dizi, en içteki sarmalayıcı reklamdan (satır içi reklama yakın) başlayıp en dıştaki sarmalayıcı reklama doğru ilerleyen öğelerle doldurulur. Dizideki her öğe, aşağıdaki anahtarları ve değerleri içeren bir sözlüktür.
AdId
Dize. Sarmal reklam için kullanılan reklam kimliği. Kullanılamıyorsa boş olur.
AdSystem
Dize. Sarmalayıcı reklam için kullanılan reklam sistemi. Kullanılamıyorsa boş.
CreativeId
Dize. Sarmalayıcı reklam için kullanılan reklam öğesi kimliği. Kullanılamıyorsa boş olur.