DFP-macro's

In DoubleClick for Publishers zijn macro's tekststrings die de DoubleClick-advertentieserver vervangt door andere tekststrings op basis van een set regels. Ze kunnen worden opgenomen in elke code die wordt verwerkt door de advertentieserver tijdens het weergaveproces: advertentiecode van derden of aangepaste advertentiecode, DoubleClick Rich Media-code, doorklik-URL's, DFP-tags, zelfs in Flash-bestanden die worden gehost door DFP.

Voor elke macro hebben we gebruikssuggesties gegeven. Het is echter helemaal aan u hoe u macro's gebruikt. Net als met de DoubleClick for Publishers API kunt u macro's inzetten voor doeleinden die voor u het meest waardevol zijn.

Macro's zijn hoofdlettergevoelig. De macro %%CACHEBUSTER%% werkt bijvoorbeeld wel, maar de macro %%Cachebuster%% niet.

URL-macro's met escapecodes, met dubbele escapecodes en zonder escapecodes

URL-macro's zoals de bestemmings-URL-macro, klikmacro, macro voor bekeken vertoningen en bepaalde videospecifieke macro's, zijn beschikbaar als varianten zonder escapecodes en met dubbele escapecodes. Het is belangrijk dat u begrijpt wanneer u welke variant van deze macro's moet kiezen. Daarom raden we u aan het artikel over URL-macro's met en zonder escapecodes te lezen.

Macro's toevoegen aan advertentiecode

Een van de belangrijkste toepassingen van macro's is in de advertentiecode van aangepaste advertenties en advertenties van derden. Als DFP voor advertenties van derden de derde partij herkent, worden de macro's automatisch ingevoegd. Voor aangepaste advertenties en advertentiesjablonen moet u de macro's handmatig toevoegen.

Ondersteunde macro's

DoubleClick for Publishers ondersteunt de volgende macro's. We hebben ze ingedeeld op basis van de doeleinden waarvoor ze het meest worden gebruikt. Macro's zijn echter zeer flexibele tools die u anders kunt gebruiken.

Macro's voor weergeven

Deze macro's worden het meest gebruikt voor het weergeven van advertentiemateriaal en zorgen ervoor dat het advertentiemateriaal er goed uitziet en correct functioneert.

Macro voor advertentieblok
Macro
%%ADUNIT%%

U kunt de macro ADUNIT als volgt toevoegen aan een advertentietag:

.definePassback('%%ADUNIT%%', [468, 60])

Hier volgt een voorbeeld van hoe het advertentieblokpad kan worden vervangen wanneer de advertentie wordt weergegeven:

.definePassback('/ad/unit/path', [468, 60])
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 de advertentie, 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 aangepaste advertenties en advertentiesjablonen. Als de advertentiecode de doorklik-URL van de advertentie moet bevatten en de doorklik-URL verandert wanneer de advertentie 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 aangepaste advertentiecode 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 oudere advertenties en sjablonen niet opnieuw te coderen.
Macro voor bestandsserver
Macro
%%FILE:file_display_name%%

De macro voor de bestandsserver %%FILE:file_display_name%% kan worden gebruikt in de code van aangepast advertentiemateriaal. De macro wordt vervangen door de volledige URL van een advertentiemateriaalitem dat is geüpload naar het advertentiemateriaal. Dit kan handig zijn als uw aangepaste advertentiecode het item moet aanroepen.

Als u de macro wilt gebruiken, vervangt u file_display_name door de weergavenaam van het advertentie-item, zoals weergegeven in DFP wanneer u de advertentiedetails bekijkt.

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

Deze macro's voegen de advertentiehoogte en -breedte in de aangepaste code van een advertentie in tijdens het advertentieweergaveproces.

De macro's voor hoogte en breedte kunnen met name handig zijn als u een advertentiesjabloon maakt die u opnieuw wilt gebruiken voor advertenties 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 advertentiecode wanneer de advertentie 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 targetingstring 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.

