Zoeken
Zoekopdracht verwijderen
Zoeken sluiten
Google-apps
Hoofdmenu

DFP-macro's

Macro's zijn speciale tekenreeksen in het codefragment van het advertentiemateriaal die later op basis van de instellingen voor het advertentiemateriaal door DFP worden vervangen door een andere waarde. Macro's kunnen worden opgenomen in elke code die wordt verwerkt door de advertentieserver tijdens het weergaveproces: advertentiemateriaalcode van derden of aangepaste advertentiemateriaalcode, DoubleClick Rich Media-code, doorklik-URL's, DFP-tags of Flash-bestanden die worden gehost door DFP.

Voor elke macro hebben we gebruikssuggesties gegeven, maar u kunt macro's inzetten voor doeleinden die voor u het meest waardevol zijn.

Belangrijke opmerkingen over macro's
  • Macro's zijn hoofdlettergevoelig. Gebruik %%CACHEBUSTER%%, niet %%Cachebuster%%.
  • Macroversies met en zonder escapecodes worden op verschillende manieren vervangen. Meer informatie
  • DFP voegt automatisch macro's in voor advertentiemateriaal van derden of URL's voor VAST-tags als DFP de derde partij herkent. Voor aangepast advertentiemateriaal en advertentiemateriaaltemplates 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.

Macro's voor weergeven

Deze macro's worden doorgaans gebruikt om advertentiemateriaal weer te geven en zorgen ervoor dat het materiaal er goed uitziet en correct werkt.

ALLES UITVOUWEN ALLES SAMENVOUWEN

Macro voor 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 volg 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 wanneer 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 wanneer 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.
Deze functie is niet beschikbaar in DFP Small Business.
Macro voor bestemmings-URL
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 de advertentie in het regelitem.

De macro voor de bestemmings-URL is handig in aangepast advertentiemateriaal en advertentiesjablonen. Als de code van het advertentiemateriaal de doorklik-URL van de advertentie moet bevatten en de doorklik-URL verandert wanneer het advertentiemateriaal of sjabloon 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 DFP:

  • 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%%).

DFP ondersteunt ook %%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 sjablonen niet opnieuw te coderen.
Macro voor bestandsserver
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 DFP wanneer u de details van het advertentiemateriaal bekijkt.

Macro's voor hoogte en breedte
Macro
%%HEIGHT%%
%%WIDTH%%

Deze macro's voegen de advertentiehoogte en -breedte (zoals gedefinieerd in DFP) in de aangepaste code van advertentiemateriaal in tijdens het advertentieweergaveproces.

De macro's voor hoogte en breedte kunnen met name handig zijn als u een advertentiemateriaalsjabloon maakt dat u opnieuw wilt gebruiken voor advertentiemateriaal met verschillende formaten. Met de macro's voor hoogte en breedte hoeft u het formaat voor elke advertentie niet te hardcoderen, maar kunt u de waarden dynamisch invoegen in elke advertentie.

U kunt deze macro's ook gebruiken in de aangepaste code voor advertenties waar u het advertentieformaat heeft overschreven (u kunt dit doen op het tabblad 'Instellingen' van een advertentie). Wanneer u het formaat overschrijft, kunt u meerdere advertentieformaten opgeven. De advertentie kan vervolgens worden weergegeven in advertentieblokken met een van die formaten. U kunt de macro's voor hoogte en breedte gebruiken om de afmetingen dynamisch toe te voegen aan de advertentiemateriaalcode wanneer het advertentiemateriaal wordt weergegeven.

Macro voor patroonovereenkomst
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 verschillende advertentiematerialen wilt weergeven op basis van informatie die bekend is over een gebruiker, zoals diens contentvoorkeuren.

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:

  1. U neemt de aangepaste waarde (in dit geval, het geslacht van de gebruiker) op in een advertentietag op uw pagina via sleutel/waarden:
    googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
    .addService(googletag.pubads())
    .setTargeting("gender", "male");
  2. 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%%
  3. De hele macro %%PATTERN:gender%% wordt vervangen door "male".
  4. Voor deze gebruiker wordt het advertentiebestand 'man' aangeroepen en weergegeven door DFP.

%%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();

Voorbeeld van een passbacktag tussen twee DFP-netwerken

U kunt deze macro gebruiken om een passbacktag in te stellen tussen twee DFP-netwerken ('Netwerk A' en 'Netwerk B').

Hier is een voorbeeld van advertentiemateriaal dat is geboekt in DFP-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 DFP-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>
Voorbeeld van een passbacktag tussen DFP en een advertentieserver van derden

U kunt TARGETINGMAP ook gebruiken in een passbacktag 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 DFP:

<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 DFP, 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/dfp_premium/answer/2811375?hl=en)
 .updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>

Hiervoor kan de derde partij een sjablooncode 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 DoubleClick-tags die url als sleutelnaam hebben, worden overschreven door de verwijzende URL.

