Campaign Manager 360 宏

宏简介

Campaign Manager 360 宏是什么？

Campaign Manager 360 宏是一些短命令，会被 Campaign Manager 360 广告服务器扩展为对应的值（例如关键字、网站键名或网址）。有些宏可用于记录报表信息，还有一些宏则用于决定要投放的广告或用户点击广告后重定向到的位置。大多数宏只包含几个字符，非常便于插入到代码中。

您可以将 Campaign Manager 360 宏插入到各种环境中，包括着陆页网址、点击跟踪广告代码、重定向网址、广告素材的 HTML、帧头或 Floodlight 代码。宏可能是在广告投放时或其他事件（如 Floodlight 调用）发生后扩展，也可能是动态地进行扩展（使用用户所特有的信息），具体取决于您使用的宏及其插入位置。

并非所有宏都能在各种环境中使用。如果将宏插入不受支持的来源，Campaign Manager 360 广告服务器可能会无法正常扩展宏。请参见下表，搭配正确的来源使用宏。例如，如果将 %g 宏插入着陆页网址，Campaign Manager 360 广告服务器会扩展该宏；但如果插入点击跟踪广告代码，Campaign Manager 360 广告服务器就不会扩展该宏。

基本信息

• Campaign Manager 360 宏区分大小写。请务必以小写字母输入宏。例如，%c 是有效的宏，而 %C 则不是。

• 您可以在宏之间使用分隔符，但这并不是强制性要求。如果使用分隔符，请使用英文逗号 (,) 或竖线 (|)。除非您是经验丰富的广告投放人员，否则应避免使用其他分隔符，因为某些分隔符在不合适的环境中出现可能会引发问题。

• 如需修改供应商跟踪网址中的宏，请使用事件代码。以下是基本的操作流程：

  • 首先，在 Campaign Manager 360 中创建一个事件代码。然后，向该事件代码添加供应商跟踪网址。该网址可以是点击跟踪网址、展示跟踪像素或受众调查网址。通过 Campaign Manager 360 中的事件代码属性，您可轻松地向跟踪网址添加宏或从中移除宏。

  • 待事件代码就绪后，即可将其应用到广告中。您的广告在投放时，将使用您事件代码中的跟踪网址。您可以通过 Campaign Manager 360 轻松将事件代码一次性应用到多个广告。例如，您可以将事件代码设置为自动应用到广告系列中的所有广告。如需开始使用事件代码，请按照事件代码指南中的步骤操作。

• Floodlight 代码仅支持扩展宏的 1 个版本，即 %ers!。了解详情

宏的类型

%c – 点击字符串宏

%c 宏会扩展为广告素材着陆页网址中的 Campaign Manager 360 点击字符串。点击字符串是着陆页网址的一部分，用于将浏览器转到 Campaign Manager 360 广告服务器。

如果您需要在自定义广告素材中使用点击字符串的转义版本，请使用 %c_esc（而非 %c）。Campaign Manager 360 点击字符串使用 & 符号，这可能会导致您在使用第三方服务器时遇到问题。

请注意，对于自定义展示广告素材，%c 宏在扩展后不会包含点击事件代码。

点击字符串的运作方式：当用户点击广告素材时，浏览器即会被转到着陆页网址。点击字符串会先将浏览器重定向至 Campaign Manager 360 广告服务器，然后再将其转到广告客户的着陆页。每次展示广告时，Campaign Manager 360 都会自动将点击字符串添加到点击后到达网址中。

如果您向自定义广告素材的 HTML 代码手动添加着陆页网址，则可能需要添加 %c 宏，以确保点击会重定向至 Campaign Manager 360 广告服务器。若想同时扩展点击字符串和着陆页网址，您还可添加 %u（着陆页宏）：%c%u 会扩展为完整的着陆页网址。

实施步骤。下面是点击字符串的示例：

要将点击字符串添加到自定义广告素材的着陆页网址中，请将 %c 宏放在广告素材代码中着陆页网址的开头，如下面的点击后到达网址所示：

当广告服务器投放广告素材时，%c 宏便会扩展为点击字符串。待开头的 %c 宏扩展后，上述着陆页网址可能会如下所示：

您可以看到，%c 已扩展为着陆页网址开头的点击字符串，从而形成了一个完整的广告素材网址。

要一次性插入整个广告素材网址，请将 %c 宏（点击字符串）与 %u 宏（着陆页网址）组合使用：<a href="%c%u">。这两个宏会扩展为完整的广告素材网址。

例如，如果您将 <a href="%c%u"> 插入到 HTML 代码中，该宏便可能会扩展为：

当 %u 扩展为着陆页网址时，着陆页网址中的任何其他宏（包括 %c 宏）也会自动扩展。

%e – 扩展宏

