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, die es Adservern ermöglicht, Anzeigenklicks zu verfolgen und zu zählen. 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, die es Adservern ermöglicht, Anzeigenklicks zu verfolgen und zu zählen. 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 100000. long
${TM_SESSION_ID} Die ID der Sitzung, die einem einzelnen Abruf des Anzeigen-Tags entspricht. Zeichenfolge
${TM_SITE_DOMAIN_URLENC} Die von der URL in der Angebotsanforderung analysierte Seiten-Subdomäne; 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 Angebotsanfrage ü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 Betrachter war:
  • 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: BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMgBkIDIgM0AgOJxAnQA)
  • 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.

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. }.
Verwandte Artikel

Auf dieser Seite