A makrók speciális karakterláncok a kreatívkódban. Az Ad Manager utólag, a kreatív beállításai alapján másik értékre vagy kódra cseréli le ezt a karakterláncot. A makrók azért hasznosak, mert Önnek nem kell közvetlenül frissítenie a kreatív kódját, ha módosításokat kell végeznie – elég frissítenie a makróhivatkozást.
Minden egyes makróhoz használati javaslatokat fűztünk, de bárhol használhat makrókat, ahol segítséget nyújtanak Önnek. A hirdetésszerver által a megjelenítés során feldolgozott bármilyen kódban szerepelhetnek makrók: harmadik féltől származó vagy egyéni kreatívkódban, Studio-kódban, átkattintási URL-ekben, valamint hirdetési címkékben.
Fontos megjegyzések a makrókkal kapcsolatban
- Kis- és nagybetűk megkülönböztetése
A makrók megkülönböztetik a kis- és nagybetűket. A%%CACHEBUSTER%%makrót használja, ne a%%Cachebuster%%makrót. - A nem megtisztított és a megtisztított kibontás
A nem megtisztított és a megtisztított makróverziók másképpen bonthatók ki. További információ a megtisztított és a nem megtisztított makrók használatáról. - Makróbeillesztés
A harmadik féltől származó kreatívok vagy a VAST-címke URL-jeinek esetében az Ad Manager automatikusan beilleszti a makrót, ha felismeri az adott harmadik felet. Az egyéni kreatívok és a kreatívsablonok esetében manuálisan kell megadnia a makrókat. Ha nem biztos abban, hol kellene elhelyeznie az adott makrót, forduljon a kreatívot biztosító szolgáltatóhoz.
Kreatívsablonnal végzett hirdetésforgalmazás esetén az átkattintási URL beviteli mezője csak akkor jelenik meg, ha kattintási makrót használt a sablonban. - Fenntartott karakterek és URL-kódolás (százalékkódolás)
Az Ad Manager fenntart bizonyos kisbetűket, amelyek előtt százalékjel látható:%a
%c
%h
%i
%n
%p
%kEzeket a karakterláncokat nem szabad URL-kódolásban használni, mivel zavarhatják a makrókibontást.
- A makrók nem támogatottak közvetlen, automatizált kapcsolatnál
Tekintse át a közvetlen, automatizált kapcsolatnál rendelkezésre álló funkciókat.
Ugrás adott makróra a listában
Az összes kibontása Az összes összecsukása
Megjelenítési makrók
Ezeket a makrókat a kreatívok megjelenítésénél szokták használni. Ezek biztosítják a megfelelő megjelenést és működést.
Hirdetési egység| Makró |
|---|
%%ADUNIT%% |
A hirdetési egység makrója a hirdetési egységnek a Google megjelenítői címkében lévő útvonalát beszúrja a kreatívkódba annak megjelenítésekor.
A következőképpen adhatja hozzá az ADUNIT makrót harmadik féltől származó kreatívkódhoz:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
A hirdetési egység makrója kibővül a hirdetési egység teljes elérési útjára, amely az eredeti hirdetési kérelemben szerepel, és tartalmazza a hálózati kódot is. Íme egy példa arra, hogy a hirdetési egység elérési útja hogyan bővül ki, amikor a hirdetés megjelenik:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Ez a makró csak jóváhagyott javasolt hirdetési egységekkel működik. Ha a javasolt hirdetési egység a harmadik szinten van, akkor a makró kreatív-kódrészletben való használat esetén csak a második szintű hirdetési egységre bontható ki. A javasolt hirdetési egység jóváhagyása után a makró a harmadik szintű hirdetési egységre bontódik ki a kreatív-kódrészletben.
| Makró | Megtisztítás |
|---|---|
%%DEST_URL_ESC%% |
Megtisztított |
%%DEST_URL_ESC_ESC%% |
Kétszeresen megtisztított |
%%DEST_URL_UNESC%% |
Nem megtisztított |
A cél-URL-makró a kreatív átkattintási URL-címére bővül, amely vagy az adott sor átkattintási URL-je, vagy egy felülbírálási készlet a sorban szereplő kreatívhoz.
A cél-URL-makró az egyéni hirdetéseknél és a hirdetéssablonoknál hasznos. Ha a hirdetéskódban szerepelnie kell a hirdetés átkattintási URL-jének, és ez az átkattintási URL megváltozik a hirdetések vagy sablonok különböző sorokban való használatával, akkor ezt a makrót érdemes használni.
Három átkattintási URL-makró létezik: megtisztított, kétszeresen megtisztított és nem megtisztított. A megtisztítás mértéke (hogy az „ESC” elem egyszer, kétszer vagy egyszer sem szerepel) jellemzően a külső kattintáskövetési cégtől függ. Egyes külső kattintáskövetési cégek megkövetelik az URL megtisztítását, míg mások nem. A megtisztítás szükséges mértékét általában a click= karakterláncot tartalmazó címkében adják meg a harmadik fél hirdetési címkéjében vagy az Ad Manageren belül az egyéni kreatívkódban:
-
click=: Egyszeres megtisztítás (%%DEST_URL_ESC%%). -
click0=: Nincs megtisztítás (%%DEST_URL_UNESC%%). -
click1=: Egyszeres megtisztítás (%%DEST_URL_ESC%%). -
click2=: Kétszeres megtisztítás (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%% makrót is támogatja, amely ugyanúgy működik, mint a %%DEST_URL_ESC%%. Az egyértelműség kedvéért a %%DEST_URL_ESC%% használatát javasoljuk, de nem szükséges újrakódolni a régebbi hirdetéseket és sablonokat.%u vagy %%DEST_URL%% makrót tartalmaz, a rendszer az xsd:string URL-re irányítja át, amikor a kreatívra kattint. Maximális hossza 1024 karakter lehet.| Makró |
|---|
%%FILE:file_display_name%% |
A %%FILE:file_display_name%% fájlmegjelenítési makró a kreatívhoz feltöltött kreatívtartalomnak a teljes URL-címére bővül. E makró segítségével egyéni kreatívkóddal hívhat meg feltöltött tartalmakat, például képeket.
A makró használatához cserélje le a file_display_name részt a kreatívtartalom megjelenítési nevére, ahogyan az az Ad Managerben a kreatív részleteinél látható.
| Makró |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Ezek a makrók illesztik be az Ad Managerben a kreatív „Hirdetési egység mérete” mezőben megadott értéknek megfelelő magasságát és szélességét a kreatív egyéni kódjába a hirdetésmegjelenítési folyamat során.
Akkor különösen hasznosak a magassági és szélességi makrók, ha olyan hirdetési sablont hoz létre, amelyet különböző méretű hirdetéseknél is szeretne felhasználni. Ahelyett, hogy minden kreatívnál meg kellene adnia a méretet, a magassági és szélességi makrók minden egyes kreatív esetében dinamikusan beillesztik az értékeket.
| Makró |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
A mintaillesztő makró használatával egyéni változókat, például célzási értéket adhat át a kreatívnak. A makró használatával kulcsértékeket adhat át, módosíthatja a teljes célzási karakterláncot, illetve kibővítheti a hivatkozó URL-t. Ez főleg akkor hasznos, ha a felhasználóra vonatkozó információk, például a tartalmi preferenciái alapján különböző hirdetéseket szeretne megjeleníteni.
A mintaillesztő makró kreatívonként legfeljebb 100 módosításra alkalmas.
A mintaillesztő makró megtisztítása
A mintaillesztő makró úgy adja vissza az értéket, ahogy kapta. Ha a makrót az egyik URL-mezőben, például a videókreatív „VAST címke URL-je” vagy „Harmadik féltől származó nyomkövetési URL” mezőjében használja, akkor előfordulhat, hogy megtisztítva szeretné visszaküldeni a kibontott értéket. Ehhez háromszorosan kell megtisztítania az értéket a kérelemben.
%%PATTERN:key%%
Lehetséges például, hogy két hirdetése van egy adott sorhoz, és az egyiket a nőknek, a másikat a férfiaknak szánja. A makróban használt „kulcs” csak alfanumerikus karaktereket és aláhúzásjelet (_) tartalmazhat.
Íme a folyamat:
- Az egyéni értéket (jelen esetben a felhasználó nemét) kulcsértékek használatával adhatja át az oldalon lévő hirdetési címkének:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - Egyéni és harmadik féltől származó kreatívokban dinamikusan adja át az egyéni értéket (a felhasználó nemét) a következő makró használatával:
<ide jön a kreatív szövege>...&gender=%%PATTERN:gender%%. - A teljes
%%PATTERN:gender%%makró arra fog kicserélődni, hogy„male”. - Az Ad Manager az ilyen felhasználók esetében a „male” kreatívfájlt hívja és jeleníti meg.
%%PATTERN:TARGETINGMAP%%
A %%PATTERN:TARGETINGMAP%% makróval módosíthatja a teljes célzási térképet, valamint dinamikusan létrehozhat visszaküldési címkéket is.
A következőképpen adhatja hozzá a TARGETINGMAP makrót a hirdetési címkékhez:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Példa a teljes kulcsérték-karakterláncra a hirdetés megjelenítésekor:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
Ezzel a makróval állíthat be visszaküldési címkét két Ad Manager-hálózat között („A hálózat” és „B hálózat”).
Példa egy kreatívra, amelyet az „A” Ad Manager-hálózatban foglaltak le:
<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>
Amennyiben a „B” Ad Manager-hálózatnak nincs megjeleníthető értékesített kampánya, visszaküldési kreatív használatával visszaadhatja a megjelenítést az „A” hálózatnak, például:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // a végtelen hurkok elkerülésére
.display();
</script>A harmadik fél hirdetésszerverének elküldött kérelem visszaküldési címkéjében a TARGETINGMAP makrót is használhatja, így egy dinamikus kreatívban több érték is szerepelhet.
Példa Ad Managerben lefoglalt kreatívra:
<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>
Ha az Ad Manager jeleníti meg, akkor kibővül a következőre:
<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>
A harmadik fél hozzáfér a dinamikusan létrehozott „dfpAdUnit” és „targeting” paraméterekhez, így elő tudja állítani a következő visszaküldési címkét:
<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") // a végtelen hurkok elkerülésére (see https://support.google.com/admanager/answer/2811375)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
A végrehajtáshoz a harmadik fél kaphat egy sablonkódot, amely a következőképpen néz ki:
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%%
Az url fenntartott kulcs a hivatkozó oldal URL-jévé is kibővülhet.
Vegye figyelembe, hogy az url fenntartott kulcs. Bármely olyan, az Ön Campaign Manager 360-címkéiben szereplő kulcsérték, amely az url kulcsnevet használja, felülíródik a hivatkozó URL-lel.
| Makró |
|---|
%%TAG_PARAM%% |
A címkeparaméter makró más hirdetésicímke-paraméterekkel együtt használatos, és csak a következő paraméterekkel használható:
Amennyiben támogatott, a paraméter értékére bővül.
Például a %%TAG_PARAM:correlator%% (támogatott) a hirdetési címkéből származó korrelátor értékére bővül, a %%TAG_PARAM:ppid%% (nem támogatott) azonban nem bővül ki semmilyen értékre.
| Makró |
|---|
%%TARGET_IN_NEW_WINDOW%% |
A cél új ablakban makró azt jelzi, hogy „_blank” (új ablak) vagy más érték-e a kreatívot megjelenítő hirdetési egységnél meghatározott célablak-beállítás.
-
Ha a célablak értéke
_blank, akkor a makró a következőre bővül:1. -
Ha a célablaknál bármilyen más érték szerepel, illetve ha nincs megadva célablak, a makró a következőre bővül:
0.
Akkor használja a %%TARGET_WINDOW%% makrót, ha be szeretné szúrni a célablak beállításának tényleges értékét.
| Makró |
|---|
%%TARGET_WINDOW%% |
A célablak makró a kreatívot megjelenítő hirdetési egységhez meghatározott célablakká bővül. A makrót egy adott kreatív kódjában arra használhatja, hogy megadja a következőt: a kreatívra történő kattintás egy új ablakba navigálja a felhasználót, vagy ugyanabban az ablakban tölti be a céloldalt (azoknak a webhelyeknek a beállításától függően, ahol a felhasználók láthatják a hirdetést).
Tegyük fel például, hogy az AdManager_News.com hirdetési egység célablakának beállítása _top, az AdManager_Fashion.com hirdetési egységé pedig _new. Ha a %%TARGET_WINDOW%% makró szerepel a kreatív kódjában, akkor az AdManager_News.com felhasználói számára _top értékkel, míg az AdManager_Fashion.com felhasználói számára _new értékkel bővül.
Íme egy lehetséges megvalósítás:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Akkor használja a %%TARGET_IN_NEW_WINDOW%% makrót, ha meg szeretné határozni, hogy a célablak beállításának értéke „_blank” vagy más legyen-e.
| Makró |
|---|
%%TFCD%% |
A gyermekeket megszólító tartalom címkéje (Tag For Child-Directed Content, TFCD) lehetővé teszi, hogy harmadik felek tudomására hozza, amennyiben egy adott hirdetési kérelem gyermekeket megszólító tartalmú oldalról érkezik. A makró célja, hogy segítsen az Amerikai Egyesült Államok gyermekek online adatvédelméről szóló törvénye (Children’s Online Privacy Protection Act, COPPA) előírásainak való megfelelésben.
A makrót a coppa=%%TFCD%% vagy ehhez hasonló formátumban bármelyik átirányításban, illetve harmadik felek hirdetéseinek kérelmeiben is szerepeltetheti. Használható továbbá JavaScriptben is a GPT visszaküldési címkék iránti kérelmek gyermekeket megszólítóként való beállításához. A makró gyermekeket megszólító tartalom esetén az 1-es értéket, más tartalmak esetén pedig a 0 értéket veszi fel (az Ad Managernek kérést küldő oldal, webhely vagy mobilalkalmazás jellege alapján).
Ha a Google hirdetési szolgáltatásait használja, és webhely- vagy alkalmazásszinten szeretné használni a gyermekeket megszólítóként való kezelést, kérjük, tekintse át a Webhely vagy alkalmazás gyermekeket megszólítóként való megcímkézése című cikkünket.
| Makró |
|---|
[%URI_ENCODE:variable%] |
Az URI-kódolási makró a kreatívsablon változó értékeiben lévő szóközöket és más speciális karaktereket helyesen alakítja át az URI-kben, vagyis az URL-ekben történő használat céljából.
Példa
Tegyük fel, hogy rendelkezik egy „Color” (szín) nevű „list” változóval, amely a következő két értéket veheti fel: „dark blue” (sötétkék) és „light green” (világoszöld). Az Ad Manager alapértelmezés szerint hozzáadja a [%Color%] változót a kreatívsablon kódrészletéhez:
<a href="https://paint.com/wall.html?color=[%Color%]">Váltson színt!</a>
A kreatív létrehozásakor az Ad Manager a [%Color%] részt lecseréli a kiválasztott listaelem tényleges szöveges karakterláncára. Ebben a példában a tényleges szöveges karakterláncok szóközöket tartalmaznak, amelyek működésképtelenné tehetik az URL-t, ugyanis ezeket kódolni kell. A probléma elkerülése érdekében használja az [%URI_ENCODE:Color%] változót.
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Váltson színt!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Ez a makró különösen hasznos akkor, ha kreatívsablon-változó használatával szeretné meghatározni az átkattintási vagy az átirányítási URL-t. A megfelelő kódolás nélkül előfordulhat, hogy a kreatívban lévő teljes URL nem fog működni.
Példa
Tegyük fel, hogy a kreatívsablonban van egy „LandingPage” (céloldal) nevű „URL” változó. Az Ad Manager alapértelmezés szerint hozzáadja a [%LandingPage%] változót a kreatívsablon kódrészletéhez:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Kattintson ide!</a>
Ha a [%LandingPage%] URL lekérdezési paramétereket (pl. ?page=home&sport=baseball) tartalmaz, akkor rosszul formázottnak minősíti a rendszer, és nem fog megfelelően működni az átirányítás. Ebben a példában az „és” jel (&) utáni tartalom a teljes URL, nem pedig az átirányítási URL attribútuma lesz. A probléma elkerülése érdekében használja az [%URI_ENCODE:LandingPage%] változót.
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Kattintson ide!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Követési makrók
Ezeket a makrókat leggyakrabban követési és jelentési céllal használják.
Cachebuster (véletlen szám)| Makró |
|---|
%%CACHEBUSTER%% |
A megjelenítések pontos számolása érdekében a cachebuster makró biztosítja, hogy minden kódvégrehajtáskor friss hívás történjen a hirdetésszerver felé. Ha nem adja hozzá a cachebuster makrót a kreatívkódhoz, akkor nagyobb valószínűséggel tapasztal majd eltéréseket a Google Ad Manager és a harmadik fél hirdetésszervere által számolt megjelenítésekben. A cachebuster makrót nem minden harmadik fél követeli meg.
A legtöbb hirdetésszolgáltató kínál helyőrzőt a címkéjében cachebuster makró beillesztése céljából. Tegyük fel például, hogy a harmadik fél kreatívkódja ehhez hasonlót tartalmaz:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
Ebben az esetben érdemes kiválasztania a [RANDOM_NUMBER] elemet, majd rákattintania a Cachebuster makró beillesztése lehetőségre, hogy a helyőrző helyére a makró kerüljön:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER makró beszúrásával csökkentheti az eltérések mértékét.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
A cachebuster makró VAST-válaszokban
A %%CACHEBUSTER%% makró egy adott kreatívban az összes eseménynél ugyanarra a véletlen számra bontható ki. Ez kifejezetten hasznos a videóhirdetések esetében, mivel a makró a VAST-válaszokban minden videókövetési eseménynél ugyanarra a véletlen számra bővül ki.
| Makró | Megtisztítás |
|---|---|
%%CLICK_URL_UNESC%% |
Nem megtisztított |
%%CLICK_URL_ESC%% |
Megtisztított |
%%CLICK_URL_ESC_ESC%% |
Kétszeresen megtisztított |
A kattintási makró speciális URL-re bővül ki, így Ön nyomon tudja követni az Ad Managerben a harmadik féltől származó kreatívokra leadott kattintásokat. Ehhez a makróhoz általában a kreatív átkattintási URL-je társul a horgonycímkében (<a>). Ne adja meg a kattintási makrót kép vagy iframe forrásaként. Ha így tesz, akkor a rendszer a kép vagy iframe minden egyes megjelenítésekor rögzít egy kattintást, ami nem szabályszerű, és érvénytelen kattintásnak minősül.
Link elején használja a %%CLICK_URL_UNESC%% verziót. Ha a kattintáskövető egy másik URL paramétere, akkor a %%CLICK_URL_ESC%% verziót használja.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">link</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">link</a>
További információ a megtisztított és nem megtisztított makrókról.
A kattintási makró megvalósításának ellenőrzése
A helytelenül elhelyezett kattintási makró nem fogja követni a kattintásokat. Az alábbi lépések végrehajtásával győződhet meg arról, hogy az Ad Manager az elvártak szerint fogja rögzíteni a kattintásokat.
- Tekintse meg a kreatív előnézetét.
- Kattintson az előnézetre.
Az Ad Manager visszaigazolja, hogy rögzítette a kattintást. Ha nem látja a visszaigazoló üzenetet, akkor helytelenül valósította meg a kattintási makrót.
| Makró | Mivé bővül ki? |
|---|---|
%eaid! |
Sor azonosítója |
%eadv! |
A megjelenített sor hirdetői azonosítója |
%ebuy! |
A megjelenített sor rendelési azonosítója |
%ecid! |
Kreatív azonosítója |
%eenv! |
Környezeti (címketípus) jelző: i iframe-nél, j JavaScriptnél |
%epid! |
A hirdetési egység azonosítója, ahol a sor megjelenik |
%esid! |
A legmagasabb szintű hirdetési egység azonosítója azon hirdetési egység felett, ahol a sor megjelenik
Ez egy régi makró, és lehetséges, hogy az Ön hálózatán nem megfelelően működik.
|
A kibontási makrókat egyéni kreatívkódban vagy átkattintási URL-ben használja az Ad Managerből származó azonosítók megjelenítésére, amikor kreatívokat jelenít meg az oldalon. Ezt gyakran használják arra, hogy hibaelhárítási vagy egyéb jelentéskészítési céllal egyeztessék az Ad Managerből származó azonosítókat a megjelenítő saját adatbázisában lévő azonosítókkal.
A kibontási makrókat az Ad Manager átkattintási URL-ekben biztonságosan használható bármely karakterrel el lehet választani egymástól az átkattintási URL-ben. Például a http://www.site.com/?%eaid!;%ecid! a következővé bővülhet ki: http://www.site.com/?1234567;4265598.
| Makró |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (az eszköz azonosítója) |
%%ADVERTISING_IDENTIFIER_TYPE%% (az eszköz típusa) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (a Hirdetéskövetés korlátozása beállítás) |
Az %%ADVERTISING_IDENTIFIER_PLAIN%% makró lehetővé teszi az alkalmazáson belüli megjelenítők számára visszaállítható eszközazonosító küldését a hirdetési partnereknek érdeklődésen alapuló hirdetések megjelenítése céljából. Ezáltal könnyebben adhat hozzáférést a hirdetőknek és az ügynökségeknek a visszaállítható eszközazonosítókhoz.
Az alkalmazáson belüli megjelenítők ezenkívül az %%ADVERTISING_IDENTIFIER_TYPE%% makróval küldhetik el az eszköz típusát, míg az %%ADVERTISING_IDENTIFIER_IS_LAT%% makróval küldhetik el a Hirdetéskövetés korlátozása (LAT) beállítást, amely az eszközről származó „Hirdetéskövetés korlátozása” jelet jelzi.
További információ a visszaállítható eszközazonosítók felhasználócélzáshoz való használatáról, ami a támogatott eszköztípusokat is tartalmazza.
Előfeltételek
Állítsa be a HTTPS-titkosítást a kreatívoknál. Ez mind a kreatívok, mind a konverziókövetésre használt bármely harmadik féltől származó képpont esetében követelmény. Amennyiben nem titkosítja a kreatívokat a HTTPS használatához, vagy ha felülbírálja az automatikus SSL-kompatibilitást, a makró nem bontja ki az értéket, a kreatívok azonban továbbra is meg fognak jelenni.
Hogyan működik?
- A megjelenítő belefoglalja a makrókat a kreatív/nyomkövetési URL-jeibe az Ad Managerben.
-
A makrók kibomlanak, hogy megkapják a felhasználó eszközazonosítóját, az eszköztípust és/vagy a LAT-beállítást, amelyek aztán bekerülnek a kreatívba, ahogy meghívják a harmadik felet.
Az azonosító makró nem bővül ki, ha a hirdetéskérelem gyermekeknek készített alkalmazásból (TFCD) érkezik, vagy ha a hirdetéskövetés korlátozása (Limit Ad Tracking, LAT) funkció be van kapcsolva. A makró ilyen esetekben üres karakterláncot ("") küld vissza.
Formátum
Ez a makró 32 nagybetűs hexadecimális karaktert küld vissza öt csoportra felosztva, kötőjelekkel elválasztva, 8-4-4-4-12 eloszlásban, összesen 36 karaktert lefedve (32 alfanumerikus karakter és négy kötőjel).
Példa: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Tekintse meg a támogatott eszköztípusok és a hirdetéskövetés korlátozása (Limited Ad Tracking, LAT) funkció lehetséges értékeit.
| Makró |
|---|
%%PREVIEW_MODE%% |
Az előnézet mód makrót az egyéni kreatívkódban használhatja, hogy megakadályozza az előnézeti megjelenítések kiszolgálóoldali vagy harmadik felektől származó rendszerek általi számlálását. A makró true értékre bővül, ha a kreatív megtekintése Ad Manager-előnézetként történik, és false értékre, ha szokásos megjelenítés.
| Makró |
|---|
%%SCHEME%% |
A séma makró http: vagy https: formára bővül attól függően, hogy melyik felel meg a hirdetést megjelenítő weboldal biztonsági sémájának. A makrót az URL-ek elejére lehet beilleszteni.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Makró |
|---|
%%SITE%% |
A hirdetéscímkében lévő URL-paraméter domainjévé bővül (például google.com). A makró az egyes kreatívok módosítására szolgál az alapján, hogy honnan érkezett a kérés. Névtelenként megjelölt Ad Exchange-hirdetésekkel nem működik.
| Makró | Megtisztítás |
|---|---|
%%VIEW_URL_ESC%% |
Megtisztított |
%%VIEW_URL_UNESC%% |
Nem megtisztított |
A „megtekintett megjelenítés” makró lehetővé teszi az Ad Manager számára, hogy minden alkalommal megjelenítést számoljon, amikor a kreatív letöltődött a felhasználó eszközére, és elkezd betöltődni. Ezt a makrót kizárólag oldalon kívüli kreatívokban használja.
A megtekintési ping küldésének többféle módja is van. Javasoljuk az <img> címke használatát:
<!-- Ez az img címke nem látható. A megtekintési URL-hez irányuló kérés küldésére kényszeríti a böngészőt. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- Ez az img címke a valódi hirdetést jeleníti meg.-->
<img src="[%Imagefile%]" border="0">
Az első <img> címke egy 1 × 1-es képet hív le a VIEW_URL paraméterből. Állítsa a stílust “display:none” értékre, így a rendszer elrejti, és nem befolyásolja az oldal elrendezését.
GDPR-hoz kapcsolódó hirdetéskérelmi makrók
Ezeket a makrókat leggyakrabban a GDPR hatálya alá eső hirdetési kérelmeknél használják.
GDPR| Makró |
|---|
${GDPR} |
A kérelemhez tartozó gdpr= értékére bővül.
| Makró |
|---|
${GDPR_CONSENT_XXXX} |
A kérelemhez tartozó Átláthatósági és hozzájárulási (TC) karakterláncra bővül. Ha az Átláthatósági és beleegyezési (TC) karakterlánc üres vagy érvénytelen, akkor a makró kibontására nem kerül sor. A nem automatizált kreatívok esetében ezzel a makróval adhatja át a TC-karakterláncot az URL-ben a harmadik félként működő kreatívszolgáltatónak.
Az „XXXX” karakterlánc helyére a harmadik fél szolgáltató IAB GVL-azonosítóját írja. Ha a TC-karakterlánc üres vagy érvénytelen, akkor a makró kibontására nem kerül sor.
A ${GDPR_CONSENT_XXXX} makróval rendelkező kreatívokat a rendszer letilthatja, ha a beillesztett IAB GVL-azonosítóhoz társított harmadik fél szolgáltató nem kap felhasználói hozzájárulást.
Ha VAST-címkében használja a makrót, és a külső szolgáltató nem rendelkezik felhasználói beleegyezéssel, akkor a makró nem bontható ki.
A ${GDPR_CONSENT_XXXX} makró csak egyszer szerepelhet az URL-ben. Vegye fel a kapcsolatot harmadik fél hirdetési partnerével, hogy megismerje a TC-karakterláncra és URL-hossz korlátozásokra vonatkozó megfelelés követelményeit. A releváns IAB TCF v2.0-kérések esetében a makró helyére a teljes, nem módosított TC-karakterlánc kerül.
Az Átláthatósági és Hozzájárulási Keretrendszer (TCF) makrói nem bővülnek ki, amikor HTML5-kreatív HTML-kódjában vannak megvalósítva. Csak a vizuális átirányítás és az egyéni vizuális kreatívok támogatják a kibővülő TCF-makrókat a „Harmadik fél URL-je”, illetve a „HTML-kód” mezőn keresztül.
| Makró |
|---|
${ADDTL_CONSENT} |
A kérelemhez tartozó Kiegészítő hozzájárulás (AC) karakterláncra bővül.
| Makró |
|---|
%%TFUA%% |
Az 1-es értékre bővül, amely az EGT és az Egyesült Királyság beleegyezési korhatárt nem betöltött felhasználóinak kérelmét jelöli meg.
Videómakrók
Ezeket a makrókat leginkább videókreatívokban használják, hogy adatokat biztosítsanak a kontextusról vagy a tartalomról.
Videóhirdetés időtartama (ezredmásodpercben)| Makró |
|---|
%%VIDEO_AD_DURATION%% |
A videóhirdetés hosszára bővül ki (ezredmásodpercben). A VAST-burkolók/-átirányítások esetében a makró a hirdetés deklarált időtartamára bővül az Ad Managerben.
| Makró | Megtisztítás |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Nem megtisztított |
%%DESCRIPTION_URL_ESC%% |
Megtisztított |
%%DESCRIPTION_URL_ESC_ESC%% |
Kétszeresen megtisztított |
Ha a makró egy URL-ben szerepel, akkor a %%DESCRIPTION_URL_ESC%% (egyszeresen megtisztított) lehetőséget, egyéb esetben pedig a %%DESCRIPTION_URL_UNESC%% (nem megtisztított) lehetőséget használja. További információ a megtisztított és nem megtisztított makrókról.
Ezek a makrók az átirányítási hirdetéscímkéknél az eredeti Google megjelenítői címke description_url lekérdezésparaméterének leírási URL-paraméterére bővülnek ki. A leírás URL-je jellemzően azonos a hivatkozó URL-lel. Adja meg a description_url elemet a Google megjelenítői címkében, ha vannak olyan beágyazások, amelyekben előfordulhat, hogy az IMA SDK nem tudja pontosan észlelni az oldal URL-jét, illetve ha videót használ az Ad Exchange vagy AdSense Videóhoz szolgáltatásban.
%%DESCRIPTION_URL%% makrót is, amely ugyanarra szolgál, mint a %%DESCRIPTION_URL_UNESC%%, így nem szükséges újrakódolnia a régebbi kreatívokat és sablonokat.| Makró | Megtisztítás |
|---|---|
%%REFERRER_URL_UNESC%% |
Nem megtisztított |
%%REFERRER_URL_ESC%% |
Egyszeresen megtisztított |
%%REFERRER_URL_ESC_ESC%% |
Kétszeresen megtisztított |
Ha a makró URL-ben szerepel, akkor a %%REFERRER_URL_ESC%% (egyszeresen megtisztított) lehetőséget, egyéb esetekben pedig a %%REFERRER_URL_UNESC%% (nem megtisztított) lehetőséget használja. További információ a megtisztított és nem megtisztított URL-makrókról.
Ez a makró az átirányítási hirdetési címkékben a hivatkozási URL-lé bővül (ami azon oldal URL-je, ahol a videólejátszó található). Ezt a következőképpen teszi: az Ad Manager elemzi a hirdetési címke URL-jének lekérdezési paraméterét, elkülöníti a hivatkozó URL-t, majd ezzel az URL-lel helyettesíti a makró szövegét. Kizárólag a Google IMA SDK-val működik, az alábbi feltételek teljesülése esetén:
- A makró működéséhez engedélyezni kell az oldalon a szkripthozzáférést.
- A makró nem működik iframe-en belül.
%%REFERRER_URL%% makrót is, amely ugyanarra szolgál, mint a %%REFERRER_URL_UNESC%%, így nem szükséges újrakódolnia a régebbi kreatívokat és sablonokat.Videótartalom-makrók
Ezeket a makrókat a videó-tartalomforrásokat célzó hirdetéseknél lehet használni.
| Makró |
|---|
%%VIDEO_DURATION%% |
A videó hosszára bővül ki (ezredmásodpercben).
| Makró |
|---|
%%VIDEO_ID%% |
Az éppen lejátszott videótartalom azonosítójára bővül ki, amely a CMS-ben szereplő egyedi azonosító vagy az MRSS-ből származó dfpvideo:ContentID érték.
| Makró |
|---|
%%VIDEO_METADATA:key%% |
Azon videóval kapcsolatos metaadatokra bővül ki, amely mellett a kreatív megjelenik (a videótartalommal társított kulcsértékek alapján). A kulcsértékek az Ad Manager „Videó” lapján vannak beállítva.
A videó-metaadatkulcsot a megcélzását követően kibővítheti a videó-metaadatok makró. A makróban használt „kulcs” csak alfanumerikus karaktereket és aláhúzásjelet (_) tartalmazhat.
| Makró | Megtisztítás |
|---|---|
%%VIDEO_TITLE%% |
Egyszeresen megtisztított |
„A videó címe” makró a videónak az Ad Managerben megadott címére bővül ki.
A makró működéséhez tartalomfeldolgozás szükséges.
| Makró |
|---|
%%FW_CAID%% |
A FreeWheel egyéni hirdetésazonosítójára bővül ki.
Ez a makró csak azokra a megjelenítőkre vonatkozik, akik a FreeWheelt használják videóhirdetések megjelenítésére.
| Makró |
|---|
%%IAB_CATEGORIES%% |
A makró segítségével hirdetési kategóriákat adhat olyan kreatívokhoz, amelyeket címkékkel már manuálisan besorolt. Ez a makró egy vesszővel tagolt listát jelenít meg a vonatkozó szabványos IAB-kategóriákról (a Google által besorolt kategóriákból konvertálva).
Ezt a makrót azoknak a megjelenítőknek érdemes használni, akik a FreeWheel segítségével osztanak meg videókészletet, és akik hirdetési kategóriát szeretnének hozzáadni egyéni paraméterként. Például hozzáadhatja az &iab_categories=%%IAB_CATEGORIES%% makrót a VAST átirányítási címkéjéhez.