%e 宏会扩展为广告素材各个属性的 ID 号。您只需在该宏后面插入存取器，即可确定该宏会扩展为哪个 ID 号，从而确定要跟踪的广告素材属性。请参见下面的存取器列表。

您可以使用匹配表来定义这些 ID 号，并将广告素材属性与其关联，因为 ID 号与 Campaign Manager 360（以及您的后端数据库）中的说明相关联。这些 ID 号可以帮助您通过 Campaign Manager 360 广告服务器跟踪广告素材的不同属性。

Floodlight 代码仅支持 1 种形式的扩展宏，即 %ers!；不支持任何其他类型的 %e 宏。请注意，%ers! 还可用于其他任何支持该扩展宏的位置（见上表）。

如果您在移动应用广告资源上使用跟踪广告，并且使用静态着陆页，%e 宏将无法正常扩展。

着陆页网址可以包含的 %e 宏的数量没有限制。下面是包含三个 %e 宏的着陆页网址的示例：

%g – 地理位置数据宏

%g 宏会提供与广告请求相关的地理位置信息。该宏可用于在标准广告素材、自定义广告素材和富媒体广告素材中动态反映用户所在的位置。%g 宏会扩展为一个由多个键值对组成的字符串，其中的键值对分别表示国家/地区缩写、州/省级行政区缩写、城市、邮政编码、Designated Market Area^®（特定媒体市场区域）和互联网连接带宽等信息。这些信息会通过 Campaign Manager 360 广告服务器反馈给您。

例如，如果用户位于纽约市，%g 可能会扩展为以下内容：

ct=US&st=NY&ac=212&zp=10001&bw=4&dma=3&city=13275

%h – 广告素材服务器宏

%h 宏会扩展为投放广告素材的服务器的主机名。这样一来，您便无需将主机名硬编码到自己的代码中。主机名不尽相同，因此对于每个广告素材，该宏会动态地进行扩展。

请将 %h 宏添加到代码中网址的开头处，比如下面这个包含“123456”作为广告客户 ID 占位符的图片代码：

%i – 展示宏

%i 宏会扩展为展示字符串。借助该字符串，Campaign Manager 360 广告服务器可以在插页式广告展示期间跟踪其展示次数。

请将 %i 宏添加到代码中网址的开头处，如下例所示：

所有插页式广告中都必须使用 %i 宏，因为借助该宏，Campaign Manager 360 广告服务器才能在插页式广告实际投放时跟踪其展示次数。

%k – 关键字宏

%k 宏会扩展为广告代码中（具体来说就是请求网址中）的一个子字符串。您可以使用该宏在广告素材中显示用户输入的关键字。

该宏对于购买多个关键字也会非常实用：它会根据用户输入的关键字，扩展为同一广告素材的多个关键字之一。不妨以 %k 宏会如何帮助已购买 car insurance 和 car loans 这两个关键字的广告客户为例。如果用户搜索 car insurance，带有该宏的广告素材会显示“Click Here for Car Insurance”；如果用户搜索 car loans，此广告素材会显示“Click Here for Car Loans”。

请使用键值对来指定该宏会扩展为哪个子字符串。每个键值对均是由一个键 (start_key_string) 和一个对应的值 (end_character) 组成。

请按以下顺序插入宏和键值对：首先插入宏，然后插入第一个值，接着插入感叹号 (!)，最后插入第二个值。其格式如下所示：

%k 宏会捕获这些参数指定的子字符串。它会找到您指定的关键字并将该宏扩展为该关键字。您可以在 ad Campaign Manager 360 代码或 jump Campaign Manager 360 代码中插入该键值对。

%k 宏的另一个用途是取消转义已转义的字符。当该宏将子字符串传递到广告素材的 HTML 中时，所捕获的子字符串中的每个已转义字符都会自动还原为各自的原始字符集。例如：

要在广告素材中展示 car insurance，您必须对已转义的字符 + 进行解码。因此，广告客户将 %k 嵌入广告素材的代码中。广告服务器会捕获子字符串 kw=car+insurance，对 + 字符进行解码，并在广告素材中将其显示为“car insurance”。

现在，该代码会如下所示：

有关 %k 和 %p 宏的注意事项：这两个宏类似，因为它们都捕获 start_key_string 指定的子字符串，但它们传递子字符串的方式有所不同。%k 宏会将子字符串传递到广告素材的 HTML 中，而 %p 宏会将子字符串传递到网址中。与 %p 宏不同，%k 宏仅在广告素材的 HTML 代码中起作用。

%m – 匹配代码宏

在浏览器设置启用了 Cookie 的情况下，当用户点击广告素材时，%m 宏会扩展为用户的 DoubleClick Cookie 值。该宏的用途之一是：生成用户 ID 列表，然后对之前响应过相应广告素材的用户进行重访定位。用户 ID 通过广告客户 ID 加密密钥进行加密。详细了解 Campaign Manager 360 帐号中的用户 ID 加密。

