Bir gösterim gerçekleştiğinde Google Mobile Ads SDK'sı, ilişkilendirilen gelir verileriyle birlikte ücretli etkinlik işleyiciyi çağırır. Bu işleyiciyi uygulayarak verileri bir kullanıcının yaşam boyu değerini hesaplamak veya aşağı akıştaki verileri diğer ilgili sistemlere yönlendirmek için kullanabilirsiniz.
Bu kılavuzun amacı, iOS uygulamanıza YBD verisi yakalamayı uygulamanıza yardımcı olmaktır.
Ön koşullar
- AdMob kullanıcı arayüzünde gösterim düzeyinde reklam geliri özelliğini etkinleştirdiğinizden emin olun.
- Google Mobile Ads SDK'sı 9.10.0 veya üstünü içe aktarın.
- Başlangıç kılavuzunu tamamlayın.
Gösterim düzeyinde reklam geliri elde etmeden önce en az bir reklam biçimi uygulamanız gerekir:
Ücretli etkinlik işleyiciyi uygulama
Her reklam biçimi GADPaidEventHandler
türünde bir paidEventHandler
özelliğine sahiptir.
Bir reklam etkinliğinin yaşam döngüsü sırasında Google Mobile Ads SDK'sı, gösterim etkinliklerini izler ve işleyiciyi kazanılan bir değerle ç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ı hakkında bilgi alma bölümüne bakın.
Uygulama İlişkilendirme Ortakları (AAP) ile Entegrasyon
Reklam geliri verilerini analiz platformlarına yönlendirme hakkında tüm ayrıntılar için iş ortağının 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şim elde ettikten hemen sonra ve kesinlikle reklamı göstermeden önce ayarlayın. Bu, ücretli etkinlik geri çağırmalarını kaçırmamanızı sağlar.
paidEventHandler
yöntemi çağrıldığı anda ücretli etkinlik bilgilerini tercih ettiğiniz analiz sunucusuna hemen gönderin. Böylece yanlışlıkla yapılan geri çağırmaları bırakmaz ve veri tutarsızlıklarını önlersiniz.
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ğıdaki gibi kodlanmış hassasiyet türü.
GADAdValuePrecision | Açıklama |
---|---|
GADAdValuePrecisionUnknown
|
Bilinmeyen bir reklam değeri. Bu hata, 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ğeri. |
GADAdValuePrecisionPublisherProvided
|
Yayıncının sağladığı reklam değeri (ör. uyumlulaştırma grubundaki manuel BGBM'ler) |
GADAdValuePrecisionPrecise
|
Bu reklam için ödenen tam değer. |