Lorsqu'une impression se produit, le SDK Google Mobile Ads fournit des données sur les revenus publicitaires associés à cette impression. Vous pouvez utiliser ces données pour calculer la valeur vie d'un utilisateur ou les transmettre en aval à d'autres systèmes pertinents.
L'objectif de ce guide est de vous aider à implémenter la capture des données sur les revenus publicitaires au niveau des impressions dans votre projet Unity.
Prérequis
- Assurez-vous d'avoir activé la fonctionnalité de revenus publicitaires au niveau des impressions dans l'interface utilisateur AdMob.
- Plug-in Unity 5.0.0 ou version ultérieure.
- Suivez les instructions de la section Premiers pas. Le plug-in Google Mobile Ads Unity doit déjà être importé dans votre application Unity.
Pour pouvoir recevoir des données sur les 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 comporte un événement OnPaidEvent
. 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.
Le code ci-dessous montre comment gérer les événements payants pour une annonce avec récompense:
RewardedAd rewardedAd; private void RequestRewardedAd() { rewardedAd = new RewardedAd("AD_UNIT_ID"); rewardedAd.OnPaidEvent += this.HandleAdPaidEvent; AdRequest adRequest = new AdRequest(); rewardedAd.LoadAd(adRequest); } public void HandleAdPaidEvent(object sender, AdValueEventArgs args) { // TODO: Send the impression-level ad revenue information to your // preferred analytics server directly within this callback. AdValue adValue = args.AdValue; long valueMicros = adValue.Value; string currencyCode = adValue.CurrencyCode; PrecisionType precision = adValue.Precision; ResponseInfo responseInfo = rewardedAd.GetResponseInfo(); string responseId = responseInfo.GetResponseId(); AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo(); string adSourceId = loadedAdapterResponseInfo.AdSourceId; string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId; string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName; string adSourceName = loadedAdapterResponseInfo.AdSourceName; string adapterClassName = loadedAdapterResponseInfo.AdapterClassName; long latencyMillis = loadedAdapterResponseInfo.LatencyMillis; Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping; Dictionary<string, string> extras = responseInfo.GetResponseExtras(); string mediationGroupName = extras["mediation_group_name"]; string mediationABTestName = extras["mediation_ab_test_name"]; string mediationABTestVariant = extras["mediation_ab_test_variant"]; }
Pour en savoir plus sur la source d'annonce gagnante, consultez la section Récupération 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 l'événement
OnPaidEvent
immédiatement après avoir créé l'objet d'annonce ou y avoir accès, et certainement avant de diffuser l'annonce. Cela vous permet de ne manquer aucun rappel. - Envoyez immédiatement les informations sur les revenus publicitaires au niveau des impressions à votre serveur d'analyse préféré dans votre gestionnaire
OnPaidEvent
. Cela vous permet de ne pas supprimer accidentellement de rappels et d'éviter les écarts de données.
AdValue
AdValue
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.
AdValue.PrecisionType |
Description |
---|---|
Unknown |
Valeur d'annonce inconnue. Cette valeur est renvoyée lorsque le pingback LTV est activé, mais que les données disponibles sont insuffisantes. |
Estimated |
Valeur d'annonce estimée à partir de données globales. |
PublisherProvided |
Valeur d'annonce fournie par l'éditeur, telle que les CPM manuels dans un groupe de médiation. |
Precise |
Valeur exacte de cette annonce. |
En cas de médiation, AdMob essaie de fournir une ESTIMATED
valeur pour les sources d'annonces optimisées. Pour les sources d'annonces non optimisées, ou dans les cas où les données globales ne sont pas suffisantes pour fournir une estimation pertinente, la valeur PUBLISHER_PROVIDED
est renvoyée.