%%PATTERN:key%%

U heeft bijvoorbeeld twee advertentiematerialen voor een bepaald regelitem: een die bedoeld is voor vrouwelijke gebruikers en een voor mannelijke gebruikers. 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-string 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%%

De macro voor doel in nieuw venster wordt vervangen door een waarde die overeenkomt met het doelvenster dat is opgegeven voor de uitgever en advertentieruimte waar een advertentie wordt weergegeven:

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

Macro voor doelvenster
Macro
%%TARGET_WINDOW%%

De macro voor doelvenster wordt vervangen door het doelvenster dat is opgegeven voor het advertentieblok waar een advertentie wordt weergegeven. U kunt de macro gebruiken in de code van een advertentie om aan te geven of een klik op de advertentie 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>

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 appniveau wilt behandelen als content die bedoeld is voor kinderen, bekijkt u het gedeelte Een site of app taggen voor de behandeling van content die bedoeld is voor kinderen.

Macro voor URI-escaping
Macro
[%URI_ENCODE:variabele%]

De macro voor URI-escaping kan ervoor zorgen dat waarden die worden ingevoegd in URI's, correct worden opgemaakt, met alle benodigde escaping voor tekens als spaties. Als u bijvoorbeeld queryparameters dynamisch toevoegt aan een URL en sommige van die queryparameters spaties bevatten, kunt u de macro voor URI-escaping gebruiken om ervoor te zorgen dat de querywaarden worden opgemaakt als geldige strings voor een URL.

Houd er rekening mee dat de macro de tekens die al zijn gecodeerd, niet dubbel codeert. Een punt (.) wordt bijvoorbeeld gecodeerd als "%3A". Maar de macro laat "%3A" ongewijzigd, omdat deze al is gecodeerd.

Deze macro werkt alleen met advertentiesjablonen, niet met aangepaste advertenties of advertenties van derden.

Advertentiesjabloonvariabelen gebruiken als queryparameters

Met de macro voor URI-codering kunnen advertentiesjabloonvariabelen worden gebruikt als queryparameters.

Een advertentiesjabloon heeft bijvoorbeeld een lijstvariabele 'Smaak', die wordt gebruikt voor een smaak ijs, met de mogelijke waarden 'chocolate fudge brownie', 'rum rozijnen', enzovoort. De opmaaktool voor advertentiesjablonen neemt de volgende code op:

<a href="http://icecreamflavors.com/interested-in-flavor.php?flavor=[%Flavor%]">Klik hier!</a>

De variabele 'smaak' moet zijn voorzien van correcte URI-codering, anders bevat de uiteindelijke doorklik-URL spaties en werkt deze niet:

http://icecreamflavors.com/interested-in-flavor.php?flavor=chocolate fudge brownie

Geef [%URI_ENCODE:variable%] op in de opmaaktool voor advertentiemateriaalsjablonen om te voorkomen dat dit gebeurt. Geef vervolgens de waarden voor variable op. In ons voorbeeld geeft u chocodate fudge brownie, rum rozijnen, enzovoort op. Het resultaat is dat de spaties in de variabelen worden voorzien van escapecodes en worden vervangen door %20, wat leidt tot een werkende URL:

http://icecreamflavors.com/interested-in-flavor.php?flavor=Chocolate%20Fudge%20Brownie

Advertentiesjabloonvariabelen gebruiken als omleidingen

Om voor de juiste URL-opmaak te zorgen, gebruikt u de macro voor URI-escaping wanneer een sjabloonvariabele wordt opgenomen als omleiding.

U heeft bijvoorbeeld de volgende code in uw sjabloon:

<a href="%%CLICK_URL_UNESC%%[%click-throughURL1%]">Klik hier!</a>

Als de waarde van click-throughURL1 queryparameters (?k1=v1&k2=v2) bevat, krijgt de URL een ongeldige opmaak 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 omleidings-URL. Om ervoor te zorgen dat de URL de juiste opmaak heeft, geeft u in de opmaaktool voor advertentiemateriaalsjablonen de variabele click-throughURL1 op met de URI-coderingsmacro: <a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:click-throughUrl1%]">Klik hier!</a>

