Erweiterte native Funktionen festlegen

Plattform auswählen: Android Android iOS

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

• Das native Anzeigenformat einbinden.

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

**Wichtig**: Die Verwendung dieser API garantiert nicht, dass alle Anzeigen-Creatives die angegebene Präferenz erfüllen.

Legen Sie GADNativeAdMediaAdLoaderOptions mediaAspectRatio mit einem GADMediaAspectRatio fest.

• Wenn die Einstellung nicht festgelegt ist, kann die zurückgegebene Anzeige ein beliebiges Seitenverhältnis 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])
NativeAdOptionsSnippets.swift

Objective-C

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.

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. So können Sie die tatsächlichen Bilder nach Belieben herunterladen.

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])
NativeAdOptionsSnippets.swift

Objective-C

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

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

Einstellungen für die Bildnutzlast

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 Bildnutzlast 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])
NativeAdOptionsSnippets.swift

Objective-C

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 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 „oben rechts“ 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])
NativeAdOptionsSnippets.swift

Objective-C

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

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

Benutzerdefinierte Ansicht der Datenschutzinfos

**Warnung** : Der Zugriff auf diese Funktion ist eingeschränkt. Wenden Sie sich an Ihren Account Manager, um Zugriff anzufordern.

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 sie rendern. 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
}
NativeAdOptionsSnippets.swift

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;
}
NativeAdOptionsSnippets.m

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 dem Verhalten beim Starten mit Stummschaltung können Sie die Audioausgabe beim Starten eines Videos deaktivieren oder aktivieren.

Legen Sie GADVideoOptions startMuted mit einem BOOL Wert fest.

• Das Verhalten beim Starten mit Stummschaltung 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])
NativeAdOptionsSnippets.swift

Objective-C

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

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

Benutzerdefinierte Wiedergabesteuerelemente

**Warnung** : Der Zugriff auf diese Funktion ist eingeschränkt. Wenden Sie sich an Ihren Account Manager, um Zugriff anzufordern.

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 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 Einstellung aktiviert ist, können Sie GADVideoController play , GADVideoController pause und GADVideoController setMute verwenden, um die Videoanzeige zu steuern.

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])
NativeAdOptionsSnippets.swift

Objective-C

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 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
}
NativeAdOptionsSnippets.swift

Objective-C

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

Benutzerdefinierte Videosteuerelemente rendern

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

1. Rendern Sie die Ansicht der benutzerdefinierten Steuerelemente als untergeordnetes Element der Ansicht der nativen Anzeige. So können bei der Berechnung der Sichtbarkeit mit Open Measurement die benutzerdefinierten Steuerelemente als freundliche Behinderung berücksichtigt werden.
2. Vermeiden Sie es, ein unsichtbares Overlay über die gesamte Medienansicht zu rendern. Overlays blockieren Klicks auf die Medienansicht 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.

Hinweis: Informationen zu Anbietern von Messungen und Überprüfungen, die sich an der Entwicklung des Sichtbarkeitsstandards für Open Measurement beteiligt haben, finden Sie in der Open Measurement Working Group.