Optionen für native Anzeigen

Native Anzeigen bieten viele erweiterte Funktionen, mit denen Sie zusätzliche Anpassungen vornehmen und die bestmögliche Nutzererfahrung schaffen 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

In diesem Abschnitt wird beschrieben, wie Sie die Creative-Assets in Ihren nativen Anzeigen anpassen. Sie können ein bevorzugtes Seitenverhältnis für Media-Assets angeben und festlegen, wie die Bild-Assets heruntergeladen und angezeigt werden.

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.

Legen Sie GADNativeAdMediaAdLoaderOptions mediaAspectRatio mit einem GADMediaAspectRatio fest.

• 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.

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Ersetzen Sie nativeAdUnitID durch Ihre Anzeigenblock-ID.

Steuerung des Bilddownloads

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

Legen Sie GADNativeAdImageAdLoaderOptions disableImageLoading mit einem BOOL-Wert fest.

• 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.

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

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.

• 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.

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Platzierungen der Datenschutzinfos

In diesem Abschnitt wird beschrieben, wie Sie das AdChoices-Overlay positionieren. Sie haben die Möglichkeit, das Placement in einer der vier Ecken festzulegen oder es in einer benutzerdefinierten Ansicht zu rendern.

Einstellungen für die Position von AdChoices

Mit den Steuerelementen für die Position von AdChoices können Sie auswählen, in welcher Ecke das Datenschutzinfo-Symbol gerendert werden soll.

Legen Sie GADNativeAdViewAdOptions preferredAdChoicesPosition mit einem GADAdChoicesPosition-Wert fest.

• 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.

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

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 „Anzeigenauswahl“, bei denen nur eine der vier Ecken angegeben werden kann.

Legen Sie die GADNativeAd.adChoicesView-Property mit einem GADAdChoicesView fest, bevor Sie das Rendering ausführen. Der AdChoices-Inhalt wird innerhalb des GADAdChoicesView gerendert.

Das folgende Beispiel zeigt, wie eine benutzerdefinierte AdChoices-Ansicht festgelegt wird. Das Datenschutzinfo-Symbol wird im GADAdChoicesView gerendert:

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}
NativeAdOptionsSnippets.swift

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}
NativeAdOptionsSnippets.m

Videosteuerelemente

In diesem Abschnitt wird beschrieben, wie Sie die Wiedergabe von Videoanzeigen anpassen können. Sie können den anfänglichen Stummschaltungsstatus festlegen und benutzerdefinierte Wiedergabesteuerelemente implementieren.

Verhalten beim Stummschalten

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

Legen Sie GADVideoOptions startMuted mit einem BOOL-Wert fest.

• 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.

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

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.

Legen Sie GADVideoOptions customControlsRequested mit einem BOOL-Wert fest.

• 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 Funktion aktiviert ist, können Sie die Videoanzeige mit GADVideoController play, GADVideoController pause und GADVideoController setMute steuern.

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

GADVideoController.

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

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

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.

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}
NativeAdOptionsSnippets.swift

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}
NativeAdOptionsSnippets.m

Benutzerdefinierte Videosteuerelemente rendern

Beachten Sie beim Rendern benutzerdefinierter Videosteuerelemente die folgenden Best Practices:

1. 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.
2. 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 Wischgesten aufgerufen werden. In diesem Leitfaden erfahren Sie, wie Sie benutzerdefinierte Klickgesten für Ihre nativen Anzeigen aktivieren.

Initialisieren Sie eine GADNativeAdCustomClickGestureOptions-Instanz mit der ausgewählten Wischrichtung. Außerdem müssen Sie angeben, ob Tippen als Klicks gezählt werden sollen.

• Benutzerdefinierte Klickgesten sind standardmäßig deaktiviert.

• Wenn diese Option deaktiviert ist, werden nur Tippen als Klicks gezählt.

• Wenn die Option aktiviert ist, werden Wischbewegungen als Klicks gezählt. Sie können festlegen, ob Tippen weiterhin als Klicks gezählt werden soll.

Das folgende Beispiel zeigt, wie Sie eine benutzerdefinierte Wischgeste nach rechts implementieren und das normale Tippverhalten beibehalten.

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])
NativeAdOptionsSnippets.swift

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];
NativeAdOptionsSnippets.m

Auf Wischgestenereignisse warten

Wenn ein Wischklick aufgezeichnet wird, ruft das Google Mobile Ads SDK zusätzlich zur vorhandenen Delegatenmethode nativeAdDidRecordClick: die Delegatenmethode nativeAdDidRecordSwipeGestureClick: für GADNativeAdDelegate auf.

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}
NativeAdOptionsSnippets.swift

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}
NativeAdOptionsSnippets.m

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.