DokumentationAdvertisingHandbuch zu DSP

Advertising DSP-Makros

Last update: Thu Dec 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende

Ein Makro ist ein kurzer Befehl oder eine Abkürzung für eine Anweisung und folgt normalerweise dem ${MACRO_NAME}. Im Kreativ-Code enthaltene Makros oder Clickthrough-URLs werden zu einer längeren Code-Zeichenfolge erweitert, die der Anzeigen-Server versteht. Der DSP-Werbeserver führt Makros aus, wenn die Anzeige geschaltet oder angeklickt wird.

Werbeserver-Makros sind nützlich, um wichtige Informationen an DSP oder Werbeserver von Drittanbietern weiterzugeben. Makros werden am häufigsten während des Handels mit kreativem Code oder Metadaten von Drittanbietern und deren Bearbeitung verwendet (z. B. Pixel von Drittanbietern).

Sie können ein Makro manuell an einer beliebigen Stelle einfügen, z. B. in einem VAST-Tag, in einer beliebigen URL oder in einem DSP- oder Ereignispixel eines Drittanbieters. Jeder DSP-Client und -Partner hat jedoch ein anderes Tag-Format für die Anzeige, und die Makros sollten entsprechend an verschiedenen Stellen im Tag eingefügt werden. Fragen Sie bei jeder Arbeit mit einem neuen Client oder Partner nach der Dokumentation, wo die Makros in die Anzeigen-Tags eingefügt werden können, die DSP-Traffic unterstützen.

Allgemeine Tracking-Makros

Verwenden Sie allgemeine Tracking-Makros für alle Anzeigen- und Tag-Typen, um bestimmte Daten nach Bedarf zurückzugeben.

Makro
Ersatzbeschreibung
Typ
${TM_ACCOUNT_ID}
Die Konto-ID.
Ganzzahl
${TM_AD_ID}
Der Anzeigenschlüssel (adKey).
Zeichenfolge
${TM_AD_ID_NUM}
Die Werbe-ID.
Ganzzahl
${TM_ADVERTISER_ID}
Die Werbekunden-ID.
Ganzzahl
${TM_CAMPAIGN_ID}
Der Kampagnenschlüssel.
Zeichenfolge
${TM_CAMPAIGN_ID_NUM}
Die Kampagnen-ID.
Ganzzahl
${TM_CLICK_URL}
Die Umleitungs-URL, mit der Anzeigen-Server Anzeigenklicks verfolgen und zählen können. Wenn der Benutzer bei der Auslieferung der Anzeige darauf klickt, wird das Makro aktiviert und der Klick aufgezeichnet und zu Berichtszwecken gezählt.
Zeichenfolge
${TM_CLICK_URL_URLENC}
Die kodierte Umleitungs-URL, mit der Anzeigen-Server Anzeigenklicks verfolgen und zählen können. Wenn der Benutzer bei der Auslieferung der Anzeige darauf klickt, wird das Makro aktiviert und der Klick aufgezeichnet und zu Berichtszwecken gezählt. Verwenden Sie dieses Makro nur, wenn Sie Anzeigen von Drittanbietern erstellen und Ihr Anbieter eine URL-Codierung erfordert.
Zeichenfolge
${TM_FEED_ID}
Der Schlüssel für die Medienplatzierung (feedKey).
Zeichenfolge
${TM_FEED_ID_NUM}
Die ID für die Medienplatzierung.
Ganzzahl
${TM_MACRO_PLACEMENT_SITE_KEY
Der Site-Schlüssel für die Platzierung. Erforderlich für AppsFlyer Klick-Tracker zur Installation von Anzeigen in Mobile Apps.
Zeichenfolge
${TM_PLACEMENT_ID}
Der Platzierungsschlüssel (cpKey).
Zeichenfolge
${TM_PLACEMENT_ID_NUM}
Die Platzierungs-ID.
Ganzzahl
${TM_RANDOM}
Cachebuster: eine zufällige Zahl zwischen 1 und 1000000.
lang
${TM_SESSION_ID}
Die ID der Sitzung, die einem einzelnen Abrufen des Anzeigen-Tags entspricht.
Zeichenfolge
${TM_SITE_DOMAIN_URLENC}
Die Subdomain der Seite, die von der URL in der Angebotsanfrage geparst wird; URL-kodiert. Nicht unterstützt für In-Banner-, Klick-to-Play-Anzeigen.
Zeichenfolge
${TM_SITE_NAME}
Der Site-Name für die Platzierung.
Zeichenfolge
${TM_SITE_URL_URLENC}
Die in der Angebotsanfrage übergebene URL (URL-kodiert). Nicht unterstützt für In-Banner-, Klick-to-Play-Anzeigen.
Zeichenfolge
${TM_SITE_ID_NUM}
Die Site-ID für die Platzierung.
Ganzzahl
${TM_TIMESTAMP}
Der Unix-Zeitstempel, der die Anzahl der Sekunden angibt, die seit Mitternacht (00:00 UTC) am 1. Januar 1970 verstrichen sind.
lang
${TM_VIDEO_DURATION}
Die Dauer des Anzeigenvideos in Sekunden.
Ganzzahl

Mobile-spezifische Makros

Makro
Ersatzbeschreibung
Typ
${CS_PLATFORM_ID}

(ComScore) Die Plattform-ID, die dem Betriebssystem des Geräts entspricht:

  • ios = Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • other, wenn die Plattform keine der oben genannten Funktionen aufweist
varchar(50)
${CS_DEVICE_MODEL}
(ComScore) Der Gerätemodellname, URL-kodiert.
Zeichenfolge
${CS_IMPLEMENTATION_TYPE}

(ComScore) Die Umgebung, in der die Anzeige geschaltet wurde:

  • a = Mobile App
  • b = mobile Website
Zeichenfolge (a oder b)
${NS_PLATFORM_ID}

(Nielsen) Die Plattform-ID, die dem Betriebssystem des Geräts entspricht:

  • ios= Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • other, wenn die Plattform keine der oben genannten Funktionen aufweist
Zeichenfolge
${NS_DEVICE_GROUPING}

(Nielsen) Der Gerätetyp, auf dem die Anzeige angezeigt wurde:

  • TAB = Tablette
  • PHN = mobil
  • computer = Computer
Zeichenfolge
${UOO}

(Nielsen) Ob der Benutzer das Anzeigen-Tracking abgelehnt hat oder nicht:

  • 1 (DNT-Flag = 1) = der Benutzer hat das Anzeigen-Tracking abgelehnt
  • 0 (DNT-Flag = 0) = der Benutzer hat sich für das Anzeigen-Tracking entschieden
Ganze Zahl (0 oder 1)
${TM_BUNDLE}
Die Bundle-ID des iOS oder Android App Store. Beispiele: com.zynga.wwf2.free oder id804379658
Zeichenfolge
gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}