Macro's voor het bijhouden van gegevens

Deze macro's worden voornamelijk of het meest gebruikt voor doeleinden met betrekking tot het bijhouden van gegevens en rapportage.

Cachebuster-macro (willekeurig nummer)
Macro
%%CACHEBUSTER%%

De cachebuster-macro zorgt ervoor dat er elke keer dat de code wordt uitgevoerd, een nieuwe aanvraag naar de advertentieserver wordt verzonden, zodat de vertoningen nauwkeurig worden geteld. Als u de cachebuster-macro niet toevoegt aan de advertentiecode, 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 advertenties 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%%

Als u niet zeker weet hoe u cachebuster-macro's op de juiste manier in uw advertenties van derden moet plaatsen, neemt u contact op met de leverancier die uw advertenties heeft gemaakt.

Klikmacro
Macro Escaping
%%CLICK_URL_ESC_ESC%% Dubbele escapecodes
%%CLICK_URL_UNESC%% Zonder escapecodes

Met een klikmacro kunt u klikken op advertenties van derden bijhouden.

Als algemene regel gebruikt u een klikmacro zonder escapecodes wanneer de advertentie die op een andere server wordt gehost, een standaardafbeeldingsbestand (GIF/JPG) is. Gebruik de klikmacro met dubbele escapecodes %%CLICK_URL_ESC_ESC%% voor Flash-advertenties (SWF) en voor bepaalde derden. U kunt een voorbeeld van de advertentie bekijken en met de rechtermuisknop klikken om het bijbehorende bestandstype te bepalen. Als in het snelmenu de optie 'Afbeelding opslaan als' of 'Beeld opslaan als' wordt weergegeven, is de advertentie een standaardbeeldadvertentie. Als u de optie 'Over Adobe Flash Player' ziet, is de advertentie een Flash-advertentie

Voor gecertificeerde derden voegt DFP de juiste klikmacro automatisch in. Als u niet zeker weet welke klikmacro u moet gebruiken of waar u deze moet plaatsen in de advertentiecode, neemt u ter bevestiging contact op met de betreffende derde partij. Onjuist geplaatste klikmacro's houden waarschijnlijk geen klikken bij.

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.

Controleren of uw advertentie klikken correct bijhoudt:

  1. Bekijk een voorbeeld van de advertentie.

  2. Klik op het voorbeeld. Als er klikken worden geregistreerd, geeft DFP een bevestiging weer om u dit te laten weten. (Als de advertentie van derden omleidt naar een Flash-bestand, wordt de bevestiging niet weergegeven, zelfs niet als uw advertentie klikken correct bijhoudt.)
DFP ondersteunt ook de macro's %%CLICK_URL%% en %%CLICK_URL_ESC%%, die precies hetzelfde doen als %%CLICK_URL_ESC_ESC%%. We raden u aan om voor de duidelijkheid %%CLICK_URL_ESC_ESC%% te gebruiken, maar u hoeft oudere advertenties en sjablonen niet opnieuw te coderen.

 

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

De vervangingsmacro's kunnen worden gebruikt in aangepaste advertentiecode of in een doorklik-URL. Ze worden het meest gebruikt om regelitems bij te houden met uw backend-rapportagesysteem. U kunt de ID's van DFP koppelen aan ID's in uw eigen database. De informatie die u op deze manier opslaat, kan nuttig zijn voor het oplossen van problemen.

U kunt de vervangingsmacro invoegen aan het einde van de doorklik-URL van het regelitem (of de doorklik-URL voor de advertentie als u de URL van het regelitem overschrijft). In http://www.firstautomobile.com/?%ecid! wordt bijvoorbeeld de advertentie-ID voor het regelitem ingevoegd.

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 voor IDFA/AdID doorgeven
Macro
%%ADVERTISING_IDENTIFIER_PLAIN%%
 

