安装脚本
安装只需在页面 head 中加入一个脚本标签。它异步加载,从不阻塞渲染,也不会在您访客的设备上设置任何 cookie。
脚本标签
从“接入”页面复制标签。其中带有您的公开密钥,该密钥本身就是公开设计的,且只在您自己的域名上有效。
<script async src="https://…/l.js" data-loop="pk_live_…"></script>常见平台上的位置
| 平台 | 位置 |
|---|---|
| WordPress | 外观 → 主题文件编辑器 → header.php,或使用“页头脚本”插件 |
| Ghost | Settings → Code injection → Site header |
| Tistory | 皮肤编辑 → HTML → <head> 内 |
| Webflow | Site settings → Custom code → Head code |
| Squarespace | Settings → Advanced → Code Injection → Header |
| Wix | Settings → Custom code → Head |
| Shopify | Online Store → Themes → Edit code → theme.liquid |
用 AI 安装
“接入”→“用 AI 安装”会给出一条面向 Claude Code、Cursor 或 Codex 的指令。它会指明要添加的确切标签、该标签在您的框架中应放置的位置、不要改动的内容,以及如何验证结果。它由固定且经过审阅的文本组装而成,只包含您的公开密钥。
React 和 Next.js
封装脚本和广告位的组件位于 SDK 包中。该包尚未发布到 npm,因此大多数站点应使用脚本标签;在 Next.js App Router 中,将其放入 app/layout.tsx,或使用带相同属性的 next/script。
Content-Security-Policy
如果您的站点发送了 Content-Security-Policy 头,请在 script-src 和 connect-src 中都允许该脚本的来源。
验证如何进行
无需上传文件,也无需配置 DNS 记录。脚本从您域名下的页面调用我们,这就是您控制该站点的证明。第一个完成此操作的账户将持有该域名;在此之前,任何人都可以保留它的未验证草稿,而未验证的站点不参与交换。
常见问题
- 脚本有多大?
- 压缩后不到 4 KB。
- 它会设置 cookie 吗?
- 没有 cookie,也不会在您自己访客的设备上存储任何内容。有一个例外:在访客点击广告单元后到达的网站上,这次访问的令牌会在该浏览器标签页中保存最长一小时,以便统计在该网站上的注册或购买。标签页关闭后令牌即消失,其他网站无法读取。
- 可以通过标签管理器加载吗?
- 可以,只要标签保留其 data-loop 属性。直接在 head 中加载可以更快完成站点验证。