Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, können Sie dem offiziellen AdMob-Discord-Kanal auf dem Server der Google Advertising and Measurement Community beitreten.

Diese Seite wurde von der Cloud Translation API übersetzt.

Optionen für native Anzeigen

Plattform auswählen:Android iOS

Native Anzeigen bieten viele erweiterte Funktionen, mit denen Sie zusätzliche Anpassungen vornehmen und die bestmögliche Nutzerfreundlichkeit erzielen können. In diesem Leitfaden erfahren Sie, wie Sie die erweiterten Funktionen von nativen Anzeigen nutzen können.

Vorbereitung

Integrieren Sie das Format für native Anzeigen.

Asset-Einstellungen

Steuerelemente für native Anzeigen-Assets konfigurieren

Einstellungen für das bevorzugte Seitenverhältnis von Medien

Mit den Einstellungen für das Media-Seitenverhältnis können Sie ein bevorzugtes Seitenverhältnis für Werbe-Creatives angeben.

Rufen Sie NativeAdOptions.Builder.setMediaAspectRatio() mit einem NativeAdOptions.MediaAspectRatio-Wert auf.

Wenn nicht festgelegt, kann die zurückgegebene Anzeige ein beliebiges Media-Seitenverhältnis haben.
Wenn Sie diese Einstellung festlegen, können Sie die Nutzerfreundlichkeit verbessern, indem Sie das bevorzugte Seitenverhältnis angeben.

Im folgenden Beispiel wird das SDK angewiesen, ein zurückgegebenes Bild oder Video mit einem bestimmten Seitenverhältnis zu bevorzugen.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Ersetzen Sie AD_UNIT_ID durch Ihre Anzeigenblock-ID.

Einstellungen für das Herunterladen von Bildern

Mit der Bild-Download-Steuerung können Sie festlegen, ob das SDK Bild-Assets oder nur URIs zurückgeben soll.

Rufen Sie NativeAdOptions.Builder.setReturnUrlsForImageAssets() mit einem boolean-Wert auf.

Die Steuerelemente für den Bilddownload sind standardmäßig deaktiviert.
Wenn diese Option deaktiviert ist, werden sowohl das Bild als auch der URI vom Google Mobile Ads SDK ausgefüllt.
Wenn diese Option aktiviert ist, wird im SDK nur der URI eingefügt. Sie können die tatsächlichen Bilder dann nach Belieben herunterladen.

Im folgenden Beispiel wird das SDK angewiesen, nur den URI zurückzugeben.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID")
        .withNativeAdOptions(nativeAdOptions)
        .forNativeAd(
            nativeAd -> {
              List<Uri> imageUris = new ArrayList<>();
              for (Image image : nativeAd.getImages()) {
                imageUris.add(image.getUri());
              }
            })
        .build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build()

val loader =
  AdLoader.Builder(context, "AD_UNIT_ID")
    .withNativeAdOptions(nativeAdOptions)
    .forNativeAd { nativeAd ->
      val imageUris = nativeAd.images.mapNotNull { it.uri }
    }
    .build()NativeAdOptionsSnippets.kt

Steuerelemente für die Bildnutzlast

Einige Anzeigen enthalten mehrere Bilder statt nur eines. Mit dieser Funktion können Sie angeben, ob Ihre App für die Anzeige aller Bilder oder nur eines Bildes vorbereitet ist.

Rufen Sie NativeAdOptions.Builder.setRequestMultipleImages() mit einem boolean-Wert auf.

Die Steuerelemente für die Bildnutzlast sind standardmäßig deaktiviert.
Wenn diese Option deaktiviert ist, weist Ihre App das SDK an, nur das erste Bild für Assets mit einer Reihe bereitzustellen.
Wenn diese Option aktiviert ist, wird in Ihrer App angegeben, dass sie bereit ist, alle Bilder für Assets mit mehr als einem Bild anzuzeigen.

