Revenus publicitaires au niveau des impressions

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

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 ESTIMATEDvaleur 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.