宏

宏是广告素材代码中的特殊字符串。Google Ad Manager 之后会根据广告素材的设置将此类字符串替换为其他值或代码。宏很有用，因为如果使用了宏，当您需要进行更改时，就无需直接更新广告素材代码，而只需更新宏引用即可。

理解并正确使用宏对于解决常见的网址相关问题至关重要，这些问题包括网址上传期间出现的错误、UTM 参数丢失、重定向不正确，以及确保网址中包含有效的字符。例如，%epid! 宏可用于在着陆页网址中动态包含广告单元 ID，从而帮助解决重定向不正确或跟踪方面的问题。

有关宏的重要注意事项

  • 区分大小写
    宏区分大小写。请使用 %%CACHEBUSTER%%，而不要使用 %%Cachebuster%%。
  • 不转义宏和转义宏的展开方式
    不转义宏和转义宏的展开方式不同。了解如何使用转义的宏和不转义的宏。
  • 宏的插入
    对于第三方广告素材或 VAST 广告代码网址，如果 Ad Manager 能够识别出第三方，便会自动插入宏。对于自定义广告素材和广告素材模板，您需要手动添加宏。如果您不确定该在何处添加宏，请与您的广告素材供应商联系。
    使用广告素材模板进行投放管理时，仅当模板中使用 Click 宏时，用于输入点击后到达网址的字段才会显示。
  • 预留字符和网址编码（使用百分号编码）
    在 Ad Manager 中，以下这些前面带有百分号的小写字母为预留字符：

    %a
    %c
    %h
    %i
    %n
    %p
    %k

    请勿在网址编码中使用这些字符串，因为它们会干扰宏的展开。

  • 程序化直接交易不支持宏
    请参阅程序化直接交易可使用的功能。

书签您可以通过下方列表中的链接跳转至特定宏

对于每种宏，我们都在下文中提供了相应的用法建议，但您也可以根据自己的需要加以充分利用。宏可以被添加到在广告投放期间由广告服务器处理的任意代码（如第三方或自定义广告素材代码、Studio 代码、点击后到达网址或广告代码）中。

呈现宏
广告单元
目标网址
文件服务器
高度和宽度
模式匹配
代码参数
目标是否为新窗口
目标窗口
面向儿童的内容标记
适用于广告素材模板的 URI 编码

跟踪宏                
缓存无效化（随机数）
Click
扩展
设备 ID（iOS、Android、Roku、tvOS）
预览模式
协议
网站
查看的展示

与 GDPR 有关的广告请求宏
GDPR
透明度和用户意见征求字符串
额外同意模式
未达到同意年龄的 EEA 和英国用户

视频宏
视频广告时长（以秒为单位）
视频广告时长（以毫秒为单位）
视频说明网址
视频引荐来源网址

视频内容宏
视频时长（以毫秒为单位）
视频 ID
视频元数据
内容来源 ID
自定义广告 ID (FreeWheel)
IAB 类别 (FreeWheel)
查看动态广告插播 (DAI) 宏列表。

全部展开  全部收起

呈现宏

呈现宏常用于呈现广告素材，旨在确保广告素材能够正常展示和运行。

广告单元
 
宏
%%ADUNIT%%
 

广告单元宏会在广告投放时，将 Google 发布商代码中的广告单元路径插入到广告素材代码中。

下面展示了如何将 ADUNIT 宏添加到第三方广告素材代码段中：

<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>

广告单元宏会展开为初始广告请求中包含的完整广告单元路径（包括广告资源网代码）。下例说明了广告投放时广告单元路径会如何展开：

<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>

此宏仅适用于获得批准的提示的广告单元。如果提示的广告单元处于第三级，那么此宏在广告素材代码段中只会展开为第二级广告单元。在提示的广告单元获得批准后，此宏便会在广告素材代码段中展开为第三级广告单元

目标网址
 