Im folgenden Beispiel wird das SDK angewiesen, mehrere Bild-Assets zurückzugeben.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setRequestMultipleImages(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setRequestMultipleImages(true).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Platzierungen der Datenschutzinfos

Anzeige des Datenschutzinfo-Symbols anpassen

Einstellungen für die Position von AdChoices

Mit den Einstellungen für die Position des Datenschutzinfo-Symbols können Sie festlegen, in welcher Ecke das Symbol eingeblendet werden soll.

Rufen Sie NativeAdOptions.Builder.setAdChoicesPlacement() mit einem NativeAdOption.AdChoicesPlacement-Wert auf.

Wenn kein Wert angegeben ist, wird das Datenschutzinfo-Symbol oben rechts platziert.
Wenn diese Option festgelegt ist, wird „Ihre Anzeigenentscheidungen“ an der benutzerdefinierten Position platziert.

Im folgenden Beispiel wird gezeigt, wie Sie eine benutzerdefinierte Position für das AdChoices-Bild festlegen.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Benutzerdefinierte Ansicht für „Datenschutzinfo“

Mit der benutzerdefinierten Ansicht für das Datenschutzinfo-Symbol können Sie das Datenschutzinfo-Symbol an einer benutzerdefinierten Position platzieren. Das unterscheidet sich von den Positionssteuerungen für AdChoices, bei denen nur eine der vier Ecken angegeben werden kann.

Rufen Sie NativeAdView.setAdChoicesView() mit einem AdChoicesView-Wert auf.

Im folgenden Beispiel wird gezeigt, wie eine benutzerdefinierte AdChoices-Ansicht festgelegt wird, wobei das AdChoices-Symbol in AdChoicesView gerendert wird.

Java

NativeAdView nativeAdView = new NativeAdView(context);
AdChoicesView adChoicesView = new AdChoicesView(context);
nativeAdView.setAdChoicesView(adChoicesView);NativeAdOptionsSnippets.java

Kotlin

val nativeAdView = NativeAdView(context)
val adChoicesView = AdChoicesView(context)
nativeAdView.adChoicesView = adChoicesViewNativeAdOptionsSnippets.kt

Videosteuerelemente

Konfigurieren Sie das Verhalten von Video-Assets.

Verhalten beim Stummschalten

Mit der Funktion „Stumm starten“ können Sie die Audioausgabe eines Videos beim Start deaktivieren oder aktivieren.

Rufen Sie VideoOptions.Builder.setStartMuted() mit einem boolean-Wert auf.

Das Verhalten „Stumm starten“ ist standardmäßig aktiviert.
Wenn diese Option deaktiviert ist, fordert Ihre App an, dass das Video mit Audio beginnt.
Wenn diese Option aktiviert ist, fordert Ihre App an, dass das Video ohne Ton wiedergegeben wird.

Das folgende Beispiel zeigt, wie das Video mit nicht stummgeschaltetem Audio gestartet wird.

Java

VideoOptions videoOptions = new VideoOptions.Builder().setStartMuted(false).build();

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setVideoOptions(videoOptions).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val videoOptions = VideoOptions.Builder().setStartMuted(false).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Benutzerdefinierte Steuerelemente für die Wiedergabe

So können Sie benutzerdefinierte Steuerelemente für die Videoeingabe anfordern, um das Video abzuspielen, zu pausieren oder stummzuschalten.

Rufen Sie VideoOptions.Builder.setCustomControlsRequested() mit einem boolean-Wert auf.

Benutzerdefinierte Steuerelemente für die Wiedergabe sind standardmäßig deaktiviert.
Wenn diese Option deaktiviert ist, werden in Ihrem Video vom SDK gerenderte Eingabesteuerelemente angezeigt.

Wenn die Anzeige Videocontent enthält und benutzerdefinierte Steuerelemente aktiviert sind, sollten Sie Ihre benutzerdefinierten Steuerelemente zusammen mit der Anzeige einblenden, da die Anzeige selbst keine Steuerelemente enthält. Die Steuerelemente können dann die entsprechenden Methoden auf dem

VideoController.

Das folgende Beispiel zeigt, wie Sie ein Video mit benutzerdefinierten Wiedergabesteuerelementen anfordern.

Java

VideoOptions videoOptions = new VideoOptions.Builder().setCustomControlsRequested(true).build();

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setVideoOptions(videoOptions).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val videoOptions = VideoOptions.Builder().setCustomControlsRequested(true).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Prüfen, ob benutzerdefinierte Steuerelemente aktiviert sind

Da zum Zeitpunkt der Anfrage nicht bekannt ist, ob für die zurückgegebene Anzeige benutzerdefinierte Videosteuerelemente zulässig sind, müssen Sie prüfen, ob sie aktiviert sind.

Java

MediaContent mediaContent = nativeAd.getMediaContent();
if (mediaContent != null) {
  VideoController videoController = mediaContent.getVideoController();
  boolean canShowCustomControls = videoController.isCustomControlsEnabled();
}NativeAdOptionsSnippets.java

Kotlin

val mediaContent = nativeAd.mediaContent
if (mediaContent != null) {
  val videoController = mediaContent.videoController
  val canShowCustomControls = videoController.isCustomControlsEnabled
}NativeAdOptionsSnippets.kt

Benutzerdefinierte Videosteuerelemente rendern

So rendern Sie benutzerdefinierte Videosteuerelemente:

Rendern Sie die Ansicht der benutzerdefinierten Steuerelemente als untergeordnetes Element der Ansicht der nativen Anzeige. Bei diesem Ansatz werden die benutzerdefinierten Steuerelemente bei der Berechnung der Sichtbarkeit im Rahmen von Open Measurement als freundliche Behinderung betrachtet.
Vermeiden Sie es, ein unsichtbares Overlay über die gesamte Media-Ansicht zu rendern. Overlays blockieren Klicks auf die Media-Ansicht und beeinträchtigen so die Leistung nativer Anzeigen. Erstellen Sie stattdessen ein kleines Overlay, das gerade groß genug für die Steuerelemente ist.

Benutzerdefinierte Klickgesten

Benutzerdefinierte Klickgesten sind eine Funktion für native Anzeigen, mit der Wischbewegungen bei Anzeigenaufrufen als Anzeigenklicks registriert werden können. Sie ist für Apps konzipiert, in denen Inhalte durch Wischbewegungen aufgerufen werden. In diesem Leitfaden erfahren Sie, wie Sie benutzerdefinierte Klickgesten für Ihre nativen Anzeigen aktivieren.

Rufen Sie NativeAdOptions.Builder.enableCustomClickGestureDirection() mit einem NativeAdOptions.SwipeGestureDirection und einem boolean auf, um anzugeben, ob Taps als Klicks zugelassen werden sollen.

Im folgenden Beispiel wird eine benutzerdefinierte Wischgeste nach rechts implementiert und das normale Tabverhalten beibehalten.

Benutzerdefinierte Klickgesten sind standardmäßig deaktiviert.
Wenn diese Option deaktiviert ist, unterstützt Ihre App normales Klickverhalten.
Wenn diese Option aktiviert ist, unterstützt Ihre App benutzerdefinierte Wischgesten.

Im folgenden Beispiel wird eine benutzerdefinierte Wischgeste nach rechts implementiert und das normale Tabverhalten beibehalten.

Java

NativeAdOptions adOptions =
    new NativeAdOptions.Builder()
        .enableCustomClickGestureDirection(
            NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, /* tapsAllowed= */ true)
        .build();

// ca-app-pub-3940256099942544/2247696110 is a sample ad unit ID that has custom click
// gestures enabled.
AdLoader.Builder builder =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions);NativeAdOptionsSnippets.java