您可以将该宏插入着陆页网址、重定向网址、广告素材代码或经过硬编码的点击跟踪广告代码（如 ad.doubleclick.net/clk）中。（DoubleClick Cookie 值是一个 64 位的整数，最多可包含 20 个字符。）

广告服务器会在点击事件发生后生成的点击字符串中扩展 %m 宏，而不会在广告素材内扩展该宏。

• 如果用户停用浏览器的 Cookie 或已选择不接受 Cookie，广告服务器便会将 %m 扩展为 0。
• 在广告素材代码中，如果浏览器使用了代理，%m 宏则不会生效。在这种情况下，广告服务器也会将 %m 扩展为 0。

%n – 随机数宏

%n 宏会扩展为一个随机数。随机数会阻止浏览器缓存网址。投放广告时，广告服务器会动态生成一个随机数，并会将其附加到网址中以代替 %n。由于每次投放广告时网址中都会有一个新的随机数，因此浏览器无法加载相应广告的缓存版本。只要您让缓存失效，便可避免第三方服务器漏算展示次数。

当 Campaign Manager 360 必须将广告素材重定向至第三方时，发布商经常会使用 %n 宏。第三方通常会有自己的随机数语法，类似于 Campaign Manager 360 的 ord=[random_number]?。

%n 宏也支持第三方跟踪点击次数。由于每次用户点击时，广告服务器都会扩展出一个独一无二的随机数来代替 %n 宏，因此第三方可以分别跟踪每次点击。广告投放人员应与第三方确认，以便确保他们支持该宏所扩展成的其他字符串。

%p – 模式匹配宏

%p 宏会扩展为广告代码请求网址中的子字符串。当广告投放时，该宏会扩展为指定开始字符串与结束字符之间的任意值。

如何指定子字符串：使用键值对来为您希望服务器搜索的那类子字符串指定开头和末尾。每个键值对均包含两个键值：start_key_string 值和 end_character 值。

• [start_key_string]：键值对的键部分。广告代码中必须包含此部分。此部分区分大小写，而且不包含占位符括号。

• [end_character]：用于表示键值结束的字符。如果未显示结束字符，且开始字符串为代码中的最后一个键值，则广告服务器会复制整个字符串。您在输入值时可以任意使用由 ASCII 值构成的字符串。该值的长度应至少为两个字符，而且不包含占位符括号。

基本格式如下：

一般情况下，%p 宏用于扩展为可帮助跟踪报表信息的关键字。例如，如果您想添加某个车型名称，则应在广告代码中插入一个 %p 宏，并使用开始字符串 model= 和选定的结束字符（在此示例中是一个分号）。另请注意，占位符括号不包括在内：

当您的广告投放时，Campaign Manager 360 会在广告代码中搜索 model=，然后捕获 model= 与结束字符 (;) 之间的所有内容。

%p 宏的一些常见用途包括：

• 广告客户使用该宏将 Floodlight 代码中的值或变量传递至发布商代码。

• 发布商使用该宏将值动态传递至着陆页网址。

%s – 网站键名宏

%s 宏的扩展结果会不尽相同，具体取决于您是将此类宏添加到了广告代码还是添加到了 Floodlight 代码。

• 广告代码扩展为 Campaign Manager 360 网站键名：当用户点击 Campaign Manager 360 投放的广告时，该宏将会扩展为此广告所投放到的目标网站的键名。该键名应与 Campaign Manager 360 中该网站的“属性”标签页（管理 > 网站）上列出的键名一致。

  以下面这一在末尾处包含 %s 宏的网址为例：

  http://www.advertiser.com/cgi.bin/?%s

  如果包含此网址的广告投放到了键名为 N255.010101.sandwiches 的网站中，那么当用户点击此广告时，该宏便会扩展为 N255.010101.sandwiches：

  http://www.advertiser.com/cgi.bin/?N255.010101.sandwiches

  如果无法实时获取网站信息，%s 可能会扩展为空字符串。

• Floodlight 代码扩展为 Campaign Manager 360 网站 ID：当 Floodlight 代码在网站上触发时，%s 宏会扩展为该网站的 ID。该 ID 即为 Campaign Manager 360 用于标识网站的 ID。

%u – 着陆页网址宏

%u 宏会扩展为广告素材的着陆页网址。例如，<a href="%u"> 可能会扩展为以下着陆页网址：

要一次性插入整个广告素材网址，请结合使用 %u 宏和 %c 宏。这两个宏会扩展为完整的网址：%c（点击字符串）+ %u（着陆页网址）= 完整的广告素材网址。

例如，如果您将 <a href="%c%u"> 插入到 HTML 代码中，该宏便可能会扩展为：

http://ad.doubleclick.net/click;361119;0-8388608;2;321977;1-468|60;0|0|0;;?http%3A%2F%2Fwww.doubleclick.com%2Fpath%2Fpage.html