Makra jsou speciální řetězce v kódu kreativ. Služba Ad Manager později tyto řetězce na základě nastavení kreativy nahradí jinou hodnotou nebo kódem. Makra jsou užitečná, protože pomocí nich můžete provádět změny, aniž byste museli aktualizovat přímo kód kreativy – stačí aktualizovat hodnotu, na kterou makro odkazuje.
Pro každé makro poskytujeme návrhy použití. Můžete je však využít libovolným způsobem, který se vám nejlépe hodí. Makra je možné zahrnout v libovolném kódu, který je během procesu zobrazení zpracováván reklamním serverem: v kódu kreativy třetí strany i v kódu vlastní kreativy, v kódu služby Studio, v cílových adresách URL nebo ve značkách reklam.
Důležité poznámky ohledně maker
- Rozlišování velkých a malých písmen
V makrech se rozlišují velká a malá písmena. Použijte řetězec%%CACHEBUSTER%%, nikoliv%%Cachebuster%%. - Nahrazení s escapováním a bez něj
Verze maker s escapováním a bez něj se nahrazují jinak. Přečtěte si, jak používat makra s escapováním a bez něj. - Vložení makra
V případě kreativ třetích stran a adres URL značek VAST platí, že pokud služba Ad Manager třetí stranu rozpozná, vloží makra automaticky. U vlastních kreativ a šablon kreativ je makra potřeba přidat ručně. Pokud si nejste jistí, kam makro umístit, kontaktujte dodavatele kreativy.
Při konfiguraci reklam pomocí šablony kreativy bude pole Cílová adresa URL k dispozici pouze v případě, že je v šabloně použito makro kliknutí. - Vyhrazené znaky a kódování adres URL (kódování pomocí procent)
Některá malá písmena uvozená znakem procenta jsou vyhrazena pro službu Ad Manager:%a
%c
%h
%i
%n
%p
%kTyto řetězce v kódování adres URL nesmíte používat, protože by mohly narušovat nahrazení maker hodnotami.
- Makra nejsou podporována u přímého programatického obchodování
Viz funkce dostupné u přímého programatického obchodování.
Přeskočte na konkrétní makro v seznamu
Makra vykreslení
Makra vykreslení se obvykle používají k vykreslení kreativ a zajišťují, aby vypadaly a fungovaly správně.
Reklamní jednotka| Makro |
|---|
%%ADUNIT%% |
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:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
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://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Toto makro funguje pouze pro schválené navrhované reklamní jednotky. Pokud je navrhovaná reklamní jednotka na třetí úrovni, toto makro se při použití ve fragmentu kreativy nahradí pouze reklamní jednotkou druhé úrovně. Jakmile bude navrhovaná reklamní jednotka schválena, nahradí se makro ve fragmentu kreativy reklamní jednotkou třetí úrovně.
| Makro | Escapování |
|---|---|
%%DEST_URL_ESC%% |
S escapováním |
%%DEST_URL_ESC_ESC%% |
S dvojitým escapováním |
%%DEST_URL_UNESC%% |
Bez escapování |
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%%).
%%DEST_URL%%, které funguje úplně stejně, jako makro %%DEST_URL_ESC%%. Z důvodu srozumitelnosti doporučujeme používat makro %%DEST_URL_ESC%%, starší kreativy a šablony však není nutné měnit.%u nebo %%DEST_URL%%, budete po kliknutí na kreativu přesměrováni na adresu xsd:string. Maximální délka je 1024 znaků.| Makro |
|---|
%%FILE:file_display_name%% |
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.
| Makro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
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.
| Makro |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
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í.
Escapování v makru shody se vzorem
Makro shody se vzorem vrací hodnotu tak, jak ji obdrželo. Pokud makro používáte v některém z polí adresy URL, například v poli „Adresa URL značky VAST“ nebo „Měřicí adresa URL třetí strany“ ve videokreativě, je možné, že byste ve vrácené hodnotě chtěli mít zvláštní znaky escapované. K dosažení tohoto výsledku je třeba hodnotu v žádosti escapovat třikrát.
%%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:
- 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"); - Ve vlastní kreativě nebo kreativě třetí strany předejte vlastní hodnotu (pohlaví uživatele) dynamicky pomocí tohoto makra:
<skript kreativy>...&gender=%%PATTERN:gender%% - Celé makro
%%PATTERN:gender%%bude nahrazeno hodnotou „male“. - 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();
Pomocí tohoto makra můžete nastavit značku passback mezi dvěma sítěmi Ad Manager (síť A a síť B).
Zde je vzorová kreativa zarezervovaná v síti A:
<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
.setTargeting("myAdUnit", "%%ADUNIT%%")
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.display();
</script>
Pokud síť B nemá žádnou prodanou kampaň, kterou by mohla zobrazit, může zobrazení předat zpět síti A pomocí kreativy passback, jako je například tato:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // to avoid infinite loops
.display();
</script>Makro TARGETINGMAP můžete použít také ve značce passback, která se odešle v žádosti na reklamní server třetí strany, což umožňuje použít v dynamické kreativě několik hodnot.
Zde je vzorová kreativa zarezervovaná ve službě Ad Manager:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>
Při zobrazení službou Ad Manager se makra nahradí takto:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>
Třetí strana má nyní přístup k dynamicky generovaným parametrům dfpAdUnit a targeting a může vytvořit tuto značku passback:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
.setTargeting("kw", "noloop") // to avoid infinite loop (see https://support.google.com/admanager/answer/2811375)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
Za tímto účelem může třetí strana obdržet šablonu kódu, která vypadá nějak takto:
myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
callback = function() {
googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
.setTargeting("kwd", "noloop")
.updateTargetingFromMap(myTargetingObject)
.display();
};
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(callback);
document.write('</sc'+'ript>'); %%PATTERN:url%%
Adresu URL odkazující stránky můžete vložit také pomocí vyhrazeného klíče url.
Hodnota url je vyhrazený klíč. 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 |
|---|
%%TAG_PARAM%% |
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:
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 |
|---|
%%TARGET_IN_NEW_WINDOW%% |
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 hodnotou1. -
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 |
|---|
%%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%%.
| Makro |
|---|
%%TFCD%% |
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 |
|---|
[%URI_ENCODE:variable%] |
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.
Příklad
Řekněme, že šablona kreativ obsahuje proměnnou typu seznamu z názvem Color (Barva) a dvěma hodnotami: „dark blue“ (tmavě modrá) a „light green“ (světle zelená). Ve výchozím nastavení služba Ad Manager do fragmentu šablony kreativ přidá zástupný symbol [%Color%]:
<a href="https://paint.com/wall.html?color=[%Color%]">Paint!</a>
Při vytvoření kreativy nahradí služba Ad Manager zástupný symbol [%Color%] textovým řetězcem z vybrané položky seznamu. Textové řetězce v tomto případě obsahují mezery a způsobí, že adresa URL nebude fungovat, protože mezery je nutné escapovat. Pokud se tomuto problému chcete vyhnout, použijte kód [%URI_ENCODE:Color%].
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Paint!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
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.
Příklad
Předpokládejme, že šablona kreativ obsahuje proměnnou typu adresy URL s názvem LandingPage (Vstupní stránka). Ve výchozím nastavení služba Ad Manager do fragmentu šablony kreativy přidá zástupný symbol [%LandingPage%]:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Click here!</a>
Pokud adresa URL [%LandingPage%] obsahuje parametry dotazu, například ?page=home&sport=baseball, bude adresa URL chybná a nebude fungovat tak, jak by měla. Obsah za ampersandem (&) bude v tomto případě přiřazen k celé adrese URL, nikoliv k adrese URL přesměrování. Tomuto problému předejdete použitím makra [%URI_ENCODE:LandingPage%].
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Click here!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Měřicí makra
Tato makra se nejčastěji používají k měření a vytváření přehledů.
Vynechání mezipaměti (náhodné číslo)| Makro |
|---|
%%CACHEBUSTER%% |
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%%
měřič zobrazení služby Campaign Manager 360, vyberte standardní značku reklamy a vložte do ní makro CACHEBUSTER. Snížíte tak míru nesrovnalostí.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
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 | Escapování |
|---|---|
%%CLICK_URL_UNESC%% |
Bez escapování |
%%CLICK_URL_ESC%% |
S escapováním |
%%CLICK_URL_ESC_ESC%% |
S dvojitým escapováním |
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://www.google.com">link</a>
<a href="http://www.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.
- Podívejte se na náhled kreativy.
- 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ě.
| Makro | Čím bude nahrazeno |
|---|---|
%eaid! |
ID řádkové položky |
%eadv! |
ID inzerenta pro zobrazovanou řádkovou položku |
%ebuy! |
ID objednávky pro zobrazovanou řádkovou položku |
%ecid! |
ID kreativy |
%eenv! |
Indikátor prostředí (typu značky): i pro iframe, j pro JavaScript |
%epid! |
ID reklamní jednotky, ve které se řádková položka zobrazuje |
%esid! |
ID reklamní jednotky nejvyšší úrovně, ve které se řádková položka zobrazuje
Toto makro je starší a nemusí ve vaší síti fungovat podle očekávání.
|
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://www.site.com/?%eaid!;%ecid! například po nahrazení vznikne adresa http://www.site.com/?1234567;4265598.
| Makro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (identifikátor zařízení) |
%%ADVERTISING_IDENTIFIER_TYPE%% (typ zařízení) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (nastavení omezení sledování pro účely inzerce) |
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í)
Požadavky
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
- Majitel stránek ve službě Ad Manager použije makra v kreativě nebo v měřicích adresách URL.
-
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).
Příklad: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Viz možné hodnoty podporovaných typů zařízení a omezení sledování pro účely inzerce (LAT).
| Makro |
|---|
%%PREVIEW_MODE%% |
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 |
|---|
%%SCHEME%% |
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%%//www.website.com/img/logo.gif>
| Makro |
|---|
%%SITE%% |
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 | Escapování |
|---|---|
%%VIEW_URL_ESC%% |
S escapováním |
%%VIEW_URL_UNESC%% |
Bez escapování |
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.
Makra žádostí o reklamy pro GDPR
Tato makra se nejčastěji používají se žádostmi o reklamy, na které se vztahuje nařízení GDPR.
GDPR| Makro |
|---|
${GDPR} |
Nahradí se hodnotou parametru gdpr= přidruženou k žádosti.
| Makro |
|---|
${GDPR_CONSENT_XXXX} |
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.
Makra systému Transparency and Consent Framework (TCF) implementovaná v kódu HTML kreativ HTML5 se nenahrazují hodnotami. Nahrazení maker TCF pomocí polí Adresa URL třetí strany a Kód HTML je podporovováno pouze u přesměrovaných obsahových kreativ a u vlastních obsahových kreativ.
| Makro |
|---|
${ADDTL_CONSENT} |
Nahradí se řetězcem dalšího souhlasu (AC), který je k žádosti přidružen.
| Makro |
|---|
%%TFUA%% |
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.
Makra videí
Tato makra se běžně používají ve videokreativách k uvedení podrobností o kontextu nebo obsahu.
Trvání videoreklamy v milisekundách| Makro |
|---|
%%VIDEO_AD_DURATION%% |
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.
| Makro | Escapování |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Bez escapování |
%%DESCRIPTION_URL_ESC%% |
S escapováním |
%%DESCRIPTION_URL_ESC_ESC%% |
S dvojitým escapováním |
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.
%%DESCRIPTION_URL%%, které funguje stejně jako makro %%DESCRIPTION_URL_UNESC%%. Starší kreativy a šablony proto není potřeba měnit.| Makro | Escapování |
|---|---|
%%REFERRER_URL_UNESC%% |
Bez escapování |
%%REFERRER_URL_ESC%% |
S jednoduchým escapováním |
%%REFERRER_URL_ESC_ESC%% |
S dvojitým escapováním |
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.
%%REFERRER_URL%%, které funguje stejně jako makro %%REFERRER_URL_UNESC%%. Starší kreativy a šablony proto není potřeba měnit.Makra videoobsahu
Tato makra se používají pro reklamy, které cílí na zdroje videoobsahu.
| Makro |
|---|
%%VIDEO_DURATION%% |
Nahradí se trváním videa v milisekundách.
| Makro |
|---|
%%VIDEO_ID%% |
Místo tohoto makra se dosadí ID videoobsahu, který se právě přehrává. Jedná se o jedinečné ID v systému CMS nebo o hodnotu dfpvideo:ContentID ze zdroje MRSS.
| Makro |
|---|
%%VIDEO_METADATA:key%% |
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 | Escapování |
|---|---|
%%VIDEO_TITLE%% |
S jednoduchým escapováním |
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.
| Makro |
|---|
%%FW_CAID%% |
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.
| Makro |
|---|
%%IAB_CATEGORIES%% |
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%%.
