Erweiterte native Funktionen festlegen

Plattform auswählen: Android iOS Android (Legacy)

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

Vorbereitung

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 festlegen und angeben, wie Bild-Assets heruntergeladen und angezeigt werden.

Einstellungen für das bevorzugte Seitenverhältnis von Media-Assets

Mit den Einstellungen für das Seitenverhältnis von Media-Assets können Sie ein bevorzugtes Seitenverhältnis für Anzeigen-Creatives festlegen.

Legen Sie GADNativeAdMediaAdLoaderOptions mediaAspectRatio mit einem GADMediaAspectRatio fest.

  • Wenn die Einstellung nicht festgelegt ist, kann die zurückgegebene Anzeige ein beliebiges Seitenverhältnis für Media-Assets haben.

  • Wenn die Einstellung festgelegt ist, können Sie die Nutzerfreundlichkeit verbessern, indem Sie den bevorzugten Typ des Seitenverhältnisses angeben.

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

Swift

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

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

Objective-C

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

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

Ersetzen Sie nativeAdUnitID durch Ihre Anzeigenblock-ID.

Einstellungen für den Bild-Download

Mit den Einstellungen für den Bild-Download 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 Einstellungen für den Bild-Download sind standardmäßig deaktiviert.

  • Wenn die Einstellung deaktiviert ist, füllt Google Mobile Ads SDK sowohl das Bild als auch den URI für Sie aus.

  • Wenn die Einstellung aktiviert ist, füllt das SDK stattdessen nur den URI aus, sodass Sie die tatsächlichen Bilder nach Belieben herunterladen können.

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

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

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

Objective-C

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

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

Einstellungen für die Bild-Payload

Einige Anzeigen enthalten eine Reihe von Bildern und nicht nur ein einzelnes. Mit dieser Funktion können Sie angeben, ob Ihre App alle Bilder oder nur ein einzelnes anzeigen kann.

  • Die Einstellungen für die Bild-Payload sind standardmäßig deaktiviert.

  • Wenn die Einstellung deaktiviert ist, weist Ihre App das SDK an, nur das erste Bild für alle Assets bereitzustellen, die eine Reihe von Bildern enthalten.

  • Wenn die Einstellung aktiviert ist, gibt Ihre App an, dass sie alle Bilder für Assets mit mehr als einem Bild anzeigen kann.

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

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

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

Objective-C

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

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

Platzierungen der Datenschutzinfos

In diesem Abschnitt wird beschrieben, wie Sie das Datenschutzinfo-Overlay positionieren. Sie können die Platzierung in einer der vier Ecken festlegen oder es in einer benutzerdefinierten Ansicht rendern.

Einstellungen für die Position der Datenschutzinfos

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

Legen Sie GADNativeAdViewAdOptions preferredAdChoicesPosition mit einem GADAdChoicesPosition -Wert fest.

  • Wenn die Einstellung nicht festgelegt ist, wird die Position des Datenschutzinfo-Symbols auf „Rechts oben“ gesetzt.

  • Wenn die Einstellung festgelegt ist, werden die Datenschutzinfos an der benutzerdefinierten Position platziert.

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

Swift

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

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

Objective-C

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

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

Benutzerdefinierte Ansicht der Datenschutzinfos

Mit der Funktion für die benutzerdefinierte Ansicht der Datenschutzinfos können Sie das Datenschutzinfo-Symbol an einer benutzerdefinierten Position platzieren. Dies unterscheidet sich von den Einstellungen für die Position der Datenschutzinfos, bei denen nur eine der vier Ecken angegeben werden kann.

Legen Sie die GADNativeAd.adChoicesView Eigenschaft mit einem GADAdChoicesView fest, bevor Sie das Rendering durchführen. Der Inhalt der Datenschutzinfos wird dann in GADAdChoicesView gerendert.

Im folgenden Beispiel wird gezeigt, wie Sie eine benutzerdefinierte Ansicht für die Datenschutzinfos festlegen. Das Datenschutzinfo-Symbol wird in GADAdChoicesView gerendert:

