自定义广告素材的宏

了解如何使用转义的宏和未转义的宏

技术专业知识

本文面向制作自定义广告素材的用户,要求用户具备技术专业知识

如果您是广告投放人员,希望将自定义广告素材与订单项关联起来,但不具备对自定义广告素材进行问题排查的技术专业知识,请寻找具备相关知识的人员。这可以是贵组织内使用 Ad Manager 制作该自定义广告素材的人员,也可以是为贵组织提供该自定义广告素材中所用代码的广告代理机构的人员。

在自定义广告素材中,宏有多种用途。其中的两个重要用途是作为目标网址(点击后到达网址)和点击跟踪网址的占位符。这些宏有三种变体:未转义、经过一次转义和经过两次转义。

转义是指使用一个字符(或一系列字符)来表示其他字符的做法。在互联网上传输时,网址只能使用 ASCII 字符集。不过,网址中也可能会使用该字符集以外的字符,因此这些字符在传输过程中必须经过编码才能被正确解析。

制作自定义广告素材时,您需要在广告素材代码中使用以下一项或多项:

  • 未转义的点击跟踪网址:%%CLICK_URL_UNESC%%
  • 经过一次转义的点击跟踪网址:%%CLICK_URL_ESC%%
  • 未转义的目标网址:%%DEST_URL%%
  • 经过一次转义的目标网址:%%DEST_URL_ESC%%
  • 经过两次转义的目标网址宏:%%DEST_URL_ESC_ESC%%

您需要使用相应的变体,才能确保能够对点击次数进行跟踪或用户能够转到目标网址。如果使用了错误的变体,就可能意味着点击跟踪无法记录相应数据或用户无法转到目标网址。

如果同时需要点击跟踪网址和点击后到达网址,您还需要确保使用合适的变体对这些宏进行正确的排序或“链合”。

在本文中,您可以查看正确和错误的示例,以了解如何使用目标网址宏和点击跟踪网址宏以及如何将它们链合在一起。

示例:宏插入

下面列举了 Campaign Manager 360 中的一个未转义的点击跟踪网址。为清楚起见,我们移除或缩短了相关参数:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=

请将该网址与同一网址的经过转义的版本进行比较:

http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253D

在该网址中,系统已使用百分号编码对保留的字符进行了两次转义。例如,问号 (?) 始终由字符序列 %253F 表示,而等号 (=) 始终由字符序列 %253D 表示。

示例 1A - 正确:自定义广告素材的 Ad Manager 点击跟踪

在此示例中,假设我们有一个自定义广告素材,它的点击后到达网址是:

http://www.google.com/page.html?param1=red&param2=blue

图片广告素材可能会按如下方式跟踪点击次数:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

在此示例中,用户的浏览器上呈现的广告素材如下所示:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

这是一个正确有效的点击跟踪网址,因为 Ad Manager 点击跟踪网址未进行转义但目标网址进行了正确转义。

示例 1B - 错误:自定义广告素材的 Ad Manager 点击跟踪

对于上述示例中的广告素材代码,导致其无法运行的一个常见错误是使用了转义的点击跟踪网址宏。在广告素材代码中,此宏如下所示:

<a href='%%CLICK_URL_ESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

用户的浏览器上呈现的广告素材如下所示:

<a href='http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

这是一个错误的网址 - 因为所有参数都已进行转义,无法被 adclick 服务器正确解析。实际上,该服务器会将此网址解读为对以下页面的请求:/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue

由于该页面不存在,因此 adclick 服务器会返回 HTTP 404(未找到)错误,并且不会将用户重定向至广告着陆页。

示例 1C - 错误:自定义广告素材的 Ad Manager 点击跟踪

对于上述示例中的广告素材代码,导致其无法运行的另一个常见错误是使用了未转义的目标网址宏。在广告素材代码中,此宏如下所示:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_UNESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

用户的浏览器上呈现的广告素材如下所示:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

