简报广告(Beta 版)

简报广告可用于在电子邮件简报中展示 Google Ad Manager 预订型广告和有保证的程序化广告。本指南介绍了如何在电子邮件简报中植入简报广告。

概览

以下是植入简报广告的简要工作流程:

  1. 创建或选择 Ad Manager 广告单元
  2. 创建或选择 Ad Manager 订单项。 请牢记以下准则:
    • 预计使用的广告素材必须包含您希望在简报中展示的所有广告素材尺寸。
    • 定位条件必须包含第 1 步中的广告单元。
    • 简报广告仅支持图片广告素材。
  3. (推荐)配置自家订单项作为备用订单项,以防广告未填充。
  4. 制作简报广告代码
  5. 在您希望广告在简报中显示的位置插入简报代码。

简报广告代码格式

简报广告代码由 HTML 图片 (img) 元素组成,该元素嵌套在 HTML 锚点 (a) 元素中。每个简报广告代码后面都必须跟随“关于此广告”链接,以便向用户提供有关所展示广告的信息。

<!-- Newsletter ad tag -->
<a href="JUMP_URL?AD_PARAMETERS" target="_blank">
  <img src="AD_URL?AD_PARAMETERS">
</a>

<!-- "About this ad" link -->
<a href="JUMP_URL?AD_PARAMETERS&click_type=wta">About this ad</a>

锚点 href 和图片 src 网址的格式如下:

JUMP_URL https://securepubads.g.doubleclick.net/gampad/jump
AD_URL https://securepubads.g.doubleclick.net/gampad/ad
AD_PARAMETERS ptt=21&iu=AD_UNIT_PATH&sz=CREATIVE_SIZES&clkk=CLKK_VALUE&clkp=CLKP_VALUE&url=URL&t=TARGETING_KEY_VALUES

如需查看使用模拟值的完整简报广告代码示例,请参阅示例部分

下面详细介绍了支持的简报广告参数:

参数
ptt

必须始终设置为 21,以指明这是一份简报广告请求。

必需
iu

广告单元路径,用于标识要展示的 Ad Manager 广告单元。

广告单元路径必须采用以下格式:

/network-code/[parent-ad-unit-code/.../]ad-unit-code

  • network-code 是广告单元所属 Ad Manager 广告联盟的唯一标识符。使用多客户管理 (MCM) 时,应将父级和子广告资源网标识符都作为 parent,child 提供。
  • parent-ad-unit-code 是所有父级广告单元的代码(仅适用于非顶级广告单元)。
  • ad-unit-code 是要显示的广告单元的代码。
广告单元路径中包含的所有广告单元代码都必须遵循 Ad Manager 指定的格式规则

示例 顶级广告单元:/123/homepage
多级广告单元:/123/sports/baseball
MCM:/123,456/homepage
必需
sz

可在此广告位中展示的广告素材的尺寸。

请确保此处列出的尺寸与所选订单项的预计使用的广告素材字段中选择的尺寸一致。

可以指定多个尺寸,以竖线 (|) 字符分隔。此参数的整个值都必须经过网址编码

示例 尺寸:216x36、300x50 或 320x50
尺寸字符串:216x36|300x50|320x50
参数值:216x36%7c300x50%7c320x50
必需
clkk

针对每位收件人和每项电子邮件广告系列的唯一字符串。

电子邮件中包含的每条简报广告都必须指定一个唯一的 clkk 值。 不过,每个单独的简报广告代码都必须在其锚链接 href 和图片 src 网址中指定完全相同clkk 值。

如需生成 clkk 值,您需要使用电子邮件服务提供商 (ESP) 提供的合并标签功能。“合并标签”是电子邮件中动态且可自定义的变量,例如 *|DATE:d/m/y|*。合并标签功能的确切名称因 ESP 而异。

简而言之,clkk 值是多个合并标记变量的串联,其格式类似于 *|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*。可用的变量和语法取决于 ESP,因此您的 clkk 值可能并不完全遵循此格式。

如需生成 clkk 值,请执行以下操作:

  1. 找到您 ESP 的“合并标签”文档。
  2. 确定合并代码变量的组合,这些变量串联后会生成一个字符串,该字符串对于每个用户和每项电子邮件广告系列都具有唯一性。
  3. 将这些变量串联起来,形成 clkk 值。

必需
clkp

用于唯一标识单个简报广告展示位置的字符串。

如果电子邮件中包含多个简报广告,则必须提供此参数。如果您的简报仅包含一个广告展示位置,则可以省略此参数。

示例 12topmiddlebottom
必需 是,如果存在多个广告展示位置
url

当前简报的“在浏览器中查看”网址。

url 值应通过电子邮件服务提供商 (ESP) 提供的“在浏览器中查看”网址合并标签填充。“合并标签”是电子邮件中动态且可自定义的变量,例如 *|ARCHIVE|*。“在浏览器中查看”网址合并标签的确切名称因 ESP 而异。

