التوثيق

كل ما تحتاجه لتشغيل Monoid على موقعك.

البدء السريع الإعداد الأحداث المخصصة الخصوصية والبيانات مرجع API

1. إنشاء حساب

اذهب إلى monoid.website، وأدخل بريدك الإلكتروني وكلمة المرور والنطاق. ستتلقى رابط تفعيل عبر البريد الإلكتروني.

2. أضف مقطع المتعقّب

بعد التأكيد، الصق هذا داخل وسم <head> الخاص بموقعك. استبدل YOUR_SITE_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 تطابق معرّف موقعك تمامًا.

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 لا يُسجَّلون.

هل هناك شيء ناقص أو غير صحيح؟ أخبرنا