Werbeeinnahmen auf Impressionsebene

Sobald eine Impression erfolgt, stellt Google Mobile Ads SDK Daten zu den Werbeeinnahmen für diese Impression bereit. Sie können die Daten verwenden, um den Lifetime-Wert eines Nutzers zu berechnen, oder die Daten an andere relevante Systeme weiterleiten.

In diesem Leitfaden wird beschrieben, wie Sie die Erfassung von LTV-Daten in Ihrer iOS-App implementieren.

Vorbereitung

Kostenpflichtige Ereignisse verarbeiten

Das Delegatprotokoll jedes Anzeigenformats enthält eine didRecordPaidEventWithAdValue:-Methode. Während des Lebenszyklus einer Anzeige überwacht Google Mobile Ads SDK Impressionsereignisse und ruft diese Delegatmethode mit einem erhaltenen GADAdValue-Objekt auf.

Im folgenden Beispiel werden bezahlte Ereignisse für eine Anzeige mit Prämie verarbeitet:

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);
}

Name einer Anzeigenquelle für benutzerdefinierte Ereignisse ermitteln

Bei Anzeigenquellen für benutzerdefinierte Ereignisse gibt die Property adSourceName den Namen der Anzeigenquelle Custom event an. Wenn Sie mehrere benutzerdefinierte Ereignisse verwenden, ist der Name der Anzeigenquelle nicht detailliert genug, um zwischen mehreren benutzerdefinierten Ereignissen zu unterscheiden. So finden Sie ein bestimmtes benutzerdefiniertes Ereignis:

  1. Rufen Sie das Attribut adNetworkClassName ab.
  2. Legen Sie einen eindeutigen Namen für die Anzeigenquelle fest.

Im folgenden Beispiel wird ein eindeutiger Anzeigenquellenname für ein benutzerdefiniertes Ereignis festgelegt:

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;
}

Weitere Informationen zur erfolgreichen Anzeigenquelle finden Sie unter Informationen zur Anzeigenantwort abrufen.

Best Practices für die Implementierung

  • Legen Sie den Delegate sofort fest, nachdem Sie das Anzeigenobjekt erstellt oder Zugriff darauf erhalten haben, und auf jeden Fall, bevor die Anzeige ausgeliefert wird. So verpassen Sie keine Callbacks für kostenpflichtige Ereignisse.
  • Sende die Informationen zum kostenpflichtigen Ereignis sofort an deinen bevorzugten Analyseserver, wenn die Delegatmethode didRecordPaidEventWithAdValue: aufgerufen wird. So wird verhindert, dass versehentlich Callbacks verloren gehen, und Datenabweichungen werden vermieden.

GADAdValue

GADAdValue ist eine Klasse, die den mit einer Anzeige erzielten Geldwert darstellt, einschließlich des Währungscodes des Werts und seines Genauigkeitstyps, der wie folgt codiert ist.

GADAdValuePrecision Beschreibung
GADAdValuePrecisionUnknown Ein unbekannter Anzeigenwert. Dieser Wert wird zurückgegeben, wenn der LTV-Pingback aktiviert ist, aber nicht genügend Daten verfügbar sind.
GADAdValuePrecisionEstimated Ein Anzeigenwert, der anhand von aggregierten Daten geschätzt wird.
GADAdValuePrecisionPublisherProvided Ein vom Publisher bereitgestellter Anzeigenwert, z. B. manuelle CPMs in einer Vermittlungsgruppe.
GADAdValuePrecisionPrecise Der genaue Wert, der für diese Anzeige gezahlt wird.

Testimpressionen aus Open Bidding

Nachdem ein Ereignis für Werbeeinnahmen auf Impressionsebene für eine Open Bidding-Anzeigenquelle über eine Testanfrage aufgetreten ist, erhalten Sie nur die folgenden Werte:

  • GADAdValuePrecisionUnknown: Gibt den Genauigkeitstyp an.
  • 0: Gibt den Anzeigenwert an.
Zuvor wurde der Genauigkeitstyp möglicherweise als ein anderer Wert als GADAdValuePrecisionUnknown und der Anzeigenwert als ein Wert über 0 angezeigt.

Weitere Informationen zum Senden einer Testanzeigenanfrage finden Sie unter Testgeräte aktivieren.