宏 转义
%%DEST_URL_ESC%% 一次转义
%%DEST_URL_ESC_ESC%% 两次转义
%%DEST_URL_UNESC%% 不转义
 

目标网址宏会展开为广告素材的点击后到达网址，此网址既可以是订单项的点击后到达网址，也可以是订单项内广告素材的替换设置值。

目标网址宏在自定义广告素材和广告素材模板中非常有用。如果广告素材代码需要包含广告素材的点击后到达网址，且广告素材或模板在不同订单项中使用时该点击后到达网址会随之发生变化，此时这类宏会非常有用。

点击后到达网址宏分为 3 种：一次转义、两次转义和不转义。通常情况下，转义次数（添加一次还是两次转义，亦或是根本不添加）视第三方点击跟踪公司而定。有些第三方点击跟踪公司要求对此网址进行转义，而有些则不要求这样做。对于 Ad Manager 中的第三方广告代码或自定义广告素材代码，第三方点击跟踪公司所要求的转义级别通常是在代码中通过 click= 字符串来指定：

  • click=：转义一次 (%%DEST_URL_ESC%%)。

  • click0=：不转义 (%%DEST_URL_UNESC%%)。

  • click1=：转义一次 (%%DEST_URL_ESC%%)。

  • click2=：转义两次 (%%DEST_URL_ESC_ESC%%)。

Ad Manager 还支持 %%DEST_URL%%，此宏的用途与 %%DEST_URL_ESC%% 完全相同。为了清楚起见，我们建议使用 %%DEST_URL_ESC%%。不过，您无需对较旧的广告素材和模板进行重新编码。
如果模板代码段包含 %u 或 %%DEST_URL%% 宏，那么您在点击广告素材后将被定向到 xsd:string 网址。该代码段的长度上限为 1024 个字符。
文件服务器
 
宏
%%FILE:file_display_name%%
 

文件服务器宏 %%FILE:file_display_name%% 会展开为已为广告素材上传的广告素材资源的完整网址。file_display_name使用此宏可以通过自定义广告素材代码调用已上传的素材资源（例如图片）。

要使用此宏，请将 file_display_name 替换为广告素材资源的显示名，即您在查看广告素材详情时在 Ad Manager 中看到的名称。file_display_name

高度和宽度
 
宏
%%HEIGHT%%
%%WIDTH%%
 

在广告投放过程中，这些宏会将 Ad Manager 广告素材的“目标广告单元尺寸”字段值中定义的广告素材高度和宽度插入到广告素材的自定义代码中。

如果您要创建一个广告素材模板，并想将该模板重复用于不同尺寸的广告素材，便会发现高度宏和宽度宏特别有用。您可以使用这些高度和宽度宏将尺寸值动态插入每个广告素材中，而不用对每个广告素材的尺寸进行硬编码。

模式匹配
 
宏
%%PATTERN:key%%
%%PATTERN:TARGETINGMAP%%
%%PATTERN:url%%
 

模式匹配宏可用于向广告素材传递一个或多个自定义变量（如定位值）。您可以使用此类宏传递键值对、替换整个定位字符串或展开引荐来源网址。如果您希望根据所了解的用户信息（如用户的内容偏好）投放不同的广告素材，则会发现此类宏非常有用。

对于每个广告素材，模式匹配宏最多只能替换 100 次。

对模式匹配宏进行转义

模式匹配宏会按原样返回接收的值。如果您在其中一个网址字段（例如，视频广告素材中的“VAST 广告代码网址”或“第三方跟踪网址”字段）中使用此宏，则可能希望展开的值经过转义后返回。为此，您需要对请求中的值进行 3 次转义。

%%PATTERN:key%%

例如，您的某个订单项中包含两个广告素材：一个旨在吸引女性用户，另一个旨在吸引男性用户。此宏中使用的“key”必须是字母数字字符或下划线 (_)。

