React و Next.js و TanStack

ما تحتاج حزمة خاصة لأي إطار. حط الكود في الـ head مرة وحدة، و datacub يتابع كل تنقّل بين الصفحات بنفسه.

الـ SDK يراقب History API في المتصفح، فـ React Router و TanStack Router و Next.js و Vue Router و SvelteKit والمواقع العادية كلها تسجّل مشاهدة صفحة وحدة لكل تنقّل بدون أي كود زيادة.

وين يروح الكود

خذ الكود من تثبيت SDK الويب (أو من الإعدادات، الربط ومعه مفتاحك جاهز) وحطه في <head> الصفحة:

الإطاروين
Vite (React و Vue)، و TanStack Router، والمواقع العاديةindex.html داخل <head>
Next.js App Routerapp/layout.tsx: وسم <script> في <head> والكود داخله كـ dangerouslySetInnerHTML
TanStack Startسكربتات head في الـ root route
SvelteKitsrc/app.html داخل <head>
index.html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <script>
      (function (w, d, src) {
        var q = (w.datacub = w.datacub || [])
        ;['init', 'track', 'identify', 'reset'].forEach(function (n) {
          q[n] = function () { q.push([n].concat([].slice.call(arguments))) }
        })
        var s = d.createElement('script'); s.async = true; s.src = src; d.head.appendChild(s)
      })(window, document, 'https://ingest.datacub.example/v1/sdk/datacub-0.4.0.min.js')
      datacub.init('pk_live_YOUR_PROJECT_KEY')
    </script>
  </head>
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.tsx"></script>
  </body>
</html>

بعدها استخدم datacub العام في كود الواجهة. ولـ TypeScript احفظ ملف الأنواع في مشروعك.

التعريف بعد تسجيل الدخول

استدعِ identify في المكان اللي يعرف فيه تطبيقك مين مسجّل دخول، و reset عند تسجيل الخروج. شوف التعريف بالمستخدمين.

src/use-analytics-user.ts
import { useEffect } from 'react'

export function useAnalyticsUser(user: { id: string } | null) {
  useEffect(() => {
    if (user) datacub.identify(user.id)
  }, [user])
}

راوترات الهاش

الراوترات اللي تحط المسار بعد الهاش (/#/orders/12) تحتاج hashRouting:

datacub.init('pk_live_YOUR_PROJECT_KEY', { hashRouting: true })