您可以使用 Google 发布商控制台检查使用 Google 发布商代码 (GPT) 库的网页上的广告投放情况。您可以使用此功能排查广告加载问题,并优化网页的性能。
本指南介绍了如何访问和使用发布商控制台。如需详细了解特定消息,请参阅发布商控制台消息的完整列表。
如果您需要有关 GPT 的更多帮助,请参阅支持选项。
访问控制台
您可以在使用 GPT 的任何页面上通过浏览器访问发布商控制台。您可以通过以下三种方式访问发布商控制台:
- JavaScript 控制台
- 在浏览器的开发者工具中的 JavaScript 控制台中,运行以下命令:
js googletag.openConsole()
- JavaScript 书签
将以下按钮拖到书签栏中,即可为发布商控制台创建新书签:
然后,您只需在任何包含 GPT 的网页上点击书签,即可加载发布商控制台。
- 网址查询参数
在任何包含 GPT 的网页网址末尾添加
?google_console=1
。例如http://www.example.com?google_console=1
在网页上访问发布商控制台后,您可以使用键盘快捷键 Ctrl+F10(在 Mac 上,使用 fn+control+F10)来显示或隐藏网页。
使用控制台
发布商控制台有两个标签页:广告位和网页请求。此外,系统还提供了按钮,供用户使用 Lighthouse 发布商广告评估服务审核网页,以及使用 Ad Manager 投放工具排查投放问题。
广告信息叠加层
发布商控制台会向通过 GPT 注册的每个广告位添加一个叠加层。每个叠加层都包含相应广告位中当前加载的广告的相关信息,以及一个您可在 Ad Manager 投放工具中查看详细投放数据的链接。
![发布商控制台广告信息叠加窗口屏幕截图](https://developers.google.cn/static/publisher-tag/images/pub-console/ad-overlay.png?authuser=8&hl=ro)
# | 字段 | 说明 |
---|---|---|
1 | 广告来源 | 所返回广告的来源。
可能的值包括:
|
2 | 广告单元路径 | 广告单元的路径,包括父级广告单元路径。所展示广告单元的名称会显示在父路径下的那一行中。 |
3 | 广告容器 | 广告已呈现到的 <div> 元素的 ID。
|
4 | 广告素材 | 返回的 Ad Manager 广告素材的 ID。点击此值即可在 Ad Manager 中打开相应广告素材。 |
5 | 订单项 | 与所返回广告素材相关联的 Ad Manager 订单项的 ID。点击此值即可在 Ad Manager 中打开此订单项。 |
“广告位”标签页
“广告位”标签页包含有关当前已向 GPT 注册的每个广告位的详细信息。信息按卡片进行整理,每个广告位对应一张卡片。此外,我们还提供了用于查看 Ad Manager 中返回广告的广告单元、广告素材和投放诊断信息的链接。
![发布商控制台中的“广告位”标签页屏幕截图](https://developers.google.cn/static/publisher-tag/images/pub-console/ad-slots-tab.png?authuser=8&hl=ro)
# | 字段 | 说明 |
---|---|---|
1 | 广告单元路径 | 广告单元的路径,包括父级广告单元路径。所展示广告单元的名称会显示在父路径下的那一行中。 |
2 | 赛区 | 广告已呈现到的 <div> 元素的 ID。
|
3 | 槽大小 | 广告代码定义中指定的广告位尺寸(像素宽度 x 像素高度)。如需详细了解广告位尺寸,请参阅支持的广告尺寸。 |
4 | 页外 | 指明广告单元是否展示页外广告素材,例如弹出式广告、背后弹出式广告或浮动广告。有关详情,请参阅投放页外广告素材。
可能的值包括:
|
5 | 服务 | 用于投放广告的服务。GPT 仅支持 Ad Manager。 |
6 | 叠加层状态 | 指明广告位是否具有关联的发布商控制台叠加层。不含叠加层的广告位可能不包含在 DOM 中,也可能是页外广告位。
可能的值包括:
|
7 | 获取时间耗时 毫秒 | 从 Ad Manager 提取广告所用的时间(以毫秒为单位)。 |
8 | 广告提取次数 | 自用户打开网页后获取广告的次数(包括广告刷新)。 |
9 | iframe 类型 | 广告素材内呈现的 iframe 类型。如需详细了解 iframe 类型,请参阅使用 SafeFrame 呈现广告素材。
可能的值包括:
|
10 | 订单项 ID | 与所返回广告素材相关联的 Ad Manager 订单项的 ID。 |
11 | 广告素材 ID | 返回的 Ad Manager 广告素材的 ID。 |
12 | 查询 ID | 返回了此广告单元的查询的 ID。您的技术支持客户经理 (TAM) 可以使用此 ID 对所展示的广告素材进行问题排查。 |
13 | 定位信息 | 一个可展开的部分,其中列出了应用于相应广告位的有效网页级和广告位级键值对定位条件。 |
“网页请求”标签页
“网页请求”标签页提供了有关网页及其呈现环境的一般信息、遇到的警告以及广告事件的时间轴。
![发布商控制台中的“网页请求”标签页屏幕截图](https://developers.google.cn/static/publisher-tag/images/pub-console/page-request-tab.png?authuser=8&hl=ro)
# | 字段 | 说明 |
---|---|---|
1 | 网址 | 当前网页的网址。 |
2 | Browser | 用于加载网页的浏览器的用户代理字符串。 |
3 | 浏览器视口宽度和高度 | 当前浏览器视口尺寸(像素宽度 x 像素高度)。 |
4 | 媒体资源代码 | 广告资源网代码,它是广告单元所属的 Ad Manager 广告资源网的唯一标识符。如需了解详情,请参阅查找 Ad Manager 帐号信息。 |
5 | 获取广告耗时 毫秒 | 从 Ad Manager 提取网页上所有 GPT 广告所需的时间(以毫秒为单位)。 |
6 | 呈现广告耗时 毫秒 | 从 Ad Manager 返回广告素材后,在网页上呈现所有 GPT 广告所需的时间(以毫秒为单位)。 |
时间表
网页请求标签页的时间轴部分会针对网页上显示的每个 GPT 广告,按时间顺序列出从创建广告位到呈现广告的各个事件。此时间轴还会包括在请求或展示广告时返回的所有警告或错误。