Żądanie reklam

new RequestRequest()

Implementuje

google.ima.AdsRequestInterface

adTagUrl,

tekst

Określa adres URL tagu reklamy wymagany przez serwer reklam. Szczegółowe informacje o tworzeniu adresu URL tagu reklamy znajdziesz w sekcji Ręczne tworzenie głównego tagu reklamy wideo.

Ten parametr jest wymagany.

adsResponse

(Dokument o wartości null, ciąg znaków lub pusty)

Określa dokument VAST 2.0, który ma być używany jako odpowiedź na żądanie reklamy zamiast wysyłać żądanie z adresu URL tagu reklamy. Może to być przydatne podczas debugowania i w innych sytuacjach, gdy odpowiedź VAST jest już dostępna.

Ten parametr jest opcjonalny.

czas trwania treści

(wartość null lub liczba)

Określa czas wyświetlania treści w sekundach. Jest ona używana w 2 przypadkach: 1) kierowanie reklam w Ad Exchange i 2) decyzja o tym, kiedy wstępnie wczytać VMAP po filmie.

Ten parametr jest opcjonalny.

słowa kluczowe w treści

(Tablica null lub niepusta wartość)

Określa słowa kluczowe opisujące zawartość, która ma być wyświetlana. Używane w żądaniach AdX.

Ten parametr jest opcjonalny.

tytułtytu

(wartość null lub ciąg)

Określa tytuł wyświetlanej treści. Używane w żądaniach AdX.

Ten parametr jest opcjonalny.

forceNonLinearFullSlot

wartość logiczna

Wymusza renderowanie nielinearnych reklam AdSense jako liniowych reklam zajmujących cały boks reklamowy. Jeśli zasada jest skonfigurowana, wideo w treści zostaje wstrzymane, a nielinearna reklama tekstowa lub graficzna jest wyświetlana jako reklama na cały boks reklamowy. Wideo w treściach zostanie wznowione, gdy reklama zostanie pominięta lub zamknięta.

wysokość LiniiReklamy

liczba

Określa wysokość obszaru prostokątnego, w którym wyświetla się reklama liniowa. Ta wartość jest jednym z kryteriów wyboru reklam. Wartość ta nie musi odpowiadać rzeczywistej wysokości reklamy.

Ten parametr jest wymagany.

LinearAdSlotWidth,

liczba

Określa szerokość obszaru prostokątnego, w którym jest wyświetlana reklama liniowa. Ta wartość jest jednym z kryteriów wyboru reklam. Wartość ta nie musi być ściśle dopasowana do rzeczywistej szerokości reklamy.

Ten parametr jest wymagany.

LiveStreamPrefetchSeconds

liczba

Określa maksymalny czas oczekiwania (w sekundach) po wywołaniu żądania ads, przed wysłaniem żądania adresu URL tagu reklamy. Można go używać do rozłożenia żądań w czasie transmisji na żywo w celu złagodzenia gwałtownych skoków liczby żądań.

Wysokość boksu nieliniowego

liczba

Określa wysokość obszaru prostokątnego, w którym wyświetla się reklama nielinearna. Ta wartość jest jednym z kryteriów wyboru reklam. Wartość ta nie musi odpowiadać rzeczywistej wysokości reklamy.

Ten parametr jest wymagany.

NiestandardowaSzerokośćSlotuReklamy

liczba

Określa szerokość obszaru prostokątnego, w którym wyświetla się reklama nielinearna. Ta wartość jest jednym z kryteriów wyboru reklam. Wartość ta nie musi być ściśle dopasowana do rzeczywistej szerokości reklamy.

Ten parametr jest wymagany.

reguły dostępu otwartego

niepusty obiekt z właściwościami ciągu znaków

Obiekt ustawień mapowania dostawców weryfikacji do OMID. Klucze muszą być wartościami w obiekcie google.ima.Omid VerificationVendor, a wartościami muszą być wartości w google.ima.OmidAccessMode.

Adresy URL skryptów weryfikacji są wewnętrznie porównywane z udostępnionymi przez dostawcę wyrażeniami regularnymi w celu rozwiązania problemu z kluczem OmidVerifyVendor. Następnie IMA szuka przy użyciu tego obiektu trybu dostępu danego dostawcy.

W przypadku adresów URL skryptów, które nie zawierają nazwy znanego dostawcy, lub jeśli w tym obiekcie nie podano podanego dostawcy OmidVerifyVendor, IMA korzysta z trybu dostępu udostępnionego przez funkcję OmidVerifyVendor. Jeśli nie zostanie podany dostawca OmidVerifyVendor.OTHER, używany będzie tryb dostępu LIMITED.

pageUrl,

(wartość null lub ciąg)

Określa pełny adres URL strony, która będzie uwzględniana w żądaniu reklamy Google na potrzeby kierowania. URL musi być prawidłowym adresem URL. Jeśli określisz tę wartość, będzie ona używana w makrze VAST [PAGEURL].

Ten parametr jest opcjonalny.

Czas oczekiwania wczytywania

liczba

Zastąpienie dla domyślnego czasu oczekiwania na wczytanie VAST w milisekundach dla pojedynczego kodu. Domyślny limit czasu wynosi 5000 ms.

Ten parametr jest opcjonalny.

Ustaw

setAdWillAutoPlay(autoPlay) zwroty są nieważne

Informuje SDK o tym, czy odtwarzacz zamierza uruchomić treść i reklamę w odpowiedzi na działanie użytkownika, czy też będzie automatycznie odtwarzany. Zmiana tego ustawienia nie ma wpływu na odtwarzanie reklamy.

Zwroty

void 

setAdWillPlayMuted

setAdWillPlayMuted(wyciszony) zwraca błędy

Informuje SDK o tym, czy odtwarzacz chce uruchomić reklamę po wyciszeniu. Zmiana tego ustawienia nie ma wpływu na odtwarzanie reklamy, ale w żądaniu reklamy zawiera odpowiedni sygnał, który pozwala kupującym ustalać stawki za wyciszone zasoby reklamowe.

Zwroty

void 

ustaw ciągłe odtwarzanie

Ustaw funkcję ciągłego odtwarzania(ciągłe odtwarzanie)

Informuje SDK o tym, czy odtwarzacz zamierza odtwarzać filmy pojedynczo, jakby był emitowany w telewizji. Zmiana tego ustawienia nie ma wpływu na odtwarzanie reklamy, ale w odpowiedzi na to żądanie wysyła odpowiedni sygnał, by umożliwić kupującym licytowanie danego typu zasobów reklamowych.

Zwroty

void