Dodawanie parametrów kierowania do strumienia

Dodawanie opisanych tutaj parametrów kierowania jest opcjonalne.

Gdy tworzysz lub konfigurujesz źródło treści na potrzeby wideo na żądanie (VOD) lub transmisję na żywo na potrzeby dynamicznego wstawiania reklam, musisz określić domyślny tag reklamy wideo. Wszystkie strumienie z dynamicznym wstawianiem reklam standardowo korzystają z tego tagu i jego parametrów. Parametry tagu reklamy mają zastosowanie zarówno do reklam w trakcie filmu, jak i przed filmem. Jeśli odtwarzacz ma wysyłać unikalne żądania dotyczące danego strumienia, zastosuj te opcje.

Parametry tagu reklamy Ad Managera, które można zastąpić

Przejdź do konkretnego parametru:

addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent givn|paln idtype is_lat iu

iu is_lat ltd mpt mpv npa omid_p ppid ptpl ptpln rdid rdid

rdp sdk_apis sid sz tfcd trt vconp vpa vpmute wta

 

Zastępowanie domyślnego tagu reklamy

Gdy odtwarzacz prześle żądanie strumienia, system używa domyślnego tagu reklamy dokładnie w takiej postaci, jaka została przez Ciebie określona w interfejsie. Jeśli chcesz, możesz jednak zastąpić niektóre parametry tagu w żądaniu strumienia. Parametry wymienione poniżej to jedyne, które można zastąpić.

Dowiedz się, jak zastąpić domyślny tag reklamy za pomocą pakietu IMA SDK lub sygnalizowania po stronie serwera.

