浏览器端 SDK 参考

脚本的接口刻意保持得很小:一个标签、一种元素、一个函数。

脚本标签

属性含义
src“接入”页面上显示的脚本地址。
data-loop您的公开密钥。公开;只在您已验证的域名上有效。
async必需。脚本不得阻塞您的页面。

广告位元素

属性含义
data-loop-slot该位置的名称,最多 64 个字符。它会出现在您的展示位置报告中。
data-loop-size可选。300x250、320x50、320x100、728x90、970x250、160x600 之一。使该广告位成为横幅。
data-loop-type可选。recommendation(未指定尺寸时的默认值)、feed 或 banner。

追踪转化

name 是最多 40 个字符的字符串。props 是可选的扁平对象,值为字符串、数字和布尔值。除非当前页面加载是通过广告单元到达的,否则该调用会被忽略。

loop('track', name, props?)

您可以依赖的行为

  • 无论标签被包含多少次,每个页面只运行一次。
  • 能找到由客户端导航后新增的广告位。
  • 将每个广告单元渲染在封闭的 shadow root 中:您的 CSS 无法影响它,它也无法影响您的页面。
  • 绝不会向您的页面抛出异常。任何失败都以广告位为空并收起告终。
  • 通过 sendBeacon 以 text/plain 请求体上报,因此不会产生预检请求。

调试

给广告位添加 data-loop-debug,即可在开发者工具中打开其 shadow root 进行检查。在网络面板中,第一个请求是对 /v1/config 的请求;返回 200 表示密钥与域名匹配。

下一步故障排查 →