Opcje reklamy natywnej

Reklamy natywne mają wiele zaawansowanych funkcji, które pozwalają i zwiększaj widoczność reklam. Ten przewodnik pokazuje, jak korzystać z zaawansowanych funkcji reklam natywnych.

Wymagania wstępne

• Integracja formatu reklamy natywnej

Zarządzanie zasobami

Ustawienia preferowanego formatu obrazu multimediów

Ustawienia współczynnika proporcji multimediów umożliwiają określenie preferowanego formatu obrazu kreacji reklamowych.

Ważne: użycie tego interfejsu API nie gwarantuje, że wszystkie kreacje będą spełniać wymagania. zgodnie z określoną preferencją.

Ustaw GADNativeAdMediaAdLoaderOptions mediaAspectRatio dzięki GADMediaAspectRatio.

• Gdy zasada jest nieskonfigurowana, zwrócona reklama może mieć dowolny format obrazu.

• Po jej skonfigurowaniu możesz zwiększyć wygodę użytkowników, określając preferowany typ formatu obrazu.

W poniższym przykładzie pakiet SDK ma ustawiony preferowany obraz lub film zwrotny ze konkretnego współczynnika proporcji.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

Kontrola pobierania obrazu

Kontrola pobierania obrazów pozwala określić, czy komponenty z obrazem, czy tylko identyfikatory URI zwracane przez pakiet SDK.

Ustaw GADNativeAdImageAdLoaderOptions disableImageLoading z wartością BOOL.

• Kontrola pobierania obrazów jest domyślnie wyłączona.

• Gdy ta opcja jest wyłączona, pakiet SDK do reklam mobilnych Google zapełnia za Ciebie obraz i identyfikator URI.

• Gdy ta opcja jest włączona, pakiet SDK wypełnia tylko identyfikator URI, umożliwiając pobranie rzeczywiste obrazy według własnego uznania.

W tym przykładzie pakiet SDK zwraca tylko identyfikator URI.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

Ustawienia ładunku obrazu

Niektóre reklamy zawierają serię obrazów, a nie tylko jeden. Za pomocą tej funkcji możesz: określić, czy aplikacja jest gotowa do wyświetlenia wszystkich obrazów czy tylko jednego.

Ustaw GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages z wartością BOOL.

• Ustawienia ładunku obrazów są domyślnie wyłączone.

• Gdy ta funkcja jest wyłączona, aplikacja instruuje pakiet SDK, aby podał tylko pierwszy obraz w przypadku zasobów zawierających serię.

• Gdy ta opcja jest włączona, aplikacja wskazuje, że jest gotowa do wyświetlania wszystkich obrazów w przypadku zasobów, które mają więcej niż 1.

W tym przykładzie pakiet SDK zwraca wiele komponentów z obrazem.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

Miejsca docelowe Informacja

Kontrola pozycji reklamy

Elementy sterujące pozycją Informacja pozwalają wybrać róg, Ikona Informacja.

Ustaw GADNativeAdViewAdOptions preferredAdChoicesPosition z GADAdChoicesPosition .

• Jeśli zasada jest nieskonfigurowana, ikona Informacja znajduje się w prawym górnym rogu.

• Jeśli ją ustawisz, Informacja będzie umieszczona w żądanym miejscu na pozycji niestandardowej.

Ten przykład pokazuje, jak ustawić niestandardową pozycję obrazu w Informacjach.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

Widok niestandardowy Informacja

Uwaga: dostęp do tej funkcji jest ograniczony. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.

Funkcja widoku niestandardowego Informacja pozwala umieścić ikonę Informacja w sekcji lokalizację niestandardową. Różni się to od elementów sterujących pozycjonowaniem w usłudze Informacja, które który pozwala wskazać jeden z czterech rogów obrazu.

Ustawianie GADNativeAd.adChoicesView usługa z pakietem GADAdChoicesView przed renderowaniem, a treść Informacja będzie renderowana wewnątrz GADAdChoicesView.

Poniższy przykład pokazuje, jak skonfigurować niestandardowy widok Informacja. Ikona Informacja będzie renderowana wewnątrz elementu GADAdChoicesView.

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

Sterowanie odtwarzaniem

Działanie ignorowania

