Parametry adresu URL tagu reklamy VAST

Odtwarzacz używa adresu URL tagu reklamy VAST do pobierania reklam wideo i reklam dźwiękowych. Możesz ręcznie przygotować adres URL tagu reklamy VAST lub zmienić dotychczasowy adres, używając poniższych parametrów, a następnie przetestować go za pomocą inspektora pakietu VAST. Kontrolę i testy możesz też przeprowadzić, korzystając z tych przykładowych tagów.

Ogólne wymagania dotyczące adresów URL

• Protokół: tagi reklamy VAST obsługują adresy rozpoczynające się zarówno od „https”, jak i „http”. Linki monitorujące wyświetlenia uwzględniają bieżące ustawienie SSL i zwracają odpowiednio wersję HTTPS lub HTTP. Linki docelowe i monitorujące kliknięcia zwracają wersję HTTP, ponieważ używają przekierowań przez inną stronę.
• Domena: używanie domen dynamicznych utworzonych za pomocą makra dopasowania do wzorca lub innej metody dynamicznej jest niedozwolone i powoduje wyświetlenie komunikatu o błędzie.
• Rzeczywisty ruch: adresy URL tagów reklam na potrzeby strumieniowej transmisji wideo na żywo muszą w swoich ścieżkach zawierać parametr /live, aby umożliwiać obsługę ruchu o dużym natężeniu pochodzącego z transmisji na żywo, gdy wszystkie przerwy na reklamy są realizowane w tym samym czasie.

Przykład tagu reklamy VAST

Przykładowy URL tagu reklamy VAST z parametrami i przypisanymi wartościami wygląda tak:

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

Przejdź do konkretnego parametru na liście

aconp ad_rule ad_type addtl_consent afvsz allcues an ciu_szs correlator cmsid cust_params description_url env excl_cat gdfp_req gdpr gdpr_consent hl

iabexcl idtype ipd ipe is_lat iu lip ltd max_ad_duration min_ad_duration mridx msid nofb npa omid_p output plcmt pmad

pmnd pmxd pod pp ppt ppid ppos ppsj ptpl ptpln pubf pvid pvid_s pvtf rdid rdp scor sdk_apis

sdmax sid ssss sz tfcd trt unviewed_position_start url vad_type vconp vid vid_d vpa vpi vpmute vpos wta

