Makra pro dynamické vkládání reklam

K dispozici jsou také další informace o makrech s vysvětlením, jak makra se službou Ad Manager fungují, a s úplným seznamem maker vykreslení, měřicích maker a dalších maker videí.

Přeskočte na konkrétní makro v seznamu

Makra žádostí o reklamy _{Aplikační rámce API Balíček aplikace Klíč podkladu Maximální trvání přestávky Pozice přestávky Vynechání mezipaměti ID klienta ID v systému CMS DAI_PRE Doména FW Ciad GDPR Souhlas podle GDPR}	_{Nonce reklamy in-stream Google IFA Typ IFA Omezit měření reklam Typ MIME média Nepersonalizované reklamy Partner Omid Adresa URL stránky Typ umístění Předpisy SCTE-35 Na straně serveru ID streamu}	_{TFCD TFUA Časové razítko ID transakce Ochrana soukromí v USA User-agent IP adresa uživatele Délka videa Délka videav sekundách ID videa Název videa}
Měřicí makra VAST _{Vynechání mezipaměti Kód chyby}

Rozbalit vše Sbalit vše

Makra žádostí o reklamy

Zde zobrazená makra žádostí o reklamy lze použít pouze ve značce reklamy pro dynamické vkládání reklam (DAI) pro zdroj obsahu videí na vyžádání nebo přímý přenos. V kontextu kreativ VAST nefungují.

Aby makra ve službě Ad Manager prošla ověřením maker pro přesměrování, obvykle je potřeba použít verzi s hranatými závorkami.

Aplikační rámce API

Makro
`[APIFRAMEWORKS]`

Parametr sdk_apis.

Balíček aplikace

Makro
`[APPBUNDLE]`

Parametr an.

Klíč podkladu

Makro
`%%ASSET_KEY%%`

Nahradí se kódem události živého přenosu.

Pozice přestávky

Makro
`[BREAKPOSITION]`

Makro šablony VAST 4.1. Vrací hodnoty:

1: pro reklamy před videem
2: pro reklamy uprostřed videa
3: pro reklamy za videem
4: pro samostatné reklamy
0: pro žádnou z výše uvedených možností/jiné

Maximální trvání přestávky

Makro
`%%BREAK_DURATION%%`
`[BREAKMAXDURATION]`

Trvání aktuální reklamní přestávky v sekundách.

Makro [BREAKMAXDURATION] by se mělo používat pouze pro přesměrování služby Ad Manager, u nichž není povoleno makro %%BREAK_DURATION%%.

Vynechání mezipaměti

Makro
`[CACHEBUSTING]`

Náhodné číslo.

ID klienta

Makro
`[CLIENTUA]`

ID použitého přehrávače VAST a klienta VAST.

ID v systému CMS

Makro
`%%CMS_ID%%`

Za toto makro se dosadí ID zdroje obsahu Ad Manager („CMS ID“), který se právě přehrává. Ve zdroji MRSS tato hodnota uvedena není, ale je vidět v uživatelském rozhraní služby Ad Manager.

DAI_PRE

Makro
`%%DAI_PRE%%`

Výchozí hodnota je 0. Pokud je žádost o reklamu odeslána v kontextu neblokování nebo rozdělení žádosti (například předčasná přestávka nebo předběžná načtení), nastavuje se na hodnotu 1. Reklamním serverům to dává najevo, že na zpracování žádosti o reklamu může být k dispozici více času.

Týká se jen provozu z živých přenosů / lineárního živého vysílání.

Doména

Makro
`[DOMAIN]`

Makro šablony VAST 4.1. Doména adresy URL odkazujícího zdroje vytvoření streamu.

Makro
`%%FW_CAID%%`

Pouze pro VOD – vlastní ID podkladu FreeWheel ze zdroje MRSS

GDPR

Makro
`%%GDPR%%`

Parametr gdpr.

Souhlas podle GDPR

Makro
`[GDPRCONSENT]`

Parametr gdpr_consent.

Nonce reklamy in-stream Google

Makro
`[GOOGLE_INSTREAM_VIDEO_NONCE]`

Parametr givn.

IFA

Makro
`[IFA]`

Resetovatelné inzertní ID převzaté z parametru rdid. Inzertní ID se do primárních žádostí o reklamy předává pouze v případě, že to příznaky ochrany soukromí (například tfcd nebo is_lat) povolují.

Typ IFA

Makro
`[IFATYPE]`

Parametr idtype DAI. Typ IFA se do primárních žádostí o reklamy předává pouze v případě, že to příznaky ochrany soukromí (například tfcd a is_lat) povolují.

Omezit měření reklam

Makro
`[LIMITADTRACKING]`

Parametr ltd.

Mediamime

Makro
`[MEDIAMIME]`

Makro šablony VAST 4.1: seznam čárkami oddělených podporovaných typů MIME médií.

Nepersonalizované reklamy

Makro
`%%NPA%%`

Nahradí se hodnotou 1, která udává, že se jedná o nepersonalizovanou žádost.

