Makra

Makro reklamní jednotky při zobrazení vkládá do kódu kreativy cestu reklamní jednotky ze značky GPT (Google Publisher Tag).

Makro ADUNIT lze do fragmentu kódu kreativy třetí strany přidat takto:

Makro reklamní jednotky se nahradí úplnou cestou uvedenou v původní žádosti o reklamy, včetně kódu sítě. Zde je příklad nahrazení cesty reklamní jednotky při zobrazení reklamy:

<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>

Makro cílové adresy URL bude nahrazeno cílovou adresou URL kreativy, kterou je buď cílová adresa URL řádkové položky, nebo přepis nastavený pro kreativu v řádkové položce.

Makro cílové adresy URL je užitečné ve vlastních kreativách a šablonách kreativ. Toto makro může pomoci v případě, že je potřeba v kódu kreativy uvést cílovou adresu URL a tato adresa se mění podle toho, ve které řádkové položce je kreativa nebo šablona použita.

K dispozici jsou tři typy maker cílové adresy URL podle způsobu escapování: s escapováním, s dvojitým escapováním a bez escapování. Typ escapování (provedené jednou, dvakrát, nebo vůbec) obvykle závisí na třetí straně, která měří prokliky. Někteří poskytovatelé měření prokliků vyžadují, aby speciální znaky v adrese URL byly escapovány, jiní poskytovatelé to nevyžadují. Úroveň escapování požadovaná třetí stranou, která měří prokliky, je často uvedena prostřednictvím řetězce click= ve značce reklamy třetí strany nebo v kódu vlastní kreativy ve službě Ad Manager:

• click=: Speciální znaky je třeba escapovat jednou (%%DEST_URL_ESC%%).

• click0=: Speciální znaky je třeba ponechat bez escapování (%%DEST_URL_UNESC%%).

• click1=: Speciální znaky je potřeba escapovat jednou (%%DEST_URL_ESC%%).

• click2=: Speciální znaky je potřeba escapovat dvakrát (%%DEST_URL_ESC_ESC%%).

Makro souborového serveru %%FILE:file_display_name%% se nahradí úplnou adresou URL podkladu, který byl pro kreativu nahrán. Pomocí tohoto makra můžete z vlastního kódu kreativy volat nahrané podklady, například obrázek.

Při použití tohoto makra nahraďte text file_display_name zobrazovaným názvem podkladu, který naleznete ve službě Ad Manager, když zobrazíte podrobnosti kreativy.

Tato makra do vlastního kódu kreativy při procesu zobrazení vloží výšku a šířku, která je pro ni definovaná ve službě Ad Manager v poli Velikost cílové reklamní jednotky.

Makra výšky a šířky jsou velmi užitečná hlavně v případě, že vytváříte šablonu kreativy, kterou chcete používat s kreativami různých velikostí. Namísto zadání velikosti napevno do kódu ji můžete nechat vložit do každé kreativy dynamicky pomocí maker výšky a šířky.

Pomocí makra shody se vzorem můžete do kreativy předat vlastní proměnné, například hodnotu cílení. Pomocí tohoto makra můžete předávat páry klíč–hodnota, nahradit celý řetězec cílení nebo dosadit adresu URL odkazující stránky. Může to být užitečné, pokud chcete zobrazovat různé kreativy na základě informací, které o uživateli máte (například na základě toho, jaký obsah sleduje).

Pomocí makra shody se vzorem lze u jedné kreativy provést maximálně 100 nahrazení.

%%PATTERN:key%%

Řekněme například, že pro určitou řádkovou položku máte dvě kreativy – jednu zaměřenou na ženy, druhou na muže. Klíč použitý v makru smí obsahovat pouze alfanumerické znaky a podtržítko (_).

Proces funguje takto:

1. Vlastní hodnotu (v tomto případě pohlaví uživatele) předáváte do značky reklamy na stránce pomocí párů klíč–hodnota.
   googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male");
2. Ve vlastní kreativě nebo kreativě třetí strany předejte vlastní hodnotu (pohlaví uživatele) dynamicky pomocí tohoto makra: <skript kreativy>...&gender=%%PATTERN:gender%%
3. Celé makro %%PATTERN:gender%% bude nahrazeno hodnotou „male“.
4. Služba Ad Manager zavolá server a tomuto uživateli zobrazí soubor kreativy pro hodnotu „male“.

