Cette page a été traduite par l'API Cloud Translation.

Revenus publicitaires au niveau des impressions

Lorsqu'une impression se produit, le SDK Google Mobile Ads fournit les données sur les revenus publicitaires associées à cette impression. Vous pouvez utiliser ces données pour calculer la valeur vie d'un utilisateur ou les transmettre à d'autres systèmes pertinents.

Ce guide a pour but de vous aider à implémenter la capture des données sur les revenus publicitaires au niveau des impressions dans votre application Android.

Prérequis

Assurez-vous d'avoir activé la fonctionnalité de revenus publicitaires au niveau des impressions dans l'UI AdMob.

Importez le SDK Google Mobile Ads 21.1.0 ou une version ultérieure.

Suivez le guide de démarrage.
Avant de pouvoir générer des revenus publicitaires au niveau des impressions, vous devez implémenter au moins un format d'annonce:

Gestionnaire d'événements payants

Chaque format d'annonce est associé à un OnPaidEventListener. Tout au long du cycle de vie d'un événement publicitaire, le SDK Google Mobile Ads surveille les événements d'impression et appelle le gestionnaire avec une valeur gagnée.

L'exemple suivant gère les événements payants pour une annonce avec récompense:

Kotlin

import com.google.android.gms.ads.rewarded.RewardedAd

class MainActivity : AppCompatActivity() {
  private var rewardedAd: RewardedAd? = null
  private final var TAG = "MainActivity"

  override fun onCreate(savedInstanceState: Bundle?) {
    val adRequest = AdRequest.Builder().build()

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, object: RewardedAdLoadCallback() {
        override fun onAdLoaded(ad: RewardedAd) {
          rewardedAd = ad
          // Set paid event listener
          rewardedAd.onPaidEventListener = OnPaidEventListener { adValue ->
            // TODO: Send the impression-level ad revenue information to your preferred
            // analytics server directly within this callback.

            // Extract the impression-level ad revenue data.
            val valueMicros = adValue.valueMicros
            val currencyCode = adValue.currencyCode
            val precision = adValue.precisionType

            // Get the ad unit ID.
            val adUnitId = rewardedAd.adUnitId

            val loadedAdapterResponseInfo = rewardedAd.responseInfo.loadedAdapterResponse
            val adSourceName = loadedAdapterResponseInfo.adSourceName
            val adSourceId = loadedAdapterResponseInfo.adSourceId
            val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
            val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
            val extras = rewardedAd.responseInfo.responseExtras
            val mediationGroupName = extras.getString("mediation_group_name")
            val mediationABTestName = extras.getString("mediation_ab_test_name")
            val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
          }
        }
    })
  }
}

Java

import com.google.android.gms.ads.rewarded.RewardedAd;

public class MainActivity extends Activity {
  private RewardedAd rewardedAd;
  private final String TAG = "MainActivity";

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    AdRequest adRequest = new AdRequest.Builder().build();

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, new RewardedAdLoadCallback(){
        @Override
        public void onAdLoaded(@NonNull RewardedAd ad) {
          rewardedAd = ad;
          // Set paid event listener
          rewardedAd.setOnPaidEventListener(new OnPaidEventListener() {
            @Override
            public void onPaidEvent(AdValue adValue) {
              // TODO: Send the impression-level ad revenue information to your
              //preferred analytics server directly within this callback.

              // Extract the impression-level ad revenue data.
              long valueMicros = adValue.getValueMicros();
              String currencyCode = adValue.getCurrencyCode();
              int precision = adValue.getPrecisionType();

              // Get the ad unit ID.
              String adUnitId = rewardedAd.getAdUnitId();
              
              AdapterResponseInfo loadedAdapterResponseInfo = rewardedAd.getResponseInfo().
                  getLoadedAdapterResponseInfo();
              String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
              String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
              String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
              String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

              Bundle extras = rewardedAd.getResponseInfo().getResponseExtras();
              String mediationGroupName = extras.getString("mediation_group_name");
              String mediationABTestName = extras.getString("mediation_ab_test_name");
              String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
            }
          });
        }
    });
  }
}

Pour en savoir plus sur la source d'annonces gagnante, consultez Récupérer des informations sur la réponse de l'annonce.

Intégration des App Attribution Partners (AAP)

Pour en savoir plus sur la transmission des données sur les revenus publicitaires aux plates-formes d'analyse, consultez le guide du partenaire:

SDK du partenaire
Adjust
AppsFlyer
Singular
Tenjin

Bonnes pratiques d'implémentation

Définissez l'écouteur immédiatement après avoir créé ou obtenu l'accès à l'objet d'annonce, et surtout avant de diffuser l'annonce. Vous ne manquerez ainsi aucun rappel d'événement payant.
Envoyez immédiatement les informations sur les revenus publicitaires au niveau de l'impression au serveur d'analyse de votre choix au moment de l'appel du rappel d'événement payant. Vous vous assurez ainsi 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 générée pour une annonce, y compris le code de devise de la valeur et son type de précision encodé comme ci-dessous.

PrecisionType	Description
`UNKNOWN`	Valeur d'annonce inconnue. Cette valeur est renvoyée lorsque le pingback LTV est activé, mais qu'il n'y a pas suffisamment de données disponibles.
`ESTIMATED`	La valeur de l'annonce est estimée à partir de données globales.
`PUBLISHER_PROVIDED`	La valeur de l'annonce est fournie par l'éditeur (CPM manuels dans un groupe de médiation, par exemple).
`PRECISE`	Il s'agit du montant exact payé pour cette annonce.

Dans le cas de la médiation AdMob, AdMob tente de fournir une valeur ESTIMATED pour les sources d'annonces optimisées.

Pour les sources d'annonces non optimisées ou lorsque les données agrégées ne sont pas suffisantes pour générer une estimation pertinente, la valeur PUBLISHER_PROVIDED est renvoyée.

Tester les impressions des sources d'annonces associées à des enchères

Lorsqu'un événement de revenus publicitaires au niveau des impressions se produit pour une source d'annonces d'enchères 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.

Auparavant, vous pouviez voir le type de précision comme une valeur autre que UNKNOWN et une valeur d'annonce supérieure à 0.

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