下面就是此流程的工作方式：

  1. 您需要使用键值对向网页上的广告代码传递自定义值（在本示例中，传递的是用户性别信息）：
    googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
    .addService(googletag.pubads())
    .setTargeting("gender", "male");
  2. 在自定义或第三方广告素材中，使用下面的宏动态传递自定义值（用户性别信息）：<此处为一些广告素材脚本>...&gender=%%PATTERN:gender%%
  3. %%PATTERN:gender%% 整个宏都会被替换为“male”。
  4. Ad Manager 会调用标签为“male”的广告素材文件，并将该文件投放给此用户。

%%PATTERN:TARGETINGMAP%%

您可以使用 %%PATTERN:TARGETINGMAP%% 替换整个定位地图并动态创建回传代码。

下面展示了如何将 TARGETINGMAP 宏添加到广告代码中：

.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();

下面是广告投放时完整键值字符串的示例：

.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();

  两个 Ad Manager 广告资源网之间的回传代码示例

您可以使用此宏来设置两个 Ad Manager 广告资源网（“广告资源网 A”和“广告资源网 B”）之间的回传代码。

下面是在 Ad Manager 广告资源网 A 中预订的广告素材示例：

<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
 .setTargeting("myAdUnit", "%%ADUNIT%%")
 .updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
 .display();
</script>

如果 Ad Manager 广告资源网 B 没有任何已售出的广告系列要投放，它可以使用如下所示的回传广告素材将展示机会退还给广告资源网 A：

<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
 .definePassback('%%PATTERN:myAdUnit%%', [468, 60])
 .updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
 .setTargeting("kwd", "noloop") // to avoid infinite loops
 .display();
</script>
Ad Manager 与第三方广告服务器之间的回传代码示例

您也可以在通过请求发往第三方广告服务器的回传代码中使用 TARGETINGMAP，这样就可以在一个动态广告素材中使用多个值。

下面是在 Ad Manager 中预订的广告素材示例：

<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>

由 Ad Manager 投放后，则会展开为：

<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>

现在，第三方便可访问动态生成的“dfpAdUnit”和“targeting”参数，并可以构建以下回传：

<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
 .definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
 .setTargeting("kw", "noloop") // 以免无限循环（请参见 https://support.google.com/admanager/answer/2811375）
 .updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>

为此，第三方需要先获得一段大致如下所示的模板代码：

myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
  callback = function() {
    googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
    .setTargeting("kwd", "noloop")
    .updateTargetingFromMap(myTargetingObject)
    .display();
  };

  window.googletag = window.googletag || {};
  googletag.cmd = googletag.cmd || [];
  googletag.cmd.push(callback);

document.write('</sc'+'ript>');

%%PATTERN:url%%

您还可以使用预留键 url 来展开为引荐页面的网址。

Campaign Manager 360 代码中键名称为 url 的所有键值对都会被替换为引荐来源网址。

注意：url 预留键会转义网址中的不安全字符。
代码参数
 
宏
%%TAG_PARAM%%
 

“代码参数”宏可与其他广告代码参数结合使用，且只能与以下参数配合使用：

在受支持的情况下，该参数会扩展为参数值。

例如，%%TAG_PARAM:correlator%%（受支持）会扩展为广告代码中的 correlator 值，但 %%TAG_PARAM:ppid%%（不受支持）不会扩展为任何值。

目标是否为新窗口
 
宏
%%TARGET_IN_NEW_WINDOW%%
 

“目标是否为新窗口”宏用于指明，为广告素材投放到的广告单元指定的目标窗口是否设置为“_blank”（新窗口）。

  • 如果目标窗口设置为 _blank，则此宏会展开为 1。

  • 如果目标窗口设置为任何其他值，或者没有指定目标窗口，则此宏会展开为 0。

如果要插入实际的目标窗口设置值，请使用 %%TARGET_WINDOW%% 宏。

目标窗口
 
宏
%%TARGET_WINDOW%%
 