必需
t

定位到键值对

键和值之间使用等号 (=) 字符分隔,多个键值对之间使用和号 (&) 字符分隔。每个键和值以及完整的定位字符串都必须进行网址编码

现有的键值对限制适用于简报广告。如需了解详情,请参阅键值对使用入门

示例
genre comedy
movie Lilo & Stitch
定位字符串:genre=comedy&movie=Lilo%20%26%20Stitch
参数值:genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch
必需

示例

以下示例展示了使用一组模拟值呈现的完整简报广告代码。

广告单元路径 (iu) /1/example_ad_unit
广告素材尺寸 (sz) 216x36|300x50|320x50
每封电子邮件的唯一字符串 (clkk) *|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*
广告位置 (clkp) top
定位条件 (t) genre=comedy&movie=Lilo & Stitch
“在浏览器中查看”网址 (url) *|ARCHIVE|*
<!-- Newsletter ad tag -->
<a
  href="https://securepubads.g.doubleclick.net/gampad/jump?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch"
  target="_blank">
  <img
    src="https://securepubads.g.doubleclick.net/gampad/ad?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch">
</a>

<!-- "About this ad" link -->
<a
  href="https://securepubads.g.doubleclick.net/gampad/jump?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch&click_type=wta">
  About this ad
</a>

常见问题解答

如何生成有效的 clkk 值?

请参阅 clkk 参数参考文档

我应该使用哪些合并代码变量组合来构成 clkk 值?

由于可用的合并标记变量和适当的语法因电子邮件服务提供商 (ESP) 而异,因此我们无法就您的 clkk 值提供建议或进行验证。我们建议您参阅 ESP 的文档,找到可为每个用户和每项电子邮件广告系列生成唯一字符串的变量组合。

以下是一些常用 ESP 的文档:

如何知道我的 clkk 值是否正确?

clkk 值正确无误后,系统会生成一个字符串,该字符串对于每个用户和每项电子邮件广告系列都具有唯一性。为验证这一点,您应生成测试电子邮件,点击其中包含的广告,确保您被定向到正确的目标网址,并且 Google Ad Manager 中会报告点击次数。

如果您尚未查看,我们强烈建议您查看简报广告代码参考文档,详细了解如何生成正确的 clkk 值。以下是一些重要要求:

  • 构成 clkk 值的“合并标记”组合必须针对每位用户和每项电子邮件广告系列保持唯一性。如果您的 clkk 值仅包含一个变量(例如 clkk=%UMF_MD5),则该值很可能不够唯一。
  • 单个广告展示位置必须在其锚点 href 和图片 src 网址中指定相同的 clkk 值。如果给定简报广告的 hrefsrc 没有相同的 clkk 值,该广告将无法正常投放,并且可能会出现意外行为。

为什么我的简报中没有显示广告?

以下是可能导致简报广告插入失败的一些常见问题:

  • 简报广告代码不正确。
    • HTML 锚点 href 和图片 src 参数不匹配。
    • 广告网址不包含 ptt=21 参数。
    • 代码包含空格。
    • 存在拼写错误或参数未使用和号 (&) 串联。
    • 合并标签在由 ESP 呈现时会引入无效字符。
    • 包含电子邮件地址或信用卡号等个人身份信息。
  • 广告单元路径不正确。
  • 订单项处于非活跃状态。

为什么用户点击广告后会进入错误的页面?

这可能是因为 clkk 值不是唯一的。如需了解详情,请参阅 clkk 参数参考文档

为什么 Ad Manager 报告中未报告点击次数?

可能的原因有以下两种:

  1. 您的 ESP 的点击跟踪功能已开启,这会影响 Google 记录点击的能力。
  2. 您的 clkk 值不正确。如需了解详情,请参阅 clkk 参数参考文档

如何知道我的 ESP 的点击跟踪功能是否处于开启状态?

如需了解详情,请参阅您的 ESP 的文档或与其客户服务团队联系。

如何根据设备类型或屏幕尺寸显示不同尺寸的广告素材?

您可以使用 CSS @media 查询根据浏览器视口尺寸动态调整广告素材的尺寸。在以下示例中,当视口宽度不超过 480px 时,广告 img 元素(通过 class="ad 标识)会占据其父级容器宽度的 100%;当视口宽度至少为 480px 时,它只会占据其父级容器宽度的 50%。在这两种情况下,只要未为 HTML img 元素指定任何其他尺寸,广告的宽高比将保持不变。

<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
    <meta name="viewport" content="width=device-width,initial-scale=1" />
    <style>
      @media only screen and (max-width: 480px) {
        .ad {
          width: 100%;
        }
      }
      @media only screen and (min-width: 480px) {
        .ad {
          width: 50%;
        }
      }
    </style>
  </head>
  <body></body>
</html>