Advertising DSP Macros

Ett makro är ett kort kommando eller en förkortning för en instruktion och följer vanligtvis formatet ${MACRO_NAME}. Makron som ingår i den kreativa koden eller klickbara URL:er utökas till en längre kodsträng som annonsservern kan förstå. DSP och server kör makron när annonsen hanteras eller klickas.

Ad-servermakron är användbara när du vill skicka viktig information till DSP eller till annonsservrar från tredje part. Makron används oftast vid handel med kod eller metadata från tredje part (t.ex. pixlar från tredje part).

Du kan infoga ett makro manuellt var som helst, t.ex. i en VAST-tagg, i en URL eller i en DSP eller en händelsepixel från tredje part. Varje DSP klient och partner har dock olika annonstaggformat och makrona bör infogas på olika ställen i taggen. Varje gång du arbetar med en ny kund eller partner måste du be dem om dokumentation om var makrona i deras annonstaggar som DSP trafik ska infogas.

Spårningsmakron

Använd allmänna spårningsmakron för alla annons- och taggtyper för att skicka tillbaka specifika data efter behov.

Makro
Ersättningsbeskrivning
Typ
${TM_ACCOUNT_ID}
Konto-ID.
heltal
${TM_AD_ID}
Annonsnyckeln (adKey).
string
${TM_AD_ID_NUM}
Annons-ID.
heltal
${TM_ADVERTISER_ID}
Annonsörs-ID.
heltal
${TM_CAMPAIGN_ID}
Kampanjnyckeln.
string
${TM_CAMPAIGN_ID_NUM}
Kampanjens ID.
heltal
${TM_CLICK_URL}
Omdirigerings-URL, som gör det möjligt för annonsservrar att spåra och räkna annonsklickningar. Om användaren klickar på annonsen aktiveras makrot och klickningen registreras och räknas i rapporteringssyfte.
string
${TM_CLICK_URL_URLENC}
Den kodade omdirigerings-URL:en, som gör det möjligt för annonsservrar att spåra och räkna annonsklickningar. Om användaren klickar på annonsen aktiveras makrot och klickningen registreras och räknas i rapporteringssyfte. Använd inte det här makrot om du inte skapar annonser från tredje part och leverantören kräver URL-kodning.
string
${TM_FEED_ID}
Nyckeln för medieplaceringen (feedKey).
string
${TM_FEED_ID_NUM}
ID för mediaplaceringen.
heltal
${TM_MACRO_PLACEMENT_SITE_KEY
Platsnyckeln för placeringen. Krävs för AppsFlyer klicka på spårare för mobilappsinstallationsannonser.
string
${TM_PLACEMENT_ID}
Placeringsnyckeln (cpKey).
string
${TM_PLACEMENT_ID_NUM}
Placerings-ID.
heltal
${TM_RANDOM}
Cachebuster: ett slumpmässigt tal mellan 1 och 100000.
long
${TM_SESSION_ID}
Sessionens ID, som motsvarar en enda hämtning av annonstaggen.
string
${TM_SITE_DOMAIN_URLENC}
Den sidunderdomän som tolkas från URL:en i anbudsförfrågan, URL-kodad. Stöds inte för annonser i banner, click-to-play.
string
${TM_SITE_NAME}
Platsnamnet för placeringen.
string
${TM_SITE_URL_URLENC}
Den URL som skickades i anbudsförfrågan, URL-kodad. Stöds inte för annonser i banner, click-to-play.
string
${TM_SITE_ID_NUM}
Platsens ID för placeringen.
heltal
${TM_TIMESTAMP}
Unix-tidsstämpeln anger hur många sekunder som har gått sedan midnatt (00:00 UTC) den 1 januari 1970.
long
${TM_VIDEO_DURATION}
Annonsvideons längd i sekunder.
heltal

Mobilspecifika makron

Makro
Ersättningsbeskrivning
Typ
${CS_PLATFORM_ID}

(ComScore) Plattforms-ID, som motsvarar enhetens operativsystem:

  • ios = Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • other när plattformen inte är något av ovanstående
varchar(50)
${CS_DEVICE_MODEL}
(ComScore) Enhetens modellnamn, URL-kodat.
string
${CS_IMPLEMENTATION_TYPE}

(ComScore) I vilken miljö annonsen betjänades:

  • a = mobilapplikation
  • b = mobilwebbplats
sträng (a eller b)
${NS_PLATFORM_ID}

(Nielsen) Plattforms-ID, som motsvarar enhetens operativsystem:

  • ios= Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • other när plattformen inte är något av ovanstående
string
${NS_DEVICE_GROUPING}

(Nielsen) Enhetstypen som annonsen visades på:

  • TAB = tablet
  • PHN = mobil
  • computer = dator
string
${UOO}

(Nielsen) Om användaren har valt bort annonsspårning eller inte:

  • 1 (DNT-flagga = 1) = användaren har valt bort annonsspårning
  • 0 (DNT-flagga = 0) = användaren har angett annonsspårning
heltal (0 eller 1)
${TM_BUNDLE}
The iOS eller Android app store bundle-ID. Exempel: com.zynga.wwf2.free eller id804379658
string
gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}