Toto makro se používá se žádostmi o reklamy, na které se vztahuje nařízení GDPR, a pouze ve značce reklamy pro dynamické vkládání reklam. Další makra pro GDPR

Partner OMID

Makro
`[OMIDPARTNER]`

Makro šablony VAST 4.1: parametr omid_p.

Adresa URL stránky

Makro
`[PAGEURL]`

Makro šablony VAST 4.1: adresa URL odkazujícího zdroje vytvoření streamu.

Typ umístění

Makro
`[PLACEMENTTYPE]`

Makro šablony VAST 4.1: pro DAI bude hodnota vždy 1 (in-stream).

Viz Podtypy umístění videoreklam AdCOM.

Předpisy

Makro
`[REGULATIONS]`

Makro šablony VAST 4.1: seznam platných předpisů oddělených čárkami na základě parametrů. Parametr tfcd=1 přidá „coppa“, gdpr=1 přidá „gdpr“.

Na straně serveru

Makro
`[SERVERSIDE]`

Makro šablony VAST 4.1 – vždy 1.

SCTE-35

Makro
`%%SPLICE_INSERT_EVENT_ID%%`
`%%SPLICE_INSERT_UPID%%`
`%%TIME_SIGNAL_EVENT_ID%%`
`%%TIME_SIGNAL_UPID%%`
`%%TIME_SIGNAL_UPID_RAW%%`
`%%AFMM_CBC%%`

Nahradí se signály SCTE-35.

ID streamu

Makro
`%%STREAM_ID%%`

Za toto makro se dosadí ID relace streamu s obsahem, který se právě přehrává.

TFCD

Makro
`%%TFCD%%`

Nahradí se hodnotou parametru tfcd.

TFUA

Makro
`%%TFUA%%`

Parametr tfua.

Časové razítko

Makro
`[TIMESTAMP]`

Makro šablony VAST 4.0 – aktuální časové razítko ve formátu ISO 8601.

ID transakce

Makro
`[TRANSACTIONID]`

Makro šablony VAST 4.1 – identifikátor používaný k přiřazení řetězce žádostí o reklamy na straně původu.

Ochrana soukromí v USA

Makro
`%%US_PRIVACY%%`

Nahradí se hodnotou parametru us_privacy.

User-agent

Makro
`%%USER_AGENT%%`
`[DEVICEUA]`

User-agent zařízení, které vykresluje reklamu koncovému uživateli.

V případě přesměrování VAST poskytne očekávanou funkci pouze makro [DEVICEUA].

IP adresa uživatele

Makro
`%%USER_IP%%`
`[DEVICEIP]`
`[IP_ADDRESS]`

Nahradí se IP adresou uživatele.

Makro [IP_ADDRESS] by se mělo používat jen pro přesměrování služby Ad Manager, u nichž není povoleno makro %%USER_IP%%.

Délka videa

Makro
`%%VIDEO_DURATION%%`

Pouze VOD – délka videa v milisekundách ze zdroje MRSS.

Trvání videa v sekundách

Makro
`%%VIDEO_DURATION_SEC%%`

Nahradí se trváním videa v sekundách.

ID videa

Makro
`%%VIDEO_ID%%`

Pouze VOD – ID obsahu v systému CMS ze zdroje MRSS.

Název videa

Makro
`%%VIDEO_TITLE%%`

Pouze VOD – název videa ze zdroje MRSS.

Měřicí makra VAST

Makra [CACHEBUSTING] a [ERRORCODE] odpovídají specifikaci VAST 4.0 (viz sekce 2.3.7 Makra).

Vynechání mezipaměti

Makro
`[CACHEBUSTING]`

Nahradí se osmimístným náhodným číslem.

Kód chyby

Makro
`[ERRORCODE]`

Nahradí se kódem chyby VAST.

Ohledně záležitostí souvisejících s odstraňováním problémů s DAI nebo s výpadky DAI kontaktujte podporu pro majitele obsahu.

Makra v řetězcích zakódovaných pro URL

Pokud potřebujete použít makro v části značky reklamy, která musí být zakódovaná pro URL, samotné makro pro URL nezakódovávejte. Nemuselo by fungovat správně.

Příklad

Použití makra nonce reklamy in-stream Google v parametru v URL, který je potřeba zakódovat:

Správně
http://some-adtag.com?encoded_param=[GOOGLE_INSTREAM_VIDEO_NONCE]%3D5

Nesprávné
http://some-adtag.com?encoded_param=%5BGOOGLE_INSTREAM_VIDEO_NONCE%5D%3D5

Pomohly vám tyto informace?

Jak bychom článek mohli vylepšit?

Makra pro dynamické vkládání reklam

Přeskočte na konkrétní makro v seznamu

Makra žádostí o reklamy

Měřicí makra VAST

Makra v řetězcích zakódovaných pro URL

Pomohly vám tyto informace?

Potřebujete další pomoc?

Vyzkoušejte tyto další kroky: