Revenus publicitaires au niveau des impressions

Lorsqu'une impression se produit, Google Mobile Ads SDK fournit les données de revenus publicitaires associées à cette impression. Vous pouvez utiliser les données pour calculer la valeur vie d'un utilisateur ou les transférer en aval vers d'autres systèmes pertinents.

Ce guide est destiné à vous aider à implémenter la capture des données de LTV dans votre application iOS.

Prérequis

Gérer les événements payants

Le protocole délégué de chaque format d'annonce inclut une méthode didRecordPaidEventWithAdValue:. Pendant le cycle de vie d'une annonce, Google Mobile Ads SDK surveille les événements d'impression et appelle cette méthode déléguée avec un objet GADAdValue obtenu.

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

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith 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.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)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.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode, (long)precision);
}

Identifier le nom d'une source d'annonce d'événement personnalisé

Pour les sources d'annonces d'événements personnalisés, la propriété adSourceName vous donne le nom de la source d'annonces Custom event. Si vous utilisez plusieurs événements personnalisés, le nom de la source d'annonce n'est pas assez précis pour les distinguer. Pour localiser un événement personnalisé spécifique, procédez comme suit :

  1. Obtenez la propriété adNetworkClassName.
  2. Définissez un nom de source d'annonce unique.

L'exemple suivant définit un nom de source d'annonce unique pour un événement personnalisé :

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

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

Bonnes pratiques pour l'implémentation

  • Définissez le délégué immédiatement après avoir créé l'objet d'annonce ou obtenu l'accès à celui-ci, et impérativement avant d'afficher l'annonce. Cela vous permet de ne manquer aucun rappel d'événement payant.
  • Envoyez les informations sur l'événement payant à votre serveur d'analyse préféré dès que la méthode déléguée didRecordPaidEventWithAdValue: est appelée. Cela permet de s'assurer que vous ne supprimez pas accidentellement des rappels et d'éviter les écarts de données.

GADAdValue

GADAdValue est une classe qui représente la valeur monétaire générée par une annonce, y compris le code de la devise de la valeur et son type de précision encodé comme suit.

GADAdValuePrecision Description
GADAdValuePrecisionUnknown Valeur d'annonce inconnue. Cette valeur est renvoyée lorsque le pingback de la valeur vie est activé, mais qu'il n'y a pas assez de données disponibles.
GADAdValuePrecisionEstimated La valeur de l'annonce est estimée à partir de données globales.
GADAdValuePrecisionPublisherProvided Une valeur d'annonce fournie par l'éditeur, comme les CPM manuels dans un groupe de médiation.
GADAdValuePrecisionPrecise Il s'agit du montant exact payé pour cette annonce.

Impressions de test d'Open Bidding

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

  • GADAdValuePrecisionUnknown : indique le type de précision.
  • 0 : indique la valeur de l'annonce.
Auparavant, vous avez peut-être vu le type de précision sous une valeur autre que GADAdValuePrecisionUnknown et une valeur d'annonce supérieure à 0.

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