W tym artykule znajdziesz pełną listę parametrów, których można używać w tagu reklamy VAST. Może to być przydatne, jeśli chcesz dowiedzieć się więcej o konkretnym parametrze.
Zobacz klikalny alfabetyczny indeks wszystkich parametrówNa tej stronie
- Parametry wymagane do wyświetlania reklam
- Parametry wymagane w przypadku automatyzacji
- Parametry zalecane w przypadku automatyzacji
- Inne parametry
false/true, ale w przypadku parametrów logicznych (np. vpmute, wta, ad_rule, gdpr itp.) zalecamy używanie wartości 0/1.Listy parametrów według typu implementacji
Jeśli korzystasz z konkretnej implementacji, możesz użyć list parametrów niestandardowych, które opisują sposób użycia i wymagania dotyczące tej implementacji. Używaj listy parametrów niestandardowych w tych przypadkach:
Przeglądarka Aplikacja mobilna Urządzenia CTV Dźwięk Cyfrowe reklamy zewnętrzne
Wszystkie parametry
Parametry wymagane do wyświetlania reklam
Ogólnie te parametry są wymagane do wyświetlania reklam w przypadku większości implementacji. Mogą jednak występować sytuacje, w których nie są one wymagane. Aby uzyskać jak najdokładniejsze informacje, użyj listy parametrów dla konkretnego typu implementacji.
correlator (Korelator)
Opis
Parametr korelatora (correlator) 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.
Przykłady użycia
correlator=4345645667
Wymagania i zalecenia
Ten parametr jest wymagany do implementacji wyświetlania reklam w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w reklamach audio i cyfrowych reklamach zewnętrznych.
Korzystanie z pakietu SDK
- 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.
description_url (Adres URL opisu)
Opis
Parametr adresu URL opisu (description_url) może mieć wartość zmienną, która powinna opisywać film odtwarzany na stronie.
Adres URL opisu powinien dotyczyć filmów odtwarzanych na określonej stronie aplikacji internetowej, aplikacji mobilnej lub aplikacji TV. Nie powinien być domeną najwyższego poziomu dla wszystkich filmów lub wszystkich żądań reklam. Jeśli np. masz stronę https://www.sample.com/golf.html, na której wyświetlane są filmy o golfie, ustaw ją jako wartość parametru description_url.
Przykłady użycia
Wartość parametru description_url musi być zakodowana w postaci adresu URL w przypadku stron internetowych z filmami i urządzeń CTV/OTT. Wartość parametru description_url nie może być jednak zakodowana w przypadku aplikacji mobilnych.
Z zakodowanym adresem URL:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
Bez kodowania:
description_url=
https://www.sample.com/golf.html
Wymagania i zalecenia
Ten parametr jest wymagany do implementacji wyświetlania reklam w przeglądarce i aplikacjach mobilnych. Jest on też wymagany, jeśli do alokacji dynamicznej używasz Ad Exchange lub AdSense.
Ten parametr jest zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
Korzystanie z pakietu SDK
Ten parametr nie jest ustawiany automatycznie przez pakiet IMA SDK. Należy go ustawić ręcznie.
Zapoznaj się z przewodnikiem po pakiecie IMA SDK dla swojej platformy.
env (Środowisko)
Opis
Parametr środowiska (env) 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 dźwiękowych) lub vp (do używania tylko w przypadku reklam wideo).
Przykłady użycia
Reklamy wideo lub reklamy dźwiękowe:env=instream
Tylko reklamy wideo:env=vp
Wymagania i zalecenia
Ten parametr jest wymagany do implementacji wyświetlania reklam w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w reklamach audio i cyfrowych reklamach zewnętrznych.
Ten parametr jest wymagany do tworzenia dokładnych raportów o typie żądania z podziałem według „Tagu wideo”.
gdfp_req (Wskaźnik schematu)
Opis
Parametr wskaźnika schematu Google Ad Managera (gdfp_req) może mieć wartość stałą, która wskazuje, że żądanie reklamy dotyczy zasobów reklamowych Google Ad Managera.
Przykłady użycia
gdfp_req=1
Wymagania i zalecenia
Ten parametr jest wymagany do implementacji wyświetlania reklam w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w reklamach audio i cyfrowych reklamach zewnętrznych.
iu (Jednostka reklamowa)
Opis
Parametr jednostki reklamowej (iu) może mieć wartość zmienną, która powinna być ustawiona na bieżącą jednostkę reklamową w formacie /network_code/.../ad_unit.
Przykłady użycia
iu=/6062/videodemo
Wymagania i zalecenia
Ten parametr jest wymagany do implementacji wyświetlania reklam w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w reklamach audio i cyfrowych reklamach zewnętrznych.
output (Dane wyjściowe)
Opis
Parametr formatu wyjściowego (output) może mieć wartość stałą, która powinna być ustawiona na format wyjściowy reklamy.
Przykłady użycia
Użyj domyślnej wersji VAST swojej sieci:
output=vast
Użyj VAST 4 (w przypadku poszczególnych tagów możesz ustawiać konkretne wersje):
output=xml_vast4
Użyj domyślnego ustawienia VMAP sieci:
output=vmap
Użyj VMAP 1:
output=xml_vmap1
Użyj VMAP 1, zwracającego VAST 4 (jeśli zwracasz VAST w ramach VMAP):
output=xml_vmap1_vast4
Wymagania i zalecenia
Ten parametr jest wymagany do implementacji wyświetlania reklam w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w reklamach audio i cyfrowych reklamach zewnętrznych. Jest on wymagany do wygenerowania prawidłowego formatu odpowiedzi na wyświetlanie reklam.
Korzystanie z pakietu SDK
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.
sz (Rozmiar)
Opis
Parametr rozmiaru (sz) może mieć wartość zmienną, która powinna być ustawiona na rozmiar głównego boksu reklamy wideo.
Możesz podać wiele rozmiarów, rozdzielając je pionowymi kreskami (|).
Nie dodawaj litery „v” na końcu rozmiaru.
Przykłady użycia
Pojedynczy rozmiar:sz=400x300
Wiele rozmiarów:sz=300x250|400x300
Wymagania i zalecenia
Ten parametr jest wymagany do implementacji wyświetlania reklam w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV oraz w cyfrowych reklamach zewnętrznych.
Ten parametr jest opcjonalny, jeśli wymagany jest tylko parametr ad_type=audio.
unviewed_position_start (Wyświetlenia opóźnione)
Opis
Parametr wyświetleń opóźnionych (unviewed_position_start) może mieć wartość stałą, wskazującą opóźnione wyświetlenia filmu.
Przykłady użycia
unviewed_position_start=1
Wymagania i zalecenia
Ten parametr jest wymagany do implementacji wyświetlania reklam w przeglądarkach i aplikacjach mobilnych, gdy występuje możliwość opóźnionej realizacji wyświetlenia.
vpmute (Wyciszone odtwarzanie wideo)
Opis
Parametr wyciszenia odtwarzania wideo (vpmute) może mieć wartość stałą, która wskazuje, czy odtwarzanie reklamy ma się rozpocząć, gdy odtwarzacz wideo jest wyciszony. Ten parametr nie zmienia stanu odtwarzacza wideo – odtwarzanie musi być obsługiwane bezpośrednio przez odtwarzacz.
Przykłady użycia
Odtwarzanie rozpoczyna się z wyciszonym dźwiękiem:
vpmute=1
Odtwarzanie rozpoczyna się bez wyciszenia:
vpmute=0
Wymagania i zalecenia
Ten parametr jest wymagany do zautomatyzowanego generowania przychodu w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w formatach audio i cyfrowych reklamach zewnętrznych.
Ten parametr jest też zalecany w wytycznych Media Rating Council (MRC) dotyczących pomiarów wideo.
Parametry wymagane w przypadku automatyzacji
ott_placement (miejsce docelowe OTT)
Opis
Parametr miejsca docelowego OTT (ott_placement) może mieć wartość stałą, która wskazuje żądanie określonego typu miejsca docelowego.
Definicje miejsc docelowych w przypadku przykładów poniżej:
- Wstrzymanie: format reklamy wideo typu Out-Stream, która wyświetla się w postaci nakładki na treści wideo, gdy użytkownik wstrzyma odtwarzanie.
- Ekran główny: reklama wyświetlana na ekranie głównym urządzenia CTV lub aplikacji OTT. Obejmuje to reklamy w mastheadzie, banerze i kafelku na ekranie głównym.
- Obraz w obrazie: reklama wideo typu In-Stream odtwarzana w osobnym odtwarzaczu reklam obok treści wideo. Zwykle wymaga to ściśnięcia treści wideo i wczytania drugiego odtwarzacza.
- Baner L: reklama displayowa typu In-Stream, która polega na zmniejszeniu treści wideo i umieszczeniu reklamy wokół filmu. Zwykle (ale nie zawsze) jest to pole treści reklamy w kształcie litery L.
- Nakładka: dowolny format reklamy In-Stream, który pojawia się na górze treści wideo, ale nie zajmuje całego ekranu. Może to być reklama displayowa lub wideo.
Przykłady użycia
Obsługiwane formaty i odpowiadające im wartości:
Wstrzymaj:
ott_placement=1
Ekran główny:
ott_placement=2
Obraz w obrazie:
ott_placement=3
Baner L:
ott_placement=4
Nakładka:
ott_placement=5
Niestandardowa/inna:
ott_placement=99
Wymagania i zalecenia
Ten parametr jest wymagany tylko w przypadku zautomatyzowanych rozwiązań do generowania przychodu w przeglądarkach, aplikacjach mobilnych i na urządzeniach CTV, gdy wydawcy generują przychody z niestandardowych miejsc docelowych w środowiskach strumieniowego przesyłania danych OTT.
plcmt (Miejsce docelowe)
Opis
Parametr miejsca docelowego (plcmt) 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 dla kupujących 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łady użycia
Żądanie dotyczące In-Stream:
plcmt=1
Żądanie dotyczące treści towarzyszących:
plcmt=2
Wymagania i zalecenia
Ten parametr jest wymagany do zautomatyzowanego generowania przychodu w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w przypadku reklam audio i cyfrowych reklam zewnętrznych.
url (URL)
Opis
Parametr adresu URL (url) może mieć wartość zmienną, która powinna być ustawiona na pełny URL, z którego jest wysyłane żądanie. 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 internecie jest to URL strony zawierającej odtwarzacz.
- W środowiskach innych niż internet wartość tę należy ustawić na URL, który najdokładniej odpowiada zasobom reklamowym wideo lub audio generującym przychody. Przykładem jest sytuacja, gdy użytkownik ogląda w aplikacji mobilnej film, który jest też dostępny pod odpowiednikiem adresu URL na komputery*.
Uwaga: parametr url różni się od parametru description_url tym, że url odnosi się do lokalizacji, z której wysłano żądanie reklamy, a description_url to możliwa do zindeksowania strona internetowa, która opisuje treść filmu.
Wartość tego parametru powinna być zakodowana.
Przykłady użycia
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* Jeśli w przypadku aplikacji nie ma możliwości ustawienia tego parametru na zmienną wartość URL, zalecamy użycie tego wzoru: url=https%3A%2F%2F<app/bundleid>.example.com
Wymagania i zalecenia
Ten parametr jest wymagany do zautomatyzowanego generowania przychodu tylko w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w formatach audio i cyfrowych reklamach zewnętrznych.
Korzystanie z pakietu SDK
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ć.
venuetype (Typ miejsca)
Opis
Parametr typu miejsca (venuetype) służy do wskazywania typu miejsca zewnętrznego. Kwalifikujące się wartości to ujęte w taksonomii IAB OpenOOH typu miejsca 1.1 identyfikatory numeryczne (liczby całkowite).
Przykłady użycia
Pokoje hotelowe:
venuetype=80703
Tablet na tylnym siedzeniu taksówki:
venuetype=103
Wymagania i zalecenia
Ten parametr jest wymagany do zautomatyzowanego generowania przychodu w cyfrowych reklamach zewnętrznych.
vpa (Automatyczne odtwarzanie wideo)
Opis
Parametr automatycznego odtworzenia wideo (vpa) 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 film ma być odtwarzany automatycznie. Ten parametr nie zmienia stanu odtwarzacza wideo – odtwarzanie musi być obsługiwane bezpośrednio przez odtwarzacz.
Przykłady użycia
Autoodtwarzanie:
vpa=auto
Po kliknięciu:
vpa=click
Tego parametru nie należy ustawiać, jeśli jest nieznany.
Wymagania i zalecenia
Ten parametr jest wymagany do zautomatyzowanego generowania przychodu w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV i w formatach audio.
Ten parametr jest też zalecany w wytycznych Media Rating Council (MRC) dotyczących pomiarów wideo.
Parametry zalecane w przypadku automatyzacji
aconp (Ciągłe odtwarzanie dźwięku)
Opis
Parametr ciągłego odtwarzania audio (aconp) może mieć wartość stałą, która wskazuje, czy odtwarzacz ma odtwarzać treści audio w sposób ciągły. Dzięki temu Google Ad Manager może wybrać reklamy, które najlepiej pasują do wrażeń użytkowników.
Przykłady użycia
Ciągłe odtwarzanie włączone:
aconp=2
Ciągłe odtwarzanie wyłączone:
aconp=1
Jeśli nie wiesz, czy dźwięk ma być odtwarzany w sposób ciągły, nie ustawiaj tego parametru lub ustaw go na aconp=0.
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zarabiania z automatyzacji w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w przypadku reklam audio i cyfrowych reklam zewnętrznych.
Ten parametr jest też zalecany w wytycznych Media Rating Council (MRC) dotyczących pomiarów audio.
an (Nazwa aplikacji)
Opis
Parametr identyfikatora aplikacji (msid) i parametr nazwy aplikacji (an) 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ść zautomatyzowanych reklam wideo.
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łady użycia
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.
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zautomatyzowanego generowania przychodów w aplikacjach mobilnych, na urządzeniach CTV, w reklamach audio i cyfrowych reklamach zewnętrznych.
Aby zapewnić bezpieczeństwo marki i przejrzystość dla kupujących, zdecydowanie zalecamy podanie informacji o aplikacji.
Korzystanie z pakietu SDK
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).
Uwaga: jeśli używasz pakietu IMA SDK dla HTML5, informacje o aplikacji nie są używane.
dth (Wskazówka dotycząca typu urządzenia)
Opis
Parametr podpowiedzi typu urządzenia (dth) 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życia
Prośby z:
- Telefonu z podstawową przeglądarką:
dth=1 - Smartfona:
dth=2 - Komputera:
dth=3 - Tabletu:
dth=4 - Urządzenia CTV:
dth=5 - Konsoli do gier:
dth=6 - Dekodera:
dth=7
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zarabiania z automatyzacji w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w przypadku reklam audio i cyfrowych reklam zewnętrznych.
Korzystanie z pakietu SDK
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.
givn (Liczba jednorazowa filmu)
Opis
W przypadku integracji korzystających z biblioteki dostępu zautomatyzowanego (PAL) parametr liczby jednorazowej wideo może przyjmować zmienną wartość ciągu znaków.
Liczba jednorazowa jest bezpieczna w adresach URL, więc nie trzeba jej kodować w adresie URL.
Uwaga: jeśli wcześniej przesłano liczbę jednorazową za pomocą przestarzałego parametru paln, zdecydowanie zalecamy przejście na parametr givn i zaprzestanie wysyłania parametru paln. Nie podawaj obu parametrów.
Przykłady użycia
Więcej informacji o wartości przekazywanej do tego parametru znajdziesz w instrukcjach wprowadzających do PAL.
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zarabiania z automatyzacji w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w przypadku reklam audio i cyfrowych reklam zewnętrznych.
hl (Język)
Opis
Parametr języka (hl) 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.
Przykłady użycia
Wyślij żądanie reklam w języku włoskim:
hl=it
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.
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zarabiania z automatyzacji w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w przypadku reklam audio i cyfrowych reklam zewnętrznych.
msid (Identyfikator aplikacji)
Opis
Parametr identyfikatora aplikacji (msid) i parametr nazwy aplikacji (an) 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ść zautomatyzowanych reklam wideo.
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łady użycia
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.
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zautomatyzowanego generowania przychodów w aplikacjach mobilnych, na urządzeniach CTV, w reklamach audio i cyfrowych reklamach zewnętrznych.
Aby zapewnić bezpieczeństwo marki i przejrzystość dla kupujących, zdecydowanie zalecamy podanie informacji o aplikacji.
Korzystanie z pakietu SDK
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).
Uwaga: jeśli używasz pakietu IMA SDK dla HTML5, informacje o aplikacji nie są używane.
omid_p (Nazwa partnera OMID)
Opis
Parametr nazwy partnera OMID (omid_p) może mieć wartość zmienną, która wskazuje nazwę partnera przeprowadzającego pomiar OMID oraz wersję partnera.
Parametr obsługiwane interfejsy API pakietu SDK (sdk_apis) może mieć wartości zmienne, które mogą być pojedynczym interfejsem API lub rozdzieloną przecinkami listą obsługiwanych interfejsów API.
Te parametry są częścią zbioru parametrów służących do pomiaru widoczności i weryfikacji reklam.
Przykłady użycia
Jeśli nie używasz PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Zobacz listę możliwych wartości platformy interfejsu API.
Jeśli używasz PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zarabiania z automatyzacji w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w przypadku reklam audio i cyfrowych reklam zewnętrznych.
Korzystanie z pakietu SDK
- Ten parametr dotyczy tylko wydawców, którzy chcą korzystać z pomiaru Widoku aktywnego przy użyciu pakietu SDK Open Measurement (OM SDK).
- 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
omidPartnerNameiomidPartnerVersion. Jeśli nie używasz interfejsów PAL ani IMA SDK, musisz ustawić parametryomid_pisdk_apis. - Nie należy go używać, gdy korzystasz z pakietu IMA SDK, ponieważ jest on ustawiany automatycznie.
rdid (Możliwy do zresetowania identyfikator urządzenia)
Opis
Parametry możliwego do zresetowania identyfikatora urządzenia (rdid, idtype, is_lat) mogą mieć wartości zmienne. Ta wartość jest też określana jako identyfikator reklamy (IFA).
W przypadku aplikacji mobilnych korzystających z pakietu IMA SDK na Androida lub iOS pakiet IMA 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.
Jeśli nie używasz pakietu IMA SDK lub używasz sygnalizowania po stronie serwera (SSB), musisz przekazywać te dane jako parametry jawne. 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ł |
Przykłady użycia
Zobacz szczegółowe przykłady możliwych do zresetowania identyfikatorów urządzeń.
Wymagania i zalecenia
Chociaż te parametry nie są wymagane do wyświetlania reklam w konkretnej implementacji, są niezbędne do automatycznego zarabiania w aplikacjach mobilnych, na urządzeniach CTV, w formatach audio i cyfrowych reklamach zewnętrznych.
W przypadku implementacji internetowych nie są używane możliwe do zresetowania identyfikatory urządzeń.
Korzystanie z pakietu SDK
Pakiet IMA SDK przekazuje to pole automatycznie, ale wydawcy, którzy korzystają z pakietu PAL SDK, muszą przekazywać te parametry ręcznie.
sid (Identyfikator sesji)
Opis
Parametr identyfikatora sesji (sid) może mieć wartość zmienną w postaci identyfikatora wyświetlania reklam zapewniającego ochronę prywatności, który służy wyłącznie do ograniczania liczby wyświetleń.
Identyfikator sesji jest obsługiwany w przypadku żądań reklam 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.
Aby zrezygnować z przekazywania identyfikatora sesji, ustaw parametr sid=0.
Przykłady użycia
sid=123e4567-e89b-12d3-a456-426614174000
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.
Wymagania i zalecenia
Parametr ten nie jest wymagany do wyświetlania reklam w konkretnej implementacji, ale jest niezbędny do zautomatyzowanego generowania przychodu w cyfrowych reklamach zewnętrznych.
Ten parametr jest zalecany do zautomatyzowanego generowania przychodu w aplikacjach mobilnych, na urządzeniach CTV i w formatach audio.
Korzystanie z pakietu SDK
Ten parametr jest wysyłany automatycznie przez pakiet IMA SDK.
vconp (Ciągłe odtwarzanie wideo)
Opis
Parametr ciągłego odtwarzania wideo (vconp) może mieć wartość stałą, która wskazuje, czy odtwarzacz ma odtwarzać treści wideo w sposób ciągły, jak transmisję telewizyjną.
Przykłady użycia
Ciągłe odtwarzanie WŁĄCZONE:
vconp=2
Ciągłe odtwarzanie WYŁĄCZONE:
vconp=1
Tego parametru nie należy ustawiać, jeśli jest nieznany.
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zautomatyzowanego generowania przychodu w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV i w formatach audio.
Ten parametr jest też zalecany w wytycznych Media Rating Council (MRC) dotyczących pomiarów wideo.
vid_d (Czas trwania filmu)
Opis
Parametr czasu trwania filmu (vid_d) może mieć wartość zmienną, która określa czas trwania treści w sekundach.
- Parametry
vid_diallcuessłużą do wyświetlania reklam w trakcie filmu bez przetwarzania treści. - Do zwracania reklam w trakcie filmu wymagane jest stosowanie reguł reklamowych. 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
allcuessą ignorowane. Reklamy w trakcie filmu nadal wymagają czasu trwania, więc musisz podać parametrvid_d.
Przykłady użycia
Czas trwania treści wideo wynoszący 90 tys. sekund (25 godzin):vid_d=90000
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zautomatyzowanych rozwiązań do generowania przychodu w przeglądarkach, aplikacjach mobilnych i na urządzeniach CTV.
vpos (Pozycja wideo)
Opis
Parametr pozycji wideo (vpos) 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łady użycia
Reklama przed filmem:
vpos=preroll
Reklama w trakcie filmu:
vpos=midroll
Reklama po filmie:
vpos=postroll
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zautomatyzowanego generowania przychodu w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV i w formatach audio.
Jeśli używasz reguł reklamowych, ten parametr nie jest potrzebny, ponieważ jest automatycznie dodawany przez serwer reklam.
wta (Dlaczego ta reklama?)
Opis
Parametr „Dlaczego ta reklama?” (wta) może mieć wartość stałą, która wskazuje, że odtwarzacz obsługuje renderowanie oznaczeń reklam.
Przykłady użycia
Jeśli odtwarzacz ma renderować ikonę Informacja podaną w odpowiedzi VAST, użyj:
wta=1(lub pomiń parametrwtaalbo prześlij parametrwtabez ustawionej wartości).Żądania reklam audio powinny zawierać 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.
Jeśli odtwarzacz nie powinien renderować ikony Informacja podanej w odpowiedzi VAST, użyj:
wta=0
Wymagania i zalecenia
Ten parametr nie jest wymagany do wyświetlania reklam w przypadku żadnego konkretnego typu implementacji, ale zalecamy jego użycie w przypadku zautomatyzowanego generowania przychodu w przeglądarce, aplikacjach mobilnych, na urządzeniach CTV i w formatach audio.
Kiedy ten parametr jest używany:
- Ruch z parametrem
&wta=0nie kwalifikuje się do niektórych typów personalizacji ze źródeł ofert reklamowych Google. - Ruch z parametrem
&wta=0z Europejskiego Obszaru Gospodarczego nie kwalifikuje się do wyświetlania kreacji z włączonym oznaczaniem reklam w elementach zamówienia automatyzacji gwarantowanej z rezerwacji i zarządzanych przez wydawcę.
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 formularza Zgłaszanie treści w Google.
Korzystanie z pakietu SDK
Funkcja oznaczania reklam jest obsługiwana automatycznie, gdy korzystasz z pakietu IMA SDK. Jeśli nie używasz pakietu IMA SDK, odtwarzacze muszą implementować VASTIcon i obsługę IconClickFallbackImage zgodnie ze standardem IAB VAST.Inne parametry
Zazwyczaj te parametry nie są wymagane do wyświetlania reklam, ale mogą być potrzebne do korzystania z pewnych funkcji lub w przypadku niektórych typów implementacji.
ad_rule (Reguła reklamowa)
Opis
Parametr reguły reklamowej (ad_rule) 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 Google Ad Managera, które umożliwia, aby wszystkie żądania były żądaniami reguł reklamowych. Jeśli używane jest ustawienie sieci, w tagu reklamy nie musisz podawać parametru ad_rule. Jeśli chcesz wyłączyć regułę na podstawie żądania reklamy, możesz przekazać parametr ad_rule=0, aby zastąpić ustawienie sieci. Jeśli reguły reklamowe nie są domyślnie włączone, możesz je włączyć lub wyłączyć, podając odpowiednio parametr ad_rule=1 lub ad_rule=0.
Przykłady użycia
Jeśli ustawienie reguł reklamowych jest wyłączone:
- Żądanie kreacji VAST:
ad_rule=0lub nie ustawiaj
Jeśli ustawienie reguł reklamowych jest włączone:
- Żądanie kreacji VAST:
ad_rule=0 - Żądanie reguł reklamowych (VMAP):
ad_rule=1lub nie ustawiaj
Jeśli nie chcesz używać reguł reklamowych, możesz użyć parametrów tagu reklamy, aby wskazać przerwę na reklamę i czas trwania bloku reklamowego w tagach VAST za pomocą parametrów pmnd, pmxd i pmad.
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w przypadku żadnego konkretnego typu implementacji, jest on niezbędny do prawidłowego korzystania z reguł reklam wideo.
addtl_consent (Dodatkowa zgoda)
Opis
Parametr Udzielenie dodatkowej zgody (addtl_consent) może mieć wartości zmienne. Jest używany przez wydawców, którzy chcą zintegrować Zasady IAB TCF 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.
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
adtest (Test reklamy)
Opis
Parametr adtest powinien być używany, aby zapytania służące do testowania zapasowych (niegwarantowanych) zasobów reklamowych nie były rozpoznawane jako nieprawidłowy ruch i nie miały wpływu na przychody.
Podczas testowania zasobów zapasowych ustaw ten parametr na on (włączono), aby reklamy nie rejestrowały wyświetleń ani kliknięć do użytku podczas testów. W środowiskach innych niż testowe ustaw to ustawienie na off (wyłączono), aby naliczać opłaty zgodnie ze standardowymi zasadami. Jeśli nie ustawisz tego parametru, jego domyślna wartość to off.
Uwaga: podczas testowania elementów zamówienia sprzedawanych bezpośrednio należy używać testowych elementów zamówienia, które nie mają wpływu na przychody.
Przykłady użycia
Włączono:
adtest=on
Wyłączono:
adtest=off
ad_type (Typ reklamy)
Opis
Parametr typu reklamy (ad_type) może mieć wartość stałą, wskazującą typy reklam, które powinny zostać zwrócone w odpowiedzi na żądanie.
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
Dzięki tej wartości
audio_videooba formaty mogą ze sobą konkurować, ale tylko jeden jest wyświetlany. Służy ona 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, takich jak transmisje sportowe, wideocasty, wiadomości 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
Wymagania i zalecenia
- Jeśli Twoja aplikacja zawiera treści wideo, ustaw ten parametr na
video,audio_videolub pozostaw go nieustawiony. - Jeśli Twoja aplikacja zawiera tylko treści audio (np. radio lub aplikację do mowy), musisz ustawić ten parametr na
audio. Jeśli nie skonfigurujesz tego parametru, nie zostaną zwrócone żadne reklamy audio.
afvsz (Rozmiary reklam nielinearnych)
Opis
Parametr rozmiarów reklam nielinearnych (afvsz) 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 200250 x 250300 x 250336 x 280450 x 50468 x 60480 x 90729 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łady użycia
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
Wymagania i zalecenia
Ten parametr nie jest wymagany do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, ale jest wymagany do wyświetlania nielinearnych reklam wideo, gdy nie używasz pakietu IMA SDK.
allcues (Wszystkie punkty wstawienia)
Opis
Parametr all cues (allcues) może mieć wartości zmienne w postaci rozdzielonej przecinkami listy punktów wstawienia reklamy (w milisekundach). W przypadku każdej wartości Google Ad Manager zwraca przerwę na reklamę.
- Parametry
vid_diallcuessł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
allcuessą ignorowane. Reklamy w trakcie filmu nadal wymagają czasu trwania, więc musisz podać parametrvid_d.
Przykłady użycia
Punkty wstawienia reklamy w 10 i 20 sekundzie:allcues=10000,20000
ciu_szs (Rozmiary reklam towarzyszących)
Opis
Parametr rozmiarów reklam towarzyszących (ciu_szs) 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łady użycia
ciu_szs=728x90,300x250
Rozmiary z wielowymiarowym boksem:
ciu_szs=728x90,300x200|300x250
cmsid (Identyfikator źródła treści)
Opis
Parametry identyfikatora źródła treści (cmsid) i identyfikatora filmu (vid) 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
cmsidoznacza niepowtarzalny numer każdego źródła treści. Aby znaleźć go w usłudze Google Ad Manager, kliknij kolejno Wideo, Źródła treści i nazwę źródła. - Parametr
vidjest 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 Google Ad Manager, kliknij kolejno Wideo, Treść i wybierz konkretne treści wideo.
Przykłady użycia
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%%
Wymagania i zalecenia
Chociaż te parametry nie są wymagane do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, są niezbędne do korzystania z kierowania na treści wideo.
cust_params (Parametry niestandardowe)
Opis
Parametr parametrów niestandardowych (cust_params) może 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łady użycia
Zobacz przykłady dodawania par klucz-wartość.
excl_cat (Kategoria wykluczenia)
Opis
Parametr kategorii wykluczenia (excl_cat) może mieć wartości zmienne i ma blokować możliwość użycia elementów zamówienia zawierających etykietę wykluczenia w żądaniu reklamy. Aby ustawić kategorię wykluczeń i etykiety wykluczeń, użyj parametru cust_params.
Przykłady użycia
Aby ustawić kategorię wykluczenia dla 2 etykiet wykluczenia (airline_excl_label i train_excl_label), użyj znaku pionowego (|) do rozdzielenia etykiet:
excl_cat=airline_excl_label%7Ctrain_excl_label
Następnie zastosuj kodowanie adresu URL i użyj zakodowanego ciągu w parametrze cust_params:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
gdpr (RODO)
Opis
Parametr RODO (gdpr) 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łady użycia
RODO obowiązuje:gdpr=1
RODO nie obowiązuje:gdpr=0
gdpr_consent (Zgoda RODO)
Opis
Parametr zgody na wykorzystanie danych zgodnie z RODO (gdpr_consent) może mieć wartości zmienne i jest używany przez wydawców, którzy chcą zintegrować Zasady IAB TCF 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 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łady użycia
gdpr_consent=GDPR_CONSENT_123
iabexcl (URL listy wykluczeń IAB)
Opis
Parametr adresu URL wykluczenia IAB (iabexcl) może mieć wartości zmienne, czyli rozdzieloną przecinkami listę kategorii.
Przykłady użycia
iabexcl=3,14,527 nie obejmuje terminów „Ciężarówki”, „Pojazdy terenowe” i „Rugby”.
Możesz pobrać listę kategorii taksonomii treści IAB i ich identyfikatorów.
idtype (Typ urządzenia)
Opis
Parametry możliwego do zresetowania identyfikatora urządzenia (rdid, idtype, is_lat) mogą mieć wartości zmienne. Ta wartość jest też określana jako identyfikator reklamy (IFA).
W przypadku aplikacji mobilnych korzystających z pakietu IMA SDK na Androida lub iOS pakiet IMA 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.
Jeśli nie używasz pakietu IMA SDK lub używasz sygnalizowania po stronie serwera (SSB), musisz przekazywać te dane jako parametry jawne. 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ł |
Przykłady użycia
Zobacz szczegółowe przykłady możliwych do zresetowania identyfikatorów urządzeń.
Wymagania i zalecenia
Chociaż te parametry nie są wymagane do wyświetlania reklam w konkretnej implementacji, są niezbędne do automatycznego zarabiania w aplikacjach mobilnych, na urządzeniach CTV, w formatach audio i cyfrowych reklamach zewnętrznych.
W przypadku implementacji internetowych nie są używane możliwe do zresetowania identyfikatory urządzeń.
Korzystanie z pakietu SDK
Pakiet IMA SDK przekazuje to pole automatycznie, ale wydawcy, którzy korzystają z pakietu PAL SDK, muszą przekazywać te parametry ręcznie.
ipd (Domena partnera udostępniającego zasoby reklamowe)
Opis
Parametr domeny partnera zasobów reklamowych (ipd) może mieć wartości zmienne, które należy ustawić na deklaracje inventorypartnerdomain w pliku app-ads.txt wydawcy (lub 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.
Przykłady użycia
Parametrinventorypartnerdomain znajduje się w pliku app-ads.txt, który wskazuje na plik .txt partnera, który może zarabiać na zasobach reklamowych. Wartość parametru ipd powinna być zgodna z wartością w pliku app-ads.txt w przypadku jednego z elementów inventorypartnerdomain.Wymagania i zalecenia
Ten parametr jest wymagany w przypadku wydawców zarabiających na zasobach reklamowych, których nie są właścicielami.
ipe (Podmiot sprawdzający wyświetlenia)
Opis
Parametr podmiotu sprawdzającego wyświetlenia za pomocą polecenia ping (ipe) może mieć wartość stałą, która wskazuje pingi i konwersje z wyświetleń pochodzących z serwera, a nie klienta.
Podmiot sprawdzający wyświetlenia za pomocą polecenia ping jest używany, gdy serwer wysyła pingi/beacony wyświetleń z serwera.
Przykłady użycia
Sygnalizowanie po stronie serwera (SSB):ipe=ssb
is_lat (Ograniczenie śledzenia reklam)
Opis
Parametry możliwego do zresetowania identyfikatora urządzenia (rdid, idtype, is_lat) mogą mieć wartości zmienne. Ta wartość jest też określana jako identyfikator reklamy (IFA).
W przypadku aplikacji mobilnych korzystających z pakietu IMA SDK na Androida lub iOS pakiet IMA 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.
Jeśli nie używasz pakietu IMA SDK lub używasz sygnalizowania po stronie serwera (SSB), musisz przekazywać te dane jako parametry jawne. 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ł |
Przykłady użycia
Zobacz szczegółowe przykłady możliwych do zresetowania identyfikatorów urządzeń.
Wymagania i zalecenia
Chociaż te parametry nie są wymagane do wyświetlania reklam w konkretnej implementacji, są niezbędne do automatycznego zarabiania w aplikacjach mobilnych, na urządzeniach CTV, w formatach audio i cyfrowych reklamach zewnętrznych.
W przypadku implementacji internetowych nie są używane możliwe do zresetowania identyfikatory urządzeń.
Korzystanie z pakietu SDK
Pakiet IMA SDK przekazuje to pole automatycznie, ale wydawcy, którzy korzystają z pakietu PAL SDK, muszą przekazywać te parametry ręcznie.
lip (Ostatnia pozycja w bloku reklamowym)
Opis
Parametr ostatniej pozycji w bloku reklamowym (lip) może mieć wartość stałą, aby wskazywać żądanie wysłane z ostatniej pozycji w bloku reklamowym na potrzeby kierowania lub raportowania.
Uwaga: ten parametr nie ma zastosowania do zoptymalizowanych bloków reklamowych i jest ignorowany, jeśli zostanie użyty.
Przykłady użycia
lip=1
ltd (Ograniczone wyświetlanie reklam)
Opis
Parametr ograniczonego wyświetlania reklam (ltd) 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. Wydawca może ręcznie dodać ten parametr, a Google podejmie podobną próbę wyświetlenia odpowiedniej reklamy bez względu na lokalizację użytkownika.
Ten parametr służy do wskazywania żądania ograniczonego wyświetlania reklam i różni się od parametru is_lat. Wyłącza personalizację i używanie identyfikatorów na potrzeby z nią związane.
ltd=1 zmienia działanie pakietu IMA SDK, tak aby traktował żądanie jako pozbawione identyfikatora i uniemożliwiał przechowywanie danych.Jeśli żądanie reklamy zawiera parametr
ltd=1 (czyli żądanie ograniczonego wyświetlania reklam), domena zmienia się na pagead2.googlesyndication.com, gdy używane są pakiety SDK. W przypadku integracji bez pakietu SDK wydawcy będą musieli ręcznie zmienić domenę na pagead2.googlesyndication.com.Przykłady użycia
ltd=1
max_ad_duration (Maksymalny czas trwania reklamy)
Opis
Parametr minimalnego czasu trwania reklamy (min_ad_duration) i parametr maksymalnego czasu trwania reklamy (max_ad_duration) mogą mieć wartości zmienne, które stosowane razem określają w milisekundach czas, w którym musi zmieścić się reklama.
Ten parametr może służyć do ograniczania czasu trwania kreacji do wartości wymaganej w tagu reklamy w przypadku pojedynczych reklam lub żądań zoptymalizowanych bloków reklamowych.
Przykłady użycia
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration (Minimalny czas trwania reklamy)
Opis
Parametr minimalnego czasu trwania reklamy (min_ad_duration) i parametr maksymalnego czasu trwania reklamy (max_ad_duration) mogą mieć wartości zmienne, które stosowane razem określają w milisekundach czas, w którym musi zmieścić się reklama.
Ten parametr może służyć do ograniczania czasu trwania kreacji do wartości wymaganej w tagu reklamy w przypadku pojedynczych reklam lub żądań zoptymalizowanych bloków reklamowych.
Przykłady użycia
min_ad_duration=15000&max_ad_duration=30000
mridx (Numer reklamy w trakcie filmu)
Opis
Parametr numeru reklamy w trakcie filmu (mridx) 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łady użycia
mridx=2
Wymagania i zalecenia
Ten parametr nie jest wymagany do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, ale jest niezbędny do kierowania na konkretny rodzaj reklamy w trakcie filmu, raportowania i prognozowania danych dotyczących reklam w trakcie filmu.
nofb (Brak kreacji zastępczej)
Opis
Parametr „brak zastępczej reklamy” (nofb) może mieć wartość stałą, aby wskazywać, że dane żądanie reklamy nie powinno zwracać playlisty zastępczych reklam wideo.
Przykłady użycia
Reklama zastępcza wyłączona:nofb=1
Funkcja pojedynczych reklam zastępczych i bufetu z reklamami na potrzeby zoptymalizowanych bloków reklamowych może być wyłączona w przypadku poszczególnych żądań reklamy przez przekazanie parametru nofb=1.
npa (Reklama niespersonalizowana)
Opis
Parametr reklam niespersonalizowanych (npa) 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łady użycia
Reklamy niespersonalizowane:
npa=1
Wymagania i zalecenia
Ten parametr jest wymagany tylko wtedy, gdy użytkownik wyłączy personalizację. Wydawcy powinni się upewnić, że przedstawiają dokładny stan użytkownika, gdy kontrolują ten stan.
paln (Liczba jednorazowa biblioteki dostępu zautomatyzowanego – starsza wersja)
Opis
W przypadku integracji korzystających z biblioteki dostępu zautomatyzowanego (PAL) parametr liczby jednorazowej wideo może przyjmować zmienną wartość ciągu znaków.
Liczba jednorazowa jest bezpieczna w adresach URL, więc nie trzeba jej kodować w adresie URL.
Uwaga: jeśli wcześniej przesłano liczbę jednorazową za pomocą przestarzałego parametru paln, zdecydowanie zalecamy przejście na parametr givn i zaprzestanie wysyłania parametru paln. Nie podawaj obu parametrów.
Przykłady użycia
Więcej informacji o wartości przekazywanej do tego parametru znajdziesz w instrukcjach wprowadzających do PAL.
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zarabiania z automatyzacji w przeglądarkach, aplikacjach mobilnych, na urządzeniach CTV, w przypadku reklam audio i cyfrowych reklam zewnętrznych.
pmad (Maksymalna liczba reklam w bloku reklamowym)
Opis
Parametr maksymalnej liczby reklam w bloku reklamowym (pmad) może mieć wartość zmienną, która wskazuje maksymalną liczbę reklam w bloku reklamowym.
Ten parametr ogranicza łączną liczbę reklam w zoptymalizowanym bloku reklamowym. Jest to funkcja dostępna dla wydawców, którzy mają zaawansowany pakiet wideo.
Nie należy go używać w przypadku VMAP (gdy ad_rule=1).
Przykłady użycia
pmad=4
pmnd (Minimalny czas trwania bloku reklamowego)
Opis
Parametr minimalnego czasu trwania bloku reklamowego (pmnd) i parametr maksymalnego czasu trwania bloku reklamowego (pmxd) 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 wysyłania żądania wielu reklam w zoptymalizowanym bloku reklamowym, który jest funkcją dostępną dla wydawców mających zaawansowany pakiet wideo. Gdy używasz reguł reklamowych, Google Ad Manager automatycznie dodaje te informacje.
Nie należy go używać w przypadku VMAP (gdy ad_rule=1).
Przykłady użycia
pmnd=0&pmxd=60000
pmxd (Maksymalny czas trwania bloku reklamowego)
Opis
Parametr minimalnego czasu trwania bloku reklamowego (pmnd) i parametr maksymalnego czasu trwania bloku reklamowego (pmxd) 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 wysyłania żądania wielu reklam w zoptymalizowanym bloku reklamowym, który jest funkcją dostępną dla wydawców mających zaawansowany pakiet wideo. Gdy używasz reguł reklamowych, Google Ad Manager automatycznie dodaje te informacje.
Nie należy go używać w przypadku VMAP (gdy ad_rule=1).
Przykłady użycia
pmnd=0&pmxd=60000
pmxfwt (Maksymalny wymuszony czas oglądania bloku reklamowego)
Opis
Parametr Maksymalny wymuszony czas oglądania bloku reklamowego (pmxfwt) może mieć wartość zmienną, która określa maksymalny czas trwania niemożliwego do pominięcia bloku reklamowego w milisekundach.
Jeśli chcesz ograniczyć czas wyświetlania reklam użytkownikom, gdy obsługujesz bloki reklamowe z reklamami wideo zarówno niemożliwymi do pominięcia, jak i możliwymi do pominięcia, użyj tego parametru, aby określić maksymalny czas wyświetlania reklamy, której użytkownik nie może pominąć.
Uwaga: parametr maksymalnego czasu trwania bloku reklamowego (pmxd) zastępuje ten parametr w określaniu maksymalnego łącznego czasu trwania bloku (w tym pełnego czasu trwania reklam możliwych do pominięcia).
Przykład zastosowania
pmxfwt=30000
pod (Numer bloku reklamowego)
Opis
Parametr numeru bloku reklamowego (pod) 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łady użycia
pod=3
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, jest niezbędny, aby umożliwić wyświetlanie tej samej reklamy w różnych blokach reklamowych oraz prawidłowe korzystanie z wykluczeń konkurencji, ograniczeń liczby wyświetleń i powiązanych funkcji.
pp (Profil kreacji)
Opis
Parametr profilu kreacji (pp) 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łady użycia
pp=creative_profile
Wymagania i zalecenia
Ten parametr nie jest wymagany do wyświetlania reklam w przypadku konkretnej implementacji, ale jest niezbędny do ograniczenia plików multimedialnych w przypadku hostowanych kreacji Google Ad Managera z profilami kreacji wideo i audio. W przypadku przekierowań i reklam zautomatyzowanych służy do sprawdzania, czy wymagania są spełnione, ale nie ogranicza plików multimedialnych do tych wybranych w profilu kreacji.
ppt (Respektowanie prywatności przez wydawcę)
Opis
Parametr Publisher Privacy Treatment (ppt) może mieć wartość stałą, która wskazuje, czy wyłączyć personalizację reklam w przypadku żądania reklamy.
Ten parametr umożliwia wymuszanie reklam niespersonalizowanych, które mogą się różnić od npa=1 i rdp=1. Dotyczy to zarówno rezerwacji, jak i automatyzacji ofert reklamowych.
Dowiedz się więcej o Publisher Privacy Treatment API.
Przykłady użycia
Wyłącz personalizację reklam:ppt=1
ppid (Identyfikator podawany przez wydawcę)
Opis
Parametr identyfikatora podawanego przez wydawcę (ppid) może mieć wartość zmienną identyfikatora i jest wykorzystywany 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.
Dowiedz się więcej o identyfikatorach podawanych przez wydawców.
Przykłady użycia
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, musisz używać spójnego identyfikatora niezależnego od platformy. Może być używany, gdy inne identyfikatory nie są dostępne, i można go udostępnić kupującym.
ppos (Pozycja w bloku reklamowym)
Opis
Parametr pozycji w bloku reklamowym (ppos) 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. Gdy używasz reguł reklamowych, Google Ad Manager automatycznie dodaje te informacje.
Przykłady użycia
ppos=2
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, jest wymagany w standardowych blokach reklamowych, gdy potrzebne jest kierowanie na pozycję, a także do prognozowania i tworzenia raportów dotyczących standardowych bloków reklamowych. Jest też wymagany do prawidłowego korzystania z wykluczeń konkurencji, ograniczenia liczby wyświetleń i powiązanych funkcji.
ppsj (Sygnały JSON dostarczane przez wydawcę)
Opis
Parametr JSON sygnałów dostarczanych przez wydawcę (ppsj) może mieć wartość zmienną, która jest obiektem JSON zakodowanym w standardzie Base64 zawierającym dane o odbiorcach i dane kontekstowe dostarczone przez wydawcę w celu zwiększania przychodów w ramach automatyzacji.
Ten parametr może służyć do wysyłania określonych sygnałów do kupujących/licytujących.
Dowiedz się więcej o sygnałach dostarczanych przez wydawcę i obsługiwanych taksonomiach.
Przykłady użycia
Obiekt JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Zastosowanie wartości zakodowanej w standardzie Base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Szczegółowe informacje o prawidłowych parach klucz-wartość JSON znajdziesz w
przykładzie HTML5 IMA SDK.
ptpl (Identyfikator szablonu przerwy na reklamę)
Opis
Parametr identyfikatora szablonu przerwy na reklamę (ptpl) i parametr nazwy (ptpln) mogą mieć wartości zmienne, które 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 parametrów.
Przykłady użycia
Dowiedz się więcej o konfigurowaniu szablonów przerw na reklamę i zgłaszaniu ich żądania.
Wymagania i zalecenia
Te parametry są wymagane tylko wtedy, gdy wysyłasz bezpośrednio żądanie szablonu przerwy na reklamę.
ptpln (Nazwa szablonu przerwy na reklamę)
Opis
Parametr identyfikatora szablonu przerwy na reklamę (ptpl) i parametr nazwy (ptpln) mogą mieć wartości zmienne, które 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 parametrów.
Przykłady użycia
Dowiedz się więcej o konfigurowaniu szablonów przerw na reklamę i zgłaszaniu ich żądania.
Wymagania i zalecenia
Te parametry są wymagane tylko wtedy, gdy wysyłasz bezpośrednio żądanie szablonu przerwy na reklamę.
pubf (Publiczne ceny minimalne w tagach Ad Exchange)
Opis
Publiczna cena minimalna parametru Ad Exchange (pubf) i prywatna cena minimalna parametru Ad Exchange (pvtf) mogą mieć wartości zmienne, które służą do dodawania cen minimalnych do tagów Ad Exchange.
Te parametry są odpowiednikami parametrów google_ad_public_floor i google_ad_private_floor.
Przykłady użycia
Publiczna cena minimalna:
pubf=123
Prywatna cena minimalna:
pvtf=123
Wymagania i zalecenia
Te parametry są dostępne tylko dla wydawców z Europejskiego Obszaru Gospodarczego („EOG”) lub Szwajcarii, którzy mają zgodę na korzystanie z funkcji „Cena minimalna”.
Dowiedz się, jak przesłać prośbę.
pvid (Identyfikator zestawu aplikacji)
Opis
Parametr identyfikatora zestawu aplikacji (pvid) może mieć wartość zmienną ustawioną na identyfikator zestawu aplikacji na Androida, a parametr zakresu zestawu aplikacji (pvid_s) może mieć wartość stałą, która reprezentuje zakres identyfikatora zestawu aplikacji (scope_app lub scope_developer).
Zapoznaj się z dokumentacją dla deweloperów aplikacji na Androida dotyczącą pobierania identyfikatora zestawu aplikacji.
Przykłady użycia
pvid=[AppSetID_value]
pvid_s=scope_app
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zautomatyzowanego generowania przychodu w aplikacji mobilnej na urządzeniach z Androidem, w tym na urządzeniach CTV opartych na aplikacjach (Android TV).
Korzystanie z pakietu SDK
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.
pvid_s (Zakres zestawu aplikacji)
Opis
Parametr identyfikatora zestawu aplikacji (pvid) może mieć wartość zmienną ustawioną na identyfikator zestawu aplikacji na Androida, a parametr zakresu zestawu aplikacji (pvid_s) może mieć wartość stałą, która reprezentuje zakres identyfikatora zestawu aplikacji (scope_app lub scope_developer).
Zapoznaj się z dokumentacją dla deweloperów aplikacji na Androida dotyczącą pobierania identyfikatora zestawu aplikacji.
Przykłady użycia
pvid=[AppSetID_value]
pvid_s=scope_app
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w konkretnej implementacji, zalecamy jego użycie w przypadku zautomatyzowanego generowania przychodu w aplikacji mobilnej na urządzeniach z Androidem, w tym na urządzeniach CTV opartych na aplikacjach (Android TV).
Korzystanie z pakietu SDK
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.
pvtf (Prywatne ceny minimalne w tagach Ad Exchange)
Opis
Publiczna cena minimalna parametru Ad Exchange (pubf) i prywatna cena minimalna parametru Ad Exchange (pvtf) mogą mieć wartości zmienne, które służą do dodawania cen minimalnych do tagów Ad Exchange.
Te parametry są odpowiednikami parametrów google_ad_public_floor i google_ad_private_floor.
Przykłady użycia
Publiczna cena minimalna:
pubf=123
Prywatna cena minimalna:
pvtf=123
Wymagania i zalecenia
Te parametry są dostępne tylko dla wydawców z Europejskiego Obszaru Gospodarczego („EOG”) lub Szwajcarii, którzy mają zgodę na korzystanie z funkcji „Cena minimalna”.
Dowiedz się, jak przesłać prośbę.
rdp (Ograniczone przetwarzanie danych)
Opis
Parametr ograniczonego przetwarzania danych (rdp) może mieć wartość stałą, aby wskazywać, że żądanie reklamy powinno ograniczać przetwarzanie danych.
Możesz ograniczyć przetwarzanie danych na poziomie sieci, włączając ustawienie sieci Ogranicz przetwarzanie danych.
Przykłady użycia
Ogranicz przetwarzanie danych:
rdp=1 lub rdp (bez określonej wartości)
Nie ograniczaj przetwarzania danych:
rdp=0
scor (Korelator strumienia)
Opis
Parametr korelatora strumienia (scor) może mieć wartość zmienną, która powinna być liczbą całkowitą generowaną dla każdego strumienia wideo.
Parametry scor i correlator nie muszą mieć tej samej wartości całkowitej. Powinny jednak zachowywać swoje wartości w trakcie odtwarzania każdego strumienia wideo, aby umożliwić identyfikację unikalnej sesji oglądania.
Przykłady użycia
scor=17
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, zalecamy jego używanie przy wyświetlaniu reklam w przeglądarkach, aplikacjach mobilnych, naurządzeniach CTV, w formatach audio i cyfrowych reklamach zewnętrznych.
Parametr służy do obsługi wykluczeń konkurencji, ograniczania liczby wyświetleń i podobnych funkcji, gdy użytkownik ogląda kilka filmów na stronie.
sdk_apis (platforma interfejsu SDK API)
Opis
Parametr platformy interfejsu API pakietu SDK (sdk_apis) dopuszcza rozdzieloną przecinkami listę stałych wartości całkowitych, które wskazują wszystkie platformy interfejsu API obsługiwane przez odtwarzacz.
Wymagania i zalecenia
Korzystanie z pakietu SDK
Ten parametr jest używany przez wydawców, którzy korzystają z biblioteki dostępu zautomatyzowanego (Programmatic Access Library, PAL). Jeśli podczas korzystania z pakietu IMA SDK spróbujesz ustawić wartości tego parametru, zostaną one zastąpione wartościami obsługiwanymi przez pakiet IMA SDK.
sdmax (Maksymalny czas trwania reklamy możliwej do pominięcia)
Opis
Parametr maksymalnego czasu trwania reklamy możliwej do pominięcia (sdmax) może mieć wartość zmienną, która pozwala wydawcom określić pożądany maksymalny czas 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 (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łady użycia
Jeśli użyjesz 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
Uzyskasz te 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.
ssss (Źródło łączenia po stronie serwera)
Opis
Parametr źródła łączenia po stronie serwera (ssss) 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łady użycia
ssss=mystitcher
Wymagania i zalecenia
Chociaż ten parametr nie jest wymagany do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, musi być używany w przypadku implementacji po stronie serwera.
tfcd (Tag treści skierowanych do dzieci)
Opis
Parametr tagu zawartości skierowanej do dzieci (tfcd) może mieć wartość stałą, która wskazuje, że żądanie powinno być traktowane jako skierowane do dzieci.
Przykłady użycia
tfcd=1
trt (Typ ruchu)
Opis
Parametr typu ruchu (trt) może mieć wartość stałą, która służy do żądania ruchu kupionego lub bezpłatnego.
Przykłady użycia
Żądanie ruchu kupionego:
trt=1
Żądanie ruchu bezpłatnego:
trt=2
Wymagania i zalecenia
Korzystanie z pakietu SDK
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).
us_privacy (Zasady IAB dotyczące ochrony prywatności użytkowników z USA)
Opis
Ciąg tekstowyus_national został wycofany przez IAB i zastąpiony przez GPP. Ad Manager nadal jednak odczyta i zaakceptuje ten ciąg znaków, jeśli zostanie on przekazany ze względu na zgodność wsteczną. Zalecamy, aby wydawcy sprawdzili ustawienia globalnej platformy do zarządzania prywatnością lub inne ustawienia prywatności i zrezygnowali z ciągu us_national.
vad_type (Typ reklamy wideo)
Opis
Parametr typu reklamy wideo (vad_type) może mieć wartość stałą, która wskazuje, czy ma zostać zwrócona reklama linearna czy nielinearna.
Przykłady użycia
Zwracanie reklamy linearnej:
vad_type=linear
Zwracanie reklamy nielinearnej:
vad_type=nonlinear
vid (Identyfikator filmu)
Opis
Parametry identyfikatora źródła treści (cmsid) i identyfikatora filmu (vid) 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
cmsidoznacza niepowtarzalny numer każdego źródła treści. Aby znaleźć go w usłudze Google Ad Manager, kliknij kolejno Wideo, Źródła treści i nazwę źródła. - Parametr
vidjest 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 Google Ad Manager, kliknij kolejno Wideo, Treść i wybierz konkretne treści wideo.
Przykłady użycia
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%%
Wymagania i zalecenia
Chociaż te parametry nie są wymagane do wyświetlania reklam w przypadku konkretnej implementacji lub typu transakcji, są niezbędne do korzystania z kierowania na treści wideo.
vpi (Wewnętrzne przekierowanie playlisty wideo)
Opis
Parametr wbudowania playlisty wideo (vpi) 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łady użycia
Zwracanie VAST:
vpi=1
Zwracanie tagów przekierowania:
vpi=0
