Lorsqu'une impression se produit, le SDK Google Mobile Ads appelle le gestionnaire d'événements payants avec les données sur les revenus associées. En implémentant ce gestionnaire, vous pouvez utiliser les données pour calculer la valeur vie d'un utilisateur ou transférer les données en aval à d'autres systèmes pertinents.
L'objectif de ce guide est de vous aider à implémenter la capture de données LTV dans votre application iOS.
Prérequis
- Assurez-vous d'avoir activé la fonctionnalité de revenus publicitaires au niveau des impressions dans l'interface utilisateur AdMob.
- Importez la version 9.10.0 ou ultérieure du SDK Google Mobile Ads.
- Suivez le guide de démarrage.
Pour pouvoir recevoir des revenus publicitaires au niveau des impressions, vous devez implémenter au moins un format d'annonce:
Implémenter un gestionnaire d'événements payants
Chaque format d'annonce possède une propriété paidEventHandler
de type GADPaidEventHandler
.
Au cours du cycle de vie d'un événement d'annonce, le SDK Google Mobile Ads surveille les événements d'impression et appelle le gestionnaire avec une valeur acquise.
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"];
};
]};
}
Pour en savoir plus sur la source d'annonce gagnante, consultez Récupérer des informations sur la réponse d'annonce.
Intégration avec App Attribution Partners (AAP)
Pour en savoir plus sur le transfert des données sur les revenus publicitaires vers les plates-formes d'analyse, consultez le guide du partenaire:
SDK partenaire |
---|
Ajuster |
AppsFlyer |
Singular |
Tenjin |
Bonnes pratiques d'implémentation
- Définissez le gestionnaire immédiatement après avoir créé l'objet d'annonce ou obtenu l'accès à celui-ci, et certainement avant d'afficher l'annonce. Cela vous permet de ne manquer aucun rappel d'événement payant.
- Envoyez immédiatement les informations sur les événements payants à votre serveur d'analyse préféré au moment où la méthode
paidEventHandler
est appelée. Cela vous permet de ne pas supprimer accidentellement de rappels et d'éviter les écarts de données.
GADAdValue
GADAdValue
est une classe qui représente la valeur monétaire gagnée pour une annonce, y compris le code de devise de la valeur et son type de précision encodé comme suit.
GADAdValuePrecision | Description |
---|---|
GADAdValuePrecisionUnknown
|
Valeur d'annonce inconnue. Cette valeur est renvoyée lorsque le pingback LTV est activé, mais que les données disponibles sont insuffisantes. |
GADAdValuePrecisionEstimated
|
Valeur d'annonce estimée à partir de données globales. |
GADAdValuePrecisionPublisherProvided
|
Valeur d'annonce fournie par l'éditeur, telle que les CPM manuels dans un groupe de médiation. |
GADAdValuePrecisionPrecise
|
Valeur exacte payée pour cette annonce. |