目标窗口宏会展开为针对广告素材所投放的目标广告单元指定的目标窗口。您可以在广告素材代码内使用此宏，以指定用户在点击广告素材后是转到新窗口还是在同一窗口中加载着陆页，具体取决于向用户展示广告的各个网站的设置。

例如，AdManager_News.com 广告单元的目标窗口设为了 _top，而 AdManager_Fashion.com 广告单元的目标窗口则设为了 _new。如果广告素材的代码中包含 %%TARGET_WINDOW%% 宏，则对于访问 AdManager_News.com 的用户，此宏会展开为 _top；而对于访问 AdManager_Fashion.com 的用户，此宏会展开为 _new。

下面是一个实现示例：

<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>

如果要确定目标窗口设置值是“_blank”还是其他值，请使用 %%TARGET_IN_NEW_WINDOW%% 宏。

面向儿童的内容标记
 
宏
%%TFCD%%
 

通过面向儿童的内容标记 (TFCD)，您可以让第三方知道，发出特定广告请求的网页中包含面向儿童的内容。此宏旨在协助遵守儿童在线隐私保护法 (COPPA)。

您可以在第三方广告素材的任何重定向或请求中添加此宏（采用 coppa=%%TFCD%% 或类似格式）。您还可以在 JavaScript 中使用此宏，以便将 GPT 回传代码请求设为面向儿童的内容。对于面向儿童的内容，此类宏会展开为 1；对于其他内容，此类宏会展开为 0（系统会根据将请求向 Ad Manager 提出请求的网页、网站或移动应用来判断内容性质）。

如果您使用 Google 的广告服务，并且希望在网站级或应用级实现面向儿童的内容，请参阅将网站或应用标记为面向儿童。

适用于广告素材模板的 URI 编码
 
宏
[%URI_ENCODE:variable%]
 

URI 编码宏能够正确转换广告素材模板变量值中的空格和其他特殊字符，以便在 URI（也称为网址）中使用。

此宏只适用于广告素材模板，不适用于自定义或第三方广告素材，且不会对已编码的字符进行双重编码。

示例

假设您的广告素材模板中包含一个名为“Color”的“列表”变量，它有两个可取值：“dark blue”和“light green”。默认情况下，Ad Manager 会将 [%Color%] 添加到您的广告素材模板代码段中：

<a href="https://paint.com/wall.html?color=[%Color%]">绘制！</a>

广告素材创建好后，Ad Manager 会将 [%Color%] 替换为所选列表项的文本字符串。在此示例中，文本字符串中包含空格字符，但由于空格字符需要编码，因此会破坏网址。可以使用 [%URI_ENCODE:Color%] 来避免此问题。

<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">绘制！</a>
 

[%Color%] dark blue
[%URI_ENCODE:Color%] dark%20blue

使用广告素材模板变量定义点击后到达网址或重定向网址时，此宏尤其有用。如果没有进行正确编码，广告素材中的完整网址可能无法正常打开。

示例

假设您的广告素材模板中包含一个名为“LandingPage”的“网址”变量。默认情况下，Ad Manager 会将 [%LandingPage%] 添加到您的广告素材模板代码段中：

<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">点击此处！</a>

如果 [%LandingPage%] 网址中包含查询参数（例如 ?page=home&sport=baseball），则会导致网址的格式不正确，并且重定向也无法按预期运行。在此示例中，系统会将和号 (&) 后的内容视为完整网址（而非重定向网址）的一部分。可以使用 [%URI_ENCODE:LandingPage%] 来避免此问题。

<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">点击此处！</a>
 

[%LandingPage%] https://www.mysportswebsite.com?
page=home&sport=baseball
[%URI_ENCODE:LandingPage%] https%3A%2F%2Fwww.mysportswebsite.com%3F
page%3Dhome%26sport%3Dbaseball

跟踪宏

此类宏最常用于跟踪和生成报表。

缓存无效化（随机数）
 
宏
%%CACHEBUSTER%%
 

