Werbeeinnahmen auf Impressionsebene

Wenn eine Impression erfolgt, liefert das GMA Next Gen SDK Daten zum Werbeumsatz, die mit dieser Impression verknüpft sind. Sie können die Daten verwenden, um den Lifetime-Wert eines Nutzers zu berechnen oder die Daten an andere relevante Systeme weiterzuleiten.

Dieser Leitfaden soll Ihnen helfen, die Erfassung von Daten zu Werbeeinnahmen auf Impressionsebene in Ihrer Android-App zu implementieren.

Vorbereitung

Für jedes Anzeigenformat gibt es einen onAdPaid Event-Callback. Während des Lebenszyklus eines Anzeigenereignisses überwacht das GMA Next Gen SDK Impression-Ereignisse und ruft den Handler mit einem verdienten Wert auf.

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

Kotlin

ad.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdPaid(adValue: AdValue) {
      // Send the impression-level ad revenue information to your
      // preferred analytics server directly within this callback.

      // Extract the impression-level ad revenue data.
      val valueMicros = adValue.valueMicros
      val currencyCode = adValue.currencyCode
      val precisionType = adValue.precisionType

      val loadedAdSourceResponseInfo = ad.getResponseInfo().loadedAdSourceResponseInfo
      val adSourceName = loadedAdSourceResponseInfo?.name
      val adSourceId = loadedAdSourceResponseInfo?.id
      val adSourceInstanceName = loadedAdSourceResponseInfo?.instanceName
      val adSourceInstanceId = loadedAdSourceResponseInfo?.instanceId
      val extras = ad.getResponseInfo().responseExtras
      val mediationGroupName = extras.getString("mediation_group_name")
      val mediationABTestName = extras.getString("mediation_ab_test_name")
      val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
    }
  }

Java

ad.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdPaid(@NonNull AdValue value) {
        // Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.

        // Extract the impression-level ad revenue data.
        long valueMicros = value.getValueMicros();
        String currencyCode = value.getCurrencyCode();
        PrecisionType precisionType = value.getPrecisionType();

        AdSourceResponseInfo loadedAdSourceResponseInfo =
            ad.getResponseInfo().getLoadedAdSourceResponseInfo();
        String adSourceName = loadedAdSourceResponseInfo.getName();
        String adSourceId = loadedAdSourceResponseInfo.getId();
        String adSourceInstanceName = loadedAdSourceResponseInfo.getInstanceName();
        String adSourceInstanceId = loadedAdSourceResponseInfo.getInstanceId();

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

Name der Anzeigenquelle für benutzerdefiniertes Ereignis ermitteln

Bei Anzeigenquellen für benutzerdefinierte Ereignisse wird mit der Property AdSourceResponseInfo.name der Name der Anzeigenquelle Custom event zurückgegeben. 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 AdSourceResponseInfo.name 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:

Kotlin

private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdSourceResponseInfo): String {
  var adSourceName = loadedAdapterResponseInfo.name
  if (adSourceName == "Custom Event") {
    if (
      loadedAdapterResponseInfo.adapterClassName ==
        "com.google.ads.mediation.sample.customevent.SampleCustomEvent"
    ) {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

Java

private String getUniqueAdSourceName(@NonNull AdSourceResponseInfo loadedAdapterResponseInfo) {
  String adSourceName = loadedAdapterResponseInfo.getName();
  if (adSourceName.equals("Custom Event")) {
    if (loadedAdapterResponseInfo
        .getAdapterClassName()
        .equals("com.google.ads.mediation.sample.customevent.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.

Integration von App Attribution Partnern (AAP)

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

Partner-SDK
Anpassen
AppsFlyer
Singular
Tenjin

Best Practices für die Implementierung

  • Legen Sie den Listener sofort fest, nachdem Sie das Anzeigenobjekt erstellt oder darauf zugegriffen haben, und auf jeden Fall vor der Auslieferung der Anzeige. So verpassen Sie keine Rückrufe für bezahlte Ereignisse.
  • Senden Sie die Informationen zu den Werbeeinnahmen auf Impressionsebene sofort an Ihren bevorzugten Analysenserver, wenn der Callback für das kostenpflichtige Ereignis aufgerufen wird. So wird sichergestellt, dass Sie keine Callbacks versehentlich verwerfen, und Datenabweichungen werden vermieden.

AdValue

AdValue ist eine Klasse, die den mit einer Anzeige erzielten Geldwert darstellt, einschließlich des Währungscodes des Werts und des codierten Genauigkeitstyps.

PrecisionType Beschreibung
UNKNOWN Ein Anzeigenwert, der unbekannt ist. Dieser Wert wird zurückgegeben, wenn LTV-Pingbacks aktiviert sind, 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 wird.

Bei der AdMob-Vermittlung wird versucht, einen ESTIMATED-Wert für optimierte Anzeigenquellen bereitzustellen. Bei nicht optimierten Anzeigenquellen oder wenn nicht genügend aggregierte Daten für eine aussagekräftige Schätzung vorhanden sind, wird der Wert PUBLISHER_PROVIDED zurückgegeben.

Impressionen aus 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:

  • UNKNOWN: Gibt den Typ der Genauigkeit an.
  • 0: Gibt den Anzeigenwert an.

Bisher wurde der Präzisionstyp möglicherweise als ein anderer Wert als UNKNOWN und der Anzeigenwert als mehr als 0 angezeigt.

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