Macro voor doel in nieuw venster
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 _blank is, word de macro vervangen door 1.

  • 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 voor doelvenster
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 DFP_News.com is het doelvenster bijvoorbeeld ingesteld op _top en voor het advertentieblok voor DFP_Fashion.com is het ingesteld op _new. Als de macro %%TARGET_WINDOW%% is opgenomen in de advertentiecode, wordt deze vervangen door _top voor gebruikers op DFP_News.com en door _new voor gebruikers op DFP_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.

Macrotag voor content die bedoeld is voor kinderen
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 advertenties van derden. Hiervoor gebruikt u de indeling coppa=%%TFCD%% of een soortgelijke indeling. De macro kan ook worden gebruikt in JavaScript om passbacktagverzoeken 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 0 voor andere content, gebaseerd op informatie over de aard van de pagina, site of mobiele app die het verzoek naar DFP 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 voor URI-codering voor variabelen in advertentiemateriaaltemplates
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).

Deze macro werkt alleen met advertentiemateriaaltemplates, niet met aangepast advertentiemateriaal of advertentiemateriaal van derden. Ook worden er geen tekens dubbel gecodeerd als deze tekens als zijn gecodeerd.
Stel dat uw advertentiemateriaaltemplate een lijstvariabele bevat met de naam 'Color'. Deze variabele bevat de waarden 'dark blue' en 'light green'. DFP voegt standaard [%Color%] toe aan het fragment van uw template voor advertentiemateriaal:

<a href="https://paint.com/wall.html?color=[%Color%]">Paint!</a>

Wanneer het advertentiemateriaal wordt gemaakt, vervangt DFP [%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 het advertentiemateriaalsjabloon gebruikt om een doorklik-URL of verwijzings-URL te definiëren. Zonder de juiste codering werkt de volledige URL in uw advertentiemateriaal mogelijk niet.

Stel dat uw advertentiemateriaalsjabloon een URL-variabele bevat met de naam 'LandingPage'. DFP voegt standaard [%LandingPage%] toe aan het fragment van uw advertentiemateriaalsjabloon:

<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Click here!</a>

Als de [%LandingPage%]-URL queryparameters zoals ?page=home&sport=baseball bevat, 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%]">Click here!</a>
 

[%LandingPage%] https://www.mysportswebsite.com?page=home&sport=baseball
[%URI_ENCODE:LandingPage%] https%3A%2F%2Fwww.mysportswebsite.com%3F
page%3Dhome%26sport%3Dbaseball

Macro's voor het bijhouden van gegevens

Deze macro's worden meestal gebruikt voor tracking- en rapportagedoeleinden.

ALLES UITVOUWEN ALLES SAMENVOUWEN