%%PATTERN:TARGETINGMAP%%

Pomocí makra %%PATTERN:TARGETINGMAP%% můžete nahradit celou mapu cílení a dynamicky vytvářet značky passback.

Makro TARGETINGMAP lze do značky reklamy přidat takto:

.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();

Zde je příklad celého řetězce klíč–hodnota při zobrazení reklamy:

.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();

%%PATTERN:url%%

Adresu URL odkazující stránky můžete vložit také pomocí vyhrazeného klíče url.

Všechny páry klíč–hodnota ve značkách služby Campaign Manager 360, pro které jako název klíče použijete url, budou nahrazeny adresou URL odkazující stránky.

Makro parametru značky se používá ve spojení s dalšími parametry značky reklamy a je k dispozici pouze s následujícími parametry:

• pmad
• pmxd
• pmnd
• correlator
• scor
• pod
• vpos
• mridx
• ppos
• lip
• us_privacy

Pokud je parametr podporován, bude nahrazeno jeho hodnotou.

Například makro %%TAG_PARAM:correlator%% (podporováno) se nahradí hodnotou korelátoru ze značky reklamy, ale makro %%TAG_PARAM:ppid%% (nepodporováno) se žádnou hodnotou nenahradí.

Makro cíle v novém okně udává, zda je cílové okno zadané pro reklamní jednotku, ve které se kreativa zobrazuje, nastaveno na možnost _blank (nové okno) nebo na jinou možnost.

• Pokud je cílové okno _blank, bude makro nahrazeno hodnotou 1.

• Pokud má cílové okno nějakou jinou hodnotu nebo není zadáno, bude makro nahrazeno hodnotou 0.

K vložení samotné hodnoty nastavení cílového okna použijte makro %%TARGET_WINDOW%%.

Makro cílového okna se nahradí cílovým oknem zadaným pro reklamní jednotku, ve které se kreativa zobrazuje. Pomocí tohoto makra můžete v kódu kreativy určit, zda kliknutí na kreativu otevře nové okno, nebo se vstupní stránka načte ve stejném okně, a to na základě nastavení pro jednotlivé weby, kde uživatelé tuto reklamu uvidí.

Reklamní jednotka AdManagerNews.com má cílové okno nastaveno na hodnotu _top, reklamní jednotka AdManagerFashion.com na hodnotu _new. Pokud je v kódu kreativy zahrnuto makro %%TARGET_WINDOW%%, bude u uživatelů na stránkách AdManager_Fashion.com nahrazeno hodnotou _top a u uživatelů na stránkách AdManager_News.com hodnotou _new.

Zde je příklad implementace:

<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>

Pokud chcete zjistit, zda je hodnota nastavení cílového okna „_blank“, nebo jiná hodnota, použijte makro %%TARGET_IN_NEW_WINDOW%%.

Pomocí značky obsahu určeného dětem (TFCD) můžete třetím stranám sdělit, že příslušná žádost o reklamu pochází ze stránky s obsahem pro děti. Účelem tohoto makra je pomoci zajistit soulad se zákonem o ochraně soukromí dětí na internetu (COPPA).

Toto makro můžete použít ve všech přesměrováních nebo žádostech o kreativy třetích stran ve formátu coppa=%%TFCD%% (nebo v nějakém podobném formátu). Lze ho použít i v JavaScriptu k nastavení žádostí značek passback GPT pro obsah určený dětem. Makro se pro obsah určený dětem nahradí hodnotou 1 a pro jiný obsah hodnotou 0. Vychází se přitom z informací o povaze stránky, webu nebo mobilní aplikace, ze které byla žádost odeslána do služby Ad Manager.

Pokud používáte reklamní služby společnosti Google a chtěli byste na úrovni webu nebo aplikace implementovat zpracování obsahu určeného dětem, přečtěte si článek Označení webu nebo aplikace jako určených dětem.

Makro kódování URI správně přeloží mezery a další speciální znaky v hodnotách proměnných šablony kreativ, které se používají v identifikátorech URI neboli adresách URL.

Toto makro je užitečné zejména v případě použití šablony kreativ k definování cílové adresy URL nebo adresy URL přesměrování. Bez správného escapování by celá adresa URL v kreativě nemusela fungovat.

