文档

让 Monoid 在你的网站上运行所需的一切。

1. 创建账户

前往 monoid.website，输入你的邮箱、密码和域名。你将通过邮件收到激活链接。

2. 添加跟踪器代码片段

确认后，将此代码粘贴到你网站的 <head> 标签内。将 YOUR_SITE_ID 替换为你仪表盘中的 ID。

html

<script async defer
  src="https://api.monoid.website/tracker.min.js"
  data-site-id="YOUR_SITE_ID"
  data-autotrack="true">
</script>

脚本以异步方式加载 — 永远不会阻塞页面渲染。数据将在数秒内出现在你的仪表盘中。

3. 验证安装

在浏览器中打开你的网站，然后查看你的 Monoid 仪表盘。你应该会在实时访客面板中实时看到一个页面浏览。如果一分钟后仍无内容，请检查 data-site-id 属性是否与你的站点 ID 完全匹配。

Next.js / React

在 Next.js 中，将代码片段添加到你的 _document.tsx，或使用 next/script 组件并设置 strategy="afterInteractive"：

tsx

import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://api.monoid.website/tracker.min.js"
          data-site-id="YOUR_SITE_ID"
          strategy="afterInteractive"
        />
      </body>
    </html>
  )
}

WordPress

在你主题的 functions.php 中添加：

php

function monoid_tracker() {
  echo '<script async defer src="https://api.monoid.website/tracker.min.js" data-site-id="YOUR_SITE_ID" data-autotrack="true"></script>';
}
add_action('wp_head', 'monoid_tracker');

无 JS 跟踪（像素）

如果你无法运行 JavaScript — 禁用 JS 的服务端渲染页面、严格的静态页面或屏蔽脚本的环境 — 请改用跟踪像素。在你希望触发跟踪的位置放置此 <img> 标签。将 YOUR_SITE_ID 替换，并将 p 设置为当前页面路径。

html

<img src="https://api.monoid.website/pixel.gif?s=YOUR_SITE_ID&p=/your-page-path"
  width="1" height="1" alt=""
  style="display:none"
  referrerpolicy="strict-origin-when-cross-origin" />

像素记录与 JS 跟踪器相同的核心分析数据 — 路径、来源、国家、设备类型和每日访客哈希 — 但没有屏幕宽度（无 JavaScript 可用）。浏览器的 Referer 头部会被自动使用；你可以使用 &r=referrer-domain 参数覆盖它。发送 DNT: 1 的访客不会被记录。

缺少内容或不正确？告诉我们