Anzeigendaten nach Placements segmentieren

Mit der Funktion „Anzeigen-Placements“ können Sie die Berichtsdaten zur Anzeigenleistung segmentieren. Mit Placements können Sie Impressionsdaten in einem Bericht segmentieren, ohne zusätzliche Anzeigenblöcke zu benötigen. Wenn Sie die Placement-Funktion verwenden möchten, benötigen Sie eine Placement-ID. Weitere Informationen zu Placements finden Sie unter Placements.

In diesem Leitfaden wird beschrieben, wie Sie eine Placement-ID in Google Mobile Ads SDK (Legacy) festlegen und einen Bericht zur Anzeigenleistung aufrufen.

Vorbereitung

Bevor Sie fortfahren, führen Sie die folgenden Schritte aus:

  • Schließen Sie die Einrichtung von Google Mobile Ads SDK (Legacy) ab.
  • Google Mobile Ads SDK (Legacy)-Version 24.5.0 oder höher
  • Zugriff auf die Funktion „Placement-ID“ erhalten. Wenden Sie sich an Ihren Account Manager, um Zugriff anzufordern.
  • Erstellen Sie eine Placement-ID für Ihre App.

Orts-ID festlegen

Wenn Sie die Leistungsdaten Ihrer Anzeige segmentieren möchten, legen Sie eine Placement-ID auf eine der folgenden Arten fest:

  • Beim Laden der Anzeige.
  • Vor der Auslieferung der Anzeige.

Sie können die Orts-ID bei Bedarf aktualisieren. Wenn Google Mobile Ads SDK (Legacy) eine Anzeigenimpression erfasst, wird die zuletzt festgelegte Placement-ID verwendet.

Placement-ID beim Laden festlegen

In diesem Abschnitt wird beschrieben, wie Sie eine Placement-ID beim Laden festlegen. Dieser Workflow gilt für alle Anzeigenformate.

Im folgenden Beispiel wird eine Placement-ID für eine Interstitial-Anzeige beim Laden festgelegt:

Kotlin

private fun loadInterstitial(context: Context) {
  val adRequest = AdRequest.Builder().setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    context,
    "AD_UNIT_ID",
    adRequest,
    object : InterstitialAdLoadCallback() {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

Java

public void loadInterstitial(Context context) {
  AdRequest adRequest = new AdRequest.Builder().setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      context,
      "AD_UNIT_ID",
      adRequest,
      new InterstitialAdLoadCallback() {
        @Override
        public void onAdLoaded(@NonNull InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

Ersetzen Sie die folgenden Werte:

  • AD_UNIT_ID durch Ihre Anzeigenblock-ID.
  • PLACEMENT_ID durch Ihre Placement-ID.

Placement-ID zur Wiedergabezeit festlegen

In diesem Abschnitt wird beschrieben, wie Sie eine Placement-ID für alle Anzeigenformate festlegen, wenn die Anzeige präsentiert wird. Wählen Sie in den folgenden Abschnitten die gewünschten Anzeigenformate aus:

Bei Banneranzeigen legen Sie die Placement-ID fest, bevor Sie die Anzeigenansicht in der Ansichtshierarchie platzieren. Im folgenden Beispiel wird eine Placement-ID für eine Banneranzeige zur Einblendungszeit festgelegt:

Kotlin

private fun showBannerView(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

Java

public void showBannerView(AdView adView, ViewGroup parentView) {
  adView.setPlacementId(PLACEMENT_ID);
  parentView.addView(adView);
}

Vollbildanzeigen

Bei Vollbildanzeigenformaten legen Sie die Placement-ID fest, bevor eine Anzeige ausgeliefert wird. Dieser Workflow gilt für die folgenden Formate:

Im folgenden Beispiel wird die Placement-ID für eine Interstitial-Anzeige zum Zeitpunkt der Auslieferung festgelegt:

Kotlin

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}

Java

private void showInterstitial(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}

Native Anzeigen

Bei nativen Anzeigen legen Sie die Placement-ID fest, nachdem Sie eine native Anzeige geladen haben und bevor Sie die Anzeige in der Anzeigenansicht registrieren.

Im folgenden Beispiel wird eine Placement-ID für eine native Anzeige zum Zeitpunkt der Auslieferung festgelegt:

Kotlin

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.setNativeAd(nativeAd)
}

Java

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.setNativeAd(nativeAd);
}

Placement-Bericht ansehen

Nachdem Sie die Placement-ID festgelegt haben, wird in der AdMob-Benutzeroberfläche ein Bericht zur Dimension „Placement-ID“ angezeigt. Folgen Sie der Anleitung unter Placements aufrufen, um den Bericht aufzurufen.