Macro's zijn speciale tekenreeksen in code voor advertentiemateriaal. Ad Manager vervangt deze tekenreeks later door een andere waarde of code op basis van de instellingen van het advertentiemateriaal. Macro's zijn handig omdat u de code voor advertentiemateriaal niet rechtstreeks hoeft te updaten als u wijzigingen moet aanbrengen. U kunt de macroverwijzing gewoon updaten.
Voor elke macro hebben we gebruikssuggesties gegeven, maar u kunt macro's inzetten voor doeleinden die voor u het meest waardevol zijn. Macro's kunnen worden opgenomen in elke code die wordt verwerkt door de advertentieserver tijdens de weergave: advertentiemateriaalcode van derden of aangepaste advertentiemateriaalcode, Studio-code, doorklik-URL's en advertentietags.
Belangrijke opmerkingen over macro's
- Hoofdlettergevoeligheid
Macro's zijn hoofdlettergevoelig. Gebruik%%CACHEBUSTER%%, niet%%Cachebuster%%. - Uitbreiding met en zonder escapecodes
Macroversies met en zonder escapecodes worden op verschillende manieren vervangen. Bekijk meer informatie over hoe u macro's met en zonder escapecodes gebruikt. - Invoeging van macro's
Ad Manager voegt automatisch macro's in voor advertentiemateriaal van derden of URL's voor VAST-tags als Ad Manager de derde partij herkent. Voor aangepast advertentiemateriaal en templates voor advertentiemateriaal moet u de macro's handmatig toevoegen. Als u niet zeker weet waar u een macro moet plaatsen, neemt u contact op met de leverancier van het advertentiemateriaal.
Als u trafficking uitvoert met een template voor advertentiemateriaal, is er alleen een doorklik-URL-invoer beschikbaar als er een macro voor klikken wordt gebruikt in de template. - Gereserveerde tekens en URL-codering (percentagecodering)
Ad Manager reserveert bepaalde kleine letters, voorafgegaan door een percentage:%a
%c
%h
%i
%n
%p
%kDeze tekenreeksen moeten niet worden gebruikt in URL-codering, omdat ze de macro-uitbreiding kunnen verstoren.
- Macro's worden niet ondersteund voor Programmatic direct
Bekijk de beschikbare functies voor Programmatic direct.
Naar een specifieke macro in de lijst gaan
Alles uitvouwen Alles samenvouwen
Macro's voor weergave
Macro's voor weergave worden doorgaans gebruikt om advertentiemateriaal weer te geven en zorgen ervoor dat het materiaal er goed uitziet en correct werkt.
Advertentieblok| Macro |
|---|
%%ADUNIT%% |
De macro van het advertentieblok voegt het advertentieblokpad uit uw Google-uitgeverstag aan de code van het advertentiemateriaal toe wanneer dit wordt weergegeven.
U kunt de macro ADUNIT als volgt toevoegen aan code voor advertentiemateriaal van derden:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
De macro van het advertentieblok wordt uitgebreid naar het advertentieblokpad in het oorspronkelijke advertentieverzoek, inclusief de netwerkcode. Hier volgt een voorbeeld van hoe het advertentieblokpad kan worden vervangen als de advertentie wordt weergegeven:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Deze macro werkt alleen voor goedgekeurde voorgestelde advertentieblokken. Als een voorgesteld advertentieblok zich op het derde niveau bevindt, wordt de macro alleen uitgebreid naar het advertentieblok op het tweede niveau als dit in het advertentiemateriaalfragment wordt gebruikt. Zodra het voorgestelde advertentieblok is goedgekeurd, wordt de macro uitgebreid naar het advertentieblok op het derde niveau in het advertentiemateriaalfragment.
| Macro | Escaping |
|---|---|
%%DEST_URL_ESC%% |
Escapecodes |
%%DEST_URL_ESC_ESC%% |
Dubbele escapecodes |
%%DEST_URL_UNESC%% |
Zonder escapecodes |
De macro voor de bestemmings-URL wordt vervangen door de doorklik-URL van het advertentiemateriaal, die bestaat uit de doorklik-URL van het regelitem of uit een overschrijving die is ingesteld voor het advertentiemateriaal in het regelitem.
De macro voor de bestemmings-URL is handig in aangepast advertentiemateriaal en templates voor advertentiemateriaal. Als de code van het advertentiemateriaal de doorklik-URL van het advertentiemateriaal moet bevatten en de doorklik-URL verandert als het advertentiemateriaal of de template wordt gebruikt voor verschillende regelitems, kan deze macro helpen.
Er zijn drie macro's voor doorklik-URL's: met escapecodes, met dubbele escapecodes en zonder escapecodes. Gewoonlijk is de mate van escaping (of u ESC één keer, twee keer of helemaal niet opneemt) afhankelijk van het externe bedrijf dat de klikken bijhoudt. Bepaalde externe bedrijven die klikken bijhouden, vereisen dat de URL is voorzien van escapecodes, terwijl andere dat niet doen. De vereiste mate van escaping voor een extern bedrijf dat klikken bijhoudt, wordt vaak aangegeven in de tag met de string click= in de advertentietag van derden of de code van het aangepaste advertentiemateriaal in Ad Manager:
-
click=: één keer escapen (%%DEST_URL_ESC%%). -
click0=: niet escapen (%%DEST_URL_UNESC%%). -
click1=: één keer escapen (%%DEST_URL_ESC%%). -
click2=: twee keer escapen (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%%, die precies hetzelfde doet als %%DEST_URL_ESC%%. We raden u aan om voor de duidelijkheid %%DEST_URL_ESC%% te gebruiken, maar u hoeft ouder advertentiemateriaal en oudere templates niet opnieuw te coderen.%u of %%DEST_URL%% bevat, wordt u omgeleid naar de URL van xsd:string als u op het advertentiemateriaal klikt. Het heeft een maximale lengte van 1024 tekens.| Macro |
|---|
%%FILE:file_display_name%% |
De macro voor de bestandsserver %%FILE:file_display_name%% wordt vervangen door de volledige URL van een bestand dat is geüpload voor het advertentiemateriaal. Gebruik deze macro om geüploade items met aangepaste code voor advertentiemateriaal aan te roepen, zoals een afbeelding.
Als u deze macro wilt gebruiken, vervangt u file_display_name door de weergavenaam van het bestand voor het advertentiemateriaal, zoals weergegeven in Ad Manager als u de details van het advertentiemateriaal bekijkt.
| Macro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Deze macro's voegen tijdens het advertentieweergaveproces de hoogte en breedte van het advertentiemateriaal toe aan de aangepaste code. De hoogte en breedte worden in het Ad Manager gedefinieerd in het veld 'Formaat van doeladvertentieblok' van het aangepaste advertentiemateriaal.
De macro's voor hoogte en breedte kunnen met name handig zijn als u een advertentiemateriaaltemplate maakt dat u opnieuw wilt gebruiken voor advertentiemateriaal met verschillende formaten. Met de macro's voor hoogte en breedte hoeft u het formaat voor elk advertentiemateriaal niet te hardcoderen, maar kunt u de waarden dynamisch invoegen in elk advertentiemateriaal.
| Macro |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Gebruik de macro voor patroonovereenkomst om een of meer aangepaste variabelen, zoals een targetingwaarde, op te nemen in advertentiemateriaal. U kunt deze macro gebruiken om sleutel/waarden door te geven, de volledige targetingtekenreeks te vervangen of de verwijzende URL te vervangen. Dit kan handig zijn als u verschillend advertentiemateriaal wilt weergeven op basis van informatie die bekend is over een gebruiker, zoals diens contentvoorkeuren.
De macro voor patroonovereenkomst is beperkt tot 100 vervangingen per advertentiemateriaal.
De macro voor patroonovereenkomst escapen
De macro voor patroonovereenkomst retourneert de waarde zoals deze is ontvangen. Als u de macro in een van de URL-velden gebruikt, zoals in het veld 'URL van VAST-tag' of 'Tracking-URL van derden' in videoadvertentiemateriaal, wilt u wellicht dat de uitgebreide waarde met een escapecode wordt geretourneerd. U moet een drievoudige escape gebruiken voor de waarde in het verzoek om dit te realiseren.
%%PATTERN:key%%
U heeft bijvoorbeeld twee advertentiematerialen voor een bepaald regelitem: een die bedoeld is voor vrouwelijke gebruikers en een voor mannelijke gebruikers. De macro die in de sleutel wordt gebruikt, moet alfanumeriek of een underscore (_) zijn.
Het proces werkt als volgt:
- U neemt de aangepaste waarde (in dit geval het geslacht van de gebruiker) op in een advertentietag op uw pagina via aangepaste sleutel/waarden:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - In aangepast advertentiemateriaal of advertentiemateriaal van derden geeft u de aangepaste waarde (het geslacht van de gebruiker) dynamisch door via de volgende macro:
<some creative script here>...&gender=%%PATTERN:gender%% - De hele macro
%%PATTERN:gender%%wordt vervangen door "male". - Voor deze gebruiker wordt het advertentiebestand 'man' aangeroepen en weergegeven door Ad Manager.
%%PATTERN:TARGETINGMAP%%
U kunt %%PATTERN:TARGETINGMAP%% gebruiken om de volledige targetingkaart te vervangen en op dynamische wijze passbacktags te maken.
U kunt de macro TARGETINGMAP als volgt toevoegen aan een advertentietag:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Hier volgt een voorbeeld van de volledige sleutel/waarde-tekenreeks wanneer de advertentie wordt weergegeven:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
U kunt deze macro gebruiken om een passback-tag in te stellen tussen twee Ad Manager-netwerken ('Netwerk A' en 'Netwerk B').
Hier is een voorbeeld van advertentiemateriaal dat is geboekt in Ad Manager-netwerk 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>
Als Ad Manager-netwerk B geen verkochte campagne heeft om weer te geven, kan het de vertoning teruggeven aan Netwerk A met behulp van passback-advertentiemateriaal zoals het volgende:
<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>U kunt TARGETINGMAP ook gebruiken in een passback-tag die wordt verzonden in een verzoek aan een advertentieserver van derden, zodat u meerdere waarden in dynamisch advertentiemateriaal kunt hebben.
Hier is een voorbeeld van advertentiemateriaal dat is geboekt in 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>
Indien weergegeven door Ad Manager, wordt dit vervangen door:
<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>
De derde partij heeft nu toegang tot de dynamisch gegeneerde parameters dfpAdUnit en targeting en kan de volgende passback bouwen:
<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>
Hiervoor kan de derde partij een templatecode krijgen die er ongeveer zo uitziet:
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%%
U kunt de gereserveerde sleutel url ook vervangen door de URL van de verwijzende pagina.
Houd er rekening mee dat url een gereserveerde sleutel is. Sleutel/waarden in uw Campaign Manager 360-tags die url als sleutelnaam hebben, worden overschreven door de verwijzende URL.
| Macro |
|---|
%%TAG_PARAM%% |
De macro voor de tagparameter wordt gebruikt in combinatie met andere advertentietagparameters en is alleen beschikbaar voor gebruik met de volgende parameters:
Indien ondersteund, wordt deze vervangen door de waarde van de parameter.
%%TAG_PARAM:correlator%% (ondersteund) wordt bijvoorbeeld vervangen door de waarde van de correlator uit de advertentietag, maar %%TAG_PARAM:ppid%% (unsupported) wordt niet vervangen door een waarde.
| Macro |
|---|
%%TARGET_IN_NEW_WINDOW%% |
Het doel in de macro voor een nieuw venster geeft aan of de opgegeven instelling voor het doelvenster voor het advertentieblok waar advertentiemateriaal wordt weergegeven, _blank is (nieuw venster) of niet.
-
Als het doelvenster
_blankis, wordt de macro vervangen door1. -
Als het doelvenster een andere waarde heeft of als er geen doelvenster is opgegeven, wordt de macro vervangen door
0.
Gebruik de macro %%TARGET_WINDOW%% als u de waarde van de daadwerkelijke instelling voor het doelvenster wilt invoegen.
| Macro |
|---|
%%TARGET_WINDOW%% |
De macro voor het doelvenster wordt vervangen door het doelvenster dat is opgegeven voor het advertentieblok waar advertentiemateriaal wordt weergegeven. U kunt de macro gebruiken in de code van advertentiemateriaal om aan te geven of een klik op het advertentiemateriaal de gebruiker naar een nieuw venster brengt of de bestemmingspagina opent in hetzelfde venster, afhankelijk van de instellingen voor elke site waar gebruikers de advertentie te zien krijgen.
Voor het advertentieblok voor AdManager_News.com is het doelvenster bijvoorbeeld ingesteld op _top en voor het advertentieblok voor AdManager_Fashion.com is het ingesteld op _new. Als de macro %%TARGET_WINDOW%% is opgenomen in de advertentiemateriaalcode, wordt deze vervangen door _top voor gebruikers op AdManager_News.com en door _new voor gebruikers van AdManager_Fashion.com.
Hier volgt een voorbeeldimplementatie:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Gebruik de macro %%TARGET_IN_NEW_WINDOW%% als u wilt bepalen of de waarde van de instelling voor het doelvenster _blank is of dat er een andere waarde wordt gebruikt.
| Macro |
|---|
%%TFCD%% |
Met de macrotag voor content die bedoeld is voor kinderen (TFCD) kunt u derden laten weten dat een bepaald advertentieverzoek afkomstig is van een pagina met content die bedoeld is voor kinderen. De macro is bedoeld om te helpen bij de naleving van de Children's Online Privacy Protection Act (COPPA).
U kunt de macro opnemen in alle omleidingen of verzoeken voor advertentiemateriaal van derden. Hiervoor gebruikt u de indeling coppa=%%TFCD%% of een soortgelijke indeling. De macro kan ook worden gebruikt in JavaScript om passback-tagverzoeken in te stellen voor de behandeling van content die bedoeld is voor kinderen. De macro wordt vervangen door 1 voor content die bedoeld is voor kinderen of door 0 voor andere content, gebaseerd op informatie over de aard van de pagina, site of mobiele app die het verzoek naar Ad Manager heeft verzonden.
Als u gebruikmaakt van de advertentieservices van Google en de content op site- of app-niveau wilt behandelen als content die bedoeld is voor kinderen, raadpleegt u het gedeelte Een site of app taggen voor de behandeling van content die bedoeld is voor kinderen.
| Macro |
|---|
[%URI_ENCODE:variable%] |
De macro voor URI-codering zorgt voor een correcte vertaling van spaties en andere speciale tekens naar variabelewaarden voor advertentiemateriaaltemplates voor het gebruik in URI's (ook wel bekend als URL's).
Voorbeeld
Stel dat uw advertentiemateriaaltemplate een lijstvariabele bevat met de naam 'Color'. Deze variabele bevat de waarden 'dark blue' en 'light green'. Ad Manager voegt standaard [%Color%] toe aan het fragment van uw template voor advertentiemateriaal:
<a href="https://paint.com/wall.html?color=[%Color%]">Paint!</a>
Als het advertentiemateriaal wordt gemaakt, vervangt Ad Manager [%Color%] door de letterlijke tekenreeks van het geselecteerde lijstitem. In dit voorbeeld bevatten de letterlijke tekenreeksen spaties die de URL zouden verbreken, aangezien spaties moeten worden gecodeerd. Gebruik [%URI_ENCODE:Color%] om dit probleem te voorkomen.
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Paint!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Deze macro is vooral handig wanneer u een variabele voor de template voor advertentiemateriaal gebruikt om een doorklik-URL of verwijzings-URL te definiëren. Zonder de juiste codering werkt de volledige URL in uw advertentiemateriaal mogelijk niet.
Voorbeeld
Stel dat uw advertentiemateriaaltemplate een URL-variabele bevat met de naam 'LandingPage'. Ad Manager voegt standaard [%LandingPage%] toe aan het fragment van uw template voor advertentiemateriaal:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Klik hier!</a>
Als de URL [%LandingPage%] queryparameters bevat, zoals ?page=home&sport=baseball, krijgt de URL een ongeldige indeling en werkt de omleiding niet naar behoren. In dit voorbeeld wordt de content na de ampersand & toegeschreven aan de volledige URL en niet aan de verwijzings-URL. Gebruik [%URI_ENCODE:LandingPage%] om dit probleem te voorkomen.
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Klik hier!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Macro's voor het bijhouden van gegevens
Deze macro's worden meestal gebruikt voor tracking- en rapportagedoeleinden.
Cachebuster (willekeurig nummer)| Macro |
|---|
%%CACHEBUSTER%% |
De CacheBuster-macro zorgt ervoor dat telkens wanneer de code wordt uitgevoerd, een nieuwe aanvraag naar de advertentieserver wordt verzonden, zodat u nauwkeurig het aantal vertoningen kunt tellen. Als u de CacheBuster-macro niet toevoegt aan advertentiemateriaalcode, is de kans groter dat u verschillen ziet in het aantal vertoningen dat wordt geteld door Google Ad Manager en door een advertentieserver van derden. Houd er rekening mee dat de CacheBuster-macro niet vereist is voor alle derden.
De meeste leveranciers van advertentiemateriaal bieden een tijdelijke aanduiding in hun tag om cachebuster-macro's in te voegen. Als uw advertentiecode van derden bijvoorbeeld het volgende bevat:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
U moet [RANDOM_NUMBER] selecteren en op CacheBuster-macro invoegen klikken, zodat de tijdelijke aanduiding hierdoor wordt vervangen:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER toe om het aantal verschillen te verkleinen als u Campaign Manager 360-vertoningstracker gebruikt voor Ad Manager.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
De cachebuster-macro's in VAST-reacties
De %%CACHEBUSTER%%-macro breidt uit naar hetzelfde willekeurige nummer voor alle gebeurtenissen in bepaald advertentiemateriaal. Dit is vooral nuttig voor videoadvertenties, omdat de macro uitbreidt naar hetzelfde willekeurige nummer voor elke videotrackinggebeurtenis in een VAST-reactie.
| Macro | Escaping |
|---|---|
%%CLICK_URL_UNESC%% |
Zonder escapecodes |
%%CLICK_URL_ESC%% |
Escapecodes |
%%CLICK_URL_ESC_ESC%% |
Dubbele escapecodes |
De klikmacro wordt vervangen door een speciale URL, zodat u klikken in Ad Manager kunt bijhouden voor advertentiemateriaal van derden. Deze macro wordt doorgaans gekoppeld aan de doorklik-URL van advertentiemateriaal in de ankertag (<a>). Geef de klikmacro niet op als bron van een afbeelding of iframe Als u dit wel doet, wordt een klik geregistreerd telkens als de afbeelding of het iframe wordt weergegeven. Dergelijke klikken zijn ongeldig en worden weggefilterd.
Gebruik %%CLICK_URL_UNESC%% aan het begin van een link. Gebruik %%CLICK_URL_ESC%% als de kliktracker de parameter van een andere URL is.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">link</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">link</a>
Meer informatie over macro's met en zonder escapecodes.
De implementatie van uw klikmacro controleren
Een onjuist geplaatste klikmacro houdt geen klikken bij. Volg deze stappen om te controleren of Ad Manager klikken registreert zoals u dat wilt.
- Bekijk een voorbeeld van het advertentiemateriaal.
- Klik op het voorbeeld.
Ad Manager geeft een bevestiging weer dat klikken worden geregistreerd. Als deze bevestiging niet wordt weergegeven, is uw klikmacro niet goed geïmplementeerd.
| Macro | Waardoor de macro wordt vervangen |
|---|---|
%eaid! |
Regelitem-ID |
%eadv! |
Adverteerders-ID voor het regelitem dat wordt weergegeven |
%ebuy! |
Order-ID voor het regelitem dat wordt weergegeven |
%ecid! |
Advertentie-ID |
%eenv! |
Omgevingsaanduiding (tagtype): i voor iframe, j voor JavaScript |
%epid! |
ID van het advertentieblok waar het regelitem wordt weergegeven |
%esid! |
ID van het advertentieblok op het hoogste niveau boven het advertentieblok waar het regelitem wordt weergegeven
Dit is een verouderde macro en werkt mogelijk niet zoals verwacht voor uw netwerk.
|
Gebruik de vervangingsmacro's in aangepaste advertentiemateriaalcode of in een doorklik-URL om ID-waarden uit Ad Manager weer te geven als advertentiemateriaal wordt weergegeven op een pagina. Dit wordt vaak gebruikt om ID's van Ad Manager te koppelen aan ID's in de eigen database van een uitgever voor het oplossen van problemen of andere rapportagemethoden.
Vervangingsmacro's kunnen in de doorklik-URL van elkaar worden gescheiden met een teken dat veilig kan worden gebruikt in doorklik-URL's van Ad Manager. http://www.site.com/?%eaid!;%ecid! kan bijvoorbeeld worden vervangen door http://www.site.com/?1234567;4265598.
| Macro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (de apparaat-ID) |
%%ADVERTISING_IDENTIFIER_TYPE%% (het apparaattype) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (de instelling Beperkte advertentietracking) |
Met de macro %%ADVERTISING_IDENTIFIER_PLAIN%% kunnen in-app uitgevers een resetbare apparaat-ID naar advertentiepartners sturen om op interesses gebaseerde advertenties weer te geven. Dit maakt het makkelijker om toegang tot resetbare apparaat-ID's te verlenen aan uw adverteerders en bureaus.
In-app-uitgevers kunnen ook de macro %%ADVERTISING_IDENTIFIER_TYPE%% gebruiken om het type apparaat te versturen en de macro %%ADVERTISING_IDENTIFIER_IS_LAT%% om de instelling Advertentietracking beperken (LAT) te versturen waarmee het signaal voor beperkte advertentietracking van een apparaat wordt aangegeven.
Meer informatie over resetbare apparaat-ID's voor gebruikerstargeting, waaronder de ondersteunde apparaattypen
Vereisten
HTTPS-versleuteling instellen voor advertentiemateriaal. Dit is een vereiste voor het advertentiemateriaal en eventuele pixels van derden die u gebruikt voor het bijhouden van conversies. Als advertentiemateriaal niet is versleuteld voor HTTPS of als u de automatische SSL-compatibiliteit overschrijft, wordt de macro niet vervangen door de waarde, maar wordt het advertentiemateriaal nog steeds weergegeven.
Hoe het werkt
- In Ad Manager neemt de uitgever de macro's op in zijn advertentiemateriaal-/tracking-URL's.
-
De macro's worden vervangen door de apparaat-ID van de gebruiker, het apparaattype en/of de instelling 'Beperkte advertentietracking', die vervolgens worden opgenomen in het advertentiemateriaal als aanroepen naar derden worden verstuurd.
De ID-macro wordt niet vervangen als het advertentieverzoek afkomstig is van een op kinderen gerichte app (TFCD) of als Beperkte advertentietracking (Limit Ad Tracking, LAT) is geactiveerd. In deze gevallen retourneert deze macro een lege tekenreeks ("").
Indeling
Deze macro verstuurt een waarde van 32 hexadecimale tekens in hoofdletters, weergegeven in vijf groepen en gescheiden door koppeltekens, in de vorm 8-4-4-4-12 voor een totaal van 36 tekens (32 alfanumerieke tekens en vier koppeltekens).
Voorbeeld: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Bekijk de mogelijke waarden voor ondersteunde apparaattypen en Beperkte advertentietracking (Limit Ad Tracking; LAT).
| Macro |
|---|
%%PREVIEW_MODE%% |
Gebruik de macro voor de voorbeeldmodus in aangepaste advertentiecode om te voorkomen dat voorbeeldvertoningen worden geteld door uw backend-systemen of systemen van derden. De macro wordt vervangen door true als het advertentiemateriaal wordt bekeken als Ad Manager-voorbeeld en door false als het een gewone vertoning betreft.
| Macro |
|---|
%%SCHEME%% |
De schemamacro wordt vervangen door http: of https:, afhankelijk van wat overeenkomt met het beveiligingsschema van de webpagina waar advertentiemateriaal wordt weergegeven. U kunt de macro aan het begin van een URL plaatsen.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Macro |
|---|
%%SITE%% |
Wordt vervangen door het domein van de URL-parameter in een advertentietag (bijvoorbeeld google.com). De macro kan worden gebruikt om uw advertentiemateriaal aan te passen op basis van waar het verzoek vandaan kwam. De macro werkt niet voor Ad Exchange-advertenties die als anoniem zijn gemarkeerd.
| Macro | Escaping |
|---|---|
%%VIEW_URL_ESC%% |
Escapecodes |
%%VIEW_URL_UNESC%% |
Zonder escapecodes |
Met de macro voor weergegeven vertoningen kan Ad Manager een vertoning tellen als advertentiemateriaal naar het apparaat van de gebruiker is gedownload en is begonnen met laden. Gebruik deze macro alleen in advertentiemateriaal buiten de pagina.
Er zijn meerdere manieren om een weergaveping te sturen. We raden aan een <img>-tag te gebruiken:
<!-- 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">
De eerste <img>-tag haalt een 1x1 afbeelding van VIEW_URL op. Stel de stijl in op “display:none” zodat deze verborgen is en geen invloed heeft op de lay-out van de pagina.
Macro's voor advertentieverzoeken voor AVG
Deze macro's worden meestal gebruikt voor advertentieverzoeken die onder de AVG vallen.
AVG| Macro |
|---|
${GDPR} |
De macro vervangt de waarde door de waarde gdpr= die is gekoppeld aan het verzoek
| Macro |
|---|
${GDPR_CONSENT_XXXX} |
De macro vervangt de waarde door de tekenreeks voor transparantie en toestemming (TC) die is gekoppeld aan het verzoek. Als de TC-tekenreeks (Transparency & Consent) leeg of ongeldig is, wordt deze macro niet vervangen. Gebruik deze macro om de TC-tekenreeks door te geven aan een externe aanbieder van advertentiemateriaal in een URL in niet-programmatic advertentiemateriaal.
Vervang XXXX door de IAB GVL-ID van de externe aanbieder. Als de TC-tekenreeks leeg of ongeldig is, wordt deze macro niet vervangen.
Advertentiemateriaal met de macro ${GDPR_CONSENT_XXXX} kan worden geblokkeerd als de externe aanbieder die aan de ingevoegde IAB GVL-ID is gekoppeld, geen toestemming van gebruikers heeft.
Als deze macro wordt gebruikt in een VAST-tag en de externe provider geen toestemming van gebruikers heeft, wordt de macro niet vervangen.
De macro ${GDPR_CONSENT_XXXX} mag maar één keer voorkomen in de URL. Neem contact op met uw externe leverancier van advertentiemateriaal om inzicht te krijgen in diens vereisten voor het doorgeven van de TC-reeks en beperkingen voor de lengte van URL's. Voor relevante IAB TCF v2.0-verzoeken wordt de macro vervangen door de volledige, niet-aangepaste TC-tekenreeks.
Macro's voor het Transparency and Consent Framework (TCF) worden niet vervangen als ze worden geïmplementeerd in de HTML van HTML5-advertentiemateriaal. Alleen advertentiemateriaal met display-omleiding en aangepast display-advertentiemateriaal ondersteunen het vervangen van TCF-macro's via de velden URL van derden en HTML-code.
| Macro |
|---|
${ADDTL_CONSENT} |
De macro vervangt de waarde door de tekenreeks voor aanvullende toestemming (AC) die is gekoppeld aan het verzoek.
| Macro |
|---|
%%TFUA%% |
De macro vervangt de waarde door de waarde 1 om het verzoek te taggen voor gebruikers in de EER en het Verenigd Koninkrijk die jonger zijn dan de minimumleeftijd.
Videomacro's
Deze macro's worden doorgaans gebruikt in videoadvertentiemateriaal om details over de context of content op te nemen.
Duur van videoadvertentie, in milliseconden| Macro |
|---|
%%VIDEO_AD_DURATION%% |
De macro vervangt de waarde door de duur van de videoadvertentie in milliseconden. Voor VAST-wrappers/omleidingen wordt de macro vervangen door de opgegeven duur van de advertentie in Ad Manager.
| Macro | Escaping |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Zonder escapecodes |
%%DESCRIPTION_URL_ESC%% |
Escapecodes |
%%DESCRIPTION_URL_ESC_ESC%% |
Dubbele escapecodes |
Gebruik %%DESCRIPTION_URL_ESC%% (dubbele escapecodes) als de macro zich in een URL bevindt en gebruik %%DESCRIPTION_URL_UNESC%% (zonder escapecodes) in andere contexten. Meer informatie over macro's met en zonder escapecodes
In omleidende advertentietags vervangen deze macro's de queryparameter description_url van de oorspronkelijke Google-uitgeverstag door de beschrijvende URL-parameter. De beschrijvende URL is doorgaans gelijk aan de verwijzende URL. U moet de description_url opgeven in de Google-uitgeverstag als er sprake is van insluitingen waar de IMA-SDK de pagina-URL mogelijk niet goed detecteert of als u video in Ad Exchange of AdSense voor video gebruikt.
%%DESCRIPTION_URL%%, die precies hetzelfde doet als %%DESCRIPTION_URL_UNESC%%. Het is dus niet nodig om ouder advertentiemateriaal en oudere templates opnieuw te coderen.| Macro | Escaping |
|---|---|
%%REFERRER_URL_UNESC%% |
Zonder escapecodes |
%%REFERRER_URL_ESC%% |
Enkele escapecodes |
%%REFERRER_URL_ESC_ESC%% |
Dubbele escapecodes |
Gebruik %%REFERRER_URL_ESC%% (dubbele escapecodes) als de macro zich in een URL bevindt en gebruik %%REFERRER_URL_UNESC%% (zonder escapecodes) in andere contexten. Meer informatie over URL-macro's met en zonder escapecodes
In omleidende advertentietags wordt deze macro vervangen door de verwijzende URL (de URL van de pagina waar de videospeler zich bevindt). Dit gebeurt als volgt: Ad Manager parseert de URL-queryparameter van de advertentietag, isoleert de verwijzende URL en vervangt de macrotekst door die URL. Dit werkt alleen met de Google IMA-SDK, met de volgende kwalificaties:
- Deze macro werkt alleen als scripttoegang is geactiveerd op de pagina.
- De macro werkt niet in een iframe.
%%REFERRER_URL%%, die precies hetzelfde doet als %%REFERRER_URL_UNESC%%. Het is dus niet nodig om ouder advertentiemateriaal en oudere templates opnieuw te coderen.Macro's voor videocontent
Deze macro's worden gebruikt voor advertenties die bronnen met videocontent targeten.
| Macro |
|---|
%%VIDEO_DURATION%% |
De macro vervangt de waarde door de duur van de video in milliseconden.
| Macro |
|---|
%%VIDEO_ID%% |
De macro vervangt de waarde door de ID van de videocontent die momenteel wordt afgespeeld. Dit is de unieke ID in de CMS of de waarde dfpvideo:ContentID van MRSS.
| Macro |
|---|
%%VIDEO_METADATA:key%% |
De macro vervangt de waarde door metadata over de video waar het advertentiemateriaal wordt weergegeven op basis van sleutel/waarden die zijn gekoppeld aan de videocontent. De sleutel/waarden zijn ingesteld in Ad Manager op het tabblad Video.
Nadat een sleutel voor videometadata is getarget, kan deze worden vervangen door de macro voor videometadata. De macro die in de sleutel wordt gebruikt, moet alfanumeriek of een underscore (_) zijn.
| Macro | Escaping |
|---|---|
%%VIDEO_TITLE%% |
Enkele escapecodes |
De macro voor de videotitel wordt vervangen door de titel van een video zoals gedefinieerd in Ad Manager.
Voor deze macro is contentopname vereist.
| Macro |
|---|
%%FW_CAID%% |
De macro vervangt de waarde door de aangepaste FreeWheel-advertentie-ID.
Deze macro is alleen van toepassing op uitgevers die FreeWheel gebruiken voor de weergave van videoadvertenties.
| Macro |
|---|
%%IAB_CATEGORIES%% |
Wordt gebruikt om advertentiecategorieën door te geven voor advertentiemateriaal dat u handmatig heeft geclassificeerd met labels. Deze macro retourneert een door komma's gescheiden lijst met toepasselijke standaard IAB-categorieën (geconverteerd via door Google geclassificeerde categorieën).
Deze macro kan worden gebruikt door uitgevers die videovoorraad delen met FreeWheel en advertentiecategorieën willen doorgeven als aangepaste parameters. Zo kunt u &iab_categories=%%IAB_CATEGORIES%% toevoegen aan uw VAST-omleidingstag.