Kotlin

val adOptions =
  NativeAdOptions.Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, true)
    .build()

val builder = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions)NativeAdOptionsSnippets.kt

Auf Wischgestenereignisse warten

Wenn ein Wischklick aufgezeichnet wird, ruft das Google Mobile Ads SDK zusätzlich zur vorhandenen Methode onAdClicked() die Methode onAdSwipeGestureClicked() für AdListener auf.

Java

AdLoader adLoader =
    new AdLoader.Builder(context, AD_UNIT_ID)
        .withAdListener(
            new AdListener() {
              // Called when a swipe gesture click is recorded.
              @Override
              public void onAdSwipeGestureClicked() {
                // Called when a swipe gesture click is recorded.
                Log.d(TAG, "A swipe gesture click has occurred.");
              }

              @Override
              public void onAdClicked() {
                // Called when a swipe gesture click or a tap click is recorded, as
                // configured in NativeAdOptions.
                Log.d(TAG, "A swipe gesture click or a tap click has occurred.");
              }
            })
        .build();NativeAdOptionsSnippets.java

Kotlin

val adLoader =
  AdLoader.Builder(context, AD_UNIT_ID)
    .withAdListener(
      object : AdListener() {
        override fun onAdSwipeGestureClicked() {
          // Called when a swipe gesture click is recorded.
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        override fun onAdClicked() {
          // Called when a swipe gesture click or a tap click is recorded, as
          // configured in NativeAdOptions.
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      }
    )
    .build()NativeAdOptionsSnippets.kt

Vermittlung

Benutzerdefinierte Klickgesten funktionieren nur bei nativen Anzeigen, die mit dem Google Mobile Ads SDK gerendert werden. Anzeigenquellen, für die Drittanbieter-SDKs für das Rendering erforderlich sind, reagieren nicht auf die Einstellung für benutzerdefinierte Klickanweisungen.

Optionen für native Anzeigen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Vorbereitung

Asset-Einstellungen

Einstellungen für das bevorzugte Seitenverhältnis von Medien

Java

Kotlin

Einstellungen für das Herunterladen von Bildern

Java

Kotlin

Steuerelemente für die Bildnutzlast

Java

Kotlin

Platzierungen der Datenschutzinfos

Einstellungen für die Position von AdChoices

Java

Kotlin

Benutzerdefinierte Ansicht für „Datenschutzinfo“

Java

Kotlin

Videosteuerelemente

Verhalten beim Stummschalten

Java

Kotlin

Benutzerdefinierte Steuerelemente für die Wiedergabe

Java

Kotlin

Prüfen, ob benutzerdefinierte Steuerelemente aktiviert sind

Java

Kotlin

Benutzerdefinierte Videosteuerelemente rendern

Benutzerdefinierte Klickgesten

Java

Kotlin

Auf Wischgestenereignisse warten

Java

Kotlin

Vermittlung

Optionen für native Anzeigen