Makro pro vynechání mezipaměti prohlížeče zajistí, aby při každém spuštění kódu proběhlo nové volání reklamního serveru a získali jste tak správný počet zobrazení. Pokud do kódu kreativy nepřidáte makro pro vynechání mezipaměti prohlížeče, pravděpodobně zaznamenáte větší rozdíly v počtech zobrazení mezi službou Google Ad Manager a reklamním serverem třetí strany. Některé třetí strany makro pro vynechání mezipaměti prohlížeče nevyžadují.

Většina dodavatelů kreativ ve svých značkách nabízí zástupný symbol pro vložení maker pro vynechání mezipaměti prohlížeče. Kód kreativy třetí strany může například obsahovat řetězec jako tento:

http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]

Je třeba vybrat část [RANDOM_NUMBER] a kliknout na Vložit makro CacheBuster. Zástupný znak bude nahrazen:

http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%

Makra pro vynechání mezipaměti prohlížeče v odpovědích VAST

Makro %%CACHEBUSTER%% se u všech událostí v jedné kreativě nahradí stejným náhodným číslem. Tato vlastnost je velmi užitečná zejména u videoreklam, protože toto makro se u všech událostí měření videa v odpovědi VAST nahradí stejným náhodným číslem.

Makro kliknutí se nahradí speciální adresou URL, abyste ve službě Ad Manager mohli měřit kliknutí na kreativy třetích stran. Toto makro je obvykle spárováno s cílovou adresou URL kreativy ve značce ukotvení odkazu (<a>). Makro kliknutí nevkládejte jako zdroj obrázku nebo prvku iframe. Vedlo by to k zaznamenání prokliku při každém vykreslení obrázku nebo prvku iframe. Takové chování není legitimní a bylo by odfiltrováno jako neplatné kliknutí. 

Makro %%CLICK_URL_UNESC%% použijte na začátku odkazu. Makro %%CLICK_URL_ESC%% použijte v případě, že je měřič prokliků použit jako parametr jiné adresy URL.

<a href="%%CLICK_URL_UNESC%%http://google.com">link</a>

<a href="http://google.com?rd_url=%%CLICK_URL_ESC%%">link</a>

Další informace o makrech s escapováním a bez něj.

Ověření implementace makra kliknutí

Nesprávně umístěné makro kliknutí nebude měřit prokliky. Pomocí těchto kroků zkontrolujte, zda služba Ad Manager bude měřit kliknutí tak, jak potřebujete.

1. Podívejte se na náhled kreativy.
2. Klikněte na náhled.

Ad Manager zobrazí potvrzení, že kliknutí budou zaznamenána. Pokud toto potvrzení nevidíte, makro kliknutí není implementováno správně.

Makra rozbalení lze v kódu vlastní kreativy nebo v cílové adrese URL použít k zobrazení hodnot ID ze služby Ad Manager při zobrazení kreativ na stránce. Často se to používá k porovnání ID ze služby Ad Manager s ID z vlastní databáze majitele stránek při odstraňování problémů nebo vytváření jiných přehledů.

Makra rozbalení mohou být v cílové adrese URL vzájemně oddělena libovolným znakem, který lze bezpečně použít v cílových adresách URL služby Ad Manager. Z adresy http://site.com/?%eaid!;%ecid! například po nahrazení vznikne adresa http://site.com/?1234567;4265598.

Makro %%ADVERTISING_IDENTIFIER_PLAIN%% umožňuje majitelům inventáře v aplikacích odesílat inzertním partnerům resetovatelné ID zařízení za účelem zobrazování zájmově orientovaných reklam. Usnadňuje to poskytování přístupu k resetovatelnému ID zařízení inzerentům a agenturám.

Majitelé obsahu v aplikacích také mohou pomocí makra %%ADVERTISING_IDENTIFIER_TYPE%% odesílat typ zařízení a pomocí makra %%ADVERTISING_IDENTIFIER_IS_LAT%% odesílat nastavení Omezit sledování reklam (LAT), které udává signál omezení sledování reklam ze zařízení.

Další informace o resetovatelných ID zařízení pro cílení na uživatele (zahrnuje seznam podporovaných typů zařízení)

Předpoklady

Pro kreativy je potřeba nastavit šifrování HTTPS. Tento požadavek se týká jak kreativy, tak všech pixelů třetích stran, které používáte k měření konverzí. Pokud kreativy nejsou šifrovány pro HTTPS nebo pokud přepíšete automatickou kompatibilitu s protokolem SSL, makro sice hodnotou nahrazeno nebude, ale kreativy se přesto zobrazí.

