Revenus publicitaires au niveau des impressions

Lorsqu'une impression se produit, Google Mobile Ads SDK for React Native fournit les données de revenus publicitaires associées à cette impression. Utilisez ces données pour calculer la valeur vie (LTV) d'un utilisateur, ou transmettez-les à des plates-formes d'analyse ou à des partenaires d'attribution tiers.

Ce guide explique comment implémenter la capture des données sur les revenus publicitaires au niveau des impressions dans votre application React Native.

Prérequis

Avant de continuer, procédez comme suit :

Chaque format d'annonce accepte un rappel d'événement onAdPaid. Pendant le cycle de vie d'une annonce, Google Mobile Ads SDK for React Native surveille les événements d'impression et appelle le gestionnaire avec une charge utile AdValue gagnée.

L'exemple suivant enregistre un écouteur d'événements payants sur une annonce avec récompense, consigne les données sur les revenus publicitaires générés et affiche l'annonce :

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Nous vous recommandons d'effectuer les opérations suivantes :

  • Pour les annonces en plein écran, définissez l'écouteur sur l'objet d'annonce après avoir chargé l'annonce et avant de l'afficher. Pour les bannières et les annonces natives, transmettez le rappel onAdPaid en tant que propriété au composant <BannerAdView /> ou <NativeAdView />. Ce processus vous permet de ne manquer aucun rappel d'événement payant.

  • Envoyez les informations sur les revenus publicitaires au niveau des impressions à votre serveur d'analyse préféré lorsque Google Mobile Ads SDK for React Native appelle le rappel onAdPaid. Ce processus vous permet de ne pas manquer de rappels et de maintenir la cohérence de vos données.

En savoir plus sur l'intégration d'AAP

Pour en savoir plus sur le transfert des données de revenus publicitaires vers les plates-formes d'analyse, consultez les guides suivants des App Attribution Partners (AAP) :

Comprendre l'objet AdValue

Un objet AdValue représente la valeur monétaire générée par une annonce, y compris le code de la devise et le type de précision. Le tableau suivant liste les propriétés de l'objet AdValue :

Propriété Description
amountMicros Revenus publicitaires en micro-unités, où 1000000 micro-unités équivalent à une unité de devise, par exemple 1 USD ou 1 EUR.
currencyCode Code de devise ISO 4217 de la valeur de l'annonce (par exemple, USD ou EUR).
precision Niveau de précision de la valeur de l'annonce. La liste suivante détaille chaque niveau de précision :
  • UNKNOWN : valeur d'annonce inconnue. Cette valeur est renvoyée lorsque le pingback de la LTV est activé, mais que les données sont insuffisantes.
  • ESTIMATED : valeur de l'annonce estimée à partir de données globales.
  • PUBLISHER_PROVIDED : valeur d'annonce fournie par l'éditeur, comme les CPM manuels dans un groupe de médiation.
  • PRECISE : montant exact payé pour une annonce.

Dans la médiation AdMob, AdMob tente de fournir une valeur d'ESTIMATED pour les sources d'annonces optimisées. Pour en savoir plus, consultez Optimiser les sources publicitaires en cascade dans la médiation. Si une source d'annonce n'est pas optimisée ou ne dispose pas de suffisamment de données agrégées pour une estimation, Google Mobile Ads SDK for React Native renvoie le type de précision PUBLISHER_PROVIDED.

Tester les impressions provenant de sources d'annonces pour l'enchère

Lorsqu'un événement de revenus publicitaires au niveau des impressions se produit pour une source d'annonces pour l'enchère via une demande de test, vous ne recevez que les valeurs suivantes :

  • UNKNOWN : indique le type de précision.
  • 0 : indique la valeur de l'annonce.

Pour savoir comment envoyer une demande d'annonce test, consultez Activer les appareils de test.