您可以使用无代码请求代替广告代码,以请求在 Ad Manager 中进行投放管理的原始广告素材代码。在需要自定义解析和显示时(例如机顶盒或其他没有 Google 代码或 SDK 支持的环境),通常会使用无代码请求。
当您发出无代码请求后,Ad Manager 仅会返回与进行投放管理时完全一致的原始广告素材代码,不会执行和显示相应广告。如果未找到广告,则系统会返回状态为 200/OK
的空响应。
您的应用、播放器或网站必须执行代码才能显示广告并启用展示跟踪。
手动创建无代码请求
若要构建无代码请求,请先创建基础网址,然后添加所有必需参数以及任何其他可选参数。这些参数用于指定广告单元、广告素材尺寸、键值对和有关请求的其他信息等设置。
必须使用 SSL (https://
) 安全地发出无代码请求。
从基础网址开始
使用以下基础网址:https://securepubads.g.doubleclick.net/gampad/adx?
指定广告请求的参数
必需参数参数 | 说明 |
---|---|
iu |
Google Ad Manager 广告单元代码(包括您的 Google Ad Manager 广告资源网代码)。要包含多个级别,请使用正斜线 ( 示例
将多客户管理 (MCM) 与无代码请求搭配使用时,请对广告资源网代码使用 示例 (MCM)
|
sz |
广告素材尺寸。要包含多个尺寸,请在这些尺寸之间使用竖线 ( 示例单个尺寸: 我们建议将无代码请求中的竖线字符 ( 示例
|
url |
托管初始广告请求的网域对应的网址。仅对 MCM 请求是必需的。 示例
|
c |
Correlator(或缓存无效化)值。它必须是发布商生成的随机数(不允许使用字母),以确保每次网页加载时系统均执行新的广告服务器调用,从而避免产生展示次数统计差异。 示例
|
tile |
代码在网页上的位置。此值应该是一个不重复的整数。为了更轻松地进行实现,我们建议您使用累加计数的值。 只有当多个广告代码在同一网页上使用同一广告单元代码 ( 示例
tile= ) 值的请求都必须在 30 秒内触发,以确保不会为同一关联器 (c= ) 再次选择同一广告素材。 |
参数 | 说明 |
---|---|
d_imp |
此参数用于启用/停用延迟记录展示次数的功能。如果添加了此参数,系统会停止在收到请求时统计展示次数,并会改为依据所返回广告素材中的“查看的展示”宏或 示例
|
d_imp_hdr |
此参数用于启用/停用为延迟记录展示次数提供标头信息的功能。如果添加了此参数,系统会在 HTTP 标头中返回要用于统计展示次数的查看网址。默认情况下,系统不会指定此标头信息。因此,发布商需要对此查看网址手动执行 ping 操作,以统计一次展示。不妨详细了解展示次数统计和无代码请求。
示例
|
t |
广告位级键值对。在每个键和值之间使用等号 ( 示例参数 将 示例
键或值中不允许使用以下字符: 示例
|
月 |
HTTP 标头上的 MIME 类型值。 示例
|
mob |
移动广告请求指示符。 示例
|
ppid |
通过发布商提供的标识符 (PPID) 参数,您可以向 Google Ad Manager 发送一个标识符,以用于跨设备实现以下功能:控制广告展示频次不超过频次上限、进行受众群细分和受众群体定位、依序轮播广告以及进行其他基于受众群体的广告投放控制。 示例
|
u_w |
移动设备屏幕宽度,这会替换广告服务器自动检测到的信息。 示例
|
u_h |
移动设备屏幕高度,这会替换广告服务器自动检测到的信息。 示例
|
submodel |
移动设备硬件信息,这会替换广告服务器自动检测到的信息。 示例
子型号值:
|
启用展示跟踪
对于无代码请求,Ad Manager 可以跟踪已下载广告的展示次数(也称为“延迟”记录的展示次数)。使用下列任一方案,但不要同时使用所有方案。同时使用所有方案可能会导致系统重复(双重或三重)统计展示次数。
我们建议使用方案 1,但前提是您必须有权访问 HTTP 响应标头并能够实施基于标头的协议。
方案 1:读取 HTTP 响应标头以控制展示次数统计
向无代码请求中添加 d_imp=1
和 d_imp=1
参数。这样一来,仅当您使用 d_imp=1
HTTP 标头网址手动触发了展示 ping 后,Google Ad Manager 才会记录一次展示或一次已下载广告的展示。当展示 ping 被触发时,Google Ad Manager 会记录一次“广告服务器展示”和“广告服务器的已下载广告的展示”。
请勿向无代码请求所返回的广告素材中添加“查看的展示”宏,以免重复统计展示次数。
方案 2:使用“查看的展示”宏
如果您无法访问 HTTP 响应标头,则必须细分您的广告资源,并向无代码请求所返回的每个广告素材的代码段中添加查看的展示宏。这种宏会展开为一个网址,以供广告素材在呈现时发送。
创建无代码请求以检索广告素材代码
网页内容
无代码请求通常用于没有 Google 代码或 SDK 支持的环境中。如果您要在网页上发出无代码请求,则必须在 <iframe>
<iframe> 中进行加载,以便能够执行返回的原始代码。
没有 Google SDK 的自定义环境
要在没有 Google 代码或 SDK 支持的环境(例如非 Google 机顶盒)中检索原始广告素材代码,请参阅下列指南:
- 在
User-Agent
请求标头中设置一个有效的用户代理,以确保定位功能正常发挥作用。 - 确保您的环境可以处理富媒体行为,包括 JavaScript 和广告素材展开。
- 向 Google Ad Manager 发送 HTTPS 请求。
- 检查响应状态,查找是否有“HTTP 200/OK”(表明相应请求采用了正确的格式)。
无代码请求不支持的功能
- Active View
- Ad Exchange
- 用于进行跟踪的 Cookie 或移动应用标识符
- 广告素材封装容器
- AdSense、Ad Exchange 或 AdMob 的动态分配功能
- 原生广告资源
- 首选交易
- 广告素材预览
在 HTML 图片代码 (gampad
) 中使用 gampad
/gampad
的无代码请求不支持 JavaScript 跟踪代码;此外,系统也不支持为这种请求统计已下载广告的展示次数。
若要为这些广告生成报告,请在 Ad Manager 报告中使用代码调用总次数指标。