Princip

1. Majitel stránek ve službě Ad Manager použije makra v kreativě nebo v měřicích adresách URL.

2. Makra se nahradí identifikátorem zařízení uživatele, typem zařízení a nastavením LAT a tyto informace budou při volání třetí strany uvedeny v kreativě.

   Pokud žádost o reklamu pochází z aplikace pro děti (TFCD) nebo je aktivované omezení sledování pro účely inzerce (LAT), makro identifikátoru se nenahradí. V těchto případech toto makro vrátí prázdný řetězec ("").

Formát

Toto makro odešle 32 hexadecimálních číslic s velkými písmeny zobrazených v pěti skupinách oddělených spojovníky ve tvaru 8-4-4-4-12. Celkem tedy 36 znaků (32 alfanumerických znaků a čtyři spojovníky).

Example: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41

Viz možné hodnoty podporovaných typů zařízení a omezení sledování pro účely inzerce (LAT).

Pomocí makra režimu náhledu v kódu vlastní kreativy můžete zajistit, aby vaše systémy backend a systémy třetích stran nepočítaly zobrazení při prohlížení náhledu. Pokud je kreativa zobrazena jako náhled ve službě Ad Manager, nahradí se makro hodnotou true, pokud se jedná o standardní zobrazení, nahradí se hodnotou false.

Makro schématu se nahradí řetězcem http: nebo https: podle schématu zabezpečení webové stránky, na které se kreativa zobrazuje. Můžete ho vložit na začátek adresy URL.

<img src=%%SCHEME%%//website.com/img/logo.gif>

Toto makro bude nahrazeno doménou parametru adresy URL ve značce reklamy (například google.com). Toto makro lze použít k úpravě kreativy v závislosti na tom, odkud požadavek pochází. Nefunguje u reklam Ad Exchange, které jsou označeny jako anonymní.

Makro zhlédnutého zobrazení službě Ad Manager umožňuje započítat zobrazení pokaždé, když se kreativa stáhne do zařízení uživatele a začne se načítat. Toto makro používejte pouze v kreativách mimo stránku.

Oznámení o zobrazení lze odeslat několika způsoby. Doporučujeme použít značku <img>:

<!-- This img tag is invisible. It makes the browser send a request to the VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">

<!-- This img tag shows the real ad.-->
<img src="[%Imagefile%]" border="0">

První značka <img> načte z adresy VIEW_URL obrázek o rozměrech 1 × 1 pixel. Styl nastavte na hodnotu "display:none", aby obrázek zůstal skrytý a neovlivnil rozvržení stránky.

Nahradí se hodnotou parametru gdpr= přidruženou k žádosti.

Nahradí se řetězcem pro transparentnost a souhlas (TC) přidruženým k žádosti. Pokud je řetězec TC prázdný nebo není platný, toto makro se nenahradí. Pomocí tohoto makra můžete předat řetězec TC externímu poskytovateli kreativ v adrese URL u neprogramatických kreativ.

Řetězec „XXXX“ nahraďte identifikátorem externího poskytovatele v globálním seznamu dodavatelů organizace IAB (IAB GVL ID). Pokud je řetězec TC prázdný nebo není platný, toto makro se nenahradí.

Jestliže externí poskytovatel přidružený k vloženému identifikátoru IAB GVL ID nemá souhlas uživatele, mohou být kreativy s makrem ${GDPR_CONSENT_XXXX} zablokovány.

Pokud je toto makro použito ve značce VAST a externí poskytovatel nemá souhlas uživatele, toto makro se nenahradí.

Makro ${GDPR_CONSENT_XXXX} by v adrese URL mělo být pouze jednou. Informujte se u svého externího dodavatele kreativ o jeho požadavcích na předávání řetězce TC a omezení délky adresy URL. V příslušných žádostech, které využívají systém IAB TCF v2.0, se toto makro nahradí úplným neupraveným řetězcem TC.

Nahradí se řetězcem dalšího souhlasu (AC), který je k žádosti přidružen.

Nahradí se hodnotou 1, která udává, že se jedná o žádost pro uživatele z EHP a Velké Británie, kteří nedosáhli věku požadovaného pro poskytnutí souhlasu.