缓存无效化宏可确保系统在每次执行代码时都会向广告服务器发送新的调用，以便准确统计展示次数。如果您不向广告素材代码添加缓存无效化宏，那么 Google Ad Manager 和第三方广告服务器之间很可能会出现展示次数统计差异。请注意，并非所有的第三方广告代码都需要缓存无效化宏。

大多数的广告素材供应商都会在各自的代码中提供一个占位符，以供插入缓存无效化宏。例如，如果第三方广告素材代码的部分内容如下所示：

http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]

您需要选择 [RANDOM_NUMBER]，然后点击插入缓存无效化宏，以便其替换占位符：

http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%

在 Ad Manager 中使用 Campaign Manager 360 展示跟踪代码时，请选择标准广告代码并插入 CACHEBUSTER 宏，以减少差异。

http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?

VAST 响应中的缓存无效化宏

对于给定广告素材中的所有事件，%%CACHEBUSTER%% 宏均会展开为同一随机数。此宏对视频广告特别有用，因为对于一个 VAST 响应中的每一个视频跟踪事件，此宏均展开为同一随机数。

Click
 
宏 转义
%%CLICK_URL_UNESC%% 不转义
%%CLICK_URL_ESC%% 一次转义
%%CLICK_URL_ESC_ESC%% 两次转义
 

Click 宏会展开为特殊网址，以便您在 Ad Manager 中跟踪第三方广告素材的点击次数。此宏通常在锚标记 (<a>) 中与广告素材的点击后到达网址一同出现。请勿输入 Click 宏作为图片或 iframe 的来源。否则，每当图片或 iframe 呈现时，系统都会记录一次点击，但此类点击并不合法，因而会被当作无效点击过滤掉。

在链接的开头使用 %%CLICK_URL_UNESC%%。当点击跟踪广告代码是另一个网址的参数时，使用 %%CLICK_URL_ESC%%。

<a href="%%CLICK_URL_UNESC%%http://www.google.com">链接</a>

<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">链接</a>

详细了解转义和不转义的宏。

验证 Click 宏是否正确实现

Click 宏添加不当会导致系统无法跟踪点击次数。要确认 Ad Manager 是否按预期正常记录点击次数，请按以下步骤操作。

  1. 预览相应的广告素材。
  2. 点击“预览”。

此时，Ad Manager 会显示一条确认消息，提醒您系统将记录点击次数。如果您没有看到这条确认消息，则表明 Click 宏未正确实现。

扩展
 
宏 会展开为
%eaid! 订单项 ID
%eadv! 要投放的订单项的广告客户 ID
%ebuy! 要投放的订单项的订单 ID
%ecid! 广告素材 ID
%eenv! 环境（代码类型）指示器：i 表示 iframe，j 表示 JavaScript
%epid! 订单项所投放的目标广告单元的 ID
%esid! 订单项所投放的目标广告单元上方最高层级广告单元的 ID
此宏是一项旧版功能，可能无法在您的广告资源网中按预期运行。
 

如果在自定义广告素材代码或点击后到达网址中使用展开宏，便可以在向网页投放广告素材时显示 Ad Manager 中的 ID 值。这通常用于将 Ad Manager 中的 ID 与发布商自己数据库中的 ID 进行匹配，以进行问题排查或生成报表。

您可以在点击后到达网址中分隔各个展开宏，分隔符可以是任何能在 Ad Manager 点击后到达网址中放心使用的字符。例如：http://www.site.com/?%eaid!;%ecid! 会展开为 http://www.site.com/?1234567;4265598。

设备 ID
 
宏
%%ADVERTISING_IDENTIFIER_PLAIN%%（设备标识符）
%%ADVERTISING_IDENTIFIER_TYPE%%（设备类型）
%%ADVERTISING_IDENTIFIER_IS_LAT%%（限制广告跟踪设置）
 

借助 %%ADVERTISING_IDENTIFIER_PLAIN%% 宏，应用内广告资源发布商可以向广告合作伙伴发送可重置的设备 ID，以便针对用户兴趣投放合作伙伴的广告。这样一来，您就可以更轻松地向自己的广告客户和代理机构授予可重置设备 ID 的访问权限。

