Gösterim düzeyinde reklam geliri

Bir gösterim gerçekleştiğinde Google Mobile Ads SDK'sı, ilişkili gelir verileriyle ücretli etkinlik işleyiciyi çağırır. Bu işleyiciyi uygulayarak kullanıcının yaşam boyu değerini hesaplamak için verileri kullanabilir veya verileri diğer alakalı sistemlere aktarabilirsiniz.

Bu kılavuzun amacı, iOS uygulamanızda YBD verilerini yakalama özelliğini uygulamanıza yardımcı olmaktır.

Ön koşullar

Ücretli etkinlik işleyici uygulama

Her reklam biçiminin GADPaidEventHandler türüne sahip bir paidEventHandler mülkü vardır. Google Mobile Ads SDK'sı, bir reklam etkinliğinin yaşam döngüsü sırasında gösterim etkinliklerini izler ve kazanılan değerle işleyiciyi çağırır.

Swift

class ViewController: UIViewController, GADFullScreenContentDelegate {
  var rewardedAd: GADRewardedAd?
  func requestRewardedAd() {
    GADRewardedAd.load(
      withAdUnitID: "AD_UNIT_ID", request: GADRequest()
    ) { (ad, error) in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
        return
      }
      if let ad = ad {
        self.rewardedAd = ad
        self.rewardedAd?.paidEventHandler = { adValue in
          // 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 precision = adValue.precision
          let currencyCode = adValue.currencyCode

          // Get the ad unit ID.
          let adUnitId = ad.adUnitID

          let responseInfo = ad.responseInfo
          let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
          let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
          let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
          let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
          let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
          let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
          let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
        }
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end

@implementation ViewController
- (void)requestRewardedAd {
  __weak ViewController *weakSelf = self;

  GADRequest *request = [GADRequest request];
  [GADRewardedAd
   loadWithAdUnitID:@"AD_UNIT_ID"
   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.paidEventHandler = ^void(GADAdValue *_Nonnull value){
      ViewController *strongSelf = weakSelf;
      // 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; = value.value;
      NSString *currencyCode = value.currencyCode;
      GADAdValuePrecision precision = value.precision;

      // Get the ad unit ID.
      NSString *adUnitId = strongSelf.rewardedAd.adUnitID;

      GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo =
          strongSelf.rewardedAd.responseInfo.loadedAdNetworkResponseInfo;
      NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
      NSString *adSourceID = loadedAdNetworkResponseInfo.adSourceID;
      NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
      NSString *adSourceInstanceID = loadedAdNetworkResponseInfo.adSourceInstanceID;
      NSDictionary<NSString *, id> *extras = strongSelf.rewardedAd.responseInfo.extrasDictionary;
      NSString *mediationGroupName = extras["mediation_group_name"];
      NSString *mediationABTestName = extras["mediation_ab_test_name"];
      NSString *mediationABTestVariant = extras["mediation_ab_test_variant"];
    };
  ]};
}

Kazanan reklam kaynağı hakkında daha fazla bilgi için Reklam yanıtıyla ilgili bilgileri alma başlıklı makaleyi inceleyin.

Uygulama İlişkilendirme İş Ortakları (AAP) ile entegrasyon

Reklam geliri verilerini analiz platformlarına yönlendirmeyle ilgili tüm ayrıntılar için iş ortağı kılavuzuna bakın:

İş Ortağı SDK'sı
Adjust
AppsFlyer
Singular
Tenjin

Kullanımla ilgili en iyi uygulamalar

  • İşleyiciyi, reklam nesnesini oluşturduktan veya reklam nesnesine eriştikten hemen sonra ve kesinlikle reklamı göstermeden önce ayarlayın. Bu sayede, ücretli etkinlik geri aramalarını kaçırmazsınız.
  • Ücretli etkinlik bilgilerini, paidEventHandler yöntemi çağrıldığı anda tercih ettiğiniz analiz sunucusuna hemen gönderin. Bu, geri aramaları yanlışlıkla atlamamanızı sağlar ve veri tutarsızlıklarını önler.

GADAdValue

GADAdValue, bir reklam için kazanılan parasal değeri temsil eden bir sınıftır. Değerin para birimi kodu ve aşağıda kodlanmış hassasiyet türü de bu sınıfa dahildir.

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

Teklifli sistem reklam kaynaklarından gelen gösterimleri test etme

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

  • GADAdValuePrecisionUnknown: Kesinlik türünü belirtir.
  • 0: Reklam değerini belirtir.

Daha önce, hassasiyet türünü GADAdValuePrecisionUnknown dışında bir değer ve reklam değeri olarak 0'ten fazla bir değer 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.