Reclame DSP Macro's
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 server voeren macro's uit wanneer de advertentie wordt aangeboden of wanneer op de advertentie wordt geklikt.
Servermacro's van de advertentie 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 client of partner werkt, vraagt u hen om documentatie over de plaats waar de macro's in hun advertentietags moeten worden ingevoegd die DSP.
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
als het platform geen van bovenstaande items is
${CS_DEVICE_MODEL}
${CS_IMPLEMENTATION_TYPE}
(ComScore) De omgeving waarin de advertentie is bediend:
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
als het platform geen van bovenstaande items is
${NS_DEVICE_GROUPING}
(Nielsen) Het apparaattype waarop de advertentie viewer was:
TAB
= tabletPHN
= mobielcomputer
= computer
${UOO}
(Nielsen) Of de gebruiker al dan niet heeft gekozen voor het volgen van advertenties:
1
(DNT-markering = 1) = de gebruiker heeft de advertentie niet bijgehouden0
(DNT-markering = 0) = de gebruiker heeft zich aangemeld voor het bijhouden van advertenties
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 de GDPR-handhaving vereist:
1
= GDPR moet worden afgedwongen0
= GDPR dient niet te worden afgedwongen
gdpr_consent=${GDPR_CONSENT}
is de waarde van de instemming die door de leverancier in het binnenkomende biedverzoek is doorgegeven:
- 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
Als u kliks voor advertenties op nauwkeurige wijze wilt bijhouden met behulp van externe weergavetags, DSP is een klikmacro voor de weergave vereist. 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 de weergave van klikmacro's in een externe weergavetag in wanneer u:
- Advertentietags exporteren van een partner van een advertentieserver
- Bulkupload Flashtalking of Google DoubleClick for Advertisers tags rechtstreeks in DSP plaatsen
Als een klikmacro ontbreekt wanneer u een vertoningsadvertentie bouwt, DSP toont een waarschuwingsbericht, die u ertoe aanzet om de aangewezen vertoning manueel op te nemen klikt macro in het correcte gebied van de markering.
Analytics for Advertising Macros
Voor extra macro's die specifiek beschikbaar zijn voor Analytics for Advertising klanten, zie "Toevoegen Analytics for Advertising Macro's naar Flashtalking Labels toevoegen" en "Toevoegen Analytics for Advertising Macro's naar Google Campaign Manager 360 Labels toevoegen."
Problemen met macrofouten oplossen
Wanneer u macro's aan uw code toevoegt, zorg ervoor u de nauwkeurige syntaxis van de macro gebruikt. Wanneer u de macro's valideert, controleert DSP of de macro exact 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
}
.