Advertising DSP Macros
Een macro is een korte opdracht of korte opdracht voor een instructie en volgt doorgaans de indeling ${MACRO_NAME}
. Macro's die zijn opgenomen in creatieve code of doorklikken-URL's, worden uitgebreid naar een langere codereeks die de advertentieserver kan begrijpen. De DSP en de server voeren macro's uit wanneer de advertentie wordt bediend of geklikt.
Servermacro's zijn handig om belangrijke informatie door te geven aan DSP of aan externe ad-hocservers. Macro's worden het meest gebruikt tijdens de handel in creatieve code of meta-gegevens van derden en douane (zoals derdepixel).
U kunt een macro overal, zoals in een markering VAST, in om het even welke URL, of in een DSP of derdegebeurtenispixel manueel opnemen. Elke DSP-client en -partner heeft echter een andere indeling voor een advertentietag en de macro's moeten dienovereenkomstig op verschillende plaatsen in de tag worden ingevoegd. Elke keer dat u met een nieuwe klant of partner werkt, vraagt u hen om documentatie over waar u de macro's in hun advertentietags moet invoegen die door DSP worden verhandeld.
Algemene trackingsmacro's
Gebruik algemene 'tracking'-macro's voor alle advertentietypen en tagtypen om zo nodig specifieke gegevens door te geven.
${TM_ACCOUNT_ID}
${TM_AD_ID}
${TM_AD_ID_NUM}
${TM_ADVERTISER_ID}
${TM_CAMPAIGN_ID}
${TM_CAMPAIGN_ID_NUM}
${TM_CLICK_URL}
${TM_CLICK_URL_URLENC}
${TM_FEED_ID}
${TM_FEED_ID_NUM}
${TM_MACRO_PLACEMENT_SITE_KEY
${TM_PLACEMENT_ID}
${TM_PLACEMENT_ID_NUM}
${TM_RANDOM}
${TM_SESSION_ID}
${TM_SITE_DOMAIN_URLENC}
${TM_SITE_NAME}
${TM_SITE_URL_URLENC}
${TM_SITE_ID_NUM}
${TM_TIMESTAMP}
${TM_VIDEO_DURATION}
Mobiele macro's
${CS_PLATFORM_ID}
(ComScore) De platform-id, die overeenkomt met het besturingssysteem van het apparaat:
ios
= Apple iOSandroid
= Google Androidwindows
= Windows Mobileblackberry
= Blackberryother
wanneer het platform geen van de bovenstaande items is
${CS_DEVICE_MODEL}
${CS_IMPLEMENTATION_TYPE}
(ComScore) Het milieu waarin de advertentie werd gediend:
a
= mobiele toepassingb
= mobiele website
a
of b
)${NS_PLATFORM_ID}
(Nielsen) De platform-id, die overeenkomt met het besturingssysteem van het apparaat:
ios
= Apple iOSandroid
= Google Androidwindows
= Windows Mobileblackberry
= Blackberryother
wanneer het platform geen van de bovenstaande items is
${NS_DEVICE_GROUPING}
(Nielsen) Het apparaattype waarop de advertentie viewer was:
TAB
= tabletPHN
= mobielcomputer
= computer
${UOO}
(Nielsen) Of de gebruiker het volgen van advertenties al dan niet heeft uitgeschakeld:
1
(DNT-markering = 1) = de gebruiker heeft de advertentie niet bijgehouden0
(DNT-markering = 0) = de gebruiker heeft zich aangemeld voor advertentie-tracking
0
of 1
)${TM_BUNDLE}
gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}
gdpr=${GDPR_ENFORCED}
geeft aan of de bieder bepaalt dat het bod afkomstig is uit de Europese Unie en dat GDPR-handhaving vereist:
1
= GDPR moet worden afgedwongen0
= GDPR mag niet worden afgedwongen
gdpr_consent=${GDPR_CONSENT}
is de waarde van de toestemming die door de leverancier is doorgegeven in de binnenkomende biedaanvraag:
- In de meeste gevallen is dit een basis64url-gecodeerde toestemmingskoord, of madeliefje (voorbeeld: BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMBkIDIgM0AgOJxAnQA)
0
= geen toestemming1
= toestemming
Klik op Macro's voor externe weergaveadvertenties
DSP vereist een klikmacro voor de weergave om op nauwkeurige wijze te kunnen bijhouden voor advertenties die gebruikmaken van externe weergavetags. Er is slechts één versie van de macro vereist; de relevante macro is afhankelijk van het type code.
${TM_CLICK_URL}
${TM_CLICK_URL_URLENC}
DSP voegt automatisch klikmacro's in een weergavetag van derden in wanneer u:
- Advertentietags exporteren van een advertentieserverpartner
- Bulkupload Flashtalking of Google DoubleClick for Advertisers advertentietags direct in DSP
Als een klikmacro ontbreekt wanneer u een vertoningsadvertentie bouwt, toont DSP een waarschuwingsbericht, dat u ertoe aanzet om de aangewezen vertoning manueel op te nemen klikt macro in het correcte gebied van de markering.
Analytics for Advertising Macro's
Voor extra macro's beschikbaar specifiek voor Analytics for Advertising klanten, zie " Analytics for Advertising Macro's aan Flashtalking Advertentietags"toevoegen en " voegt Analytics for Advertising Macro's aan Google Campaign Manager 360 toe - Markeringen."
Problemen met macrofouten oplossen
Wanneer u macro's aan uw code toevoegt, zorg ervoor u de nauwkeurige syntaxis van de macro gebruikt. Bij het valideren van de macro's controleert DSP of de macro precies overeenkomt met een van de geldige macro's.
Er worden fouten gegenereerd als er tekens ontbreken aan het begin of einde van de macronaam. Er wordt bijvoorbeeld een foutbericht weergegeven als:
- U vergeet een of meer tekens aan het begin van de macronaam, zoals
${
. Als u de volledige syntaxis niet opneemt, wordt het item niet herkend als een geldige macro. - De macro eindigt niet met een geldige set tekens, zoals
}
.