Werbeeinnahmen auf Impressionsebene

Plattform auswählen: Android Android iOS Unity

Wenn eine Impression erfolgt, liefert GMA Next-Gen SDK Daten zu den Werbeeinnahmen , die mit dieser Impression verbunden 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 erfahren Sie, wie Sie die Erfassung von Werbeeinnahmen auf Impressionsebene in Ihrer Android-App implementieren.

Vorbereitung

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

• Richten Sie GMA Next-Gen SDK ein.

• Bevor Sie Werbeeinnahmen auf Impressionsebene erhalten können, müssen Sie mindestens ein Anzeigenformat implementieren:

  • App-Start
  • Banner
  • Interstitial
  • Mit Prämie
  • Interstitial mit Prämie
  • Native Einbindung

Handler für bezahlte Ereignisse

Jedes Anzeigenformat hat einen onAdPaid Event-Callback. Während des Lebenszyklus eines Anzeigenereignisses überwacht GMA Next-Gen 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:

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")
    }
  }
ImpressionLevelAdRevenueSnippets.kt

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

Benutzerdefinierten Namen für Anzeigenquelle für Ereignisse ermitteln

Für Anzeigenquellen für benutzerdefinierte Ereignisse gibt die Property AdSourceResponseInfo.name 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 Property AdSourceResponseInfo.name 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:

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
}
ImpressionLevelAdRevenueSnippets.kt

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

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:

Best Practices zur Implementierung

• Legen Sie den Listener sofort fest, nachdem Sie das Anzeigenobjekt erstellt oder darauf zugegriffen haben, und auf jeden Fall, bevor Sie die Anzeige präsentieren. So verpassen Sie keine Event-Callbacks für bezahlte Ereignisse.
• Senden Sie die Informationen zu den Werbeeinnahmen auf Impressionsebene sofort an Ihren bevorzugten Analysenserver, wenn der Event-Callback für bezahlte Ereignisse aufgerufen wird. So vermeiden Sie, dass versehentlich Callbacks verloren gehen, und verhindern Datenabweichungen.

AdValue

AdValue ist eine Klasse, die den monetären Wert darstellt, der mit einer Anzeige erzielt wurde, einschließlich des Währungscodes des Werts und des Genauigkeitstyps, der wie folgt codiert ist.

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

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 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 Testanzeigenanfrage finden Sie unter Testgeräte aktivieren.