Werbeeinnahmen auf Impressionsebene

Plattform auswählen: Android Neu Android iOS Unity

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

In diesem Leitfaden wird beschrieben, wie Sie die Erfassung von Werbeeinnahmen auf Impressionsebene in Ihrer Android-App implementieren.

Vorbereitung

  • Importieren Sie Google Mobile Ads SDK 21.1.0 oder höher.

Jedes Anzeigenformat hat einen OnPaidEventListener. 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 bezahlte Ereignisse für eine Anzeige mit Prämie verarbeitet:

Java

private void setOnPaidEventListener(RewardedAd ad) {
  ad.setOnPaidEventListener(
      new OnPaidEventListener() {
        @Override
        public void onPaidEvent(@NonNull AdValue adValue) {
          // Extract the impression-level ad revenue data.
          long valueMicros = adValue.getValueMicros();
          String currencyCode = adValue.getCurrencyCode();
          int precision = adValue.getPrecisionType();

          // Get the ad unit ID.
          String adUnitId = ad.getAdUnitId();

          // Extract ad response information.
          AdapterResponseInfo loadedAdapterResponseInfo =
              ad.getResponseInfo().getLoadedAdapterResponseInfo();
          if (loadedAdapterResponseInfo != null) {
            String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
            String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
            String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
            String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

            Bundle extras = ad.getResponseInfo().getResponseExtras();
            String mediationGroupName = extras.getString("mediation_group_name");
            String mediationABTestName = extras.getString("mediation_ab_test_name");
            String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
          }
        }
      });
}
ImpressionLevelAdRevenueSnippets.java

Kotlin

private fun setOnPaidEventListener(ad: RewardedAd) {
  ad.onPaidEventListener = OnPaidEventListener { adValue ->
    // Extract the impression-level ad revenue data.
    val valueMicros = adValue.valueMicros
    val currencyCode = adValue.currencyCode
    val precision = adValue.precisionType

    // Get the ad unit ID.
    val adUnitId = ad.adUnitId

    // Extract ad response information.
    val loadedAdapterResponseInfo = ad.responseInfo.loadedAdapterResponseInfo
    val adSourceName = loadedAdapterResponseInfo?.adSourceName
    val adSourceId = loadedAdapterResponseInfo?.adSourceId
    val adSourceInstanceName = loadedAdapterResponseInfo?.adSourceInstanceName
    val adSourceInstanceId = loadedAdapterResponseInfo?.adSourceInstanceId
    val extras = ad.responseInfo.responseExtras
    val mediationGroupName = extras.getString("mediation_group_name")
    val mediationABTestName = extras.getString("mediation_ab_test_name")
    val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
  }
}
ImpressionLevelAdRevenueSnippets.kt

Namen einer benutzerdefinierten Anzeigenquelle ermitteln

Für benutzerdefinierte Ereignis-Anzeigenquellen gibt die getAdSourceName() Methode den Namen der Anzeigenquelle Custom event zurück. 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 getAdSourceName() Methode auf.
  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:

Java

private String getUniqueAdSourceName(@NonNull AdapterResponseInfo loadedAdapterResponseInfo) {

  String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
  if (adSourceName.equals("Custom Event")) {
    if (loadedAdapterResponseInfo
        .getAdapterClassName()
        .equals("com.google.ads.mediation.sample.customevent.SampleCustomEvent")) {
      adSourceName = "Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

ResponseInfoSnippets.java

Kotlin

private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdapterResponseInfo): String {

  var adSourceName = loadedAdapterResponseInfo.adSourceName
  if (adSourceName == "Custom Event") {
    if (
      loadedAdapterResponseInfo.adapterClassName ==
        "com.google.ads.mediation.sample.customevent.SampleCustomEvent"
    ) {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

ResponseInfoSnippets.kt

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

Integration von App Attribution Partnern (AAP)

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

Partner-SDK
Adjust
AppsFlyer
Singular
Tenjin

Best Practices zur Implementierung

  • Legen Sie den Listener sofort fest, nachdem Sie das Anzeigenobjekt erstellt oder darauf zugegriffen haben, und auf jeden Fall, bevor die Anzeige ausgeliefert wird. So verpassen Sie keine Rückrufe für bezahlte Ereignisse.
  • Senden Sie die Informationen zu den Werbeeinnahmen auf Impressionsebene sofort an Ihren bevorzugten Analyseserver, wenn der Rückruf für bezahlte Ereignisse erfolgt. So vermeiden Sie, dass Rückrufe versehentlich verloren gehen, und verhindern Datenabweichungen.

AdValue

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

PrecisionType Beschreibung
UNKNOWN Ein unbekannter Anzeigenwert. Dieser Wert wird zurückgegeben, wenn LTV-Pingback aktiviert ist, aber nicht genügend Daten verfügbar sind.
ESTIMATED Ein Anzeigenwert, der anhand von aggregierten Daten geschätzt wird.
PUBLISHER_PROVIDED Ein vom Publisher angegebener Anzeigenwert, z. B. manuelle CPMs in einer Vermittlungsgruppe.
PRECISE Der genaue Wert, der für diese Anzeige gezahlt wurde.

Bei der AdMob-Vermittlung versucht AdMob, einen ESTIMATED Wert für Anzeigenquellen anzugeben, die optimiert sind. Für nicht optimierte Anzeigenquellen oder in Fällen, in denen nicht genügend aggregierte Daten vorhanden sind, um eine aussagekräftige Schätzung zu liefern, wird der Wert PUBLISHER_PROVIDED zurückgegeben.

Impressionen aus Bidding-Anzeigenquellen testen

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

  • UNKNOWN gibt den Genauigkeitstyp an.
  • 0 gibt den Anzeigenwert an.

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

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