应用内广告资源发布商还可以使用 %%ADVERTISING_IDENTIFIER_TYPE%% 宏来发送设备类型，使用 %%ADVERTISING_IDENTIFIER_IS_LAT%% 宏来发送限制广告跟踪 (LAT) 设置，这项设置用于指明来自设备的“限制广告跟踪”信号。

详细了解用于用户定位的可重置设备 ID，其中包括受支持的设备类型。

前提条件

为广告素材设置 HTTPS 加密。对于广告素材以及您用于转化跟踪的所有第三方像素而言，这一步都必不可少。如果广告素材未进行 HTTPS 加密，或者如果您替换 SSL 合规性自动检查设置，则此宏将不会展开相应值，但广告素材仍会投放。

运作方式

  1. 在 Ad Manager 中，发布商将相应宏添加到自己的广告素材和/或跟踪网址中。

  2. 这些宏会展开为用户的设备 ID、设备类型和/或 LAT 设置，然后系统会在这些内容向第三方发起调用时将其添加到相应广告素材中。

    如果广告请求来自面向儿童的应用 (TFCD)，或者限制广告跟踪 (LAT) 处于启用状态，设备标识符和设备类型宏将不会展开。在这种情况下，此宏会返回一个空字符串 ("")。

格式

此宏会发送由 32 个大写字母数字组成的十六进制数值，采用连字符分五组显示，格式为 8-4-4-4-12，共计 36 个字符（32 个字母数字字符和 4 个连字符）。

Example: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41

了解支持的设备类型和限制广告跟踪 (LAT) 的可能值。

预览模式
 
宏
%%PREVIEW_MODE%%
 

您可以在自定义广告素材代码中使用预览模式宏，以防止后端系统或第三方系统统计预览展示次数。如果广告素材处于 Ad Manager 预览观看模式，则此宏会展开为 true；如果是常规展示，则此宏会展开为 false。

协议
 
宏
%%SCHEME%%
 

协议宏会展开为 http: 或 https:，具体取决于哪一个与广告素材投放网页的安全协议匹配。您可以在网址的开头插入此宏。

<img src=%%SCHEME%%//www.website.com/img/logo.gif>

网站
 
宏
%%SITE%%
 

会展开为广告代码中网址参数的网域（例如，google.com）。此宏可用于根据请求的来源修改广告素材。不适用于标记为匿名的 Ad Exchange 广告。

查看的展示
 
宏 转义
%%VIEW_URL_ESC%% 一次转义
%%VIEW_URL_UNESC%% 不转义
 

借助“查看的展示”宏，每当广告素材已下载到用户的设备上且已开始加载时，Ad Manager 都会将此计为一次展示。请仅在页外广告素材中使用此宏。

您可以通过多种方式发送查看 ping。我们建议使用 <img> 代码：

<!-- 此 img 代码不可见。但会让浏览器向 VIEW_URL 发送请求。-->
<img src="%%VIEW_URL_UNESC%%" style="display:none">

<!-- 此 img 代码会显示实际广告。-->
<img src="[%Imagefile%]" border="0">

第一个 <img> 代码会检索来自 VIEW_URL 的 1x1 图片。您可以将样式设为“display:none”以将其隐藏，使其无法影响网页布局。

与 GDPR 有关的广告请求宏

此类宏最常用于受 GDPR 约束的广告请求。

注意：在 HTML5 广告素材的 HTML 中实现的透明度和用户意见征求框架 (TCF) 宏不会扩展。只有重定向型展示广告素材和自定义展示广告素材分别支持通过“第三方网址”和“HTML 代码”字段扩展 TCF 宏。
GDPR
 
宏
${GDPR}
 

会展开为与请求关联的 gdpr= 的值

透明度和用户意见征求 (TC) 字符串
 
