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

Zarządzanie zasobami

Ustawienia preferowanego formatu obrazu multimediów

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

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

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

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.

  • 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 steruje 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ęć

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

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ęć.