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.

Macro
Beschrijving van vervanging
Type
${TM_ACCOUNT_ID}
De account-id.
integer
${TM_AD_ID}
De ad-toets (adKey).
string
${TM_AD_ID_NUM}
De advertentie-id.
integer
${TM_ADVERTISER_ID}
De adverteerder-id.
integer
${TM_CAMPAIGN_ID}
De campagnesleutel.
string
${TM_CAMPAIGN_ID_NUM}
De campagne-id.
integer
${TM_CLICK_URL}
De omleidings-URL, waarmee advertentieservers kunnen bijhouden en tellen en klikken. Wanneer de advertentie wordt aangeboden en de gebruiker erop klikt, wordt de macro geactiveerd en wordt de klik geregistreerd en geteld voor rapportagedoeleinden.
string
${TM_CLICK_URL_URLENC}
De gecodeerde omleidings-URL, waarmee ad-servers kunnen bijhouden en tellen en klikken. Wanneer de advertentie wordt aangeboden en de gebruiker erop klikt, wordt de macro geactiveerd en wordt de klik geregistreerd en geteld voor rapportagedoeleinden. Gebruik deze macro alleen als u advertenties van derden maakt en uw leverancier URL-codering vereist.
string
${TM_FEED_ID}
De sleutel voor de mediaplaatsing (feedKey).
string
${TM_FEED_ID_NUM}
De id voor de plaatsing van het medium.
integer
${TM_MACRO_PLACEMENT_SITE_KEY
De sitecode voor de plaatsing. Vereist voor AppsFlyer klik op Trackers voor mobiele apps om advertenties te installeren.
string
${TM_PLACEMENT_ID}
De plaatsingssleutel (cpKey).
string
${TM_PLACEMENT_ID_NUM}
De plaatsing-id.
integer
${TM_RANDOM}
Cachebuster: een willekeurig getal tussen 1 en 1000000.
lang
${TM_SESSION_ID}
De id van de sessie, die overeenkomt met één ophaalbewerking van de advertentietag.
string
${TM_SITE_DOMAIN_URLENC}
Het subdomein van de pagina dat vanuit de URL in de biedaanvraag is geparseerd; URL-gecodeerd. Niet ondersteund voor in-banner, klik-aan-spel advertenties.
string
${TM_SITE_NAME}
De sitenaam voor de plaatsing.
string
${TM_SITE_URL_URLENC}
De URL die in de biedaanvraag is doorgegeven; URL-gecodeerd. Niet ondersteund voor in-banner, klik-aan-spel advertenties.
string
${TM_SITE_ID_NUM}
De site-id voor de plaatsing.
integer
${TM_TIMESTAMP}
De Unix-tijdstempel die aangeeft hoeveel seconden zijn verstreken sinds middernacht (00:00 UTC) op 1 januari 1970.
lang
${TM_VIDEO_DURATION}
De duur van de advertentievideo in seconden.
integer

Mobiele macro's

Macro
Beschrijving van vervanging
Type
${CS_PLATFORM_ID}

(ComScore) De platform-id, die overeenkomt met het besturingssysteem van het apparaat:

  • ios = Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • other wanneer het platform geen van de bovenstaande items is
varchar(50)
${CS_DEVICE_MODEL}
(ComScore) De naam van het apparatenmodel, URL-Gecodeerd.
string
${CS_IMPLEMENTATION_TYPE}

(ComScore) Het milieu waarin de advertentie werd gediend:

  • a = mobiele toepassing
  • b = mobiele website
tekenreeks (a of b)
${NS_PLATFORM_ID}

(Nielsen) De platform-id, die overeenkomt met het besturingssysteem van het apparaat:

  • ios= Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • other wanneer het platform geen van de bovenstaande items is
string
${NS_DEVICE_GROUPING}

(Nielsen) Het apparaattype waarop de advertentie viewer was:

  • TAB = tablet
  • PHN = mobiel
  • computer = computer
string
${UOO}

(Nielsen) Of de gebruiker het volgen van advertenties al dan niet heeft uitgeschakeld:

  • 1 (DNT-markering = 1) = de gebruiker heeft de advertentie niet bijgehouden
  • 0 (DNT-markering = 0) = de gebruiker heeft zich aangemeld voor advertentie-tracking
integer (0 of 1)
${TM_BUNDLE}
De bundel-id voor de iOS - of Android -app-store. Voorbeelden: com.zynga.wwf2.free of id804379658
string
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 afgedwongen
  • 0 = 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 toestemming
  • 1 = toestemming
desybit of integer

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.

Macro
Beschrijving van vervanging
Type
${TM_CLICK_URL}
De omleidings-URL waarmee advertentieservers het platform kunnen bijhouden, tellen en klikken.
string
${TM_CLICK_URL_URLENC}
De omleidings-URL waarmee advertentieservers die URL-codering nodig hebben, kunnen worden bijgehouden en geteld en op het platform kunnen worden geklikt.
string

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 } .
recommendation-more-help
9ff4800f-94be-45f0-a5bf-09d0d7e96baa