使用无代码请求加载广告素材代码

您可以使用无代码请求代替广告代码，以请求在 Ad Manager 中进行投放管理的原始广告素材代码。在需要自定义解析和显示时（例如机顶盒或其他没有 Google 代码或 SDK 支持的环境），通常会使用无代码请求。

当您发出无代码请求后，Ad Manager 仅会返回与进行投放管理时完全一致的原始广告素材代码，不会执行和显示相应广告。如果未找到广告，则系统会返回状态为 200/OK 的空响应。

您的应用、播放器或网站必须执行代码才能显示广告并启用展示跟踪。

不应使用无代码请求将广告投放到电子邮件中。请查看所有不支持的功能。

手动创建无代码请求

若要构建无代码请求，请先创建基础网址，然后添加所有必需参数以及任何其他可选参数。这些参数用于指定广告单元、广告素材尺寸、键值对和有关请求的其他信息等设置。

必须使用 SSL (https://) 安全地发出无代码请求。

从基础网址开始

使用这个基准网址：https://securepubads.g.doubleclick.net/gampad/adx?

指定广告请求的参数

必需参数

参数	说明
iu	Google Ad Manager 广告单元代码（包括您的 Google Ad Manager 广告联盟代码）。要包含多个级别，请使用正斜线 (/) 字符作为分隔符。 示例 iu=/123/homepage iu=/456/sports/baseball 将多客户管理 (MCM) 与无代码请求搭配使用时，请对广告资源网代码使用 parent,child 结构。 示例 (MCM) iu=/123,456/homepage
sz	广告素材尺寸。要包含多个尺寸，请在这些尺寸之间使用竖线 (|) 字符作为分隔符。 示例 单个尺寸：sz=320x50 多个尺寸：sz=320x50|300x50 我们建议将无代码请求中的竖线字符 (|) 编码为 %7c。 示例 &sz=216x36|300x50|320x50 变为 &sz=216x36%7c300x50%7c320x50。
url	托管初始广告请求的网域对应的网址。仅对 MCM 请求是必需的。 示例 url=www.example.com
c	Correlator（或缓存无效化）值。它必须是发布商生成的随机数（不允许使用字母），以确保每次网页加载时系统均执行新的广告服务器调用，从而避免产生展示次数统计差异。 示例 c=8362527364
tile	代码在网页上的位置。此值应该是一个不重复的整数。为了更轻松地进行实现，我们建议您使用累加计数的值。 只有当多个广告代码在同一网页上使用同一广告单元代码 (iu=) 和 correlator (c=) 值时，才必须提供此参数。 示例 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

可选参数

参数	说明
d_imp	此参数用于启用/停用延迟记录展示次数的功能。如果添加了此参数，系统会停止在收到请求时统计展示次数，并会改为依据所返回广告素材中的“查看的展示”宏或 d_imp_hdr 参数中的信息来记录展示次数。 示例 d_imp=1 d_imp=0（这是 Google Ad Manager 展示次数统计方式所用的默认值。）
d_imp_hdr	此参数用于启用/停用为延迟记录展示次数提供标头信息的功能。如果添加了此参数，系统会在 HTTP 标头中返回要用于统计展示次数的查看网址。默认情况下，系统不会指定此标头信息。因此，发布商需要对此查看网址手动执行 ping 操作，以统计一次展示。不妨详细了解展示次数统计和无代码请求。 Google-Delayed-Impression 标头中包含 Google Ad Manager 展示跟踪网址。 Google-3rdParty-Delayed-Impression 标头中包含第三方展示跟踪网址（如果广告素材中有）。 示例 d_imp_hdr=1 d_imp_hdr=0（明确停用为延迟记录展示次数提供标头信息的功能。）
t	广告位级键值对。在每个键和值之间使用等号 (=) 字符作为分隔符；在各个键值对之间使用和号 (&) 字符作为分隔符。应该先对每个键和值进行网址编码，再对整个字符串进行网址编码。在一组键值对中，每个键都必须独一无二；如果您多次提供相同的键，那么系统仅会考虑其中一个关联的值。 示例 参数 t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith 会将键“genre”分配给值“action”，并将键“movie”分配给值“Mr & Mrs Smith”。 请注意，如果“&”出现在键值对赋值表达式之间，则对其进行单次编码 (%26)；如果“&”出现在值内，则对其进行两次编码 (%2526)。 将 excl_cat 用作进行竞争排除的特殊键。 示例 t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines 键或值中不允许使用以下字符：" ' ! + # * ~ ; ^ ( ) < > [ ] = 。空格可以在值中使用（转义为 %20 或 +），但不能在键中使用。 示例 t=a%3Db%252Bc（将键“a”设为值“b+c”）就无法正常起作用。
月	HTTP 标头上的 MIME 类型值。 示例 m=text/wml
mob	移动广告请求指示符。 示例 mob=js（这是唯一会被接受的值。）
ppid	通过发布商提供的标识符 (PPID) 参数，您可以向 Google Ad Manager 发送一个标识符，以用于跨设备实现以下功能：控制广告展示频次不超过频次上限、进行受众群细分和受众群体定位、依序轮播广告以及进行其他基于受众群体的广告投放控制。 示例 ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	移动设备屏幕宽度，这会替换广告服务器自动检测到的信息。 示例 u_w=1024
u_h	移动设备屏幕高度，这会替换广告服务器自动检测到的信息。 示例 u_h=768
submodel	移动设备硬件信息，这会替换广告服务器自动检测到的信息。 示例 submodel=iPhone4%2C1（分隔子型号值的逗号已经过编码。） 子型号值： iPhone（第 1 代）：iphone1,1 iPhone 3G：iphone1,2 iPhone 3GS：iphone2,1 iPhone 4 (GSM)：iphone3,1 iPhone 4 (GSM)：iphone3,2 iPhone 4 (CDMA)：iphone3,3 iPhone 4S：iPhone4,1 iPhone 5（GSM 和 LTE）：iPhone5,1 iPhone 5（CDMA 和 LTE）：iPhone5,2 iPhone 5c（GSM 和 CDMA）：iPhone5,3 iPhone 5c（GSM 和 CDMA）：iPhone5,4 iPhone 5s（GSM 和 CDMA）：iPhone6,1 iPhone 5s（GSM 和 CDMA）：iPhone6,2 iPhone 6：iPhone7,2 iPhone 6 Plus：iPhone7,1 iPhone 6s：iPhone8,1 iPhone 6s Plus：iPhone8,2 iPhone SE：iPhone8,4 iPhone 7：iPhone9,1 iPhone 7 Plus：iPhone9,2 第 1 代 iPod：iPod1,1 第 2 代 iPod：iPod2,1 第 3 代 iPod：iPod3,1 第 4 代 iPod：iPod4,1 第 5 代 iPod：iPod5,1 第 1 代 iPad (Wi-Fi)：iPad1,1 第 1 代 iPad (AT&T)：iPad1,2 第 2 代 iPad (Wi-Fi)：iPad2,1 第 2 代 iPad (AT&T)：iPad2,2 第 2 代 iPad (Verizon)：iPad2,3 第 2 代 iPad (Wi-Fi)：iPad2,4 第 3 代 iPad (Wi-Fi)：iPad3,1 第 3 代 iPad (Verizon)：iPad3,2 第 3 代 iPad (AT&T)：iPad3,3 第 4 代 iPad (Wi-Fi)：iPad3,4 第 4 代 iPad (AT&T)：iPad3,5 第 4 代 Gen iPad (Verizon)：iPad3,6 iPad Mini (Wi-Fi)：iPad2,5 iPad Mini（AT&T 美国版、GSM 和 LTE 4、17）：iPad2,6 iPad Mini（Verizon 全球版、GSM、DMA 和 LTE 1、3、5、13、25）：iPad2,7 iPad Mini Retina (Wi-Fi)：iPad4,4 iPad Mini Retina (LTE)：iPad4,5 iPad Air (Wi-Fi)：iPad4,1 iPad Air (LTE)：iPad4,2

 

您可以使用可重置的设备 ID (RDID) 来设置频次上限和受众群体定位。不妨详细了解如何针对无代码请求配置 RDID。

启用展示跟踪

对于无代码请求，Ad Manager 可以跟踪已下载广告的展示次数（也称为“延迟”记录的展示次数）。使用下列任一方案，但不要同时使用所有方案。同时使用所有方案可能会导致系统重复（双重或三重）统计展示次数。

我们建议使用方案 1，但前提是您必须有权访问 HTTP 响应标头并能够实施基于标头的协议。

方案 1：读取 HTTP 响应标头以控制展示次数统计

向无代码请求中添加 d_imp=1 和 d_imp_hdr=1 参数。这样一来，仅当您使用 Google-Delayed-Impression HTTP 标头网址手动触发了展示 ping 后，Google Ad Manager 才会记录一次展示或一次已下载广告的展示。当展示 ping 被触发时，Google Ad Manager 会记录一次“广告服务器展示”和“广告服务器的已下载广告的展示”。

请勿向无代码请求所返回的广告素材中添加“查看的展示”宏，以免重复统计展示次数。

方案 2：使用“查看的展示”宏

如果您无法访问 HTTP 响应标头，则必须细分您的广告资源，并向无代码请求所返回的每个广告素材的代码段中添加查看的展示宏。这种宏会展开为一个网址，以供广告素材在呈现时发送。

创建无代码请求以检索广告素材代码

网页内容

无代码请求通常用于没有 Google 代码或 SDK 支持的环境中。如果您要在网页上发出无代码请求，则必须在 <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 图片代码 (<img>) 中使用 gampad/ad 的无代码请求不支持 JavaScript 跟踪代码；此外，系统也不支持为这种请求统计已下载广告的展示次数。

若要为这些广告生成报表，请在 Ad Manager 报表中使用代码调用总次数指标。