Wymagane i zalecane parametry w przypadku stron internetowych

W przypadku opartego na tagach rozwiązania Video Solutions do obsługi żądań z Ad Exchange wdrażanie bez użycia pakietu IMA SDK jest w wersji beta i może być niedostępne w Twojej sieci. Aby dowiedzieć się więcej, skontaktuj się ze swoim menedżerem konta.

Poniżej znajdziesz podzbiór parametrów adresu URL tagu reklamy VAST. Te parametry są stosowane w przypadku opartych na tagach rozwiązań do wyświetlania reklam wideo na stronach internetowych, gdy brak integracji z pakietem IMA SDK.

Przejrzyj listę parametrów wymaganych w przypadku aplikacji lub parametrów wymaganych i zalecanych w przypadku zautomatyzowanych rozwiązań do generowania przychodu.

 Przejdź do konkretnego parametru na liście

correlator description_url env gdfp_req

iu output plcmt sz

unviewed_position_start url vpmute wta

 

Parametr	Szczegóły
correlator (Korelator)	Parametr korelatora może mieć wartość zmienną, która jest używana przez różne żądania pochodzące z tego samego wyświetlenia strony. Ten parametr służy do stosowania wykluczeń konkurencji, także w środowiskach nieobsługujących plików cookie. Jeśli używasz pakietu IMA SDK, wartość korelatora jest ustawiana automatycznie. Jeśli odtwarzacz próbuje określić tę wartość, pakiet SDK zastępuje ją i ustawia własną wartość. Jeśli nie używasz pakietu IMA SDK, ustaw tę wartość na prawdziwie losową całkowitą liczbę dodatnią. Nie może ona być wykorzystywana ponownie w wielu wyświetleniach strony. Przykład zastosowania correlator=4345645667 Wymaganie Wymagany w przypadku stron internetowych i aplikacji.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
description_url (Adres URL opisu)	Parametr adresu URL opisu może mieć wartość zmienną, która powinna opisywać film odtwarzany na stronie. Zwykle jest to strona z odtwarzaczem, ale może to być też strona z tekstem opisującym film. Wartość parametru description_url musi być zakodowana w postaci adresu URL w przypadku odtwarzaczy na stronach i urządzeń CTV/OTT, a niezakodowana w przypadku odtwarzaczy w aplikacjach mobilnych. Ten parametr nie jest ustawiany automatycznie przez pakiet IMA SDK. Należy go ustawić ręcznie. Przykład zastosowania Z zakodowanym adresem URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Bez kodowania: description_url= https://www.sample.com/golf.html Wymaganie  Wymagany w przypadku stron internetowych, aplikacji i Ad Exchange.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
env (Środowisko)	Parametr środowiska może mieć wartość stałą, która wskazuje, że żądanie jest typu In-Stream lub że pochodzi tylko z odtwarzacza wideo. Możliwe wartości to instream (do używania w przypadku reklam wideo i reklam audio) lub vp (do używania tylko w przypadku reklam wideo). Przykład zastosowania Reklamy wideo lub reklamy audio: env=instream Tylko reklamy wideo: env=vp Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
gdfp_req (Wskaźnik schematu Ad Managera)	Parametr wskaźnika schematu Ad Managera może mieć wartość stałą, która wskazuje, że użytkownik używa schematu Ad Managera. Przykład zastosowania gdfp_req=1 Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
iu (Jednostka reklamowa)	Parametr jednostki reklamowej może mieć wartość zmienną, która powinna być ustawiona na obecną jednostkę reklamową w formacie: /network_id/.../ad_unit Przykład zastosowania iu=/6062/videodemo Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
output (Format wyjściowy reklamy)	Parametr formatu wyjściowego reklamy może mieć wartość stałą, która powinna być ustawiona na format wyjściowy reklamy. Parametr output=vast oznacza domyślną wersję VAST ustawioną w Twojej sieci. W wybranych tagach reklamy lub częściach witryny możesz żądać konkretnej wersji VAST lub VMAP. W przypadku VAST, jeśli Twój odtwarzacz wideo używa pakietu IMA SDK, parametr output żądania reklamy wideo zawsze będzie mieć ustawienie output=xml_vast4. Nie powoduje to żadnego zagrożenia dla niezawodności działania, ponieważ pakiet SDK jest zgodny ze wszystkimi starszymi wersjami VAST, z których mogą korzystać serwery reklamowe firm zewnętrznych. Parametr output=vmap zwraca domyślną wersję VMAP (np. VMAP 1), która jest włączona w Twojej sieci. Jeśli zwracasz VAST w ramach VMAP, możesz użyć xml_vmap1_vast3 lub xml_vmap1_vast4, aby określić wersję VAST, którą chcesz zwrócić. Przykład zastosowania Domyślne ustawienie VAST Twojej sieci: output=vast VAST 4: output=xml_vast4 Domyślne ustawienie VMAP Twojej sieci: output=vmap VMAP 1: output=xml_vmap1 VMAP 1 zwracające VAST 4: output=xml_vmap1_vast4 Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
plcmt (Miejsce docelowe)	Parametr miejsca docelowego może mieć wartość stałą, która wskazuje, czy zasoby reklamowe In-Stream są zadeklarowane jako In-Stream czy treści towarzyszące, zgodnie ze wskazówkami podanymi w specyfikacji IAB. W przypadku żądań reklam innych niż In-Stream pole jest wypełniane automatycznie na podstawie zadeklarowanego formatu zasobów reklamowych i ta wartość zastąpi wszelkie deklaracje dotyczące ich typu (In-Stream lub treści towarzyszące). Przykład zastosowania Żądanie dotyczące In-Stream: plcmt=1 Żądanie dotyczące treści towarzyszących: plcmt=2 Wymaganie   Wymagany w przypadku stron internetowych i zautomatyzowanych rozwiązań do generowania przychodu.
sz (Rozmiar)	Parametr rozmiaru może mieć wartość zmienną, która powinna być ustawiona na rozmiar głównego boksu reklamowego wideo. Możesz podać wiele rozmiarów, rozdzielając je pionowymi kreskami (|). Nie dodawaj litery „v” na końcu rozmiaru. Przykład zastosowania sz=400x300 Wymaganie  Wymagany w przypadku stron internetowych i aplikacji. Ten parametr jest opcjonalny, jeśli wymagany jest tylko parametr ad_type=audio.
unviewed_position_start (Wyświetlenia opóźnione)	Parametr wyświetleń opóźnionych może mieć wartość stałą, aby wskazywać opóźnione wyświetlenia filmu. Przykład zastosowania unviewed_position_start=1 Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
url (Adres URL)	Parametr adresu URL może mieć wartość zmienną, która powinna być ustawiona na pełny adres URL, z którego jest wysłane żądanie reklamy. Ta wartość jest potrzebna, aby pomóc kupującym zidentyfikować i zrozumieć źródło żądania. Na ile to możliwe, powinna być ona wstawiana do żądania reklamy dynamicznie. W przypadku strony jest to adres URL strony zawierającej odtwarzacz. Jeśli używasz pakietu IMA SDK, wartość adresu URL jest ustawiana automatycznie. Jeśli odtwarzacz ustawia tę wartość, pakiet IMA SDK będzie ją uwzględniać. W przypadku aplikacji (na urządzeniu mobilnym lub CTV) wartość tę należy ustawić na adres URL, który najdokładniej odpowiada zasobom reklamowym wideo lub audio generującym przychody. Na przykład gdy użytkownik ogląda w aplikacji mobilnej film, który jest też dostępny pod odpowiednikiem adresu URL na komputery*. Wartość tego parametru powinna być zakodowana. Przykład zastosowania url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * Jeśli w przypadku aplikacji nie ma możliwości ustawienia tego parametru na zmienną wartość adresu URL, zalecamy skonfigurowanie go według tego wzoru: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Wymaganie Wymagany w przypadku stron internetowych i aplikacji.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
vpmute (Wyciszone odtwarzanie wideo)	Parametr zalecany w wytycznych MRC dotyczących pomiarów wideo Parametr wyciszonego odtwarzania wideo może mieć wartość stałą, która wskazuje, czy odtwarzanie reklamy ma się rozpocząć, gdy odtwarzacz wideo jest wyciszony. Przykład zastosowania Wyciszenie: vpmute=1 Wyciszenie wyłączone: vpmute=0 Wymaganie   Wymagany w przypadku stron internetowych i zautomatyzowanych rozwiązań do generowania przychodu.
wta (Dlaczego ta reklama?)	Parametr „Dlaczego ta reklama?” może mieć wartość stałą, która wskazuje, że odtwarzacz wideo obsługuje renderowanie „Dlaczego ta reklama?”. To pytanie jest obsługiwane automatycznie, gdy korzystasz z pakietu IMA SDK. Jeśli nie używasz pakietu IMA SDK, odtwarzacze muszą mieć zaimplementowaną obsługę elementów Icon i IconClickFallbackImage zgodnie ze standardem VAST organizacji IAB. Żądania reklam audio powinny wysyłać parametr wta=1, jeśli ikona Informacja podana w odpowiedzi VAST będzie renderowana w reklamach towarzyszących lub w inny sposób przekazywana użytkownikowi. Aby kwalifikować się do ruchu zarezerwowanego i ofert reklamowych Google w Europejskim Obszarze Gospodarczym, żądania reklam muszą wysyłać parametr wta=1 wskazujący, że w reklamie wideo lub w reklamach towarzyszących renderowana jest ikona informacyjna z odpowiedzi VAST (lub że jest ona przekazywana użytkownikowi w inny sposób) w przypadku wszystkich kreacji. Przykład zastosowania Obsługuje: wta=1 Nie obsługuje: wta=0 Wymaganie Wymagany w przypadku Ad Exchange. Wymagany w przypadku ruchu z EOG w witrynie i aplikacji  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.