Advertising DSP宏

Last update: Wed Aug 16 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
DSP Ads

创建对象：

User

宏是指令的简短命令或简称，通常遵循格式 ${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 应用商店捆绑包ID。示例： 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或整数

单击第三方显示广告的宏

要使用第三方显示标记准确跟踪广告的点击量，DSP需要显示点击宏。只需要宏的一个版本；相关的宏取决于标记类型。

宏

替代描述

类型

${TM_CLICK_URL}

使广告服务器能够跟踪和计数平台中的广告点击的重定向URL。

字符串

${TM_CLICK_URL_URLENC}

重定向URL，允许需要URL编码的广告服务器跟踪和计数平台中的广告点击量。

字符串

在以下情况下，DSP会在第三方显示标签中自动插入显示单击宏：

从广告服务器合作伙伴导出广告标记
批量上传 Flashtalking 或 Google DoubleClick for Advertisers 直接在DSP中广告标记

如果在构建显示广告时缺少单击宏，DSP将显示一条警告消息，提示您手动在标签的正确区域插入相应的显示单击宏。

Analytics for Advertising 宏

用于专门用于 Analytics for Advertising 客户，请参见"附加 Analytics for Advertising 宏到 Flashtalking 广告标记”和“附加 Analytics for Advertising 宏到 Google Campaign Manager 360 广告标记“

宏错误疑难解答

将宏添加到代码时，请确保使用宏的确切语法。验证宏时，DSP会检查宏是否与有效宏之一完全匹配。

如果宏名称的开头或结尾缺少字符，则会生成错误。例如，如果出现以下情况，您将看到一条错误消息：

您忘记了宏名称开头的一个或多个字符，例如 ${. 如果不包括完整语法，则无法将条目识别为有效的宏。
宏未以有效字符集结尾，例如 }.

recommendation-more-help

9ff4800f-94be-45f0-a5bf-09d0d7e96baa