请注意,如果第一个点击服务器足够智能,可以将剩余的参数解读为网址并对这些参数进行转义,那么此特定点击跟踪网址示例或许能正确运行。在这种情况下,Ad Manager 确实会重写网址,以便点击跟踪网址能正常运行。即便如此,您也不应想当然地认为服务器总是能够处理格式错误的点击跟踪网址。我们强烈建议您使用格式正确的点击跟踪网址,而不是依赖 Ad Manager 或第三方分析服务器来处理格式错误的网址。

如果服务器没有重写格式错误的网址,则会将此网址解读为如下内容:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue

在这种情况下,最后一个“&”字符会被解读为分隔符,用于连接第一个服务器请求的新参数(而不是解读为应传递给广告着陆页托管服务器的参数)。这可能会干扰点击服务器处理点击跟踪网址,进而可能导致服务器无法将用户重定向至着陆页。即使用户已被成功重定向至着陆页,服务器很可能也不会将第二个参数 (param2) 传递给着陆页。

示例 2A - 正确:第三方点击跟踪广告代码和宏

广告客户可能会要求您将第三方点击跟踪广告代码添加到广告素材中。跟踪广告代码会对广告素材的点击次数进行单独计数,并协助广告客户日后进行审计或对帐。

通常,点击跟踪广告代码的具体形式是一个网址。下面是一个 Campaign Manager 360 示例:

http://ad.doubleclick.net/clk;a;b;c?[点击后到达网址][目标网址]

该网址 (ad.doubleclick.net) 指向用于记录展示次数或点击次数的服务器。其他第三方网址也与之类似。点击后到达网址应由两个宏表示:

  • 经过一次转义的 Click 宏:%%CLICK_URL_ESC%%
  • 经过两次转义的目标网址宏:%%DEST_URL_ESC_ESC%%

二者都代表同一个点击后到达网址,并且都必须位于问号 (?) 后面。下面是一个包含 Campaign Manager 360 点击跟踪网址的图片广告素材示例:

<a href='http://ad.doubleclick.net/clk;a;b;c?%%CLICK_URL_ESC%%%%DEST_URL_ESC_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

在使用广告素材模板时,第三方点击跟踪广告代码通常会以网址占位符的形式呈现在广告素材代码内。用户的浏览器上呈现的广告素材会将这些宏展开至预期值。下面举个例子:

<a href='http://ad.doubleclick.net/clk;a;b;c?http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/page.html%253Fparam1%253Dred%2526param2%253Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

广告素材预览与测试宏

测试广告素材可确保其按预期正常运行。由于宏是占位符,并且有时会涉及到复杂的代码,因此测试自定义广告素材的最佳方法是从订单项预览广告素材。为此,请执行以下操作:

  1. 新窗口中打开广告素材。

    JavaScript 在 Ad Manager 中直接提供的预览中无法运行。此外,宏的展开版本是无法查看的。

  2. 使用浏览器的开发者工具(“开发者工具”)来检查各个元素和 DOM。

验证点击跟踪宏

在正确插入宏后,从预览中点击广告素材便会转到相应的 Ad Manager 着陆页。该网页可确认系统已跟踪相应点击操作。然后,系统会将您重定向到与该广告素材相关联的目标网址页面。

如果没有发生以上任一情况,则表明这些宏或其链合方式出问题了。

验证 View 宏

若要验证展示跟踪宏,您需要使用流量分析器。借助流量分析器,您可以查看并捕获 HTTP 请求。某些浏览器开发者工具包含此类工具。此外,您还可以使用第三方流量分析器软件。

使用流量分析工具,在广告素材加载时检查 HTTP 请求。您要查找的是对记录展示次数的服务器成功执行的请求或“ping”操作。请注意 HTTP 请求过程中出现的所有 HTTP 错误。

  • 如果您未发现任何错误,并且可以看到对记录展示次数的服务器成功执行的 ping 操作,则表明这些宏已配置正确。
  • 如果您发现任何错误,请返回自定义广告素材的源代码进行问题排查。宏未放置正确时的常见错误代码为 HTTP 204

该内容对您有帮助吗?

您有什么改进建议?
true
版本说明

获悉最新的 Ad Manager 功能和帮助中心更新。

了解新变化

搜索
清除搜索内容
关闭搜索框
主菜单
14202797582143001751
true
搜索支持中心
true
true
true
true
true
148
false
false