Swift

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
}

Objective-C

- (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;
}

Videosteuerelemente

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

Verhalten beim Starten mit Stummschaltung

Mit der Einstellung „Mit Stummschaltung starten“ können Sie die Audioausgabe beim Starten eines Videos deaktivieren oder aktivieren.

Legen Sie GADVideoOptions startMuted mit einem BOOL Wert fest.

  • Die Einstellung „Mit Stummschaltung starten“ ist standardmäßig aktiviert.

  • Wenn die Einstellung deaktiviert ist, fordert Ihre App an, dass das Video mit Audioausgabe gestartet wird.

  • Wenn die Einstellung aktiviert ist, fordert Ihre App an, dass das Video mit stummgeschalteter Audioausgabe gestartet wird.

Im folgenden Beispiel wird gezeigt, wie das Video mit nicht stummgeschalteter Audioausgabe gestartet wird.

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

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

Objective-C

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

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

Benutzerdefinierte Wiedergabesteuerelemente

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

Legen Sie GADVideoOptions customControlsRequested mit einem BOOL Wert fest.

  • Benutzerdefinierte Wiedergabesteuerelemente sind standardmäßig deaktiviert.

  • Wenn die Einstellung deaktiviert ist, werden in Ihrem Video vom SDK gerenderte Steuerelemente für die Eingabe angezeigt.

Wenn die Anzeige Videoinhalte enthält und benutzerdefinierte Steuerelemente aktiviert sind, sollten Sie Ihre benutzerdefinierten Steuerelemente zusammen mit der Anzeige präsentieren, da die Anzeige selbst keine Steuerelemente enthält. Die Steuerelemente können dann die entsprechenden Methoden für

GADVideoControlleraufrufen.

Im folgenden Beispiel wird gezeigt, wie Sie ein Video mit benutzerdefinierten Wiedergabesteuerelementen anfordern.

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

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

Objective-C

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

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

Prüfen, ob benutzerdefinierte Steuerelemente aktiviert sind

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

Swift

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

Objective-C

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

Benutzerdefinierte Videosteuerelemente rendern

Rendern Sie benutzerdefinierte Videosteuerelemente gemäß den folgenden Best Practices:

  1. Rendern Sie die Ansicht der benutzerdefinierten Steuerelemente als untergeordnetes Element des Anzeigenaufrufs der nativen Anzeige. So können bei der Berechnung der Sichtbarkeit durch Open Measurement die benutzerdefinierten Steuerelemente als freundliche Behinderung berücksichtigt werden.
  2. Vermeiden Sie es, ein unsichtbares Overlay über die gesamte Media-Ansicht zu rendern. Overlays blockieren Klicks auf die Media-Ansicht und wirken sich negativ auf die Leistung nativer Anzeigen aus. 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 Sie Wischbewegungen in Anzeigenansichten als Anzeigenklicks registrieren können. Sie funktioniert mit Apps, die Wischbewegungen für die Inhaltsnavigation verwenden. 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 zugelassen werden soll.

  • Benutzerdefinierte Klickgesten sind standardmäßig deaktiviert.

  • Wenn die Einstellung deaktiviert ist, werden nur Tippen als Klicks gezählt.

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

Im folgenden Beispiel wird gezeigt, wie Sie eine benutzerdefinierte Wischbewegung nach rechts implementieren und das normale Tippverhalten beibehalten.

Swift

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

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

Objective-C

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

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

Auf Wischbewegungsereignisse warten

Wenn ein Klick durch eine Wischbewegung erfasst wird, ruft Google Mobile Ads SDK zusätzlich zur vorhandenen nativeAdDidRecordClick: Delegatenmethode die nativeAdDidRecordSwipeGestureClick: Delegatenmethode für GADNativeAdDelegate auf.

Swift

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

Objective-C

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

Vermittlung

Benutzerdefinierte Klickgesten funktionieren nur bei nativen Anzeigen, die vom 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 Klickrichtungen.