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
Steuerung des bevorzugten Seitenverhältnisses 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.
GADNativeAdMediaAdLoaderOptions *nativeOption = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOption.mediaAspectRatio = GADMediaAspectRatioAny;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
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.
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.
GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.disableImageLoading = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
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.
GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.shouldRequestMultipleImages = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
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.
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.
GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
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.
Legen Sie die GADNativeAd.adChoicesView-Property mit einem GADAdChoicesView vor dem Rendern fest. Der AdChoices-Inhalt wird dann im GADAdChoicesView gerendert.
Das folgende Beispiel zeigt, wie eine benutzerdefinierte AdChoices-Ansicht festgelegt wird. Das Datenschutzinfo-Symbol wird innerhalb von GADAdChoicesView gerendert.
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
...
GADAdChoicesView *customAdChoicesView =
[[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];
[nativeAdView addSubview:customAdChoicesView];
nativeAdView.adChoicesView = customAdChoicesView;
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd;
}
Swift
func adLoader(_ adLoader: AdLoader, didReceive nativeAd: NativeAd) {
refreshAdButton.isEnabled = true
...
// 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
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd;
}
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.
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.
GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.startMuted = NO;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
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 diese Option aktiviert ist, können Sie
GADVideoController play,GADVideoController pauseundGADVideoController setMuteverwenden, um die Videoanzeige zu 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
Das folgende Beispiel zeigt, wie Sie ein Video mit benutzerdefinierten Wiedergabesteuerelementen anfordern.
GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.customControlsRequested = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
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.
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didReceiveNativeAd:(GADNativeAd*)nativeAd {
GADVideoController *videoController = nativeAd.mediaContent.videoController;
BOOL canShowCustomControls = videoController.customControlsEnabled;
}
Swift
func adLoader(_ adLoader: AdLoader, didReceive nativeAd: NativeAd) {
let videoController = nativeAd.mediaContent.videoController
let canShowCustomControls = videoController?.customControlsEnabled() == true
}
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.
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 Wischbewegung nach rechts implementieren und das normale Tippverhalten beibehalten.
GADNativeAdCustomClickGestureOptions *swipeGestureOptions = [[GADNativeAdCustomClickGestureOptions alloc]
initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
tapsAllowed:YES];
// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ swipeGestureOptions ]];
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.
#pragma mark - GADNativeAdDelegate implementation
// Called when a swipe gesture click is recorded.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
NSLog(@"A swipe gesture click has occurred.");
}
// Called when a swipe gesture click or a tap click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
NSLog(@"A swipe gesture click or tap click has occurred.");
}
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.