Parametr	Szczegóły
aconp (Ciągłe odtwarzanie audio)	Zalecany w wytycznych MRC dotyczących pomiarów audio Parametr ciągłego odtwarzania audio może mieć wartość stałą, która wskazuje, czy odtwarzacz ma odtwarzać treści audio w sposób ciągły. Tego parametru nie należy ustawiać, jeśli jest nieznany. Przykład zastosowania Ciągłe odtwarzanie WŁĄCZONE: aconp=2 Ciągłe odtwarzanie WYŁĄCZONE: aconp=1
ad_rule (Reguła reklamowa)	Parametr reguły reklamowej może mieć wartość stałą, która wskazuje, czy zwrócić kreację VAST czy reguły reklamowe. Domyślne ustawienie reguł reklamowych zależy od ustawienia sieci Ad Managera. Możesz zastąpić ustawienia poszczególnych tagów reklam, korzystając z poniższych przykładów. Przykład zastosowania Żądanie kreacji VAST: ad_rule=0 Żądanie reguł reklamowych (VMAP): ad_rule=1 Wymaganie  Wymagany w przypadku reguł reklam wideo.
ad_type (Typ reklamy)	Parametry typu reklamy mogą mieć wartość stałą, która wskazuje typy reklam, które należy zwrócić w odpowiedzi na żądanie. Ten parametr jest wymagany tylko w przypadku reklam audio. Gdy parametr ad_type jest ustawiony na audio lub audio_video, parametr vpmute musi mieć wartość 0. Przykłady użycia Zezwala tylko na reklamy audio: ad_type=audio Zezwala na reklamy wideo możliwe i niemożliwe do pominięcia: ad_type=video Zezwala na reklamy audio i wideo: ad_type=audio_video (Ta wartość zezwala na konkurowanie obu formatów, ale wyświetlany jest tylko jeden). Typ reklamy audio_video służy tylko do wyświetlania kreacji wideo w treściach audio obsługujących odtwarzanie reklam wideo lub kreacji audio w odtwarzaczach typu In-Stream w przypadku treści, które z zasady są przeznaczone do słuchania. Przykłady to transmisje sportowe, programy informacyjne, vodcasty itp. Dowiedz się więcej o dźwięku w treściach wideo. Zezwala tylko na reklamy wideo możliwe do pominięcia: ad_type=skippablevideo Zezwala tylko reklamy wideo niemożliwe do pominięcia: ad_type=standardvideo Wymaganie Wymagany w przypadku reklam dźwiękowych.
addtl_consent (Udzielenie dodatkowej zgody)	Parametr dodatkowej zgody może mieć wartości zmienne. Jest używany przez wydawców, którzy chcą zintegrować Zasady IAB dotyczące przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 i korzystają z usług dostawców niezarejestrowanych jeszcze na globalnej liście dostawców IAB Europe, ale ujętych na liście dostawców technologii reklamowych Google. Bezpośrednie żądania VAST nie odczytują tych wartości automatycznie, ale są one akceptowane po dodaniu do tagów reklam. Więcej informacji o wartościach przekazywanych do tego parametru znajdziesz w specyfikacji technicznej trybu udzielania dodatkowej zgody. Przykład zastosowania addtl_consent=1~1.35.41.101
afvsz (Rozmiary reklam nielinearnych)	Parametr rozmiarów reklam nielinearnych może mieć wartości stałe w postaci rozdzielonej przecinkami listy rozmiarów reklam nielinearnych, które mogą się wyświetlać w boksie reklamowym wideo. Obsługiwane rozmiary: 200 x 200 250 x 250 300 x 250 336 x 280 450 x 50 468 x 60 480 x 90 729 x 90 Jeśli używasz pakietu IMA SDK, wartości w tym polu zostaną zastąpione wszystkimi obsługiwanymi rozmiarami w parametrach nonLinearAdSlotWidth i nonLinearAdSlotHeight. Ten parametr można pominąć lub pozostawić pusty, jeśli żadne rozmiary reklam nielinearnych nie są obsługiwane. Przykład zastosowania Wszystkie obsługiwane rozmiary: afvsz=200x200,250x250,300x250,336x280, 450x50,468x60,480x90,728x90 Maksymalna szerokość to 250: afvsz=200x200,250x250 Maksymalna wysokość to 60: afvsz=450x50,468x60 Maksymalna szerokość to 100: //puste; brak obsługiwanych wartości   Wymaganie Wymagany w przypadku nielinearnych reklam wideo, gdy pakiet IMA SDK nie jest używany.
allcues (Wszystkie punkty wstawienia reklamy)	Ten parametr może mieć wartości zmienne w postaci rozdzielonej przecinkami listy punktów wstawienia reklamy (w milisekundach). W przypadku każdej wartości Ad Manager zwraca przerwę na reklamę. Parametry vid_d i allcues służą do wyświetlania reklam w trakcie filmu bez przetwarzania treści. Do zwracania reklam w trakcie filmu są też wymagane reguły reklamowe. Jeśli w swoich regułach reklamowych używasz punktów wstawienia opartych na czasie (np. „Co n sekund” lub „O stałych porach”), używane są punkty wstawienia określone w regule reklamowej, a te przekazane w parametrze allcues są ignorowane. Reklamy w trakcie filmu nadal wymagają czasu trwania, więc musisz podać parametr vid_d. Przykład zastosowania Punkty wstawienia reklamy w 10 i 20 sekundzie: allcues=10000,20000
ciu_szs (Rozmiary reklam towarzyszących)	Parametr rozmiarów reklam towarzyszących może mieć wartości zmienne w postaci rozdzielonej przecinkami listy rozmiarów reklam towarzyszących. Wartości rozdzielane pionową kreską (|) wskazują wielowymiarowy boks reklamowy. Przykład zastosowania ciu_szs=728x90,300x250 Rozmiary z wielowymiarowym boksem: ciu_szs=728x90,300x200|300x250
cmsid (Identyfikator źródła treści) vid (Identyfikator filmu)	Parametry identyfikatora źródła treści i identyfikatora wideo mogą mieć wartości zmienne. Aby można było kierować reklamy na treści wideo, główny tag wideo musi obejmować oba te parametry. Parametr cmsid oznacza niepowtarzalny numer każdego źródła treści. Aby znaleźć go w usłudze Ad Manager, kliknij Wideo  Źródła treści, a potem kliknij nazwę źródła. Parametr vid jest ciągiem znaków lub numerem identyfikującym konkretny film. Jest on przypisywany przez system CMS, który hostuje Twoje treści. Aby znaleźć go w usłudze Ad Manager, kliknij Wideo  Treść, a potem wybierz konkretne treści wideo. Przykład zastosowania cmsid=[value]&vid=[value] Jeśli tworzysz tag na potrzeby dynamicznego wstawiania reklam w materiałach wideo na żądanie, użyj makr, które dynamicznie wstawiają prawidłowe parametry identyfikatora źródła treści i filmu. Na przykład: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%% Wymaganie  Wymagany w przypadku kierowania na treści wideo.
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.
cust_params (Niestandardowe parametry pary klucz-wartość)	Parametry niestandardowe mogą mieć wartości zmienne w postaci par klucz-wartość, które umożliwiają ustawianie określonych opcji kierowania, np. według danych demograficznych, konkretnych miejsc na stronie internetowej albo konkretnej strony lub stron. Przykład zastosowania Zobacz przykłady dodawania par klucz-wartość.
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.
excl_cat (Kategoria wykluczania)	Parametr kategorii wykluczania może mieć wartości zmienne i ma blokować możliwość użycia elementów zamówienia zawierających określoną etykietę wykluczenia w przypadku danego żądania reklamy. Ten parametr działa z parametrami cust_params. Przykład zastosowania &cust_params=excl_cat%3Dairline_excl_label%7C
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.
gdpr (RODO)	Parametr zgody na wykorzystanie danych (RODO) może mieć wartości stałe i jest używany przez wydawców, którzy chcą zintegrować zasady TCF organizacji IAB w wersji 2.0. Bezpośrednie żądania VAST nie odczytują tych wartości automatycznie, ale są one akceptowane po dodaniu do tagów reklam. Prawidłowe wartości tego parametru to jedynie 0 i 1, gdzie 0 oznacza, że RODO nie ma zastosowania, a 1 – że RODO obowiązuje. Jeśli RODO obowiązuje, musisz też podać prawidłowy ciąg tekstowy dotyczący przejrzystości i zgody, używając parametru gdpr_consent. Więcej informacji o wartościach przekazywanych do tego parametru znajdziesz w ogólnych wskazówkach wdrażania zasad TCF lub w sekcji na temat ciągu tekstowego dotyczącego przejrzystości i zgody na przetwarzanie danych w specyfikacji zasad TCF organizacji IAB w wersji 2.0. Przykład zastosowania RODO obowiązuje: gdpr=1 RODO nie obowiązuje: gdpr=0
gdpr_consent (Zgoda na wykorzystanie danych – RODO)	Parametr zgody na wykorzystanie danych (RODO) może mieć wartości zmienne i jest używany przez wydawców, którzy chcą zintegrować Zasady IAB dotyczące przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0. Bezpośrednie żądania VAST nie odczytują tych wartości automatycznie, ale są one akceptowane po dodaniu do tagów reklam. Więcej informacji o wartościach przekazywanych do tego parametru znajdziesz w ogólnych wskazówkach wdrażania platformy lub w sekcji na temat ciągu tekstowego dotyczącego przejrzystości i zgody na przetwarzanie danych w specyfikacji Zasad IAB w tym zakresie (w wersji 2.0). Przykład zastosowania gdpr_consent=GDPR_CONSENT_123
hl (Język)	Parametr języka może mieć wartość stałą, która służy do wysyłania żądań reklamy w danym języku oraz do wybierania języka reklam i renderowania reklam wideo w alokacji dynamicznej do Wideo Ad Exchange lub Wideo AdSense. Wartość parametru może być dowolnym kodem ISO 639-1 (dwuliterowym) lub ISO 639-2 (trzyliterowym). Zobacz listę prawidłowych kodów. Brak określenia tego parametru spowoduje, że przyjmie on domyślnie dowolny język wybrany w Ad Exchange do kierowania reklam według języka. Przykład zastosowania hl=it Wymaganie  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
iabexcl (Adres URL listy wykluczeń IAB)	Parametr adresu URL iabexcl może zawierać rozdzieloną przecinkami listę kategorii. Przykład zastosowania iabexcl=3,14,527 nie obejmuje terminów „Ciężarówki”, „Pojazdy terenowe” i „Rugby”. Dowiedz się więcej o taksonomii treści IAB.
ipd (Domena partnera udostępniającego zasoby reklamowe)	Parametr domeny partnera zasobów reklamowych może mieć wartości zmienne, które należy ustawić na deklaracje inventorypartnerdomain w pliku app-ads.txt wydawcy (lub pliku ads.txt) Parametr Inventorypartnerdomain to specyfikacja IAB, która pomaga wydawcom wskazać domenę partnera udostępniania zasobów reklamowych na potrzeby weryfikacji ads.txt/app-ads.txt,. Deklaracja IPD jest szczególnie ważna w sytuacjach, gdy zasoby reklamowe, z których pochodzi żądanie, mogą należeć do innego partnera (partnera udostępniania zasobów reklamowych). Więcej informacji znajdziesz w artykule Pliki ads.txt/app-ads.txt i partnerzy udostępniający zasoby reklamowe (beta).
ipe (Podmiot sprawdzający wyświetlenia)	Parametr podmiotu sprawdzającego wyświetlenia za pomocą polecenia ping może mieć wartość stałą, która wskazuje pingi i konwersje z wyświetleń pochodzących z serwera, a nie klienta. Przykład zastosowania Sygnalizowanie po stronie serwera (SSB): ipe=ssb
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.
lip (Ostatnia pozycja w bloku reklamowym)	Parametr ostatniej pozycji w bloku reklamowym może mieć wartość stałą, aby wskazywać żądanie wysłane z ostatniej pozycji w bloku reklamowym. Ten parametr jest stosowany tylko na potrzeby standardowych bloków reklamowych. Przykład zastosowania lip=true
ltd (Ograniczone wyświetlanie reklam)	Parametr ograniczonego wyświetlania reklam może mieć wartość stałą, która wskazuje, czy wyświetlać reklamy w ograniczonym zakresie przy braku zgody użytkowników na używanie plików cookie lub innych identyfikatorów lokalnych. W przeciwieństwie do innych parametrów adresu URL parametr ltd=1 zmienia działanie pakietu IMA SDK, tak aby traktował żądanie jako pozbawione identyfikatora i uniemożliwiał przechowywanie danych. Przykład zastosowania ltd=1
min_ad_duration (Minimalny czas trwania reklamy) max_ad_duration (Maksymalny czas trwania reklamy)	Parametry czasu trwania reklamy mogą mieć wartości zmienne, które stosowane razem określają w milisekundach czas, w którym musi zmieścić się reklama. Ten parametr pozwala ograniczyć czas trwania pojedynczej reklamy zarówno w żądaniach jednej reklamy, jak i żądaniach zoptymalizowanych bloków reklamowych. Przykład zastosowania min_ad_duration=15000&max_ad_duration=30000
mridx (Numer reklamy w trakcie filmu)	Parametr numeru reklamy w trakcie filmu może mieć wartość zmienną, która wskazuje liczbę porządkową reklamy w trakcie filmu (na przykład reklama w trakcie filmu 1, reklama w trakcie filmu 2 itd.). Przykład zastosowania mridx=2
msid (Identyfikator aplikacji) an (Nazwa aplikacji)	Parametry identyfikatora aplikacji i nazwy aplikacji mogą mieć wartości zmienne, które należy stosować w żądaniach wysyłanych z aplikacji mobilnych i urządzeń CTV, ponieważ są wymagane przez większość automatycznych reklam wideo. Pakiet IMA SDK automatycznie wypełni oba parametry, ale muszą one zostać ręcznie określone w środowiskach innych niż SDK, m.in. w bezpośrednich wywołaniach VAST, lub przy użyciu biblioteki dostępu zautomatyzowanego (PAL) lub zasobów reklamowych uwierzytelnionych przez wydawcę (PAI). Nazwa aplikacji powinna być zrozumiała dla człowieka. W przypadku iOS i tvOS pakiet SDK nie ma dostępu do identyfikatora aplikacji. W takich przypadkach parametr msid nie jest wysyłany, a SDK wysyła pakiet aplikacji za pomocą parametru an. Przykład zastosowania msid=com.package.publisher&an=sample%20app Identyfikatory aplikacji w różnych sklepach z aplikacjami mają odmienne nazwy i formaty. Zobacz wskazówki IAB na temat identyfikowania aplikacji lub przykłady typowych unikalnych identyfikatorów. W przypadku platform, które nie mają sklepu z aplikacjami, IAB zaleca wydawcom korzystanie z takiego formatu identyfikatorów: com.publisher.deviceplatform. Wymaganie W przypadku aplikacji oba parametry są wymagane.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
nofb (Reklama zastępcza wyłączona)	Parametr reklamy zastępczej wyłączonej może mieć wartość stałą, aby wskazywać, że dane żądanie reklamy nie powinno zwracać playlisty zastępczych reklam wideo. Przykład zastosowania Reklama zastępcza wyłączona: nofb=1
npa (Reklama niespersonalizowana)	Parametr reklam niespersonalizowanych może mieć wartość stałą, aby wskazywać, że żądanie reklamy powinno być traktowane jako niespersonalizowane. Aby oznaczyć żądanie jako dotyczące reklamy niespersonalizowanej, musisz konkretnie podać wartość npa=1 albo użyć samego parametru npa (bez określonej wartości). Żądania reklamy, w których brakuje tego parametru lub w których ma on wartość npa=0, odnoszą się domyślnie do reklam spersonalizowanych. Przykład zastosowania Reklamy niespersonalizowane: npa=1
omid_p (nazwa partnera OMID)	Parametr nazwy partnera OMID może mieć wartość zmienną, która wskazuje nazwę partnera przeprowadzającego pomiar OMID oraz wersję partnera. Ten parametr dotyczy tylko wydawców, którzy chcą korzystać z pomiarów w Widoku aktywnym, gdy korzystają z pakietu Open Measurement SDK (OM SDK). Nie należy go używać w przypadku korzystania z pakietu IMA SDK, ponieważ jest on ustawiany automatycznie. Aby wskazać obsługę OMID podczas korzystania z biblioteki dostępu zautomatyzowanego (Programmatic Access Library, PAL), do określenia nazwy i wersji partnera musisz użyć interfejsów API omidPartnerName i omidPartnerVersion. Jeśli nie używasz PAL ani IMA, musisz skonfigurować parametry omid_p i sdk_apis (obsługiwane interfejsy API, które mogą też uwzględniać inne interfejsy API rozdzielane przecinkami). Przykład zastosowania Jeśli używasz PAL: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Jeśli nie używasz PAL: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
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.
pmad (Limit reklam w bloku reklamowym)	Parametr limitu reklam w bloku reklamowym może mieć wartość zmienną, która wskazuje maksymalną liczbę reklam w bloku reklamowym. Ten parametr dotyczy zoptymalizowanych bloków reklamowych dostępnych dla wydawców, którzy dysponują zaawansowanym pakietem wideo. Nie należy go używać w przypadku VMAP (gdy ad_rule=1). Przykład zastosowania pmad=4
pmnd (Minimalny czas trwania bloku reklamowego) pmxd (Maksymalny czas trwania bloku reklamowego)	Parametry czasu trwania bloku reklamowego mogą mieć wartości zmienne, które stosowane razem określają w milisekundach czas, w którym musi się zmieścić blok reklamowy. Te parametry są używane do wysłania żądania wielu reklam. Dotyczą zoptymalizowanych bloków reklamowych dostępnych dla wydawców, którzy dysponują zaawansowanym pakietem wideo. Nie należy ich używać w przypadku VMAP (gdy ad_rule=1). Przykład zastosowania pmnd=0&pmxd=60000
pod (Numer bloku reklamowego)	Parametr numeru bloku reklamowego może mieć wartość zmienną, która odpowiada liczbie porządkowej bloku w filmie (na przykład blok reklamowy 1, blok reklamowy 2 itd.). Przykład zastosowania pod=3 Wymaganie  Wymagany, aby takie funkcje jak wykluczenia konkurencji, ograniczenie liczby wyświetleń i podobne działały prawidłowo.
pp (Profil kreacji)	Parametr profilu kreacji może mieć wartość zmienną decydującą o tym, które kreacje kwalifikują się do wyświetlenia na podstawie konfiguracji określonej w profilu kreacji wideo i audio. Przykład zastosowania pp=creative_profile Wymaganie  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
ppt (Publisher Privacy Treatment API)	Parametr Publisher Privacy Treatment może mieć wartość stałą, która wskazuje, czy wyłączyć personalizację reklam w przypadku żądania reklamy. Dowiedz się więcej o Publisher Privacy Treatment API. Przykład zastosowania Wyłącz personalizację reklam: ppt=1
ppid (Identyfikator podawany przez wydawcę)	Parametr identyfikatora podawanego przez wydawcę (PPID) może mieć wartość zmienną identyfikatora wykorzystywanego na potrzeby ograniczenia liczby wyświetleń, segmentacji odbiorców, kierowania, sekwencyjnej rotacji reklam i innych funkcji sterujących wyświetlaniem reklam w zależności od odbiorców na różnych urządzeniach. Przykład zastosowania ppid=12JD92JD8078S8J29SDOAKC0EF230337
ppos (Pozycja w bloku reklamowym)	Parametr pozycji w bloku reklamowym może mieć wartość zmienną, która odpowiada pozycji w bloku reklamowym (na przykład pozycja 1, pozycja 2 itd.). Ten parametr jest stosowany tylko w przypadku standardowych bloków reklamowych i jest potrzebny do autouzupełniania elementów towarzyszących. Przykład zastosowania ppos=2 Wymaganie  Wymagany, aby takie funkcje jak wykluczenia konkurencji, ograniczenie liczby wyświetleń i podobne działały prawidłowo.
ppsj (Parametr JSON w sygnałach dostarczanych przez wydawcę)	Parametr JSON w sygnałach dostarczanych przez wydawcę akceptuje zakodowany w standardzie Base64 obiekt JSON zawierający odbiorców i dane kontekstowe dostarczone przez wydawcę w celu zwiększania przychodów w ramach automatyzacji. Dowiedz się więcej o sygnałach dostarczanych przez wydawcę i obsługiwanych taksonomiach. Szczegółowe informacje o prawidłowych parach klucz-wartość JSON znajdziesz w przykładzie HTML5 IMA SDK. Przykład zastosowania Obiekt JSON: {   "PublisherProvidedTaxonomySignals": [{      "taxonomy": "IAB_AUDIENCE_1_1",      "values": ["6", "284"]   }] } Wartość zakodowana w standardzie Base64: eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ
ptpl (Identyfikator szablonu przerwy na reklamę) ptpln (Nazwa szablonu przerwy na reklamę)	Identyfikator oraz nazwa szablonu przerwy na reklamę mogą mieć wartości zmienne i wskazują, który szablon przerwy na reklamę ma być stosowany w żądaniu zoptymalizowanego bloku reklamowego. Szablony przerwy na reklamę pozwalają określić, które miejsca wyświetlania reklam lub niestandardowe miejsca wyświetlania reklam powinny być uwzględnione w przerwie na reklamę i w jakiej kolejności mają się wyświetlać. Aby poprosić o szablon przerwy na reklamę, wymagany jest tylko jeden z tych 2 parametrów (nazwa lub identyfikator). Przykład zastosowania Więcej informacji o konfigurowaniu szablonów przerw na reklamę i zgłaszaniu ich żądania znajdziesz tutaj.
pubf (Publiczne ceny minimalne w tagach Ad Exchange) pvtf (Prywatne ceny minimalne w tagach Ad Exchange)	Kod pubf jest odpowiednikiem google_ad_public_floor, a kod pvtf jest odpowiednikiem google_ad_private_floor. Służą one do dodawania cen minimalnych do tagów Ad Exchange. Przykład zastosowania pubf=123 pvtf=123
pvid (Identyfikator zestawu aplikacji) pvid_s (Zakres zestawu aplikacji)	Wartości identyfikatora zestawu aplikacji są niezbędne do generowania przychodów, gdy użytkownicy urządzeń z Androidem rezygnują z personalizacji. Parametr pvid może mieć wartość zmienną ustawioną na identyfikator zestawu aplikacji na Androida, a parametr pvid_s może mieć wartość stałą, która reprezentuje zakres identyfikatora zestawu aplikacji (scope_app lub scope_developer). Pakiet IMA/PAL SDK przekazuje to pole automatycznie, ale wydawcy, którzy nie korzystają z tego pakietu, muszą wywołać SDK zestawu aplikacji i ręcznie przekazać te parametry w żądaniu reklamy. Zapoznaj się z dokumentacją dla deweloperów aplikacji na Androida dotyczącą pobierania identyfikatora zestawu aplikacji. Przykład zastosowania pvid=[AppSetID_value] pvid_s=scope_app Wymaganie  Wymagany w przypadku aplikacji.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
rdid idtype is_lat (Możliwe do zresetowania identyfikatory urządzeń)	Identyfikatory urządzeń możliwe do zresetowania mogą mieć wartości zmienne. W przypadku aplikacji wbudowanych (nie na stronach na komputerze czy w internecie mobilnym) pakiet SDK przekazuje do żądań strumieni możliwe do zresetowania identyfikatory urządzeń na potrzeby kierowania na użytkowników, zawierające parametry rdid, idtype i is_lat. W strumieniach SSB musisz je przekazywać jako parametry jawne, tak jak w przypadku żądania reklamy po stronie klienta. Dowiedz się więcej o identyfikatorach urządzeń. Prawie wszystkie automatyczne reklamy wideo wymagają tych wartości. Wraz z udostępnieniem systemu iOS 14.5 firma Apple wycofała sygnał LAT. Zamiast tego, aby określić, czy użytkownik wyraził zgodę na śledzenie w wersjach iOS, które obsługują App Tracking Transparency, Google polega na obecności identyfikatora IDFA o wartości innej niż zero. W związku z tym wymagany jest prawidłowy ciąg UserAgent wskazujący odpowiednią wersję systemu operacyjnego. Przykład zastosowania Zobacz szczegółowe przykłady identyfikatorów urządzeń możliwych do zresetowania. Wymaganie  Wymagany w przypadku aplikacji.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
rdp (Ograniczone przetwarzanie danych)	Parametr ograniczonego przetwarzania danych może mieć wartość stałą, aby wskazywać, że żądanie reklamy powinno ograniczać przetwarzanie danych. Aby ograniczyć przetwarzanie danych, musisz konkretnie podać wartość rdp=1 albo użyć samego parametru rdp (bez określonej wartości). W przypadku żądań reklamy, w których brakuje tego parametru lub ma on wartość rdp=0, ograniczenie nie będzie działać, chyba że włączone jest ustawienie sieci Ogranicz przetwarzanie danych. Przykład zastosowania rdp=1
scor (Korelator strumienia)	Parametr korelatora strumienia może mieć wartość zmienną, która powinna być liczbą całkowitą generowaną dla każdego strumienia wideo. Liczba powinna być taka sama w obrębie strumienia i unikalna w ramach wyświetlenia strony. Parametr służy do obsługi wykluczeń konkurencji, ograniczenia liczby wyświetleń i podobnych funkcji, jeśli użytkownik ogląda wiele filmów na stronie. Przykład zastosowania scor=17 Wymaganie  Wymagany, aby takie funkcje jak wykluczenia konkurencji, ograniczenie liczby wyświetleń i podobne działały prawidłowo.
sdk_apis (Platforma interfejsu API pakietu SDK)	Parametr platformy interfejsu API pakietu SDK dopuszcza rozdzieloną przecinkami listę stałych wartości całkowitych, które wskazują wszystkie platformy API obsługiwane przez odtwarzacz. Zobacz listę możliwych wartości platformy interfejsu API. Ten parametr obsługuje interfejsy API w Bibliotece dostępu programowego (PAL) w przypadku wydawców, którzy nie korzystają z pakietu IMA SDK. Pakiet IMA SDK zastępuje wszystkie ustawione wartości wartościami obsługiwanymi przez pakiet IMA SDK. Przykład zastosowania sdk_apis=2,7,9
sdmax (Maksymalny czas trwania reklamy możliwej do pominięcia)	Parametr żądania reklamy sdmax (maks. czas trwania reklamy możliwej do pominięcia) może mieć wartość zmienną, która umożliwia wydawcom określenie maksymalnego czasu trwania reklam możliwych do pominięcia. Czas trwania jest określany w milisekundach i odpowiada górnej granicy dozwolonej dla możliwych do pominięcia kreacji wideo/audio w przypadku tego konkretnego żądania reklamy. Użyj parametru sdmax niezależnie – tylko w odniesieniu do reklam możliwych do pominięcia – lub w połączeniu z istniejącym parametrem max_ad_duration, aby określić różne maksymalne czasy trwania reklam możliwych i niemożliwych do pominięcia. Przykład zastosowania Przy użyciu tych ustawień: max_ad_duration = 15 000 (15 sekund) sdmax = 45 000 (45 sekund) W przypadku tych kreacji: Kreacja A: niemożliwa do pominięcia; 30 s Kreacja B: możliwa do pominięcia; 30 s Wyniki: Kreacja A zostanie odfiltrowana, bo jest niemożliwa do pominięcia, a jej czas trwania przekracza maksymalną wartość ustawioną dla reklam niemożliwych do pominięcia. Kreacja B nie zostanie odfiltrowana, bo chociaż jej czas trwania przekracza wartość parametru max_ad_duration, to jest ona możliwa do pominięcia, a jej czas trwania nie przekracza maksimum określonego dla reklam możliwych do pominięcia.
sid (Identyfikator sesji)	Parametr identyfikatora sesji może mieć wartość zmienną w postaci identyfikatora reklamowego zapewniającego ochronę prywatności, który służy wyłącznie do ograniczenia liczby wyświetleń. Identyfikator sesji jest obsługiwany w przypadku żądań reklam wideo typu In-Stream pochodzących z urządzeń CTV oraz zasobów reklamowych wideo typu In-Stream pochodzących z urządzeń z aplikacjami mobilnymi. Obecnie nie jest on obsługiwany w przeglądarce. Zgodnie z wytycznymi IAB dotyczącymi identyfikatorów reklamowych ten parametr musi mieć format UUID. Dowiedz się więcej o możliwych do zresetowania identyfikatorach urządzeń na potrzeby kierowania na użytkowników. Aby zrezygnować z przekazywania identyfikatora sesji, ustaw parametr sid=0. Przykład zastosowania 123e4567-e89b-12d3-a456-426614174000 Wymaganie  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
ssss (Źródło łączenia po stronie serwera)	Parametr źródła łączenia po stronie serwera może mieć wartość stałą, która powinna być ustawiona na rozpoznawaną, podaną przez Google wartość dostawcy technologii łączenia filmów. Dostawcy technologii łączenia filmów, którzy korzystają z integracji serwerów z Google, otrzymują tę wartość od Google i mogą Ci ją przekazać. Jeżeli masz pytania dotyczące wartości ustawianej w tym parametrze, skontaktuj się ze swoim opiekunem klienta w Google. Przykład zastosowania ssss=mystitcher Wymaganie  Wymagany w przypadku implementacji po stronie serwera
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.
tfcd (Tag zawartości skierowanej do dzieci)	Parametr tagu zawartości skierowanej do dzieci może mieć wartość stałą, która dodaje do żądania reklamy tagi traktowania treści jako skierowanych do dzieci. Przykład zastosowania tfcd=1
trt (Typ ruchu)	Parametr typu ruchu może mieć wartość stałą, która służy do żądania ruchu kupionego lub bezpłatnego. Jeśli w żądaniu brakuje parametru typu ruchu, pakiet IMA SDK nie uzupełni wartości domyślnej. W takich przypadkach serwer dostarcza wartość domyślną 0 (ruch nieokreślony). Przykład zastosowania Żądanie ruchu kupionego: trt=1 Żądanie ruchu bezpłatnego: trt=2
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.
vad_type (Reklama wideo)	Parametr typu reklamy wideo może mieć wartość stałą, która wskazuje, czy ma zostać zwrócona reklama linearna, czy nielinearna. Przykład zastosowania Zwracanie reklamy linearnej: vad_type=linear Zwracanie reklamy nielinearnej: vad_type=nonlinear
vid_d (Czas trwania wideo)	Ten parametr może mieć wartość zmienną, która określa czas trwania treści w sekundach. Parametry vid_d i allcues służą do wyświetlania reklam w trakcie filmu bez przetwarzania treści. Do zwracania reklam w trakcie filmu są też wymagane reguły reklamowe. Przykład zastosowania Czas trwania treści wideo wynoszący 90 tys. sekund (25 godzin): vid_d=90000
vconp (Ciągłe odtwarzanie wideo)	Zalecany w wytycznych MRC dotyczących pomiarów wideo Parametr ciągłego odtwarzania wideo może mieć wartość stałą, która wskazuje, czy odtwarzacz ma odtwarzać treści wideo w sposób ciągły, podobnie jak w przypadku transmisji telewizyjnych. Tego parametru nie należy ustawiać, jeśli jest nieznany. Przykład zastosowania Ciągłe odtwarzanie WŁĄCZONE: vconp=2 Ciągłe odtwarzanie WYŁĄCZONE: vconp=1
vpa (Automatyczne odtworzenie wideo)	Parametr zalecany w wytycznych MRC dotyczących pomiarów wideo Parametr automatycznego odtworzenia wideo może mieć wartość stałą, która wskazuje, czy treść wideo w reklamie ma być odtwarzana automatycznie, czy po kliknięciu. Możliwe wartości to click, jeśli wymagane jest działanie użytkownika, lub auto, jeśli reklama wideo ma być odtwarzana automatycznie. Tego parametru nie należy ustawiać, jeśli jest nieznany. Przykład zastosowania Autoodtwarzanie: vpa=auto Po kliknięciu: vpa=click Wymaganie  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
vpi (Wewnętrzne przekierowanie playlisty wideo)	Parametr wewnętrznego przekierowania playlisty wideo może mieć wartość stałą, która wskazuje, czy wyświetlać wbudowany VMAP (zwrócić VAST w ramach VMAP). Ten parametr pozwala skrócić czas oczekiwania i zagwarantować ograniczenie liczby wyświetleń oraz wykluczenia konkurencji w strumieniu wideo. Przykład zastosowania Zwracanie VAST: vpi=1 Zwracanie tagów przekierowania: vpi=0
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.
vpos (Pozycja wideo)	Parametr pozycji wideo może mieć wartość stałą, która wskazuje, czy żądanie reklamy jest wysyłane z reklamy przed filmem, w trakcie filmu, czy po filmie. Przykład zastosowania Reklama przed filmem: vpos=preroll Reklama w trakcie filmu: vpos=midroll Reklama po filmie: vpos=postroll Wymaganie  Zalecany w przypadku 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.