Optionen für native Anzeigen

Native Anzeigen bieten viele erweiterte Funktionen, mit denen Sie und die Nutzerfreundlichkeit von Werbeanzeigen optimieren. In diesem Leitfaden erfahren Sie, wie Sie die erweiterten Funktionen nativer Anzeigen nutzen können.

Vorbereitung

• Natives Anzeigenformat einbinden

Asset-Einstellungen

Steuerelemente für das bevorzugte Seitenverhältnis von Medien

Mit den Steuerelementen für das Medienseitenverhältnis können Sie eine Einstellung für das Seitenverhältnis von Anzeigen-Creatives.

Wichtig :Durch die Verwendung dieser API ist nicht garantiert, dass alle Anzeigen-Creatives die der angegebenen Einstellung.

Festlegen GADNativeAdMediaAdLoaderOptions mediaAspectRatio mit einem GADMediaAspectRatio.

• Wenn die Richtlinie nicht konfiguriert ist, kann die zurückgegebene Anzeige ein beliebiges Medienseitenverhältnis haben.

• Wenn dies festgelegt ist, können Sie die Nutzererfahrung verbessern, indem Sie den Parameter das bevorzugte Seitenverhältnis.

Im folgenden Beispiel wird das SDK angewiesen, ein Rückgabe-Bild oder -Video mit einem bestimmte Seitenverhältnis.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

Downloadsteuerung für Bilder

Mit der Bilddownloadsteuerung können Sie festlegen, ob vom SDK Bild-Assets oder nur URIs zurückgegeben werden.

Festlegen GADNativeAdImageAdLoaderOptions disableImageLoading mit einem BOOL-Wert.

• Die Downloadsteuerung für Bilder ist standardmäßig deaktiviert.

• Wenn diese Option deaktiviert ist, werden sowohl das Bild als auch der URI vom Google Mobile Ads SDK für Sie ausgefüllt.

• Wenn diese Option aktiviert ist, füllt das SDK stattdessen nur den URI aus. 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 ]];

Steuerelemente für Bildnutzlast

Einige Anzeigen enthalten mehrere Bilder. Mit dieser Funktion können Sie angeben, ob in Ihrer App alle Bilder oder nur ein Bild angezeigt werden kann.

Festlegen GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages mit einem BOOL-Wert.

• Die Steuerelemente für die Bildnutzlast sind standardmäßig deaktiviert.

• Wenn diese Option deaktiviert ist, weist deine App das SDK an, nur die erstes Bild für alle Assets, die eine Reihe enthalten.

• Wenn diese Option aktiviert ist, zeigt Ihre App an, dass alle Bilder angezeigt werden können für alle Assets mit mehr als einem.

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 ]];

Datenschutzinfo-Placements

Einstellungen für die Position von AdChoices

Mit den Steuerelementen für die AdChoices-Position können Sie festlegen, in welcher Ecke die Datenschutzinfo-Symbol.

Festlegen GADNativeAdViewAdOptions preferredAdChoicesPosition mit GADAdChoicesPosition Wert.

• Wenn diese Einstellung nicht festgelegt ist, wird das Datenschutzinfo-Symbol oben rechts platziert.

• Wenn diese Einstellung festgelegt ist, wird AdChoices an der benutzerdefinierten Position platziert.

Im folgenden Beispiel wird gezeigt, wie eine benutzerdefinierte Position für das AdChoices-Bild festgelegt wird.

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 „Datenschutzinfo“

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 des Datenschutzinfo-Symbols können Sie das Symbol an einer benutzerdefinierten Stelle platzieren. Dies unterscheidet sich von den Steuerelementen für die AdChoices-Position, eine der vier Ecken angeben.

Legen Sie die GADNativeAd.adChoicesView fest. Unterkunft mit GADAdChoicesView vor dem Rendern ausgeführt haben. Der Datenschutzinfo-Inhalt wird im GADAdChoicesView

