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.

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 voor installatiesadvertenties.
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 als het platform geen van bovenstaande items is
varchar(50)
${CS_DEVICE_MODEL}
(ComScore) De naam van het apparaatmodel, URL-gecodeerd.
string
${CS_IMPLEMENTATION_TYPE}

(ComScore) De omgeving waarin de advertentie is bediend:

  • a = mobiele toepassing
  • b = mobiele website
string (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 als het platform geen van 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 al dan niet heeft gekozen voor het volgen van advertenties:

  • 1 (DNT-markering = 1) = de gebruiker heeft de advertentie niet bijgehouden
  • 0 (DNT-markering = 0) = de gebruiker heeft zich aangemeld voor het bijhouden van advertenties
integer (0 of 1)
${TM_BUNDLE}
De iOS of Android bundel-id van 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 de GDPR-handhaving vereist:

  • 1 = GDPR moet worden afgedwongen
  • 0 = 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 toestemming
  • 1 = toestemming
desybit of integer

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.

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