gdpr=${GDPR_ENFORCED} gibt an, ob der Bieter feststellt, dass die Angebotsanfrage aus der Europäischen Union stammt und eine Durchsetzung der DSGVO erfordert:

  • 1 = Die DSGVO sollte durchgesetzt werden
  • 0 = Die DSGVO sollte nicht durchgesetzt werden

gdpr_consent=${GDPR_CONSENT} ist der Einverständniswert, der vom Übermittlungspartner in der eingehenden Angebotsanfrage übergeben wird:

  • In den meisten Fällen handelt es sich um eine base64url-kodierte Einverständniszeichenfolge, oder Daisybit (Beispiel: BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMgBkIDIgM0AgOJxAnQA)
  • 0 = kein Einverständnis
  • 1 = Einverständnis
Daisybit oder Integer

Klicken Sie auf Makros für Display-Anzeigen von Drittanbietern

Um Klicks auf Anzeigen mit Display-Tags von Drittanbietern genau zu verfolgen, erfordert DSP ein Display-Klick-Makro. Es ist nur eine Version des Makros erforderlich. Das entsprechende Makro hängt vom Typ des Tags ab.

Makro
Ersatzbeschreibung
Typ
${TM_CLICK_URL}
Die Umleitungs-URL, mit der Anzeigen-Server Anzeigenklicks in der Plattform verfolgen und zählen können.
Zeichenfolge
${TM_CLICK_URL_URLENC}
Die Umleitungs-URL, die es Anzeigen-Servern ermöglicht, die URL-Codierung benötigen, um Anzeigenklicks in der Plattform zu verfolgen und zu zählen.
Zeichenfolge

DSP fügt automatisch Display-Klick-Makros in ein Display-Tag eines Drittanbieters ein, wenn Sie:

  • Exportieren von Anzeigen-Tags aus einer Ad-Server-
  • Massen-Upload von Flashtalking- oder Google DoubleClick for Advertisers-Anzeigen-Tags direkt in DSP

Wenn beim Erstellen einer Display-Anzeige ein Klick-Makro fehlt, zeigt DSP eine Warnmeldung an, die Sie auffordert, das entsprechende Display-Klick-Makro manuell in den richtigen Bereich des Tags einzufügen.

Makros Analytics for Advertising

Weitere Makros, die speziell für Analytics for Advertising Kunden verfügbar sind, finden Sie unter Append Analytics for Advertising Macros to Flashtalking Ad Tags und Append Analytics for Advertising Macros to Google Campaign Manager 360 Ad Tags.

Fehlerbehebung bei Makro-Fehlern

Wenn Sie Makros zu Ihrem Code hinzufügen, stellen Sie sicher, dass Sie die exakte Syntax des Makros verwenden. Bei der Validierung der Makros prüft DSP, ob das Makro genau mit einem der gültigen Makros übereinstimmt.

Fehler werden erzeugt, wenn am Anfang oder Ende des Makronamens Zeichen fehlen. Beispielsweise wird eine Fehlermeldung angezeigt, wenn:

  • Sie vergessen eines oder mehrere der Zeichen am Anfang des Makronamens, z. B. ${. Wenn Sie die vollständige Syntax nicht angeben, wird der Eintrag nicht als gültiges Makro erkannt.
  • Das Makro endet nicht mit einem gültigen Zeichensatz, z. B. }.
Related Articles
recommendation-more-help
9ff4800f-94be-45f0-a5bf-09d0d7e96baa