Parametr	Opis	Przykładowa wartość
iu	Bieżąca jednostka reklamowa. Powinien mieć taki format: /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	Pary klucz-wartość używane do kierowania kampanii Ad Managera. Niektóre platformy wymagają kodowania adresów URL. W przypadku korzystania z pakietu IMA DAI SDK dla HTML5 nie ma wymogu kodowania adresu URL, ponieważ wartość jest kodowana automatycznie. Ten parametr nie działa, jeśli jest już zakodowany w HTML5.	Przykłady z wieloma parami klucz-wartość, takimi jak: section=sports  page=golf,tennis   Strumienie SSB: połącz wartości parametru cust_params i zakoduj go w całości. Nie koduj wartości tego parametru podwójnie. cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast koduj tylko wartości. streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku połącz wartości parametru cust_params i zakoduj go w całości. Nie koduj wartości tego parametru podwójnie. request.adTagParameters =   "cust_params=   section%3Dsports   %26page%3Dgolf%2Ctennis"   iOS i tvOS: nie koduj niczego. request.adTagParameters = @{   @"cust_params" :   @"section=sports&   multi=golf,tennis"};   Android: nie koduj niczego. Map<String, String> adTagParams =   new HashMap<>();   adTagParams.put(   "cust_params",   "ge=0&gr=2");
sz	Zastąpienie parametru sz w domyślnym tagu reklamy pozwala dynamicznie zmieniać rozmiar na różnych urządzeniach. Nie dodawaj litery „v” na końcu rozmiaru.	sz=400x300
tfcd	Wskazuje, że źródło żądania należy traktować jako skierowane do dzieci. Gdy żądanie DAI zawiera parametr tfcd=1, wszystkie wartości przypisane do parametrów rdid, idtype lub is_lat są usuwane, by zapewnić zgodność z ustawą COPPA.	tfcd=1
description_url	Wartość powinna opisywać film odtwarzany na stronie. Zwykle jest to strona z odtwarzaczem, ale może to być też strona z tekstem opisującym film. W przypadku strumieni SSB i podczas korzystania z pakietu IMA DAI SDK na urządzenia Roku parametr description_url musisz zawsze kodować w adresie URL. To wymaganie nie dotyczy pakietu IMA DAI SDK dla HTML5, bo wartość jest kodowana automatycznie. Ten parametr nie działa, jeśli jest już zakodowany w HTML5. Ten parametr nie jest ustawiany automatycznie przez pakiet IMA SDK. Należy go ustawić ręcznie. To pole jest wymagane, jeśli korzystasz z Ad Exchange. Więcej informacji	Przykład z zakodowanym adresem URL: description_url= http%3A%2F%2Fwww.sample.com %2Fgolf.html Przykład bez kodowania: description_url= http://www.sample.com/ golf.html
ppid	Identyfikator podawany przez wydawcę (PPID) umożliwia wydawcom przesyłanie identyfikatora wykorzystywanego na potrzeby ograniczenia liczby wyświetleń, podziału odbiorców na segmenty, kierowania, sekwencyjnej rotacji reklam i innych funkcji sterujących wyświetlaniem reklam w zależności od odbiorców na różnych urządzeniach. Więcej informacji	ppid= 12JD92J...
ciu_szs	Lista rozdzielonych przecinkami rozmiarów reklam towarzyszących. Reklamy towarzyszące są obsługiwane przez DAI tylko wtedy, gdy używasz pakietu HTML5 SDK.	ciu_szs=728x90,300x250
mpt	Wskazuje nazwę odtwarzacza partnera. Jest używany głównie przez partnerów, takich jak JWPlayer, Brightcove, Ooyala, zintegrowanych z pakietem SDK.	mpt=JWPlayer
mpv	Wskazuje wersję odtwarzacza partnera. Ten parametr należy ustawić tylko wtedy, gdy jest także określony parametr mpt. Podaje wersję odtwarzacza partnera zintegrowanego z pakietem SDK.	mpv=2.1
ptpl	Identyfikator szablonu przerwy na reklamę. Znajdziesz go w adresie URL Ad Managera podczas wyświetlania ustawień szablonu przerwy na reklamę w interfejsie Ad Managera. Jest on wyświetlany jako wartość parametru break_template_id.	ptpl=1234
ptpln	Nazwa szablonu przerwy na reklamę. Odpowiada zawartości pola „Nazwa” w usłudze Ad Manager, a nie nazwie wyświetlanej.	ptpln=my_break_template
an	Parametr an oznacza nazwę aplikacji. Należy go stosować w żądaniach wysyłanych z aplikacji mobilnych i urządzeń multimedialnych z internetem, ponieważ są wymagane przez większość automatycznych reklam wideo*. Pakiet IMA SDK automatycznie wypełni ten parametr, ale trzeba go określić ręcznie w interfejsie DAI API i SSB (środowiskach innych niż SDK). * Nazwa aplikacji powinna być łatwo zrozumiała. W przypadku iOS i tvOS pakiet SDK nie ma dostępu do 9-cyfrowego Identyfikatora App Store. W takiej sytuacji SDK wysyła pakiet aplikacji za pomocą parametru an (w formacie com.package.publisher).	an=sample%20app
ltd	Określa, czy wyświetlać reklamy w ograniczonym zakresie przy braku zgody użytkowników na używanie plików cookie lub innych identyfikatorów lokalnych. Więcej informacji	ltd=1
rdid idtype is_lat	W przypadku aplikacji natywnych (nie na stronach na komputerze czy w internecie mobilnym) na potrzeby kierowania na użytkowników pakiet SDK przekazuje do żądań strumieni możliwe do zresetowania identyfikatory urządzeń zawierające parametry rdid, idtype i is_lat. W strumieniach SSB musisz je przekazywać jako parametry jawne, tak jak w przypadku żądania reklamy Video Solutions po stronie klienta. Wraz z udostępnieniem systemu iOS 14.5 firma Apple wycofała sygnał LAT. Zamiast tego, aby określić, czy użytkownik wyraził zgodę na śledzenie w wersjach iOS, które obsługują App Tracking Transparency, Google polega na obecności identyfikatora IDFA o wartości innej niż zero. W związku z tym wymagany jest prawidłowy ciąg UserAgent wskazujący odpowiednią wersję systemu operacyjnego.	Zobacz szczegółowe przykłady możliwych do zresetowania identyfikatorów urządzeń.
trt	Wskazuje ruch jako kupiony lub pozyskany w inny sposób.	Nieokreślony typ ruchu: trt=0 Ruch kupiony: trt=1 Ruch bezpłatny: trt=2
vconp	Parametr zalecany w wytycznych MRC dotyczących pomiarów wideo. Wskazuje, czy odtwarzacz ma odtwarzać treści wideo po kolei w sposób ciągły, podobnie jak w przypadku transmisji telewizyjnych. Możliwe wartości to 2 (ciągłe odtwarzanie WŁĄCZONE) i 1 (WYŁĄCZONE). Tego parametru nie należy ustawiać, jeśli jest nieznany.	Ciągłe odtwarzanie WŁĄCZONE: vconp=2 Ciągłe odtwarzanie WYŁĄCZONE: vconp=1
vpa	Parametr zalecany w wytycznych MRC dotyczących pomiarów wideo. Wskazuje, czy reklama będzie 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. Tego parametru nie należy ustawiać, jeśli jest nieznany.	Autoodtwarzanie: vpa=auto Po kliknięciu: vpa=click
vpmute	Parametr zalecany w wytycznych MRC dotyczących pomiarów wideo. Wskazuje, czy odtwarzanie reklamy ma się rozpocząć, gdy odtwarzacz jest wyciszony. Możliwe wartości to 1 (wyciszenie) i 0 (wyciszenie wyłączone). Tego parametru nie należy ustawiać, jeśli jest nieznany.	Wyciszenie włączone: vpmute=1 Wyciszenie wyłączone: vpmute=0
npa	Ustawienie personalizacji na potrzeby żądań reklamy. Zalecamy określenie tego parametru blisko początku tagu, by zmniejszyć ryzyko obcięcia. Określ parametr npa=1, by oznaczyć żądanie reklamy jako niespersonalizowane. Jego pominięcie domyślnie powoduje wyświetlanie reklam spersonalizowanych.	npa=1
omid_p	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 pomiaru Widoku aktywnego przy użyciu pakietu SDK Open Measurement (OM SDK). Nie należy go używać, gdy korzystasz z pakietu IMA SDK, ponieważ jest on ustawiany automatycznie. Aby wskazać obsługę OMID podczas korzystania z biblioteki dostępu zautomatyzowanego (Programmatic Access Library, PAL), do określenia nazwy i wersji partnera musisz użyć interfejsów API omidPartnerName i omidPartnerVersion. Jeśli nie używasz interfejsów PAL ani IMA, musisz ustawić parametry omid_p i sdk_apis (obsługiwane interfejsy API, które mogą też zawierać inne interfejsy API rozdzielone przecinkami).	W przypadku systemu PAL: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Jeśli nie używasz PAL: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
gdpr gdpr_consent	Te pola służą do przekazywania informacji o zgodzie wyrażonej w ramach Zasad dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 zarówno w przypadku przychodzących, jak i wychodzących żądań synchronizacji plików cookie.	Zobacz specyfikację RODO.
givn|paln	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.	Więcej informacji o wartości przekazywanej do tego parametru znajdziesz w instrukcjach wprowadzających do PAL.
addtl_consent	Lista zaakceptowanych dostawców technologii reklamowych Google niezarejestrowanych w IAB.	Zobacz specyfikację Udzielenie dodatkowej zgody.
rdp	Aby ograniczyć przetwarzanie danych, musisz konkretnie podać wartość rdp=1 albo użyć samego parametru rdp (bez określonej wartości). W przypadku żądań reklam, w których brakuje tego parametru lub ma on wartość rdp=0, ograniczenie nie będzie działać, chyba że włączone jest ustawienie sieci Ogranicz przetwarzanie danych.	rdp=1
sdk_apis	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 jest używany przez wydawców, którzy korzystają z biblioteki dostępu programowego (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.	sdk_apis=2,7,9
sid	Typ identyfikatora reklamowego zapewniającego ochronę prywatności, który może służyć wyłącznie do ograniczania liczby wyświetleń. Zgodnie z wytycznymi IAB dotyczącymi identyfikatorów reklamowych ten parametr musi mieć format UUID. Więcej informacji Aby zrezygnować z przekazywania identyfikatora sesji, ustaw parametr sid=0.	sid=123e4567-e89b-12d3 -a456-426614174000
wta	Wskazuje, że odtwarzacz wideo obsługuje renderowanie „Dlaczego ta reklama?”. To pytanie jest obsługiwane automatycznie, gdy korzystasz z pakietu IMA SDK. Jeśli nie używasz pakietu IMA SDK, odtwarzacze muszą implementować parametr Icon VAST i obsługę IconClickFallbackImage, zgodnie z dokumentacją w przewodniku po interfejsie DAI API*. Parametr WTA nie jest obsługiwany w przypadku SSB. To pole jest wymagane, jeśli korzystasz z Ad Exchange. Więcej informacji * Obsługa IconClickFallbackImage jest wymagana tylko na urządzeniach CTV.	Obsługuje: wta=1 Nie obsługuje: wta=0

Zastępowanie domyślnego tagu reklamy za pomocą pakietu IMA SDK

Gdy odtwarzacz wysyła żądanie strumienia z dynamicznym wstawianiem reklam, korzystając z pakietu IMA SDK, może przekazać pole „adTagParameters”. To struktura podobna do słownika, wypełniana parami klucz-wartość, w której klucze mogą być parametrami tagu reklamy Ad Managera wymienionymi w tabeli powyżej.

Strumień możesz dostosować, by w tej samej strukturze przekazywać parametry niezwiązane z żądaniem reklamy Ad Managera. Dowiedz się więcej o żądaniu określonych wersji strumienia i konfigurowaniu czasu bez reklam.

Implementacja pola adTagParameters różni się nieco w zależności od języka programowania i platformy. Więcej dowiesz się z dokumentacji technicznej iOS, Android, tvOS, Chromecast i HTML5, a także z dodatkowych informacji w przewodniku dla programistów odtwarzacza i aplikacji do dynamicznego wstawiania reklam.

 

Ustawianie parametru adTagParameters za pomocą pakietu SDK

Gdy ustawisz parametr cust_params lub description_url za pomocą pakietu SDK, pozostaw adresy URL w formie niezakodowanej w aplikacjach na iOS, tvOS i Android. Parametr cust_params możesz przekazywać jako jeden ciąg znaków złożony z par klucz-wartość połączonych znakami „&”.

Powiedzmy, że jako wartość parametru cust_params chcesz ustawić sport=football&city=newyork.

Struktura adTagParams z niezakodowanymi wartościami wyglądałaby tak:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport=football&city=newyork",
  "description_url": "http://www.sample.com/golf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Struktura adTagParameters z zakodowanymi wartościami (w żądaniach strumienia w HTML5) wyglądałaby tak:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport%3Dfootball%26city%3Dnewyork",
  "description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Struktura adTagParams z zakodowanymi wartościami (w żądaniach strumienia w Roku) wyglądałaby tak:

request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"

Zastępowanie domyślnego tagu reklamy za pomocą interfejsu DAI API ^(Beta) 

Gdy odtwarzacz wysyła żądanie strumienia DAI korzystając z interfejsu DAI API, może przekazywać pary klucz-wartość, w których klucze mogą być parametrami tagu reklamy Ad Managera wymienionymi w tabeli powyżej.

Te parametry należy wysyłać w treści żądania HTTP POST w formularzu typu application/x‑www‑form‑urlencoded zarówno w przypadku linearnych transmisji na żywo, jak i VOD.

Strumień możesz dostosować, by w tej samej strukturze przekazywać parametry niezwiązane z żądaniem reklamy Ad Managera. Dowiedz się więcej o żądaniu określonych parametrów wersji strumienia i określonego uwierzytelnienia za pomocą tokena HMAC.

Zobacz przykładową implementację interfejsu DAI API.

Zastępowanie domyślnego tagu reklamy za pomocą sygnalizowania po stronie serwera (SSB)

Poniżej znajdziesz przykłady zmian domyślnego tagu reklamy w wideo na żądanie z sygnalizowaniem po stronie serwera. Zastąpione parametry, które przekazuje odtwarzacz lub aplikacja, są wyróżnione.

Przykłady wideo na żądanie

	Przykład
Podstawowy URL strumienia VOD	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8
(z określoną jednostką reklamową)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?iu=/9876/ path/to/adunit
(z zastąpionymi parami klucz-wartość)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& cust_params=sport%3Dgolf%26section%3Dblog %26anotherKey%3Dvalue1%2Cvalue2
(z deklaracją zawartości skierowanej do dzieci)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfcd=1
(z zastąpioną jednostką reklamową, parami klucz-wartość, niestandardowym parametrem description_url ORAZ deklaracją zawartości skierowanej do dzieci)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

 

Przykładowe linearne transmisje na żywo

	Przykład
Podstawowy URL linearnej transmisji na żywo	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8
(z określoną jednostką reklamową)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?iu=/9876/path/to/adunit
(z zastąpionymi parami klucz-wartość)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?cust_params=sport%3Dgolf%26section %3Dblog%26otherKey%3Dvalue1%2Cvalue2
(z deklaracją zawartości skierowanej do dzieci)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfcd=1
(z zastąpioną jednostką reklamową, parami klucz-wartość, niestandardowym parametrem description_url ORAZ deklaracją zawartości skierowanej do dzieci)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

Dynamiczne aktualizowanie parametrów kierowania w czasie określonej transmisji na żywo

Możesz dynamicznie aktualizować dane kierowania dla określonego użytkownika w trakcie oglądania strumienia, korzystając z metody replaceAdTagParameters w pakiecie IMA DAI SDK.

W kwestiach związanych z rozwiązywaniem problemów z systemem DAI lub przerwami w jego działaniu kontaktuj się z zespołem pomocy dla wydawców.