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

L'objectif de ce guide est de vous aider à implémenter les revenus publicitaires au niveau des impressions. la capture de données dans votre projet Unity.

Prérequis

• Assurez-vous d'avoir activé les revenus publicitaires au niveau des impressions fonctionnalité dans l'interface utilisateur AdMob.
• Plug-in Unity 5.0.0 ou version ultérieure.
• Suivez la procédure Commencer. Votre application Unity doit le plug-in Google Mobile Ads Unity est déjà importé.

• Avant de recevoir des données sur les revenus publicitaires au niveau des impressions, vous devez implémentez au moins un format d'annonce:

  • Banner
  • Interstitiel
  • Avec récompense
  • Interstitiel avec récompense
  • Natif

Implémenter un gestionnaire d'événements payants

Chaque format d'annonce est associé à un événement OnPaidEvent. Au cours du cycle de vie d'un événement publicitaire, Le SDK Google Mobile Ads contrôle 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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, 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 plus d'informations sur la source d'annonces gagnante, reportez-vous à la section Récupération d'informations sur la réponse d'annonce.

Intégration à App Attribution Partners (AAP)

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

SDK partenaire
Adjust
AppsFlyer
Singular
Tenjin

Bonnes pratiques d'implémentation

• Définissez l'événement OnPaidEvent dès que vous avez créé l'événement ou que vous y avez accès. et bien avant de diffuser l'annonce. Cela vous permet de ne pas ne manquer aucun rappel.
• Envoyez les informations sur les revenus publicitaires au niveau des impressions à l'outil d'analyse de votre choix. immédiatement dans votre gestionnaire OnPaidEvent. Cela vous permet de ne pas supprimer accidentellement tous les rappels et éviter les incohérences 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 ci-dessous.

Important :La valeur de AdValue est une micro-valeur qui représente la Par exemple, la valeur 5 000 indique que cette annonce est estimée vaut 0,005 $.

AdValue.PrecisionType	Description
Unknown	Valeur d'annonce inconnue. Cette valeur est renvoyée lorsque le pingback LTV est 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 (CPM manuel dans un groupe de médiation, par exemple).
Precise	Valeur précise de cette annonce.

Dans le cas de la médiation, AdMob essaie de fournir une ESTIMATEDvaleur pour les sources d'annonces optimisées. Pour les sources d'annonces non optimisées ou lorsque les données globales sont insuffisantes pour fournir une estimation significative, la valeur PUBLISHER_PROVIDED est renvoyée.