浏览器端 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 表示密钥与域名匹配。