Erweiterte native Funktionen festlegen

Plattform auswählen: Android (Beta) Android iOS

Native Anzeigen bieten viele erweiterte Funktionen, mit denen Sie zusätzliche Anpassungen vornehmen und die bestmögliche Anzeigenleistung 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 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 diese Option nicht festgelegt ist, kann die zurückgegebene Anzeige ein beliebiges Seitenverhältnis haben.

• Wenn diese Option 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 diese Option deaktiviert ist, füllt Google Mobile Ads SDK sowohl das Bild als auch den URI für Sie aus.

• Wenn diese Option 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])
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 Bild. Mit dieser Funktion können Sie angeben, ob Ihre App alle Bilder oder nur ein einzelnes Bild anzeigen kann.

• Die Einstellungen 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 alle Assets bereitzustellen, die eine Reihe von Bildern enthalten.

• Wenn diese Option 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 diese Option nicht festgelegt ist, wird die Position des Datenschutzinfo-Symbols auf „oben rechts“ gesetzt.

• Wenn diese Option 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 das Rendering durchführen. Der Datenschutzinfo-Content 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 diese Option deaktiviert ist, fordert Ihre App an, dass das Video mit Audioausgabe gestartet wird.

• Wenn diese Option 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 diese Option deaktiviert ist, werden in Ihrem Video vom SDK gerenderte Steuerelemente für die Eingabe angezeigt.

• Wenn diese Option 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 benutzerdefinierte Steuerelementansicht als untergeordnetes Element der nativen Anzeigenansicht. Bei diesem Ansatz werden die benutzerdefinierten Steuerelemente bei der Berechnung der Sichtbarkeit durch Open Measurement als freundliche Behinderung berücksichtigt.
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 ist, um die Steuerelemente aufzunehmen.

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.