了解 Campaign Manager 360 代码的工作原理以及您可以下载的展示位置代码类型。
关于代码
代码类型
工作原理
什么是展示位置代码?展示位置代码(有时称为广告代码)是一种用于在用户访问网站时向广告服务器调用广告内容的代码。当用户访问包含 Campaign Manager 360 展示位置代码的网站时,Campaign Manager 360 就会投放广告。展示位置代码会指示用户的浏览器发出广告请求,而 Campaign Manager 360 通常可以根据请求中包含的信息决定要发送何种类型的广告。
Campaign Manager 360 会为广告系列中的每个展示位置生成唯一的代码。对于支持多种尺寸的展示广告素材,Campaign Manager 360 会为每种尺寸生成一个代码。展示位置即网站上用于显示广告的各个位置。通常,广告客户或代理机构会与发布商合作,共同决定要在网站上的哪些位置植入代码,以及哪些类型的代码最为合适。
以下是基本流程:首先,广告投放人员设置广告中的广告素材。接下来,广告投放人员在 Campaign Manager 360 中将广告分配到展示位置。一旦 Campaign Manager 360 中的所有工作皆已就绪,广告投放人员便会生成代码,对代码进行测试,然后将代码发送给发布商。广告投放人员会先将广告素材分配给广告,再将这些广告分配到展示位置。然后,广告投放人员可以通过报告来查看广告系列的效果。
点击广告系列中的代码,以下载代码或向发布商发送通知(如果需要付款审批)。
对于 Campaign Manager 360,代码工作流程可帮助您选择展示位置、代码类型以及其他会影响到代码生成方式的相关信息。请参阅代码生成指南,了解生成代码的步骤。
注意事项
- 代码工作流程中有一个重要环节,就是将展示位置设置为代理机构付费,还是发布商付费。发布商付费的展示位置无法直接下载代码,您必须通过 Campaign Manager 360 通知发布商有关其代码的信息。
-
如果您集成了 IAB TCF v2.0,并且 TC 字符串表明 Google 未就相应请求的用途 1 征得用户同意,请将代码中的
ad.doubleclick.net
替换为pagead2.googlesyndication.com
。此要求适用于标准代码、iframe/JavaScript 代码(不包括 ins 代码)、预取代码(包括视频广告)、跟踪广告代码和点击跟踪广告代码。详细了解如何与 IAB TCF v2.0 集成。
每种素材资源支持的代码
每种广告素材资源支持的代码均相同,而与广告的投放位置和您计划覆盖的设备类型无关。为了确保选择恰当的代码,您可以参考以下表格。
图片素材资源* | HTML5 素材资源 | 富媒体 | 插播 (视频和音频) |
VPAID | 跟踪广告素材 | |
---|---|---|---|---|---|---|
标准 |
仅限 1x1 |
|||||
iframe/JavaScript | ||||||
JavaScript | ||||||
预抓取 | ||||||
内部重定向 | ||||||
点击跟踪广告代码 | ||||||
跟踪广告 |
*包含高密度图片素材资源的展示位置必须使用 ins 代码,因为此类代码会正确填充屏幕密度。
代码与移动平台
对于移动设备、移动网站或移动应用,并不存在专用的代码类型。
不过,您需要确保发布商可以正确地填充与移动平台相关的 3 个参数,尤其是必需的 dc_rdid
参数。这是启用许多重要功能的前提条件。请参见下文,获得相关指导并了解代码的其他详细信息。兼容性类型为“展示”的所有展示位置中都会显示这些参数。
必须向在应用内投放的展示位置代码添加额外的参数,才能启用许多重要功能。这些参数包括 dc_rdid=
、tag_for_child_directed_treatment=
和 dc_lat=
。
这些参数全都自动包含在兼容性类型为“展示”的所有展示位置中,因为兼容性类型为“展示”的任意展示位置都可能会在应用内投放。
请注意,如果是发布商付款的展示位置,那么您必须先将展示位置代码发送给发布商以供批准,发布商批准后您才能下载展示位置代码。
为什么您需要确保发布商向这些参数传递值
如果这些参数中没有值,那么您的代码将无法启用 Floodlight 转化跟踪、覆盖面/频次报表、频次上限、广告素材轮播或受众群体名单(再营销)。
参数定义
-
dc_rdid=
:用户可重置的设备标识符,形式为 IDFA(对于 iOS)或广告 ID (AdID)(对于 Android)。此参数是必需的。发布商必须向此参数传递值,才能启用应用内转化跟踪功能。值应为未经过哈希处理的原始值。我们只接受通过已启用 SSL 的代码安全传递的值。注意:我们强烈建议您使用
dc_rdid
参数来传递设备 ID,而不是使用旧参数dc_muid
(此参数接受经过 MD5 哈希算法处理的大写 IDFA、Android ID 和 AdID 值)。-
SSAID 适用于中国境内的非 Play Android 设备。
-
-
tag_for_child_directed_treatment=
:接受值 0 或 1。如果值为 1,则表示这一特定请求可能是由未满 13 周岁的用户发出(根据 COPPA 规定)。 -
dc_lat=
:接受值 0 或 1。如果值为 1,则表示用户已针对 IDFA 或 AdID 启用了“限制广告跟踪”选项,以选择停用针对用户兴趣的广告和再营销。如果“限制广告跟踪”处于停用状态,则值为 0。
代码示例
下面是一些包含上文所述参数的示例代码。由于所有这些参数都必须由发布商进行填充,因此,请确保您的发布商已同意传递必需的值。
ins 代码(移动环境的首选项)示例的开头部分:
<ins class='dcmads'
style='display:inline-block;width:320px;height:50px'
data-dcm-placement='N9200.284657.MYSITE/B7841342.2'
data-dcm-rendering-mode='script'
data-dcm-click-tracker='${CLICK_URL}'
data-dcm-limit-ad-tracking=0
data-dcm-resettable-device-id='38400000-8cf0-11bd-b23e-10b96e4ddddd'
data-dcm-child-directed=0>
<script src='https://www.googletagservices.com/dcm/dcmads.js'></script>
</ins>
标准代码(用于图片横幅广告)示例:
<A HREF="https://ad.doubleclick.net/ddm/jump/N9200.284257.MYSITE/B7841142;sz=320x50;ord=[timestamp]?"> <IMG SRC="https://ad.doubleclick.net/ddm/ad/N9200.284257.MYSITE/B7841142;sz=320x50;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0?" BORDER=0 WIDTH=320 HEIGHT=50 ALT="Advertisement"></A>
JavaScript 代码(通常用于 HTML5 或富媒体横幅广告)示例的开头部分:
<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/N9200.284657.MYSITE/B7841342.2;sz=320x50;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0?"> </SCRIPT>
预取代码(用于插播视频广告和插播音频广告)示例:
VAST 2.0 预取代码
https://ad.doubleclick.net/ddm/pfadx/N9200.284657.MYSITE/B7841342.2;kw=[keyword];sz=widthxheight;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0;dcmt=text/xml;dc_sdk_apis=[APIFRAMEWORKS];dc_omid_p=[OMIDPARTNER]
VAST 3.0 预取代码
https://ad.doubleclick.net/ddm/pfadx/N9200.284657.MYSITE/B7841342.2;kw=[keyword];sz=widthxheight;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0;dcmt=text/xml;dc_sdk_apis=[APIFRAMEWORKS];dc_omid_p=[OMIDPARTNER];dc_vast=3
VAST 4.0 预取代码
https://ad.doubleclick.net/ddm/pfadx/N9200.284657.MYSITE/B7841342.2;kw=[keyword];sz=widthxheight;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0;dcmt=text/xml;dc_sdk_apis=[APIFRAMEWORKS];dc_omid_p=[OMIDPARTNER];dc_vast=4
跟踪广告图片代码(用于跟踪展示次数)示例:
<IMG SRC="https://ad.doubleclick.net/ddm/trackimp/N7480.169443360.MYSITE/B7967415.105398014;dc_trk_aid=278142637;dc_trk_cid=56651190;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0?" BORDER="0" HEIGHT="1" WIDTH="1" ALT="Advertisement">
跟踪广告代码(用于跟踪点击次数)示例:
http://ad.doubleclick.net/ddm/trackclk/N7480.169443360.MYSITE/B7967415.105398014;dc_trk_aid=278142637;dc_trk_cid=56651190;dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0
虽然对于移动设备、移动网站或应用,并不存在特殊的展示位置代码类型,但总体的支持情况可能有所不同。您可以参考下表来选择正确的代码。由于您不能将设备 ID 传递到点击跟踪广告的展示位置代码,因此请改为使用跟踪广告。
移动网站兼容性图片 | HTML5 广告素材 | Rich Media | 插播 (视频和 音频) |
VPAID | 跟踪广告素材 | |
---|---|---|---|---|---|---|
标准 | 仅限 1x1 | |||||
iframe/JavaScript | ||||||
JavaScript | ||||||
预抓取 | ||||||
内部重定向 | ||||||
点击跟踪广告代码 | ||||||
跟踪广告 |
图片 | HTML5 广告素材 | Rich Media | 插播 (视频和 音频) |
VPAID | 跟踪广告素材 | |
---|---|---|---|---|---|---|
标准 | 仅限 1x1 | |||||
iframe/JavaScript | ||||||
JavaScript | ||||||
预抓取 | ||||||
内部重定向 | ||||||
点击跟踪广告代码 | ||||||
跟踪广告 |
标准代码
标准代码是一种展示位置代码。此类代码只能用于尺寸为 1x1 的展示位置。标准代码由一个锚标记 (<A HREF>
) 与一个图片标记 (<IMG SRC>
) 组成。
<A HREF="https://ad.doubleclick.net/ddm/jump/Nxxxx.site-keyname/Byyyyyyy.Pzzzz; sz=widthxheight;kw=[keyword];ord=[timestamp]?">
<IMG SRC="https://ad.doubleclick.net/ddm/ad/Nxxxx.site-keyname/Byyyyyyy.Pzzzz;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I?" BORDER=0 WIDTH=X HEIGHT=Y ALT="Click Here"></A>
请确保这两个标记始终都一起投放,并且先投放 A HREF
标记,再投放 IMG SRC
标记。
A HREF
:此标记兼作 HTML 锚标记和超链接引用标记;当用户点击图片时,此标记会指示用户的浏览器调用相应的网址。
ad.doubleclick.net
:Campaign Manager 360 广告服务器的网址。
ddm
:这是一个新参数,用于区分 Campaign Manager 360 的代码和旧版产品 (DFA) 的代码。它不会对代码的导出或植入方式产生任何影响。
jump
:一项会传递到 Campaign Manager 360 广告服务器的命令,用于统计点击次数。当用户点击相应的图片时,链接会动态替换为实际的点击后到达网址。
Nxxxx
:Campaign Manager 360 账号 ID。
site-keyname
:网站的标识符,具体视网站的网址而定。
Byyyy
:Campaign Manager 360 广告系列 ID。
.Pzzzz
:Campaign Manager 360 展示位置 ID。
sz=widthxheight
:展示位置的尺寸,以像素为单位。此信息使 Campaign Manager 360 广告服务器能够投放正确尺寸的广告素材。对于插页式展示位置,代码中的 sz=
会被删掉。
kw=[keyword]
:您可以使用 kw=
参数将关键字传递到 Campaign Manager 360 广告服务器。关键字定位通常用于在搜索结果页上投放的广告,而 kw=
属性的值就是用户的查询内容。例如,如果用户搜索“car”,那么代码中的这个参数便为 kw=car
。
何时投放 Campaign Manager 360 展示位置代码以及何时在投放的代码中插入适当的关键字均由网站决定。
ord=[timestamp]
:对于 ord=
参数,每当用户访问相应网站时,该网站要负责动态插入一个具有唯一性的字符串(不一定是时间戳)。使用唯一代码是为了防止网络浏览器向用户投放缓存的广告素材。
A HREF
和 IMG SRC
标记而言,两者中的 ord=
参数值必须一致。IMG SRC
:HTML 图片标记。SRC
参数用于告知浏览器到哪里找到要显示的图片。
ad
:表示该代码为标准代码。
dc_lat=
:dc_lat
键值对中的键,供移动应用传递相关信息,指出用户是否已针对 IDFA 或 AdID 启用了“限制广告跟踪”选项以停用个性化广告和再营销功能。
N
:dc_lat
键值对中的值。如果值为 1,则表示用户已针对 IDFA 或 AdID 启用了“限制广告跟踪”选项。如果“限制广告跟踪”处于停用状态,则值为 0。
dc_rdid=
:dc_rdid
键值对中的键,供移动应用传递可重置的设备标识符。该值是一个可由用户重置的设备标识符,形式为 IDFA(适用于 iOS)或广告 ID(AdID,适用于 Android)。我们只接受通过已启用 SSL 的代码安全传递的值,此类值需要由移动应用或广告 SDK 在运行时进行填充。
Czzzz
:dc_rdid
键值对中的值。该值是一个可由用户重置的设备标识符,形式为 IDFA(适用于 iOS)或广告 ID(AdID,适用于 Android)。我们只接受通过已启用 SSL 的代码安全传递的值,此类值需要由移动应用或广告 SDK 在运行时进行填充。
tag_for_child_directed_treatment=
:该键值对可供移动应用传递相关信息,指明相应请求是否可能是由未满 13 周岁的用户发出(根据《儿童在线隐私保护法》(COPPA) 规定)。
I
:tag_for_child_directed_treatment=
键值对中的值。如果值为 1,则表示这一特定请求可能是由未满 13 周岁的用户发出(根据 COPPA 规定)。
tfua=
:tfua=
键值对中的键,用于传递相关信息,指出相应请求是否可能是由未满 16 周岁(具体年龄可能会因国家/地区而异)的用户发出(根据欧盟《一般数据保护条例》[GDPR] 规定)。
I
:tag_for_underage_of_consent=
键值对中的值。如果值为 1,则表示这一特定请求可能是由未满 16 周岁(具体年龄可能会因国家/地区而异)的用户发出(根据欧盟的《一般数据保护条例》[GDPR] 规定)。
ltd=
:由发布商设定;如果值为 1,则表示未就使用 Cookie 征得用户同意,因此广告展示不会使用或创建 Cookie。只能投放受限广告。
BORDER=0 WIDTH=X HEIGHT=Y
:为显示图片的广告位设置尺寸并指定该图片没有边框。
ALT="Click Here"
:ALT=
参数用于设置在图片无法加载的情况下显示的文字。用户将鼠标悬停在图片上时,也会显示这些文字,并且文字阅读器还可以为有视力障碍的网页用户朗读这些文字。默认情况下,标准代码中的 ALT 文本是 Click Here
,但广告投放人员和发布商可以自行更改。
无论是投放到移动广告资源还是非移动广告资源,您的代码看上去都大体相同。不过,您可能会看到一些额外的参数(但前提是您的代码是安全的)。
dcapp=1
在我们推出“展示”兼容性之前,该参数曾用于区分应用内展示位置和页内展示位置。不过,在为旧的应用内展示位置导出代码时,您仍会看到该参数。
dc_muid=
大写的 IDFA、Android ID 或 AdID,经过 MD5 哈希算法处理。标识符必须全部使用大写字母,然后才能进行哈希处理。Campaign Manager 360 无法识别小写 ID 经过 MD5 哈希处理的值。发布商须负责对设备标识符进行 MD5 哈希处理。
注意:我们强烈建议您使用 dc_rdid
(而不是 dc_muid
)传递设备标识符。
dc_ref=
您可将该参数添加到展示位置代码中,以便发布商传递确切的广告投放网址。如果网页布局复杂(例如嵌套 iframe),发布商可能需要使用该参数来确保 Campaign Manager 360 会记录发生展示的主网页的网址与 iframe 的位置。然后,在该参数中传递的网址会被用作 Campaign Manager 360 Verification 中的信号。该参数会自动添加到内部重定向中,并可手动添加到其他所有类型的展示位置代码中。
其他参数
在某些情况下,Campaign Manager 360 展示位置代码会包含本文未提及的参数,因为这些参数专用于特定的 Campaign Manager 360 帐号,或与不太常用的功能相关。如果您对本文未提及的展示位置代码参数有任何疑问,请与支持团队联系。
Iframe/JavaScript 代码
iframe/JavaScript 代码是展示位置最常用的代码类型,可投放标准图片和富媒体。此类代码以 IFRAME SRC=
开头。
并非所有的浏览器都可以识别 iframe HTML 元素,因此这些代码均提供多种选项,以实现对不同浏览器的支持。
-
对于不能识别 iframe 的浏览器,我们将提供 JavaScript 代码。
-
对于既不能识别 iframe 代码也不能识别 JavaScript 代码的浏览器,我们还将提供一组标准代码。
根据 HTML 标准,位于 <iframe>
和 </iframe>
标记之间的代码会被忽略,因此在大部分情况下系统仅调用 iframe 代码。提供 JavaScript 和标准代码是一种有备无患的方法,目的是确保即使用户使用过时的浏览器,系统也可以投放广告。
<IFRAME SRC="https://ad.doubleclick.net/ddm/adi/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?" WIDTH=X HEIGHT=Y MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'>
<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;abr=!ie;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?">
</SCRIPT>
</IFRAME>
有关 iframe/JavaScript 代码的 iframe 代码部分的剖析,请参阅下文。要了解 JavaScript 代码部分,请参阅“JavaScript 代码”部分。
我们来看一下 iframe/JavaScript 代码示例的 iframe 部分:
<IFRAME SRC="https://ad.doubleclick.net/ddm/adi/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?" WIDTH=X HEIGHT=Y MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'>
IFRAME SRC
:HMTL iframe(内嵌框架)标记,允许将某个 HTML 网页嵌入到其他 HTML 网页中。SRC
参数会告知浏览器:可在哪里找到要加载到 iframe 中的 HTML 网页。
"https://ad.doubleclick.net/ddm/adi/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?"
:该网址中的参数与标准代码中的参数基本一致,只是多出了以下三个参数:
-
adi
参数会告知 Campaign Manager 360 广告服务器:该网址是 iframe 代码的组成部分。 -
abr=!ie
参数会告知 Campaign Manager 360 广告服务器:当用户使用 Internet Explorer 浏览器时,不要投放 JavaScript 内容。根据 HTML 惯例,浏览器不会读取
<iframe>
和</iframe>
标记之间的任何内容。因此,任何能够识别 iframe 的浏览器应该只读取 Campaign Manager 360 iframe 代码,而不是 JavaScript 代码。不过,部分旧版 Internet Explorer 会读取这两组代码。abr=!ie
参数可确保对于每组 Campaign Manager 360 展示位置代码,系统仅向这些浏览器投放 1 个广告。此参数仅存在于 iframe/JavaScript 组合代码中,而不存在于不含 iframe 的 JavaScript 代码中。 -
广告投放人员可以选择添加
click=
参数。此参数用于将点击重定向到第三方网站,通常是为了便于网站发布商自行统计点击次数。若要使用click=
参数,发布商需要插入一个网址作为参数值。如果使用了click=
参数,发布商应确保 iframe 和 JavaScript 代码中都使用此参数。发布商还需要将标准代码重定向到第三方网站,具体方法由发布商决定。用作click=
参数值的网址应该是重定向网址,而不是用于请求获取 1x1 像素图片的网址。
WIDTH=X HEIGHT=Y MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'
:这些参数用于设置 iframe 的尺寸和其他功能。默认情况下,设置这些参数的目的是为了让 iframe 与周围的网页可以浑然一体。
注意:某些广告客户可能会为 iframe 代码和 JavaScript 代码使用 ins 代码。
JavaScript 代码
JavaScript 代码可投放图片、HTML5 和富媒体广告素材。此类代码适用于为实现复杂网页布局而采用了自己的 iframe 的网站,或者不愿意使用 iframe 的发布商。
JavaScript 代码中的参数与 iframe/JavaScript 代码中 JavaScript 部分的参数基本一致,区别在于前者少了 abr=!ie
这个参数,原因是不需要排除任何浏览器类型。
为了更好地了解 JavaScript 代码,下面我们将对其进行逐项分析。
<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;dc_expa=URL;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?">
SCRIPT language='JavaScript1.1' SRC
:HTML 脚本标记,会告知浏览器将从源 (SRC
) 位置检索到的内容作为 JavaScript 来读取。
"https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;dc_expa=URL;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?"
:该网址所含的参数与标准代码中的参数基本一致,只是多出了以下三个参数:
-
adj
参数会告知 Campaign Manager 360 广告服务器:该网址是 JavaScript 代码的组成部分。 -
广告投放人员可以选择添加
click=
参数。此参数用于将点击重定向到第三方网站,通常是为了便于网站发布商自行统计点击次数。若要使用click=
参数,发布商需要插入一个网址作为参数值。如果使用了click=
参数,发布商应确保 iframe 和 JavaScript 代码中都使用此参数。发布商还需要将标准代码重定向到第三方网站,具体方法由发布商决定。 - 您可以手动添加
dc_expa=
参数,以便第三方能够实时跟踪 Rich Media 展开式展示广告素材的展开情况。发布商需要插入一个经过编码的网址作为此参数的值,该网址用于在广告素材展开时接收回传内容。
注意:某些广告客户可能会为 iframe 代码和 JavaScript 代码使用 ins 代码。
预取代码
预取代码用于投放插播音频广告素材、音频重定向广告素材、插播视频广告素材和插播视频重定向广告素材。当预取代码请求广告时,Campaign Manager 360 会先发送广告内容,继而在广告内容加载之后记录这次展示。仅当相应的主音频/视频素材资源缓冲到足以开始播放时,Campaign Manager 360 才会记录一次展示。系统会等到此代码“提取”内容后再记录这次展示。Campaign Manager 360 符合 VAST 2.0、VAST 3.0 和 VAST 4.0 规范,并提供了每种类型的预取代码。请挑选您需要的代码,或将所有类型的代码都发送给发布商。
预取代码示例VAST 2.0 预取代码
https://ad.doubleclick.net/ddm/pfadx/Nxxxx.site-keyname/Byyyyyyy;kw=[keyword]; sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;dcmt=text/xml
VAST 3.0 预取代码
https://ad.doubleclick.net/ddm/pfadx/Nxxxx.site-keyname/Byyyyyyy;kw=[keyword]; sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;dcmt=text/xml;dc_vast=3
VAST 4.0 预取代码
https://ad.doubleclick.net/ddm/pfadx/Nxxxx.site-keyname/Byyyyyyy;kw=[keyword]; sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;dcmt=text/xml;dc_vast=4
https://ad.doubleclick.net
:这些参数与标准代码中的参数相同。
ddm
:这是一个新参数,用于区分 Campaign Manager 360 的代码和旧版产品 (DFA) 的代码。它不会对代码的导出或植入方式产生任何影响。
pfadx
:告知广告服务器这是预取 (pf
) 代码,也是 XML 广告命令 (adx
)。
Nxxxx.site-keyname/Byyyyyy;kw=[keyword];ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I
:这些参数与标准代码中的参数相同。
sz=widthxheight
:展示位置的尺寸,以像素为单位(VAST 展示位置的 sz
参数值始终为 0x0
)。
dcmt=text/xml
:MIME 是“Multipurpose Internet Mail Extensions”(多用途互联网邮件扩展)的首字母缩写,用于告知浏览器您要发送什么类型的内容。在此示例中,MIME 类型为 text/xml
,表示要发送的内容是 XML 代码形式的文本。
dc_vast=3
:用于调整代码的格式,使其符合 VAST 3.0 规范。
dc_vast=4
:用于调整代码的格式,使其符合 VAST 4.0 规范。
dc_vpm
:此参数必须由发布商填充,用于在报告中启用视频播放方法维度。
可能的值包括:
dc_vpm=0
:未指定dc_vpm=1
:网页加载时播放声音dc_vpm=2
:网页加载时默认静音dc_vpm=3
:点击时播放声音dc_vpm=4
:鼠标悬停时播放声音dc_vpm=5
:进入视口时播放声音dc_vpm=6
:进入视口时默认静音
dc_vconp
:此参数必须由发布商填充,用于在报告中启用视频连续播放维度。
可能的值包括:
dc_vconp=0
:不设置dc_vconp=1
:连续播放dc_vconp=2
:不连续播放
dc_sdk_apis=
:发布商应将占位符 [APIFRAMEWORKS]
替换为受支持的 API 框架。格式是以英文逗号分隔的整数数组,例如 dc_sdk_apis=1,2,3,4,5,6
可能的值包括:
dc_sdk_apis=1
:VPAID 1.0dc_sdk_apis=2
:VPAID 2.0dc_sdk_apis=3
:MRAID 1.0dc_sdk_apis=4
:ORMMAdc_sdk_apis=5
:MRAID 2.0dc_sdk_apis=6
:MRAID 3.0dc_sdk_apis=7
:OMSDK JS API 1.0
dc_omid_p=
:由 IAB TechLab 认证的 OMID 集成应将占位符 [OMIDPARTNER]
替换为其合作伙伴 ID 及其集成代码的有效版本。格式为 partner_id/version,例如 d_omid_p=Google/2.1
。此值会跟踪 OMID 集成代码的认证状态,并在报告中启用 OMID 衡量。
点击跟踪广告代码
点击跟踪广告代码用于记录以下对象获得的点击次数:非 Campaign Manager 360 投放的广告素材、文字链接、电子邮件中的链接或网站上的其他硬编码元素。
点击跟踪广告代码示例下例就是一个点击跟踪代码。请注意,由于系统会针对点击自动进行缓存无效化,因此无需随机数。
https://ad.doubleclick.net/ddm/clk/[ad ID];[placement ID];[verifier]?[landing page URL];ltd=[]
https://ad.doubleclick.net/
:这些参数与标准代码中的参数相同。
clk
:告知 Campaign Manager 360 广告服务器这是一个点击跟踪广告代码。
[ad ID];[placement ID]
:针对此点击跟踪广告代码创建的广告的 ID,以及指定展示位置的 ID。
[verifier]
:根据专有算法创建并于内部使用的字符,用于验证代码是否为未被篡改。
dc_transparency
:如果为 dc_transparency=1
,则表示代码会显示网址重定向链。如果您为某个展示位置上的跟踪广告和点击跟踪广告使用静态着陆页网址,就会纳入重定向链。详细了解如何使用静态着陆页网址。
?[landing page URL]
:用户最终到达的网址。
着陆页网址仅包含在静态点击跟踪广告代码中。在动态点击跟踪广告代码中,以 ?
开头的代码第二部分会被删掉。当用户点击植入了代码的位置时,Campaign Manager 360 广告服务器会动态插入广告投放人员在 Campaign Manager 360 中指定的着陆页网址。
ltd=
:由发布商设定;如果值为 1,则表示未就使用 Cookie 征得用户同意,因此点击跟踪广告代码不会使用/创建 Cookie 或允许增强型归因。当 ltd=1
时,系统不会向着陆页网址的末尾附加 DCLID 值,因此无法进行增强型归因。
元刷新是指示网络浏览器在给定时间间隔后自动刷新当前网页的一种方法。如果您将该时间间隔设为 0 秒,并且将备用网址指定为最终目标网址,那么您可以将元刷新用作网址重定向。在某些情况下,发布商将静态点击跟踪广告代码作为目标网址嵌入到元刷新中可能比较方便。例如,发布商可能想要使用简洁好记的网址作为文本链接,而不使用包含 Campaign Manager 360 广告服务器调用的长网址。
如果将点击跟踪广告代码嵌入到网页的 <meta>
标记中,则需要将点击跟踪广告代码中的分号替换为其对应的 ASCII 码 (%3b
)。否则,某些旧版的浏览器可能会将分号解释为 <meta>
标记里的参数。
下例就是 <meta>
标记内的一个静态点击跟踪广告代码,其中的分号已被替换:
<html>
<head>
<meta http-equiv="refresh" content="0;https://ad.doubleclick.net/ clk%3b[ad ID]%3b[placement ID]%3b[verifier]?[landing page URL]">
</head>
</html>
注意:如果点击后到达网址中包含分号,相应的分号也应替换为 %3b
。
内部重定向代码
内部重定向代码用于在使用 Google Ad Manager 的网站上投放 Campaign Manager 360 广告。由于此类代码是在 Campaign Manager 360 和 Ad Manager 系统内部处理,因此将内部重定向代码发送给 Ad Manager 发布商有多种好处,其中包括:
- 减少延迟时间:由于无需向任何其他服务器发送请,即可投放内部重定向代码,因此不会造成延迟时间增加。
- 避免 Campaign Manager 360 和 Ad Manager 之间的统计差异:内部重定向代码不需要用到任何其他宏即可进行点击跟踪,并且可以将 Campaign Manager 360 和 Ad Manager 之间的点击次数差异维持在 2% 以下。
- 在 Verification 中提供更丰富的网域信息:与 ins 代码一样,内部重定向代码亦可在 Verification 中提供同等丰富的网域信息,这不仅可让您更深入地了解自己的广告投放到了哪里,还可更有力地增强品牌保障和垃圾内容防护能力。
内部重定向代码由图片网址和点击后到达网址组成,这两个网址由发布商在 Ad Manager 中输入。
这类参数与标准代码中的参数基本一致,只是不包含以下两个参数:
-
keywords
,因为关键字定位信息在 Campaign Manager 360 内部处理。 -
ord=
,由于这些代码会被输入到 Ad Manager 中,因此无需处理浏览器缓存。
对于图片网址,您还可以手动添加 dc_expa=
参数,以便实时跟踪 Rich Media 展开式展示广告素材的展开情况。发布商需要插入一个经过编码的网址作为此参数的值,该网址用于在广告素材展开时接收回传内容。
图片网址(仅限在 Google Ad Manager 中使用此代码)
https://ad.doubleclick.net/ddm/ad/Nxxxx.site-keyname/Byyyyyyy.n;sz=widthxheight;dc_expa=URL
点击后到达网址(仅限在 Google Ad Manager 中使用此代码)
https://ad.doubleclick.net/ddm/jump/Nxxxx.site-keyname/Byyyyyyy.n;sz=widthxheight
跟踪广告代码
跟踪广告代码在导出的代码中显示为“跟踪广告”部分,包括用于跟踪展示和点击情况的代码网址。
要想让导出的代码包含跟踪广告代码,请在您的广告系列中打开代码工作流程(代码 > 下载),然后点击选中左侧的“包含跟踪广告代码”复选框。有关详情,请参阅跟踪广告指南。
有关跟踪广告的提示-
下载代码时,请选中包含跟踪广告代码。
-
如果您在展示位置上使用事件代码,您的发布商必须实现 JavaScript 或 iframe 代码网址才能跟踪展示。我们建议您同时发送这两种类型的代码,让发布商决定使用哪一种。它们会被分别标记为
impressions (JavaScript)
和impressions (iframe)
。 -
为了让您的代码符合 Google Ads 的点击跟踪准则,请在跟踪广告中使用静态着陆页网址,以实现透明点击跟踪。详细了解如何使用静态着陆页网址。
下面是跟踪广告的代码格式的示例,分别展示了所分配的跟踪广告素材的不同代码版本。您可以在代码中看到网站键名、广告素材/广告/展示位置 ID 和时间戳的占位符。
展示跟踪(图片):
<IMG SRC="
https://ad.doubleclick.net/ddm/trackimp/Nxxxx.site-keyname/Byyyyyyy.n;dc_trk_aid=
{ad_id};dc_trk_cid=
{creative_id};ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;
tfua=;gdpr=${GDPR};gdpr_consent=${GDPR_CONSENT_755};ltd=;dc_tdv=1?"
attributionsrc BORDER="0" HEIGHT="1" WIDTH="1" ALT="Advertisement">
展示跟踪 (iframe):
dc_trk_aid=
{ad_id};dc_trk_cid=
{creative_id};
ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;tfua=;gdpr=${GDPR};gdpr_consent=${GDPR_CONSENT_755};ltd=;dc_tdv=1?"
WIDTH=1 HEIGHT=1 MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'></IFRAME>
展示跟踪 (JavaScript):
<SCRIPT language='JavaScript1.1' SRC="
https://ad.doubleclick.net/ddm/trackimp/Nxxxx.site-keyname/Byyyyyyy.n;dc_trk_aid=
{ad_id};dc_trk_cid=
{creative_id};ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;
tfua=;gdpr=${GDPR};gdpr_consent=${GDPR_CONSENT_755};ltd=;dc_tdv=1?" attributionsrc></SCRIPT>
点击跟踪:
;dc_trk_aid=
{ad_id};dc_trk_cid=
{creative_id};dc_lat=N;dc_rdid=Czzzz;
tag_for_child_directed_treatment=I;tfua=;ltd=;dc_tdv=1
第三方供应商跟踪代码:
<SCRIPT TYPE="application/javascript" SRC="https://pixel.adsafeprotected.com/xxxx/yyyy/111111/22222222/skeleton.js"></SCRIPT> <NOSCRIPT><IMG SRC="https://pixel.adsafeprotected.com/xxx/yy/333333/44444444/skeleton.gif" BORDER=0 WIDTH=1 HEIGHT=1 ALT=""></NOSCRIPT>
ins 代码
ins 代码是一种适用于 iframe 或 JavaScript 的新型代码,它所采用的格式与其他代码不同。此类代码可在 Verification 中提供更丰富的网域信息,让您更深入地了解自己的广告投放到了哪里。了解如何植入 ins 代码。