Werbeeinnahmen auf Impressionsebene

Plattform auswählen: Android iOS Unity Android (Legacy)

Wenn eine Impression erfolgt, ruft Google Mobile Ads SDK den Handler für kostenpflichtige Ereignisse mit den zugehörigen Umsatzdaten auf. Durch die Implementierung dieses Handlers können Sie die Daten verwenden, um den Lifetime-Wert eines Nutzers zu berechnen oder die Daten an andere relevante Systeme weiterzuleiten.

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

Vorbereitung

  • Achten Sie darauf, dass Sie die Funktion für Werbeeinnahmen auf Impressionsebene in der Ad Manager-Benutzeroberfläche aktiviert haben.

Event-Handler für kostenpflichtige Ereignisse implementieren

Jedes Anzeigenformat hat eine paidEventHandler-Property vom Typ GADPaidEventHandler. Während des Lebenszyklus eines Anzeigenereignisses erfasst Google Mobile Ads SDK Impressionen und ruft den Handler mit einem erzielten Wert auf.

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

Swift

rewardedAd?.paidEventHandler = { adValue in
  // 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

rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull 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);
};

Namen für Anzeigenquelle für benutzerdefiniertes Ereignis festlegen

Bei Anzeigenquellen für benutzerdefinierte Ereignisse gibt die adSourceName Property 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 die adNetworkClassName Property ab.
  2. Legen Sie einen eindeutigen Namen für die Anzeigenquelle fest.

Im folgenden Beispiel wird ein eindeutiger Name für die Anzeigenquelle 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 Anzeigenquelle, die die Auktion gewonnen hat, finden Sie unter Informationen zur Anzeigenantwort abrufen.

Best Practices zur Implementierung

  • Legen Sie den Handler 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 Rückrufe für kostenpflichtige Ereignisse.
  • Senden Sie die Informationen zu kostenpflichtigen Ereignissen sofort an Ihren bevorzugten Analysenserver, wenn die Methode paidEventHandler aufgerufen wird. So vermeiden Sie, dass Rückrufe verloren gehen, und verhindern Datenabweichungen.

GADAdValue

GADAdValue ist eine Klasse, die den Geldwert darstellt, der mit einer Anzeige erzielt wurde. Dazu gehören der Währungscode des Werts und der Genauigkeitstyp, der wie folgt codiert ist.

GADAdValuePrecision Beschreibung
GADAdValuePrecisionUnknown Ein unbekannter Anzeigenwert. Dieser Wert wird zurückgegeben, wenn 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 angegebener Anzeigenwert, z. B. manuelle CPMs in einer Vermittlungsgruppe.
GADAdValuePrecisionPrecise Der genaue Wert, der für diese Anzeige gezahlt wurde.

Impressionen aus Open Bidding testen

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

  • GADAdValuePrecisionUnknown: gibt den Genauigkeitstyp an.
  • 0: gibt den Anzeigenwert an.

Bisher wurde der Genauigkeitstyp möglicherweise als anderer Wert als GADAdValuePrecisionUnknown und ein Anzeigenwert über 0 angezeigt.

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