Działalność ta umożliwia włączenie lub wyłączenie dźwięku początkowego w filmie.

Ustaw GADVideoOptions startMuted z wartością BOOL.

• Na początku opcja wyciszenia jest domyślnie włączona.

• Gdy ta opcja jest wyłączona, aplikacja prosi o rozpoczęcie filmu od audio.

• Gdy ta opcja jest włączona, aplikacja prosi o wyciszenie dźwięku na początku filmu.

Ten przykład pokazuje, jak rozpocząć odtwarzanie filmu z włączonym dźwiękiem.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

Niestandardowe elementy sterujące odtwarzaniem

Uwaga: dostęp do tej funkcji jest ograniczony. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.

Dzięki temu możesz zażądać niestandardowych elementów sterujących wejściem wideo, by odtwarzać, wstrzymywać lub wyciszać film.

Ustaw GADVideoOptions customControlsRequested z wartością BOOL.

• Niestandardowe elementy sterujące odtwarzaniem są domyślnie wyłączone.

• Gdy ta opcja jest wyłączona, w filmie będą widoczne ustawienia wejścia renderowane przez pakiet SDK.

• Gdy ta opcja jest włączona, możesz używać usługi GADVideoController play , GADVideoController pause i GADVideoController setMute nad reklamą wideo.

• Jeśli reklama zawiera treści wideo i są włączone niestandardowe elementy sterujące, niestandardowe elementy sterujące zostaną wyświetlone razem z reklamą, ponieważ i kontroluje nad nimi. Elementy sterujące mogą następnie wywoływać odpowiednie metody na stronie GADVideoController

Ten przykład pokazuje, jak wysłać żądanie filmu za pomocą niestandardowych elementów sterujących odtwarzaniem.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

Sprawdź, czy są włączone niestandardowe elementy sterujące

Ponieważ na żądanie nie wiadomo, czy zwrócona reklama pozwoli niestandardowych elementów sterujących wideo, musisz sprawdzić, czy są w nim włączone niestandardowe elementy sterujące.

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
}

Niestandardowe gesty kliknięć

Uwaga: dostęp do tej funkcji jest ograniczony. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.

Niestandardowe gesty kliknięć to funkcja reklam natywnych, która umożliwia przesuwanie palcem po wyświetleniu reklamy, być rejestrowane jako kliknięcia reklam. Działa z aplikacjami, które używają przesuwania do poruszania się po treści. Z tego przewodnika dowiesz się, jak włączyć kliknięcie niestandardowe za pomocą gestów w reklamach natywnych.

Inicjowanie GADNativeAdCustomClickGestureOptions instancję z wybranym kierunkiem przesunięcia. Trzeba też określić, chcesz, aby kliknięcia były akceptowane jako kliknięcia.

• Niestandardowe gesty kliknięć są domyślnie wyłączone.

• Gdy ta opcja jest wyłączona, jako kliknięcia liczone są tylko kliknięcia.

• Po włączeniu tej opcji gesty przesuwania będą liczone jako kliknięcia. Możesz określić, czy kliknięcia są liczone jako kliknięcia.

Z przykładu poniżej dowiesz się, jak wdrożyć niestandardowy gest przesuwania w w prawo i zachowuje normalne działanie po dotknięciu.

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:@"/21775744923/example/native"
      rootViewController:self
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ swipeGestureOptions ]];

Ostrzeżenie: jeśli na Twoim koncie nie są włączone niestandardowe gesty kliknięć, żądania reklamy zwróci wartość niewypełnioną.

Nasłuchuj zdarzeń gestu przesuwania

Po zarejestrowaniu kliknięcia gestem przesuwania pakiet SDK do reklam mobilnych Google wywołuje komponent nativeAdDidRecordSwipeGestureClick: metoda przekazywania na GADNativeAdDelegate , oprócz istniejących nativeAdDidRecordClick: .

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

Mediacja

Niestandardowe gesty kliknięć działają tylko z reklamami natywnymi wyświetlanymi w Google Mobile renderuje pakiet SDK do wyświetlania reklam. Źródła reklam, które wymagają zewnętrznych pakietów SDK renderowane, nie reagują na ustawienie wskazówek dojazdu niestandardowych kliknięć.