Gösterim düzeyinde reklam geliri

Bir gösterim gerçekleştiğinde Google Mobile Ads SDK, bu gösterimle ilişkili reklam geliri verilerini sağlar. Bu verileri, bir kullanıcının yaşam boyu değerini hesaplamak için kullanabilir veya diğer ilgili sistemlere iletebilirsiniz.

Bu kılavuz, iOS uygulamanızda YBD verilerini yakalama özelliğini uygulamanıza yardımcı olmak için hazırlanmıştır.

Ön koşullar

Ücretli etkinlikleri yönetme

Her reklam biçiminin temsilci protokolü bir didRecordPaidEventWithAdValue: yöntemi içerir. Reklam yaşam döngüsü sırasında Google Mobile Ads SDK, gösterim etkinliklerini izler ve bu temsilci yöntemini kazanılan bir GADAdValue nesnesiyle çağırır.

Aşağıdaki örnekte, ödüllü reklamlar için ücretli etkinlikler işlenmektedir:

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: AdValue) {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)adValue {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode, (long)precision);
}

Özel etkinlik reklam kaynağı adı belirleme

Özel etkinlik reklam kaynakları için adSourceName özelliği, reklam kaynağı adını (Custom event) verir. Birden fazla özel etkinlik kullanıyorsanız reklam kaynağı adı, birden fazla özel etkinlik arasında ayrım yapacak kadar ayrıntılı değildir. Belirli bir özel etkinliği bulmak için aşağıdaki adımları uygulayın:

  1. adNetworkClassName özelliğini alın.
  2. Benzersiz bir reklam kaynağı adı belirleyin.

Aşağıdaki örnekte, özel bir etkinlik için benzersiz bir reklam kaynağı adı ayarlanmaktadır:

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

Kazanan reklam kaynağı hakkında daha fazla bilgi için Reklam yanıtı hakkında bilgi alma bölümüne bakın.

Kullanımla ilgili en iyi uygulamalar

  • Reklam nesnesini oluşturduktan veya nesneye erişim elde ettikten hemen sonra ve kesinlikle reklamı göstermeden önce temsilciyi ayarlayın. Bu sayede, ücretli etkinlik geri çağırmalarını kaçırmazsınız.
  • Ücretli etkinlik bilgilerini, didRecordPaidEventWithAdValue: temsilci yöntemi çağrıldığı anda hemen tercih ettiğiniz analiz sunucusuna gönderin. Bu sayede, geri çağırmaları yanlışlıkla silmez ve veri tutarsızlıklarını önlersiniz.

GADAdValue

GADAdValue, bir reklamdan kazanılan maddi değeri temsil eden bir sınıftır. Değerin para birimi kodu ve kesinlik türü aşağıdaki gibi kodlanır.

GADAdValuePrecision Açıklama
GADAdValuePrecisionUnknown Bilinmeyen bir reklam değeri. Bu, YBD geri pingi etkinleştirildiğinde ancak yeterli veri olmadığında döndürülür.
GADAdValuePrecisionEstimated Birleştirilmiş verilerden tahmin edilen bir reklam değeridir.
GADAdValuePrecisionPublisherProvided Uyumlulaştırma grubundaki manuel BGBM'ler gibi yayıncı tarafından sağlanan reklam değeri.
GADAdValuePrecisionPrecise Bu reklam için ödenen kesin değer.

Open Bidding'den gelen test gösterimleri

Bir test isteği aracılığıyla Open Bidding reklam kaynağı için gösterim düzeyinde reklam geliri etkinliği gerçekleştiğinde yalnızca aşağıdaki değerleri alırsınız:

  • GADAdValuePrecisionUnknown: Kesinlik türünü gösterir.
  • 0: Reklam değerini gösterir.
Daha önce kesinlik türünü GADAdValuePrecisionUnknown dışında bir değer, reklam değerini ise 0 değerinden yüksek olarak görmüş olabilirsiniz.

Test reklamı isteği gönderme hakkında ayrıntılı bilgi için Test cihazlarını etkinleştirme başlıklı makaleyi inceleyin.