宏
${GDPR_CONSENT_XXXX}
 

会展开为与请求关联的透明度和用户意见征求 (TC) 字符串。如果透明度和用户意见征求 (TC) 字符串为空白或无效，此宏将不会展开。使用此宏可通过非程序化广告素材中的网址将 TC 字符串传递给第三方广告素材提供商。

请将“XXXX”替换为第三方提供商的 IAB GVL ID。如果 TC 字符串为空白或无效，此宏将不会展开。

如果与您插入的 IAB GVL ID 关联的第三方提供商未征得用户同意，含有 ${GDPR_CONSENT_XXXX} 宏的广告素材可能会被屏蔽。

如果此宏在 VAST 代码中使用，则在第三方提供商未征得用户同意时，此宏将不会展开。

${GDPR_CONSENT_XXXX} 宏只能在网址内出现一次。请与您的第三方广告素材供应商联系，了解其关于传递 TC 字符串和网址长度限制的要求。在相关的 IAB 透明度和用户意见征求框架 (TCF) v2.0 请求中，此宏将被替换为未经修改的完整 TC 字符串。

额外同意模式
 
宏
${ADDTL_CONSENT}
 

会展开为与请求关联的更多意见征求方式 (AC) 字符串。

未达到同意年龄的 EEA 和英国用户
 
宏
%%TFUA%%
 

会展开为数值 1，以将请求标记为面向未达到同意年龄的欧洲经济区 (EEA) 用户和英国用户。

视频宏

此类宏常用于视频广告素材，以添加有关环境或内容的详细信息。

视频广告时长（以秒为单位）
 
宏
%%VIDEO_AD_DURATION_SECONDS%%
 

会展开为视频广告的时长（以秒为单位）。对于 VAST 封装容器/重定向，该宏会展开为广告在 Ad Manager 中所声明的时长。

借助此宏，您可以使用第三方跟踪网址跟踪视频广告时长。
视频广告时长（以毫秒为单位）
 
宏
%%VIDEO_AD_DURATION%%
 

会展开为视频广告的时长（以毫秒为单位）。对于 VAST 封装容器/重定向，该宏会展开为广告在 Ad Manager 中所声明的时长。

借助此宏，您可以使用第三方跟踪网址跟踪视频广告时长。
视频说明网址
 
宏 转义
%%DESCRIPTION_URL_UNESC%% 不转义
%%DESCRIPTION_URL_ESC%% 一次转义
%%DESCRIPTION_URL_ESC_ESC%% 两次转义
 

如果此宏是在网址内，请使用 %%DESCRIPTION_URL_ESC%%（一次转义）；如果是在其他环境中，请使用 %%DESCRIPTION_URL_UNESC%%（不转义）。详细了解转义与不转义的宏

在重定向广告代码中，这些宏可根据原始 Google 发布商代码的 description_url 查询参数展开为说明网址参数。说明网址通常应与引荐来源网址相同。如果存在 IMA SDK 可能无法准确检测网页网址的嵌入内容，或者如果您在 Ad Exchange 视频广告或 AdSense 视频广告中使用视频，您就应该在 Google 发布商代码中指定 description_url。

Ad Manager 还支持 %%DESCRIPTION_URL%%，此宏的用途与 %%DESCRIPTION_URL_UNESC%% 相同。因此，您无需对较旧的广告素材和模板进行重新编码。
视频引荐来源网址
 
宏 转义
%%REFERRER_URL_UNESC%% 不转义
%%REFERRER_URL_ESC%% 一次转义
%%REFERRER_URL_ESC_ESC%% 两次转义
 

如果此宏是在网址内，请使用 %%REFERRER_URL_ESC%%（一次转义）；如果是在其他环境中，请使用 %%REFERRER_URL_UNESC%%（不转义）。详细了解转义与不转义的网址宏

