Moclick Bridge
集成

安装代码

代码放在哪里、如何给落地 URL 打标记，以及子域名和跨域这两种情况怎么解决。

获取广告系列的代码#

在 Moclick 后台面板的广告系列 → 脚本中，每个广告系列都有一段可直接复制的代码。 支持团队也可以直接发给你。

全局代码#

把它加到站点所有页面的 <head> 中，包括订单确认页：
HTML<head>
<script src="https://bridge.moclick.com.br/moclick-YOUR-SLUG.js" defer></script>
把 YOUR-SLUG 换成广告系列标识符。它是代码 URL 的一部分，这也是为什么不需要额外配置： 广告系列就是由脚本地址本身识别出来的。

代码加载时会做什么#

  • 拉取广告系列配置（5 秒超时）
  • 从 URL 中捕获点击标识符并写入第一方 cookie
  • 当广告系列使用平台自有测量时，记录本次访问
  • 开始监听 window.MoclickConversion
重命名广告系列会让已安装的代码失效标识符来自广告系列名称。在后台面板中改名会改变标识符，站点上已安装的代码将无法再解析—— 没有任何可见报错，只是不再跟踪。要重命名正在投放的广告系列时，请先把新代码发给客户，再发布这次改动。

给落地 URL 打标记#

当媒体由 Moclick 投放时，跟踪链接已经打好标记，无需任何操作。当广告主自己投放广告系列、 并希望它出现在 Moclick 后台面板中时，落地 URL 需要携带标记参数：
落地 URL
// 简单标记
https://loja.com.br/oferta?mclk=1

// 该值用于在后台面板中标识来源
https://loja.com.br/oferta?mclk=busca
https://loja.com.br/oferta?mclk=social
如果广告平台提供了作用于账户下全部广告的后缀字段，就用这个字段——这样不必逐条 URL 修改：
最终 URL 后缀
mclk=SOURCE-IDENTIFIER
未打标记的流量不会进入后台面板——自然流量、直接访问和未标记来源按设计被排除在外。 后台面板测量的是已跟踪的媒体流量，而不是站点的全部会话。如果需要测量某个特定来源， 请向 Moclick 团队索取该广告系列对应的正确参数。

子域名与跨域#

转化丢失最常见的原因：商城所在的主机与接收点击的站点不是同一个。

同一域名下的子域名#

例如：在 www.marca.com.br 上点击，在 loja.marca.com.br 上结账。 代码会沿主机名层级向上推断 cookie 域名，通常能自行解决。如果 cookie 被限制在当前主机上， 就在代码之前声明配置来强制指定域名：
HTML放在全局代码之前
<script>
  window.MoclickConfig = {
    campaign_slug: "your-campaign",
    cookie_domain: ".marca.com.br"  // 前置点号：对所有子域名生效
  };
</script>
<script src="https://bridge.moclick.com.br/moclick.js" defer></script>
键 类型 必填 说明
campaign_slug string 是 广告系列标识符。
cookie_domain string 否 强制指定 cookie 域名。不填时代码会自动推断。
在涉及的所有主机上使用同一个 cookie_domain，并在每个主机上都安装全局代码。

不同域名#

例如：在 marca.com.br 上点击，在 pagamento-terceiro.com 上结账。 Cookie 无法跨越不同域名。有两条出路：
  • 通过 URL 传递：跳转到第二个域名时把点击标识符作为参数带过去，并在那边也安装全局代码。 代码会读取该参数并在新域名下重新写入 cookie。Moclick 团队会告知你的广告系列该用哪个参数。
  • S2S 回传：由广告主后端以服务器到服务器的方式回报转化，既不依赖 cookie 也不依赖 JavaScript。 这是最稳健的方案。参见 S2S 回传。
常见错误只在确认页安装代码。落地页上没有代码，点击标识符就永远不会从 URL 中被捕获， 任何转化都无法归因——记录根本不会发生，而且控制台里不会有任何报错。
Atualizado em agosto 12, 2026