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
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 zastosowaniaCiągłe odtwarzanie WŁĄCZONE: Ciągłe odtwarzanie WYŁĄCZONE: |
|
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: Żądanie reguł reklamowych (VMAP): WymaganieWymagany 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. Przykłady użyciaZezwala tylko na reklamy audio: Zezwala na reklamy wideo możliwe i niemożliwe do pominięcia: Zezwala na reklamy audio i wideo: 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: Zezwala tylko reklamy wideo niemożliwe do pominięcia: WymaganieWymagany 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
|
|
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:
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 zastosowaniaWszystkie obsługiwane rozmiary: Maksymalna szerokość to 250: Maksymalna wysokość to 60: Maksymalna szerokość to 100:
WymaganieWymagany 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 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 Przykład zastosowaniaPunkty wstawienia reklamy w 10 i 20 sekundzie: |
|
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ą ( Przykład zastosowania
Rozmiary z wielowymiarowym boksem: |
|
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 Parametr Przykład zastosowania
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: WymaganieWymagany 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
WymaganieWymagany 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 zastosowaniaZobacz 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. Opisz zawartość strony w 1–3 akapitach. Możesz na przykład dynamicznie łączyć zawartość strony Wartość parametru Ten parametr nie jest ustawiany automatycznie przez pakiet IMA SDK. Należy go ustawić ręcznie. Przykład zastosowaniaZ zakodowanym adresem URL: Bez kodowania: WymaganieWymagany w przypadku stron internetowych, aplikacji i Ad Exchange. Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu. |
|
dth
(Wskazówka dotycząca typu urządzenia) |
Parametr podpowiedzi typu urządzenia może mieć wartość stałą, która pomaga zmniejszyć liczbę błędnych klasyfikacji urządzeń, zwłaszcza w przypadku urządzeń CTV i dekoderów. Nieprawidłowa klasyfikacja urządzenia może być spowodowana niezamierzonymi błędami wydawcy lub producenta OEM urządzeń CTV. Parametr ten będzie używany w połączeniu z innymi sygnałami, aby usługa Google mogła automatycznie oznaczać przypadki, w których zasoby reklamowe na urządzeniach CTV mogą zostać zakwalifikowane w inny sposób. Przykłady użyciaProśby z:
WymaganieZalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu na urządzeniach CTV. Ten parametr jest zalecany w przypadku implementacji PAL i PAI (nieobejmujących pakietu SDK). Nie jest on wymagany w przypadku pakietów IMA SDK ani DAI SDK. |
|
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 Przykład zastosowaniaReklamy wideo lub reklamy audio: Tylko reklamy wideo: WymaganieWymagany 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 Przykład zastosowania
|
|
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
WymaganieWymagany 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 zastosowaniaRODO obowiązuje: RODO nie obowiązuje: |
|
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
|
|
givn paln
(Liczba jednorazowa wideo) |
For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value. The nonce is URL safe—you don't need to URL-encode it.
Note: If you previously provided a nonce using the legacy Usage exampleYou can read more about the value passed to this parameter in the getting started guides for PAL. |
|
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
WymaganieZalecany 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
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 Parametr Inventorypartnerdomain to specyfikacja IAB, która pomaga wydawcom wskazać domenę partnera udostępniania zasobów reklamowych na potrzeby weryfikacji 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 zastosowaniaSygnalizowanie po stronie serwera (SSB): |
|
iu
(Jednostka reklamowa) |
Parametr jednostki reklamowej może mieć wartość zmienną, która powinna być ustawiona na obecną jednostkę reklamową w formacie:
Przykład zastosowania
WymaganieWymagany 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
|
|
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.
Przykład zastosowania
|
|
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
|
|
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
|
|
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 Przykład zastosowania
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: WymaganieW 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 zastosowaniaReklama zastępcza wyłączona: |
|
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ść Przykład zastosowaniaReklamy niespersonalizowane: |
|
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 Przykład zastosowaniaJeśli używasz PAL: Jeśli nie używasz PAL: |
|
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 W przypadku VAST, jeśli Twój odtwarzacz wideo używa pakietu IMA SDK, parametr output żądania reklamy wideo zawsze będzie mieć ustawienie Parametr Przykład zastosowaniaDomyślne ustawienie VAST Twojej sieci: VAST 4: Domyślne ustawienie VMAP Twojej sieci: VMAP 1: VMAP 1 zwracające VAST 4: WymaganieWymagany 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: Żądanie dotyczące treści towarzyszących: WymaganieWymagany 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 Przykład zastosowania
|
|
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 Przykład zastosowania
|
|
blok reklamowy
(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
WymaganieWymagany, 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
WymaganieZalecany 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 zastosowaniaWyłącz personalizację reklam: |
|
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
|
|
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
WymaganieWymagany, 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ład zastosowaniaObiekt JSON: Wartość zakodowana w standardzie Base64: |
|
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ć. Przykład zastosowaniaWię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 Przykład zastosowania
|
|
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 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
WymaganieWymagany w przypadku aplikacji. Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu. |
|
rdid
(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 Prawie wszystkie automatyczne reklamy wideo wymagają tych wartości.
Przykład zastosowaniaZobacz szczegółowe przykłady identyfikatorów urządzeń możliwych do zresetowania. WymaganieWymagany 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ść Przykład zastosowania
|
|
schain
(Łańcuch dostaw) |
Parametr łańcucha dostaw może mieć wartość zmienną, która powinna być zserializowanym obiektem SupplyChain. Gdy ten parametr jest uwzględniony, Google dodaje węzeł do wszystkich otrzymanych obiektów Zapoznaj się z pełną dokumentacją IAB dotyczącą przesyłania informacji SupplyChain za pomocą tagu (a nie OpenRTB). Zobacz wymagania dotyczące poprawnego analizowaniaschain
Zgodnie z dokumentacją IAB serializacja obiektu
Kolejność serializacjiWłaściwości
Właściwości
Uwaga: zawartość atrybutu
ext zależy od giełdy. Google Ad Manager nie analizuje tej usługi.Przykłady serializacji obiektu SupplyChainPoniżej znajdziesz 2 sposoby serializacji powyższego obiektu Serializacja za pomocą przecinków w przypadku pustych pól opcjonalnych
Serializacja bez przecinków w przypadku pustych pól opcjonalnych
Dowiedz się więcej o obiekcie SupplyChain.
Przykłady użycia
Jeśli wartość parametru
WymaganieWymagane w przypadku wydawców korzystających z pośredników płatności na etapie przed wysłaniem żądania do Google Ad Managera. Dotyczy to również wydawców, którzy korzystają z serwerów reklamowych firm zewnętrznych. |
|
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
WymaganieWymagany, 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
|
|
sdmax
(Maksymalny czas trwania reklamy możliwej do pominięcia) |
Parametr żądania reklamy 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 Przykład zastosowaniaPrzy użyciu tych ustawień:
W przypadku tych kreacji:
Wyniki:
|
|
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 Przykład zastosowania
WymaganieZalecany 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
WymaganieWymagany 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 „ Przykład zastosowania
WymaganieWymagany w przypadku stron internetowych i aplikacji. Ten parametr jest opcjonalny, jeśli wymagany jest tylko parametr |
|
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
|
|
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ą Przykład zastosowaniaŻądanie ruchu kupionego: Żądanie ruchu bezpłatnego: |
|
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
WymaganieWymagany 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
* 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: WymaganieWymagany 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 zastosowaniaZwracanie reklamy linearnej: Zwracanie reklamy nielinearnej: |
|
vid_d
(Czas trwania wideo) |
Ten parametr może mieć wartość zmienną, która określa czas trwania treści w sekundach. Parametry Przykład zastosowaniaCzas trwania treści wideo wynoszący 90 tys. sekund (25 godzin): |
|
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 zastosowaniaCiągłe odtwarzanie WŁĄCZONE: Ciągłe odtwarzanie WYŁĄCZONE: |
|
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 Tego parametru nie należy ustawiać, jeśli jest nieznany. Przykład zastosowaniaAutoodtwarzanie: Po kliknięciu: WymaganieZalecany 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 zastosowaniaZwracanie VAST: Zwracanie tagów przekierowania: |
|
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 zastosowaniaWyciszenie: Wyciszenie wyłączone: WymaganieWymagany 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 zastosowaniaReklama przed filmem: Reklama w trakcie filmu: Reklama po filmie: WymaganieZalecany 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 obsługuje renderowanie oznaczeń reklam. Jeśli nie zostanie wysłany parametr Funkcja oznaczania reklam jest obsługiwana automatycznie, gdy korzystasz z pakietu IMA SDK. Jeśli nie używasz pakietu IMA SDK, odtwarzacze muszą implementować VAST Wydawcy muszą wysyłać parametr Żądania reklam audio mogą wysyłać wartość W przypadku ruchu z Europejskiego Obszaru Gospodarczego żądania z parametrem Reklamy muszą być zgodne z obowiązującymi wymaganiami prawnymi dotyczącymi reklam wyświetlanych w Europejskim Obszarze Gospodarczym. Obejmuje to mechanizm umożliwiający użytkownikom zgłaszanie treści niezgodnych z prawem. Wydawcy muszą powiadamiać Google o wszelkich zgłoszeniach treści niezgodnych z prawem, korzystając z odpowiedniego formularza. Przykład zastosowaniaObsługiwane:
Nie obsługuje: WymaganieWymagany w przypadku Ad Exchange. Wymagany w przypadku ruchu z EOG w witrynie i aplikacji Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu. |