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 formatu obrazu multimediów umożliwiają określenie formatu obrazu kreacji.

Ważne: korzystanie z tego interfejsu API nie gwarantuje, że wszystkie kreacje reklamy będą zgodne z określonymi preferencjami.

Ustaw wartość GADNativeAdMediaAdLoaderOptions mediaAspectRatio za pomocą wartości GADMediaAspectRatio.

• Jeśli nie zostanie ustawiony, zwrócona reklama może mieć dowolny format obrazu.

• Po ustawieniu możesz poprawić wrażenia użytkownika, 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 ]];

Element sterujący pobieraniem obrazu

Za pomocą tej opcji możesz określić, czy pakiet SDK ma zwracać komponenty z obrazem czy tylko identyfikatory URI.

Ustaw zmienną GADNativeAdImageAdLoaderOptions disableImageLoading na wartość BOOL.

• Domyślnie kontrola pobierania obrazów jest wyłączona.

• Gdy ta opcja jest wyłączona, pakiet SDK do reklam mobilnych Google wypełnia zarówno obraz, jak i URI.

• Gdy ta opcja jest włączona, pakiet SDK wypełnia tylko URI, co umożliwia pobieranie rzeczywistych obrazów 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 zmienną GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages na wartość BOOL.

• Elementy sterujące ładunkiem obrazu są domyślnie wyłączone.

• Gdy ta opcja jest wyłączona, aplikacja instruuje pakiet SDK, aby przekazywał tylko pierwszy obraz w przypadku wszystkich komponentó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 obrazu.

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

Za pomocą ustawień pozycji ikony Informacja możesz wybrać, w którym rogu reklamy ma się ona wyświetlać.

Ustaw GADNativeAdViewAdOptions preferredAdChoicesPosition z GADAdChoicesPosition .

• Jeśli nie zostanie ustawiony, ikona AdChoices będzie wyświetlana w prawym górnym rogu.

• Jeśli jest ustawiona, usługa AdChoices jest umieszczana w niestandardowej pozycji zgodnie z żądaniem.

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 w Informacji

Ostrzeżenie: 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 ustawień pozycji w AdChoices, które umożliwiają określenie tylko jednego z 4 rogów.

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

Ten przykład pokazuje, jak ustawić niestandardowy widok AdChoices. 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

Zachowanie podczas włączania wyciszenia

Zachowanie wyciszenia na początku pozwala wyłączyć lub włączyć dźwięk początkowy filmu.

Ustaw GADVideoOptions startMuted z wartością BOOL.

• Domyślnie włączone jest wyciszenie na początku.

• Gdy ta opcja jest wyłączona, aplikacja żąda, aby film zaczynał się od dźwięku.

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

W tym przykładzie pokazujemy, 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 poprosić o niestandardowe elementy sterujące odtwarzaniem, aby odtworzyć, wstrzymać lub wyciszyć film.

Ustaw zmienną GADVideoOptions customControlsRequested na wartość BOOL.

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

• Gdy ta opcja jest wyłączona, w filmie będą widoczne elementy sterujące renderowane przez 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 włączone są elementy sterujące, wyświetlaj je razem z reklamą, ponieważ sama reklama nie będzie zawierać żadnych elementów sterujących. 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

W momencie wysłania żądania nie wiadomo, czy zwrócona reklama będzie miała włączone elementy sterujące odtwarzaniem, dlatego musisz sprawdzić, czy są one włączone.

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
}

Renderowanie niestandardowych elementów sterujących odtwarzaniem

Renderuj niestandardowe elementy sterujące filmem, korzystając z tych sprawdzonych metod:

1. Renderuj widok niestandardowych ustawień jako element podrzędny widoku reklamy natywnej. Dzięki temu obliczenia widoczności w ramach pomiarów otwartych uwzględniają niestandardowe elementy sterujące jako przyjazne przeszkody.
2. Unikaj renderowania niewidocznego nakładki na cały widok multimediów. Nakładki blokują kliknięcia w widoku multimediów, co negatywnie wpływa na skuteczność reklam natywnych. Zamiast tego utwórz małą nakładkę, która będzie wystarczająco duża, aby pomieścić elementy sterujące.

.

Uwaga: informacje o dostawcach usług pomiarowych i weryfikacji, którzy: zaangażowaliśmy się w rozwój otwartego standardu pomiaru widoczności, zobacz Grupa robocza Open Measurement.

Niestandardowe gesty kliknięć

Ostrzeżenie: 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. Jest ona przeznaczona do korzystania z aplikacji, które używają gestów przesuwania do nawigacji po treściach. Z tego przewodnika dowiesz się, jak włączyć niestandardowe gesty kliknięcia w reklamach natywnych.

Inicjowanie GADNativeAdCustomClickGestureOptions instancję z wybranym kierunkiem przesunięcia. Musisz też określić, czy dozwolone mają być kliknięcia powstałe w wyniku dotknięcia.

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

• Gdy ta opcja jest wyłączona, tylko kliknięcia będą zliczane jako 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 gesty kliknięcia niestandardowego, żądania reklamy zwrócą odpowiedź „brak dopasowania”.

Nasłuchiwanie zdarzeń związanych z gestami przesuwania

Po zarejestrowaniu kliknięcia gestem przesuwania pakiet SDK do reklam mobilnych Google wywołuje metodę 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 w Google Mobile renderuje pakiet SDK do wyświetlania reklam. Źródła reklam, które do renderowania wymagają pakietów SDK firm zewnętrznych, nie reagują na ustawienie niestandardowych kierunków kliknięć.