gdpr=${GDPR_ENFORCED} anger om anbudsgivaren fastställer att anbudsförfrågan kommer från EU:s ursprung och kräver att GDPR verkställs:

  • 1 = GDPR ska verkställas
  • 0 = GDPR ska inte verkställas

gdpr_consent=${GDPR_CONSENT} är det värde för samtycke som skickas från leveranspartnern i ankommande anbudsförfrågan:

  • I de flesta fall är detta en base64url-kodad medgivandesträng, eller daisybit (exempel: BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMgBkIDIgM0AgOJxAnQA)
  • 0 = inget samtycke
  • 1 = samtycke
daisybit eller heltal

Klicka på Makron för visningsannonser från tredje part

För att kunna spåra klick efter annonser med hjälp av tredjepartstaggar måste DSP ha ett musklick. Endast en version av makrot krävs. Det relevanta makrot beror på taggens typ.

Makro
Ersättningsbeskrivning
Typ
${TM_CLICK_URL}
Den omdirigerings-URL som gör att annonsservrar kan spåra och räkna annonsklickningar på plattformen.
string
${TM_CLICK_URL_URLENC}
Den omdirigerings-URL som gör det möjligt för annonsservrar som kräver URL-kodning att spåra och räkna annonsklickningar på plattformen.
string

DSP infogar automatiskt klickmakron i en tredjeparts visningstagg när du:

  • Exportera annonstaggar från en annonsserverpartner
  • Massöverföring Flashtalking eller Google DoubleClick for Advertisers annonstaggar direkt i DSP

Om ett klickande makro saknas när du skapar en visningsannons visas ett varningsmeddelande, som uppmanar dig att manuellt infoga rätt visningsklicksmakro i rätt område i taggen.

Analytics for Advertising Makron

Ytterligare makron finns specifikt för Analytics for Advertising kunder, se "Lägg till Analytics for Advertising Makron till Flashtalking Annonstaggaroch "Lägg till Analytics for Advertising Makron till Google Campaign Manager 360 Annonstaggar."

Felsökning av makrofel

När du lägger till makron i koden måste du använda makrots exakta syntax. När du validerar makrona kontrollerar DSP att makrot exakt matchar något av de giltiga makrona.

Fel genereras om tecken saknas i början eller slutet av makronamnet. Ett felmeddelande visas till exempel om:

  • Du glömmer ett eller flera av tecknen i början av makronamnet, t.ex. ${. Om du inte inkluderar den fullständiga syntaxen kan posten inte tolkas som ett giltigt makro.
  • Makrot avslutas inte med en giltig teckenuppsättning, till exempel }.
recommendation-more-help
9ff4800f-94be-45f0-a5bf-09d0d7e96baa