Moclick Bridge
快速上手

环境要求

广告主站点上需要具备哪些条件,集成才能正常工作。

广告主站点侧#

要求说明
HTTPScookie 的 Secure 属性需要它。在 HTTP 下集成仍可工作,但 cookie 写入时不带 Secure
可编辑 <head>直接改主题,或通过代码管理器。
确认页必须在 JavaScript 中暴露订单金额和标识符。
每笔订单有唯一标识符订单号、交易 ID 或等价物。参见转化对象
第一方 cookie我们不使用第三方 cookie。浏览器对第三方 cookie 的拦截不影响归因。

支持的浏览器#

代码以 ES5 编写,按能力而非按版本降级。以下特性在可用时使用,不可用时有替代方案:

特性用途替代方案
fetch + AbortController拉取广告系列配置无替代——这是真正的最低要求
navigator.sendBeacon发送事件而不阻塞页面跳转图片像素
crypto.getRandomValues生成标识符标准伪随机数生成器
localStorage浏览器端的转化去重跳过本地去重;由服务端去重
String.normalize广告系列规则中的重音符号归一化不做归一化直接比较

实际上就是:Chrome、Edge、Firefox、Safari 以及各移动浏览器的当前版本和较新版本。不支持 Internet Explorer。

性能影响#

指标数值
文件体积≈28 KB 未压缩
实际传输量gzip 后 ≈7 KB
外部依赖
渲染阻塞无——以 defer 加载
浏览器缓存5 分钟,通过 ETag 重新校验
每页请求数拉取广告系列配置 1 次,另加适用时的事件记录请求

短缓存窗口是刻意的设计。带 immutable 的长缓存会把旧版本在 CDN 和浏览器里锁住数月—— 已发布的修复根本到不了访客手上。改成 5 分钟加 ETag 后,重新校验大多数情况下返回 304:带宽成本接近于零,修复却能很快送达。

平台侧的环境要求#

平台由 Moclick 运营和维护。基础设施、可用性和业务连续性的规格载于合同,可应要求提供给技术评审。参见 架构与安全

Atualizado em agosto 5, 2026