Advertising DSP Makros

Ein Makro ist ein kurzer Befehl oder Kurzbefehl für eine Anweisung und folgt normalerweise dem Format ${MACRO_NAME}. Makros, die in kreativen Code- oder Clickthrough-URLs enthalten sind, werden in eine längere Code-Zeichenfolge umgewandelt, die der Anzeigenserver verstehen kann. Der DSP Adserver führt Makros aus, wenn die Anzeige bereitgestellt oder angeklickt wird.

Anzeigenserver-Makros sind nützlich, um wichtige Informationen an DSP- oder Drittanbieter-Anzeigenserver zu übergeben. Makros werden am häufigsten während des Handels mit kreativem Drittanbieter- und benutzerdefiniertem Code oder Metadaten (z. B. Pixeln von Drittanbietern) verwendet.

Sie können ein Makro an einer beliebigen Stelle, z. B. in einem VAST-Tag, in einer beliebigen URL oder in einem DSP- oder Drittanbieter-Ereignispixel, manuell einfügen. Jeder DSP Client und Partner verfügt jedoch über ein anderes Anzeigen-Tag-Format, und die Makros sollten entsprechend an verschiedenen Stellen im Tag eingefügt werden. Jedes Mal, wenn Sie mit einem neuen Kunden oder Partner arbeiten, fragen Sie ihn nach der Dokumentation, wo die Makros in die Anzeigen-Tags eingefügt werden sollen, die für den DSP verwendet werden.

Allgemeine Tracking-Makros

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

Makro
Ersatzbeschreibung
Typ
${TM_ACCOUNT_ID}
Die Konto-ID.
integer
${TM_AD_ID}
Der Anzeigenschlüssel (adKey).
Zeichenfolge
${TM_AD_ID_NUM}
Die Anzeigen-ID.
integer
${TM_ADVERTISER_ID}
Die Advertiser-ID.
integer
${TM_CAMPAIGN_ID}
Der Kampagnenschlüssel.
Zeichenfolge
${TM_CAMPAIGN_ID_NUM}
Die Kampagnen-ID.
integer
${TM_CLICK_URL}
Die Umleitungs-URL, mit der Werbeserver Anzeigenklicks verfolgen und zählen können. Wenn die Anzeige bereitgestellt wird und der Benutzer 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 Werbeserver Anzeigenklicks verfolgen und zählen können. Wenn die Anzeige bereitgestellt wird und der Benutzer darauf klickt, wird das Makro aktiviert und der Klick aufgezeichnet und zu Berichtszwecken gezählt. Verwenden Sie dieses Makro nur, wenn Sie Werbeanzeigen von Drittanbietern erstellen und Ihr Anbieter URL-Kodierung erfordert.
Zeichenfolge
${TM_FEED_ID}
Der Schlüssel für die Medienplatzierung (feedKey).
Zeichenfolge
${TM_FEED_ID_NUM}
Die ID für die Medienplatzierung.
integer
${TM_MACRO_PLACEMENT_SITE_KEY
Der Site-Schlüssel für die Platzierung. Erforderlich für AppsFlyer Klicktracker für Anzeigen zur Installation mobiler Apps.
Zeichenfolge
${TM_PLACEMENT_ID}
Der Platzierungsschlüssel (cpKey).
Zeichenfolge
${TM_PLACEMENT_ID_NUM}
Die Platzierungs-ID.
integer
${TM_RANDOM}
Cachebuster: eine Zufallszahl zwischen 1 und 1000000.
long
${TM_SESSION_ID}
Die ID der Sitzung, die einem einzelnen Abruf des Anzeigen-Tags entspricht.
Zeichenfolge
${TM_SITE_DOMAIN_URLENC}
Die Seiten-Subdomäne, die von der URL in der Gebotsanfrage geparst wurde; URL-kodiert. Nicht unterstützt für In-Banner- und Click-to-Play-Anzeigen.
Zeichenfolge
${TM_SITE_NAME}
Der Site-Name für die Platzierung.
Zeichenfolge
${TM_SITE_URL_URLENC}
Die in der Angebotsanforderung übergebene URL, URL-kodiert. Nicht unterstützt für In-Banner- und Click-to-Play-Anzeigen.
Zeichenfolge
${TM_SITE_ID_NUM}
Die Site-ID für die Platzierung.
integer
${TM_TIMESTAMP}
Der Unix-Zeitstempel, der angibt, wie viele Sekunden seit Mitternacht (00:00 UTC) am 1. Januar 1970 vergangen sind.
long
${TM_VIDEO_DURATION}
Die Dauer des Anzeigenvideos in Sekunden.
integer

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 ist
varchar(50)
${CS_DEVICE_MODEL}
(ComScore) Der Gerätemodellname, URL-kodiert.
Zeichenfolge
${CS_IMPLEMENTATION_TYPE}

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

  • a = Mobile App
  • b = mobile Website
string (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 ist
Zeichenfolge
${NS_DEVICE_GROUPING}

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

  • TAB = Tablet
  • PHN = mobile
  • computer = computer
Zeichenfolge
${UOO}

(Nielsen) Gibt an, ob der Benutzer das Anzeigen-Tracking deaktiviert hat:

  • 1 (DNT-Markierung = 1) = Benutzer hat sich vom Anzeigen-Tracking abgemeldet
  • 0 (DNT-Markierung = 0) = Benutzer hat sich für das Anzeigen-Tracking entschieden
integer (0 oder 1)
${TM_BUNDLE}
Die iOS oder Android App Store-Bundle-ID. 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 Angebotsanforderung aus dem Ursprung der Europäischen Union stammt und die Durchsetzung der DSGVO erfordert:

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

gdpr_consent=${GDPR_CONSENT} ist der Zustimmungswert, der vom Versorgungspartner in der eingehenden Gebotsanfrage übergeben wird:

  • In den meisten Fällen handelt es sich um eine base64url-kodierte Zustimmungszeichenfolge oder ein daisybit (Beispiel: BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMBkIDIgM0AgOJXAnQA)
  • 0 = keine Zustimmung
  • 1 = Einverständnis
daisybit oder integer

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

Um Klicks für Anzeigen mithilfe von Display-Tags von Drittanbietern genau zu verfolgen, DSP ein Klick-Makro für die Anzeige erforderlich. Es ist nur eine Version des Makros erforderlich. Das relevante Makro hängt vom Tag-Typ ab.

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

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

  • Anzeigen-Tags von einem Adserver-Partner exportieren
  • Massen-Upload Flashtalking oder Google DoubleClick for Advertisers Anzeigen-Tags direkt in DSP

Wenn beim Erstellen einer Display-Anzeige ein Klickmakro fehlt, zeigt DSP eine Warnmeldung an, in der Sie aufgefordert werden, das entsprechende Display-Klickmakro manuell in den richtigen Bereich des Tags einzufügen.

Analytics for Advertising Makros

Für zusätzliche Makros, die speziell für Analytics for Advertising Kunden, sieheAnhängen Analytics for Advertising Makros zu Flashtalking Anzeigen-Tags" und "Anhängen Analytics for Advertising Makros zu Google Campaign Manager 360 Anzeigen-Tags."

Fehlerbehebung bei Makrofehlern

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

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

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