Im folgenden Beispiel wird gezeigt, wie eine benutzerdefinierte AdChoices-Ansicht festgelegt wird. Die 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: GADAdLoader, didReceive nativeAd: GADNativeAd) {
    refreshAdButton.isEnabled = true

    ...
    // Define a custom position for the AdChoices icon.
    let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
    let customAdChoicesView = GADAdChoicesView(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

Ausblendungsverhalten starten

Mit dieser Funktion können Sie den Startaudio für ein Video deaktivieren oder aktivieren.

Legen Sie für GADVideoOptions startMuted einen BOOL-Wert fest.

• Die Stummschaltung ist standardmäßig aktiviert.

• Wenn diese Option deaktiviert ist, fordert Ihre App an, dass das Video mit Audio beginnen soll.

• Wenn diese Option aktiviert ist, fordert Ihre App an, dass der Ton beim Start des Videos stummgeschaltet sein soll.

Im folgenden Beispiel wird gezeigt, wie das Video mit aktiviertem Ton 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 Wiedergabesteuerung

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

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

Legen Sie für GADVideoOptions customControlsRequested einen BOOL-Wert fest.

• Benutzerdefinierte Wiedergabesteuerungen sind standardmäßig deaktiviert.

• Wenn diese Option deaktiviert ist, werden in deinem Video vom SDK gerenderte Eingabesteuerelemente angezeigt.

• Wenn die Funktion aktiviert ist, können Sie die Videoanzeige mit den Tasten GADVideoController play, GADVideoController pause und GADVideoController setMute steuern.

• Wenn die Anzeige über Video-Content verfügt und benutzerdefinierte Steuerelemente aktiviert sind, sollten Sie Dann werden Ihre benutzerdefinierten Steuerelemente zusammen mit der Anzeige eingeblendet, da keine die sich selbst steuern. Die Steuerelemente können dann die entsprechenden Methoden auf der GADVideoController aufrufen.

Im folgenden Beispiel wird gezeigt, wie du ein Video mit benutzerdefinierten Wiedergabesteuerungen anforderst.

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 die zurückgegebene Anzeige benutzerdefinierte Videosteuerelemente zulässt, müssen Sie prüfen, ob diese aktiviert sind.

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd*)nativeAd {

  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  BOOL canShowCustomControls = videoController.customControlsEnabled;

}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
        let videoController = nativeAd.mediaContent.videoController
        let canShowCustomControls = videoController?.customControlsEnabled() == true
}

Benutzerdefinierte Videosteuerelemente rendern

Berücksichtigen Sie beim Rendern von benutzerdefinierten Videosteuerelementen die folgenden Best Practices:

1. Rendern Sie die Ansicht der benutzerdefinierten Steuerelemente als untergeordnetes Element der nativen Anzeigenansicht. So werden die benutzerdefinierten Steuerelemente für offene Messungen zur Sichtbarkeit als störend empfunden.
2. Vermeiden Sie das Rendern eines unsichtbaren Overlays über der gesamten Medienansicht. Durch Overlays werden Klicks auf die Medienansicht blockiert, was sich negativ auf die Leistung der nativen Anzeigen auswirkt. Erstellen Sie stattdessen ein kleines Overlay, das gerade groß genug ist, um die Steuerelemente zu enthalten.

Hinweis :Informationen zu Anbietern von Messungen und Überprüfungen, die die Entwicklung des Open Measurement-Sichtbarkeitsstandards die Arbeitsgruppe zur offenen Messung

Benutzerdefinierte Klick-Gesten

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

Benutzerdefinierte Klickgesten sind eine Funktion für native Anzeigen, mit der Wischaktionen bei Anzeigenaufrufen als Anzeigenklicks erfasst werden können. Sie ist für Apps konzipiert, in denen Wischgesten für die Navigation durch Inhalte verwendet werden. In diesem Leitfaden erfahren Sie, wie Sie benutzerdefinierte Klicks aktivieren. Gesten für Ihre nativen Anzeigen.

Initialisieren Sie eine GADNativeAdCustomClickGestureOptions-Instanz mit der ausgewählten Wischrichtung. Außerdem müssen Sie angeben, möchten, dass Tippen als Klicks zugelassen wird.

• Benutzerdefinierte Klickgesten sind standardmäßig deaktiviert.

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

• Wenn diese Option aktiviert ist, werden Wischgesten als Klicks gezählt. Sie können ob Tippen noch als Klicks gezählt werden kann.

Das folgende Beispiel zeigt, wie Sie eine benutzerdefinierte Wischgeste für die und behält das normale Tippverhalten bei.

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 ]];

Warnung: Wenn in Ihrem Konto keine benutzerdefinierten Klickgesten aktiviert sind, wird für Anzeigenanfragen „Kein Anzeigenauftrag“ zurückgegeben.

Auf Wisch-Ereignisse warten

Wenn ein Klick mit einer Wischgeste erfasst wird, ruft das Google Mobile Ads SDK die nativeAdDidRecordSwipeGestureClick: Delegatmethode für GADNativeAdDelegate , zusätzlich zum bereits vorhandenen nativeAdDidRecordClick: delegate-Methode an.

#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 Klickbewegungen funktionieren nur bei nativen Anzeigen, die von Google Mobile Das Ads SDK wird gerendert. Anzeigenquellen, die Drittanbieter-SDKs für nicht auf die Einstellung für benutzerdefinierte Klickrouten reagieren.