Cachebuster-macro (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 DoubleClick for Publishers 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%%

Selecteer de standaardadvertentietag en voeg de CACHEBUSTER-macro toe om het aantal verschillen te verkleinen wanneer u DCM-vertoningstracker gebruikt voor DFP.

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.

Klikmacro
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 DFP 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 wanneer 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%% wanneer de kliktracker de parameter is van een andere URL. Meer informatie over het gebruik van macro's met en zonder escapecodes

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

De implementatie van uw klikmacro controleren

Een onjuist geplaatste klikmacro houdt geen klikken bij. Volg deze stappen om te controleren of DFP klikken registreert zoals u dat wilt.

  1. Bekijk een voorbeeld van het advertentiemateriaal.
  2. Klik op het voorbeeld. DFP geeft een bevestiging weer dat klikken worden geregistreerd. Als deze bevestiging niet wordt weergegeven, is uw klikmacro niet goed geïmplementeerd.
    Als uw advertentiemateriaal van derden een omleiding naar een Flash-bestand bevat, wordt er geen bevestiging weergegeven, zelfs niet als uw advertentiemateriaal klikken correct bijhoudt.
Vervangingsmacro's
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

Gebruik de vervangingsmacro's in aangepaste advertentiemateriaalcode of in een doorklik-URL om ID-waarden uit DFP weer te geven wanneer advertentiemateriaal wordt weergegeven op een pagina. Dit wordt vaak gebruikt om ID's van DFP 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 DFP. http://www.site.com/?%eaid!;%ecid! kan bijvoorbeeld worden vervangen door http://www.site.com/?1234567;4265598.

Macro's voor apparaat-ID's (iOS, Android, Roku en tvOS)
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 opnieuw instelbare mobiele advertentie-ID (IDFA voor iOS, AdID voor Android, RIDA voor Roku en tvOS voor Apple TV) verzenden naar uw advertentiepartners voor de levering van op interesses gebaseerde advertenties. Dit maakt het gemakkelijker om toegang tot mobiele advertentie-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 verzenden en de macro %%ADVERTISING_IDENTIFIER_IS_LAT%% om de instelling Beperkte advertentietracking (Limit Ad Tracking; LAT) te verzenden, waarmee gebruikers zich kunnen afmelden voor targeting op basis van gebruikersgedrag.

Apparaat-ID's worden geleverd door het besturingssysteem van het apparaat en kunnen worden gereset door de gebruiker. Meer informatie

Vereisten

  • Uw mobiele app moet zijn voorzien van de nieuwste versie van de SDK voor mobiele advertenties van Google.
  • 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 IDFA/AdID/RIDA/tvOS-waarde, maar wordt het advertentiemateriaal nog steeds weergegeven.

Hoe het werkt

  1. In DFP neemt de uitgever de macro's op in zijn advertentiemateriaal-/tracking-URL's.
  2. De macro's worden vervangen door de IDFA/AdID/RIDA/tvOS van de gebruiker, het apparaattype en/of de instelling 'Beperkte advertentietracking', die vervolgens worden opgenomen in het advertentiemateriaal wanneer 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 ingeschakeld. In deze gevallen retourneert deze macro een lege tekenreeks ("").

Indeling

Voor iOS, Roku en tvOS verstuurt deze macro 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 voor voorbeeldmodus
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 DFP-voorbeeld en door false als het een gewone vertoning betreft.

Schemamacro
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>

Sitemacro
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 voor weergegeven vertoningen
Macro Escaping
%%VIEW_URL_ESC%% Escapecodes
%%VIEW_URL_UNESC%% Zonder escapecodes

Met de macro voor weergegeven vertoningen kan DFP een vertoning tellen wanneer advertentiemateriaal wordt bekeken in plaats van wanneer dit wordt weergegeven. Deze macro wordt voornamelijk gebruikt voor interstitials of vergelijkbaar advertentiemateriaal.

Deze macro werkt in combinatie met signalen in de advertentietag die DFP laten weten dat de vertoning niet onmiddellijk moet worden geteld. Voor GPT is dit van toepassing op tags die d_imp=1 bevatten voor vertraagde vertoningen.

Als het advertentiemateriaal wordt weergegeven voor tags die geen van deze signalen bevatten, vervangt DFP de macro door "".

Videomacro's

Deze macro's worden doorgaans gebruikt in videoadvertentiemateriaal om details over de context of content op te nemen.

ALLES UITVOUWEN ALLES SAMENVOUWEN

Macro voor beschrijvende URL van video
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.

DFP ondersteunt ook %%DESCRIPTION_URL%%, die precies hetzelfde doet als %%DESCRIPTION_URL_UNESC%%. Het is dus niet nodig om ouder advertentiemateriaal en oudere sjablonen opnieuw te coderen.
Macro voor verwijzende URL naar video URL macro
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: DFP parseert de URL-queryparameter van de advertentietag, isoleert de verwijzende URL en vervangt de macrotekst door die URL. De macro werkt alleen met de Google IMA-SDK en wanneer aan de volgende vereisten wordt voldaan:

  • Deze macro werkt alleen als scripttoegang is ingeschakeld op de pagina.
  • De macro werkt niet in een iframe.
DFP ondersteunt ook %%REFERRER_URL%%, die precies hetzelfde doet als %%REFERRER_URL_UNESC%%. Het is dus niet nodig om ouder advertentiemateriaal en oudere sjablonen opnieuw te coderen.

Macro's voor videocontent

Deze macro's worden gebruikt voor advertenties die bronnen met videocontent targeten. Deze functie is niet beschikbaar in DFP Small Business.

CMS ID-macro
Macro
%%CMS_ID%%

Wordt vervangen door de ID van de DFP-contentbron (CMS-ID) die momenteel wordt afgespeeld. Deze waarde wordt niet weergegeven in uw MRSS-feed, maar is zichtbaar in de DFP-gebruikersinterface.

Deze macro werkt alleen in een in DFP geconfigureerde advertentietag binnen een contentbron voor video on demand met dynamische advertentie-invoeging.

Stream-ID
Macro
%%STREAM_ID%%

De macro vervangt de waarde door de sessiestream-ID voor de contentbron die momenteel wordt afgespeeld.

Deze macro werkt alleen in een in DFP geconfigureerde advertentietag binnen een contentbron met dynamische advertentie-invoeging.

IP-adres van gebruiker
Macro
%%USER_IP%%

De macro vervangt de waarde door het IP-adres van de gebruiker.

Deze macro werkt alleen in een in DFP geconfigureerde advertentietag binnen een contentbron met dynamische advertentie-invoeging.

Macro voor videoduur, in milliseconden
Macro
%%VIDEO_DURATION%%

De macro vervangt de waarde door de duur van de video in milliseconden.

Macro voor videoduur, in seconden
Macro
%%VIDEO_DURATION_SEC%%

De macro vervangt de waarde door de duur van de video in seconden.

Macro voor Video-ID
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 voor videometadata
Macro
%%VIDEO_METADATA:key%%

 De macro vervangt de waarde door metadata over de video waar de advertentie wordt weergegeven op basis van sleutel/waarden die zijn gekoppeld aan de videocontent. De sleutel/waarden zijn ingesteld in DFP op het tabblad Video.

Macro voor videotitel
Macro Escaping
%%VIDEO_TITLE%% Enkele escapecodes

De macro voor de videotitel wordt vervangen door de titel van een video zoals gedefinieerd in DFP.

Voor deze macro is opname van content vereist. Deze functie is niet beschikbaar in DFP Small Business.

Aangepaste advertentie-ID (FreeWheel)
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.

Nathan is een DFP-expert en auteur van deze pagina. Help hem bij het verbeteren van de content door hieronder feedback te geven.

Was dit artikel nuttig?
Hoe kunnen we dit verbeteren?