在重定向广告代码中，此宏会展开为引荐来源网址（即视频播放器所在网页的网址）。具体方式为：Ad Manager 解析广告代码中的网址查询参数，分离出引荐来源网址，然后使用此网址替换宏文本。此宏只能与 Google IMA SDK 配合使用，且必须满足以下条件：

  • 要让此宏发挥作用，必须在网页上启用脚本访问权限。
  • 此宏在 iframe 内不起作用。
Ad Manager 还支持 %%REFERRER_URL%%，此宏的用途与 %%REFERRER_URL_UNESC%% 相同。因此，您无需对较旧的广告素材和模板进行重新编码。
 
您可以将代码参数宏与某些视频参数结合使用，以扩展到上述参数的值。

视频内容宏

此类宏用于会定位视频内容来源的广告。

仅在 Google Ad Manager 360 中提供。
视频时长（以毫秒为单位）
 
宏
%%VIDEO_DURATION%%
 

会展开为视频的时长（以毫秒为单位）。

视频 ID
 
宏
%%VIDEO_ID%%
 

展开为当前正在播放的视频内容的 ID。这是 CMS 中的唯一 ID，或视频广告解决方案 MRSS 元素的 dfpvideo:ContentID 值。

视频元数据
 
宏
%%VIDEO_METADATA:key%%
 

根据与视频内容相关联的键值对，展开为其中正在投放广告素材的视频的相关元数据。您可以在 Ad Manager 的“视频”标签页中设置键值对。

定位视频元数据键后，即可通过视频元数据宏展开。此宏中使用的“key”必须是字母数字字符或下划线 (_)。

视频标题
 
宏 转义
%%VIDEO_TITLE%% 一次转义
 

视频标题宏会展开为在 Ad Manager 中定义的视频标题。

要让此宏发挥作用，必须进行内容提取。

仅在 Google Ad Manager 360 中提供。
内容来源 ID
 
宏
%%CMS_ID%%
 

内容来源 ID 用于定位视频广告。

内容来源 ID 和视频 ID 参数接受变量值。

要将广告定位到视频内容，主视频广告代码必须同时包含这两个参数。

cmsid 是每个内容来源的唯一编号。若要在 Ad Manager 中找到它，请依次点击视频内容来源，然后点击相应来源的名称。了解如何使用媒体 RSS (MRSS) Feed 提取视频内容。

vid 是用于标识特定视频的字符串或编号。此 ID 由托管内容的 CMS 分配。若要在 Ad Manager 中找到它，请点击视频内容，然后点击特定视频内容。

用法示例
cmsid=[value]&vid=[value]

如果您要为包含视频点播内容的动态广告插播构建代码，则应使用可动态插入正确内容来源和视频 ID 的宏。

示例：cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
自定义广告 ID (FreeWheel)
 
宏
%%FW_CAID%%
 

会展开为 FreeWheel 自定义广告 ID。

此宏仅适用于使用 FreeWheel 进行视频广告投放的发布商。

IAB 类别 (FreeWheel)
 
宏
%%IAB_CATEGORIES%%
 

用于为您已使用标签手动分类的广告素材传递广告类别。此宏会返回一系列以英文逗号分隔的适用标准 IAB 类别（从 Google 分类类别转换而来）。

此宏可供与 FreeWheel 共享视频广告资源并希望将广告类别作为自定义参数来传递的发布商使用。例如，您可以向 VAST 重定向代码添加 &iab_categories=%%IAB_CATEGORIES%%。

该内容对您有帮助吗？

您有什么改进建议？

需要更多帮助？

请尝试以下步骤：

向帮助社区发帖 向社区成员寻求答案
与我们联系 向我们提供更多信息，以便我们帮您解决问题
true
立即获取个性化提示，解锁收入潜力！

访问“Google Ad Manager 优化提示”页面，查看个性化建议，以最大限度提高收入。

立即解锁

搜索
清除搜索内容
关闭搜索框
Google 应用
主菜单
4710083049616983023
true
搜索支持中心
false
true
true
true
true
true
148
false
false
false
false