Werbeeinnahmen auf Impressionsebene

Wenn eine Impression erzielt wird, stellt das Google Mobile Ads SDK die zugehörigen Werbeeinnahmen bereit. 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 Daten zu Werbeeinnahmen auf Impressionsebene in Ihrer Android-App implementieren.

Vorbereitung

• Sie müssen die Funktion für Werbeeinnahmen auf Impressionsebene in der AdMob-Benutzeroberfläche aktiviert haben.

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

• Führen Sie die Schritte im Startleitfaden aus.

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

  • App-Start
  • Banner
  • Interstitial
  • Mit Prämie
  • Interstitial mit Prämie
  • Nativ

Handler für kostenpflichtige Ereignisse

Jedes Anzeigenformat hat eine OnPaidEventListener. Während des Lebenszyklus eines Anzeigenereignisses überwacht das Google Mobile Ads SDK Impressionsereignisse und ruft den Handler mit einem erzielten Wert auf.

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

Kotlin

import com.google.android.gms.ads.rewarded.RewardedAd

class MainActivity : AppCompatActivity() {
  private var rewardedAd: RewardedAd? = null
  private final var TAG = "MainActivity"

  override fun onCreate(savedInstanceState: Bundle?) {
    val adRequest = AdRequest.Builder().build()

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, object: RewardedAdLoadCallback() {
        override fun onAdLoaded(ad: RewardedAd) {
          rewardedAd = ad
          // Set paid event listener
          rewardedAd.onPaidEventListener = OnPaidEventListener { 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.
            val valueMicros = adValue.valueMicros
            val currencyCode = adValue.currencyCode
            val precision = adValue.precisionType

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

            val loadedAdapterResponseInfo = rewardedAd.responseInfo.loadedAdapterResponse
            val adSourceName = loadedAdapterResponseInfo.adSourceName
            val adSourceId = loadedAdapterResponseInfo.adSourceId
            val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
            val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
            val extras = rewardedAd.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")
          }
        }
    })
  }
}

Java

import com.google.android.gms.ads.rewarded.RewardedAd;

public class MainActivity extends Activity {
  private RewardedAd rewardedAd;
  private final String TAG = "MainActivity";

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    AdRequest adRequest = new AdRequest.Builder().build();

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, new RewardedAdLoadCallback(){
        @Override
        public void onAdLoaded(@NonNull RewardedAd ad) {
          rewardedAd = ad;
          // Set paid event listener
          rewardedAd.setOnPaidEventListener(new OnPaidEventListener() {
            @Override
            public void onPaidEvent(AdValue 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.
              long valueMicros = adValue.getValueMicros();
              String currencyCode = adValue.getCurrencyCode();
              int precision = adValue.getPrecisionType();

              // Get the ad unit ID.
              String adUnitId = rewardedAd.getAdUnitId();
              
              AdapterResponseInfo loadedAdapterResponseInfo = rewardedAd.getResponseInfo().
                  getLoadedAdapterResponseInfo();
              String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
              String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
              String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
              String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

              Bundle extras = rewardedAd.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");
            }
          });
        }
    });
  }
}

Wichtiger Hinweis: Um die Anzeigenquelle zu ermitteln, über die die Anzeige geladen wurde, empfehlen wir den Parameter getAdSourceName().

Weitere Informationen zur ausschlaggebenden Anzeigenquelle finden Sie unter Informationen zur Anzeigenantwort abrufen.

Einbindung von App Attribution Partners (AAPs)

Ausführliche Informationen zum Weiterleiten von Daten zu Werbeumsätzen an Analyseplattformen finden Sie im Leitfaden des 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 Zugriff darauf erhalten haben, und auf jeden Fall vor dem Ausliefern der Anzeige. So gehen keine Rückrufe für kostenpflichtige Ereignisse verloren.
• Senden Sie die Informationen zu Werbeeinnahmen auf Impressionsebene sofort an Ihren bevorzugten Analyseserver, wenn der Rückruf für kostenpflichtige Ereignisse aufgerufen wird. So wird verhindert, dass versehentlich Rückrufe verworfen werden, und Datenabweichungen werden vermieden.

AdValue

AdValue ist eine Klasse, die den monetären Wert darstellt, der mit einer Anzeige erzielt wurde. Dazu gehören der Währungscode und der Genauigkeitstyp des Werts, die wie unten dargestellt codiert sind.

Wichtig: getValueMicros() gibt den Wert der Anzeige in Mikroeinheiten zurück. Wenn der zurückgegebene Wert für getValueMicros() beispielsweise 5.000 ist, hat die Anzeige einen geschätzten Wert von 0,005 $.

PrecisionType	Beschreibung
UNKNOWN	Ein unbekannter Anzeigenwert. Dieser Wert wird zurückgegeben, wenn der 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 wird.

Bei der AdMob-Vermittlung versucht AdMob, einen ESTIMATED-Wert für Anzeigenquellen anzugeben, die optimiert sind.

Bei nicht optimierten Anzeigenquellen oder wenn 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 Werbeeinnahmenereignis auf Impressionsebene für eine Anzeigenquelle mit Geboten über eine Testanfrage auftritt, erhalten Sie nur die folgenden Werte:

• UNKNOWN: Gibt den Genauigkeitstyp an.

• 0: Gibt den Anzeigenwert an.

Bisher war der Genauigkeitstyp möglicherweise ein anderer Wert als UNKNOWN und der Anzeigenwert höher als 0.

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