响应渲染器
广告投放 API 响应 JSON 包含 zones 数组以及 renderers 和 user 对象。
在本页中,我们将介绍渲染器对象,使用该对象可以在网页上独立渲染不同的容器和广告。
容器渲染器
这些呈现器旨在生成各种类型的容器,方便您在其中显示广告。容器呈现器的呈现函数将返回一个数组,其中包含您可以用来放置广告的占位符。
至于 zone 对象,您可以传递与 "广告投放 "响应中收到的相同的对象,不同之处在于您不需要传递 zones.type。
固定容器渲染器
用于呈现页面上位置固定的容器。
该脚本将公开 window.FixedContainerRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.FixedContainerRenderer.render(zone, placeholder); 可以在页面上呈现容器。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | HTML 元素,指示在何处呈现容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |
粘性容器渲染器
该脚本将公开 window.StickyContainerRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.StickyContainerRenderer.render(zone, placeholder); 可以在页面上呈现容器。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | HTML 元素,指示在何处呈现容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 | |
setBorder() | zoneId | 是 | 要设置边框的区域的 ID |
| 宽度 | 是 | 边框宽度 | |
| 颜色 | 是 | 边框的颜色 | |
| 删除边框 | zoneId | 是 | 要移除边界的区域的 ID |
setPosition() | zoneId | 是 | 要设置位置的区段 ID |
| 水平位置 | 是 | 区域的水平位置 | |
| 垂直位置 | 是 | 区域的垂直位置 |
即时信息容器渲染器
用于在页面上呈现即时信息容器。
该脚本将公开 window.InstantMessageContainerRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.InstantMessageContainerRenderer.render(zone, placeholder); 可以在页面上呈现容器。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | HTML 元素,指示在何处呈现容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |
移动即时信息容器渲染器
用于在页面上呈现移动版即时信息容器。
该脚本将公开 window.MobileInstantMessageContainerRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.MobileInstantMessageContainerRenderer.render(zone, placeholder); 可以在页面上呈现容器。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | HTML 元素,指示在何处呈现容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |
Fullpage Interstitial Container 渲染器
用于在页面上为台式机或移动设备呈现全页面的插页容器。
该脚本将公开 window.FullpageInterstitialContainerRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.FullpageInterstitialContainerRenderer.render(zone, placeholder); 可以在页面上呈现容器。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | HTML 元素,指示在何处呈现容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |
组容器渲染器
该脚本将公开 window.GroupContainerRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.GroupContainerRenderer.render(group, placeholder); 可以在页面上呈现容器。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 组 | 是 | 包含渲染信息的组对象 |
| 位置符 | 是 | HTML 元素,指示在何处呈现容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |
内容渲染器
这些呈现器负责在容器中显示广告。有些是独立的,不需要容器。
横幅内容渲染器
该脚本将公开 window.BannerRenderer 变量,你可以用它与渲染器交互。例如,通过调用 window.BannerRenderer.render(zone, placeholder); 可以渲染广告。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | 表示广告呈现位置的 HTML 元素,如容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |
本地内容渲染器
该脚本将公开 window.NativeRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.NativeRenderer.render(zone, placeholder); 可以渲染广告。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | 表示广告呈现位置的 HTML 元素,如容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |
外流视频内容渲染器
该脚本将公开 window.OutstreamVideoRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.OutstreamVideoRenderer.render(zone, placeholder); 可以渲染广告。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | 表示广告呈现位置的 HTML 元素,如容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |
页面内推送通知内容渲染器
该脚本将公开 window.InPagePushNotificationRenderer 变量,您可以使用该变量与呈现器进行交互。例如,通过调用 window.InPagePushNotificationRenderer.render(zone, placeholder); 可以渲染广告。
可用的呈现器功能:
| 功能 | 参数名称 | 需要 | 参数 描述 |
|---|---|---|---|
render() | 区域 | 是 | 包含渲染信息的区域对象 |
| 位置符 | 是 | 表示广告呈现位置的 HTML 元素,如容器 | |
| cookieConsent | 没有 | 表示用户是否同意使用 cookie 的布尔值 |