Powiadomienie

Dostęp tylko w usłudze Google Ad Manager 360.

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ć

zakładkaPrzejdź 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, idtypeis_lat. W strumieniach SSB musisz je przekazywać jako parametry jawne, tak jak w przypadku żądania reklamy Video Solutions po stronie klienta.

Uwaga

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 omidPartnerNameomidPartnerVersion. 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

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.

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.

Wideo na żądanie

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
 
linearna transmisja na żywo

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.

Czy to było pomocne?

Jak możemy ją poprawić?
Szukaj
Wyczyść wyszukiwanie
Zamknij wyszukiwanie
Aplikacje Google
Menu główne