Met deze macro kunnen in-app-uitgevers een opnieuw instelbare mobiele advertentie-ID (IDFA voor iOS, AdID voor Android) 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. De procedure is als volgt:

  1. In DFP neemt de uitgever de macro op in zijn advertentiemateriaal-/tracking-URL's.
  2. De macro wordt vervangen door de IDFA/AdID van de gebruiker, die vervolgens wordt opgenomen in het advertentiemateriaal wanneer aanroepen aan derden worden gedaan.
U moet het volgende doen voordat u deze macro kunt gebruiken:
  1. Zorg ervoor dat u de nieuwste versie van de SDK voor mobiele advertenties van Google gebruikt.
  2. Google doet grote inspanningen om van HTTPS de nieuwe standaard te maken voor alle advertentieweergave. Bijna alle DFP-app-advertenties worden nu weergegeven via HTTPS (er kunnen kleine afwijkingen zijn vanwege andere factoren waardoor in bepaalde situaties HTTPS momenteel niet kan worden gebruikt). Naast deze beveiliging op advertentieverzoekniveau die automatisch wordt toegepast, moet u enkele stappen volgen om HTTPS-versleuteling voor advertentiemateriaal in te stellen. 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, wordt de macro niet vervangen door de IDFA/AdID-waarde, maar wordt het advertentiemateriaal nog steeds geleverd.
 

Indeling (gelijk voor Android en iOS)

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). Bijvoorbeeld:

201F2EB1-8041-9E39-CD07-FCBBA5A29B41

Macro voor voorbeeldmodus
Macro
%%PREVIEW_MODE%%

U kunt de macro voor de voorbeeldmodus gebruiken 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 de advertentie 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 een advertentie 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 advertentie 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 een advertentie wordt bekeken in plaats van wanneer deze wordt weergegeven. Deze macro wordt voornamelijk gebruikt voor interstitial of vergelijkbare advertenties. De macro wordt automatisch opgenomen in de code voor bepaalde ingebouwde sjablonen voor pop-up- en pop-underadvertenties. U kunt de macro ook toevoegen aan de code van aangepaste sjablonen. De macro wordt vervangen door een URL met de informatie die DFP nodig heeft om de vertoning te registreren.

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 de advertentie wordt weergegeven voor tags die geen van deze signalen bevatten, vervangt DFP de macro door "".

 

Videospecifieke macro's

Veel uitgevers hebben toegang tot de beschrijvende URL en verwijzende URL nodig, die beide door DoubleClick for Publishers Small Business worden ondersteund.

Macro voor beschrijvende URL van video
Macro Escaping

%%DESCRIPTION_URL_UNESC%%

Zonder escapecodes

%%DESCRIPTION_URL_ESC_ESC%%

Dubbele escapecodes

Gebruik %%DESCRIPTION_URL_ESC_ESC%% (dubbele escapecodes) als de macro zich in een URL bevindt en gebruik %%DESCRIPTION_URL_UNESC%% (zonder escapecodes) in andere contexten.

In omleidende advertentietags vervangt de beschrijvende URL-parameter de queryparameter description_url van de oorspronkelijke GPT-advertentietag. De beschrijvende URL is doorgaans gelijk aan de verwijzende URL. U moet de description_url opgeven in de GPT-advertentietag 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 oudere advertenties en sjablonen opnieuw te coderen.
Macro voor verwijzende URL naar video URL macro
Macro Escaping

%%REFERRER_URL_UNESC%%

Zonder escapecodes

%%REFERRER_URL_ESC_ESC%%

Dubbele escapecodes

Gebruik %%REFERRER_URL_ESC_ESC%% dubbele escapecodes) als de macro zich in een URL bevindt en gebruik %%REFERRER_URL_UNESC%% (zonder escapecodes) in elke andere context.

 

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 oudere advertenties en sjablonen opnieuw te coderen.
Was dit artikel nuttig?