Nahradí se trváním videoreklamy v milisekundách. U obálek/přesměrování VAST se makro nahradí dobou trvání deklarovanou ve službě Ad Manager.

Když se makro nachází v adrese URL, použijte makro %%DESCRIPTION_URL_ESC%% (s jednoduchým escapováním). V ostatních případech použijte makro %%DESCRIPTION_URL_UNESC%% (bez escapování). Další informace o makrech s escapováním a bez něj

Ve značkách reklam s přesměrováním se tato makra nahradí parametrem adresy URL popisu z parametru description_url dotazu původní značky reklamy GPT. Adresa URL popisu by se obvykle měla shodovat s adresou URL odkazující stránky. Parametr description_url byste ve značce Google Publisher Tag měli uvést v případě, že používáte vložené objekty, u kterých by sada IMA SDK nemusela správně určit adresu URL stránky, nebo pokud používáte video ve službě Ad Exchange nebo AdSense pro video.

Když se makro nachází v adrese URL, použijte makro %%REFERRER_URL_ESC%% (s jednoduchým escapováním). V ostatních případech použijte makro %%REFERRER_URL_UNESC%% (bez escapování). Další informace o makrech adres URL s escapováním a bez něj

Toto makro se ve značkách reklam s přesměrováním nahradí adresou URL odkazujícího zdroje (adresou URL stránky, na které se nachází přehrávač videí). Probíhá to takto: služba Ad Manager analyzuje parametr dotazu v adrese URL ve značce reklamy, vyhledá adresu URL odkazující stránky a dosadí ji místo textu makra. Makro funguje pouze se sadou Google IMA SDK při splnění těchto podmínek:

• Aby toto makro fungovalo, musí být na stránce povolen přístup skriptům.
• Makro nefunguje uvnitř prvků iframe.

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

Místo tohoto makra se dosadí ID videoobsahu, který se právě přehrává. Jedná se o jedinečný identifikátor v systému CMS nebo o hodnotu dfpvideo:ContentID prvku MRSS v Řešení pro práci s videoreklamami. 

Místo tohoto makra se dosadí metadata o videu, ve kterém se kreativa zobrazuje, založená na párech klíč–hodnota přidružených k videoobsahu. Páry klíč–hodnota jsou nastaveny ve službě Ad Manager na kartě Video. 

Po zacílení na klíč metadat videa lze hodnotu tohoto klíče dosadit pomocí makra metadat videa. Klíč použitý v makru smí obsahovat pouze alfanumerické znaky a podtržítko (_).

Makro názvu videa se nahradí názvem videa definovaným ve službě Ad Manager.

Ke správnému fungování tohoto makra je potřeba zpracování obsahu. 

ID zdroje obsahu se používá k cílení videoreklam.

Pomocí parametru ID zdroje obsahu a ID videa se předávají proměnné hodnoty.

Aby bylo možné cílit reklamy na videoobsah, musí značka hlavního videa obsahovat oba tyto parametry.

Parametr cmsid je pro každý zdroj obsahu jedinečné číslo. Ve službě Ad Manager ho najdete tak, že kliknete na Video, poté na Zdroje obsahu a poté na název zdroje. Přečtěte si další informace o zpracování videoobsahu pomocí zdrojů Media RSS (MRSS).

Parametr vid je řetězec nebo číslo, které označuje konkrétní video. Toto ID je přidělováno systémem CMS, ve kterém je obsah hostován. Ve službě Ad Manager ho najdete tak, že kliknete na Video, poté na Obsah a poté na konkrétní videoobsah.

Pokud vytváříte značku pro dynamické vkládání reklam do videí na vyžádání, měli byste použít makra, která dynamicky vloží správný zdroj obsahu a ID videa: 

Nahradí se vlastním ID reklamy FreeWheel.

Toto makro se týká pouze majitelů stránek, kteří k zobrazování videoreklam používají službu FreeWheel.

Slouží k předávání kategorií reklam pro kreativy, které jste ručně klasifikovali pomocí štítků. Toto makro vrací čárkami oddělený seznam všech příslušných standardních kategorií IAB (převedených z kategorií klasifikovaných společností Google).

Toto makro mohou použít majitelé stránek, kteří sdílí inventář videí se službou FreeWheel a chtějí jako vlastní parametry předávat kategorie reklam. Do značky přesměrování VAST byste například mohli přidat &iab_categories=%%IAB_CATEGORIES%%.