Werbeeinnahmen auf Impressionsebene

Plattform auswählen: Android Neu Android iOS Unity

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

Event-Handler für kostenpflichtige Ereignisse implementieren

Jedes Anzeigenformat hat ein paidEventHandler Attribut 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)."
  )
}
ImpressionLevelAdRevenueSnippets.swift

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);
};
ImpressionLevelAdRevenueSnippets.m

Name der Anzeigenquelle für benutzerdefinierte Ereignisse ermitteln

Bei Anzeigenquellen für benutzerdefinierte Ereignisse gibt das adSourceName Attribut 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 adNetworkClassName Attribut 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
}
ResponseInfoSnippets.swift

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;
}
ResponseInfoSnippets.m

Weitere Informationen zur Anzeigenquelle, die die Auktion gewonnen hat, finden Sie unter Informationen zur Anzeigenantwort abrufen.

Mit App Attribution Partnern (AAP) verknüpfen

Ausführliche Informationen zum Weiterleiten von Daten zu Werbeeinnahmen an Analyseplattformen finden Sie im Leitfaden des Partners:

Partner-SDK
Adjust
AppsFlyer
Singular
Tenjin

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 den gewünschten Analyseserver, wenn die Methode paidEventHandler aufgerufen wird. So vermeiden Sie, dass Rückrufe versehentlich verworfen werden, 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 von Bidding-Anzeigenquellen testen

Nachdem ein Ereignis für Werbeeinnahmen auf Impressionsebene für eine 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.