Advertising DSP宏

2025年2月11日

创建对象：

  • 用户

宏是指令的简短命令或简称，通常遵循格式${MACRO_NAME}。 创意代码或点进URL中包含的宏可展开为广告服务器可以理解的较长代码字符串。 DSP广告服务器在投放或单击广告时执行宏。

广告服务器宏可用于将重要信息传递到DSP或第三方广告服务器。 宏最常在第三方和自定义创意代码或元数据（如第三方像素）贩运期间使用。

您可以在任意位置手动插入宏，例如在VAST标记中、在任何URL中，或者在DSP或第三方事件像素中。 但是，每个DSP客户端和合作伙伴都具有不同的广告标记格式，并且宏应相应地插入到标记中的不同位置。 每次与新客户或合作伙伴合作时，请向他们索取相关文档，了解如何在其广告标记中插入DSP所流量的宏。

常规跟踪宏

根据需要，对所有广告和标记类型使用常规跟踪宏以传递特定数据。

宏替代描述类型
${TM_ACCOUNT_ID}帐户ID。整数
${TM_AD_ID}广告键(adKey)。字符串
${TM_AD_ID_NUM}广告ID。整数
${TM_ADVERTISER_ID}广告商ID。整数
${TM_CAMPAIGN_ID}营销活动密钥。字符串
${TM_CAMPAIGN_ID_NUM}营销活动ID。整数
${TM_CLICK_URL}重定向URL，允许广告服务器跟踪和计数广告点击量。 当投放广告时，如果用户单击该广告，则会激活宏，并且会记录单击次数并计入报表中。字符串
${TM_CLICK_URL_URLENC}经过编码的重定向URL，允许广告服务器跟踪和计数广告点击量。 当投放广告时，如果用户单击该广告，则会激活宏，并且会记录单击次数并计入报表中。 除非您正在创建第三方广告，并且您的供应商需要URL编码，否则请勿使用此宏。字符串
${TM_FEED_ID}媒体投放的键(feedKey)。字符串
${TM_FEED_ID_NUM}媒体投放的ID。整数
${TM_MACRO_PLACEMENT_SITE_KEY投放位置的站点键。 AppsFlyer点击跟踪器对于移动设备应用程序安装广告是必需的。字符串
${TM_PLACEMENT_ID}放置键(cpKey)。字符串
${TM_PLACEMENT_ID_NUM}版面ID。整数
${TM_RANDOM}Cachebuster：介于1和1000000之间的随机数。长
${TM_SESSION_ID}会话的ID，对应于对广告标记的单次检索。字符串
${TM_SITE_DOMAIN_URLENC}从竞价请求中的URL解析的页面子域；URL编码。 不支持在横幅中点击播放的广告。字符串
${TM_SITE_NAME}投放位置的站点名称。字符串
${TM_SITE_URL_URLENC}在竞价请求中传递的URL；URL编码。 不支持在横幅中点击播放的广告。字符串
${TM_SITE_ID_NUM}投放的网站ID。整数
${TM_TIMESTAMP}Unix时间戳表示自1970年1月1日午夜(00:00 UTC)以来经过的秒数。长
${TM_VIDEO_DURATION}广告视频的持续时间（以秒为单位）。整数

特定于移动设备的宏

宏替代描述类型
${CS_PLATFORM_ID}

(ComScore)与设备的操作系统对应的平台ID：

  • ios = Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • 当平台不是上述任何平台时other
varchar(50)
${CS_DEVICE_MODEL}(ComScore)设备型号名称，以URL编码。字符串
${CS_IMPLEMENTATION_TYPE}

(ComScore)投放广告的环境：

  • a =移动应用程序
  • b =移动网站
字符串（a或b）
${NS_PLATFORM_ID}

(Nielsen)与设备的操作系统对应的平台ID：

  • ios= Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • 当平台不是上述任何平台时other
字符串
${NS_DEVICE_GROUPING}

(Nielsen)广告作为查看者的设备类型：

  • TAB =平板电脑
  • PHN =移动设备
  • computer =计算机
字符串
${UOO}

(Nielsen)用户是否已选择退出广告跟踪：

  • 1 （DNT标志= 1） =用户已选择退出广告跟踪
  • 0 （DNT标志= 0） =用户已选择加入广告跟踪
整数（0或1）
${TM_BUNDLE}iOS或Android应用商店捆绑包标识。 示例： com.zynga.wwf2.free或id804379658字符串
gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}

gdpr=${GDPR_ENFORCED}指示投标人是否确定投标请求来自欧盟来源并要求GDPR实施：

  • 1 =应强制执行GDPR
  • 0 =不应强制GDPR

gdpr_consent=${GDPR_CONSENT}是从入站竞价请求中的供应合作伙伴传递的同意值：

  • 在大多数情况下，这是base64url编码的同意字符串，或daisybit（示例：BN5lERiOMYEdiAKAWXEND1HoSBE6CAFApAMgBkIDIgM0AgOJxAnQA）
  • 0 =不同意
  • 1 =同意
Daisybit或整数