Saat tayangan terjadi, Google Mobile Ads SDK akan memanggil pengendali peristiwa berbayar dengan data pendapatan terkait. Dengan menerapkan pengendali ini, Anda dapat menggunakan data untuk menghitung nilai umur pengguna, atau meneruskan downstream data ke sistem lain yang relevan.
Panduan ini ditujukan untuk membantu Anda menerapkan pengambilan data LTV di aplikasi iOS.
Prasyarat
- Pastikan Anda telah mengaktifkan fitur pendapatan iklan tingkat tayangan di UI AdMob.
- Impor Google Mobile Ads SDK 9.10.0 atau yang lebih tinggi.
- Selesaikan Panduan memulai.
Sebelum dapat menerima pendapatan iklan tingkat tayangan, Anda harus menerapkan setidaknya satu format iklan:
Mengimplementasikan pengendali peristiwa berbayar
Setiap format iklan memiliki properti paidEventHandler
jenis
GADPaidEventHandler
.
Selama siklus proses peristiwa iklan, Google Mobile Ads SDK memantau peristiwa tayangan dan memanggil pengendali dengan nilai yang diperoleh.
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"];
};
]};
}
Untuk informasi selengkapnya tentang sumber iklan pemenang, lihat Mengambil informasi tentang respons iklan.
Berintegrasi dengan Partner Atribusi Aplikasi (AAP)
Untuk mengetahui detail selengkapnya tentang cara meneruskan data pendapatan iklan ke platform analisis, lihat panduan partner:
SDK Partner |
---|
Adjust |
AppsFlyer |
Singular |
Tenjin |
Praktik terbaik penerapan
- Tetapkan pengendali segera setelah Anda membuat atau mendapatkan akses ke objek iklan, dan tentunya sebelum menampilkan iklan. Dengan begitu, Anda tidak akan melewatkan callback peristiwa berbayar apa pun.
- Kirim informasi peristiwa berbayar ke server analisis pilihan Anda segera pada saat metode
paidEventHandler
dipanggil. Hal ini memastikan Anda tidak melepas callback secara tidak sengaja dan menghindari perbedaan data.
GADAdValue
GADAdValue
adalah class yang mewakili nilai uang yang diperoleh untuk sebuah iklan,
termasuk kode mata uang nilai dan jenis presisinya yang dienkode seperti di bawah ini.
GADAdValuePrecision | Deskripsi |
---|---|
GADAdValuePrecisionUnknown
|
Nilai iklan yang tidak diketahui. Nilai ini ditampilkan saat pingback LTV diaktifkan, tetapi data yang tersedia tidak cukup. |
GADAdValuePrecisionEstimated
|
Estimasi nilai iklan dari data gabungan. |
GADAdValuePrecisionPublisherProvided
|
Nilai iklan yang diberikan penayang, seperti CPM manual dalam grup mediasi. |
GADAdValuePrecisionPrecise
|
Nilai akurat yang dibayarkan untuk iklan ini. |