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 Router | app/layout.tsx: وسم <script> في <head> والكود داخله كـ dangerouslySetInnerHTML |
| TanStack Start | سكربتات head في الـ root route |
| SvelteKit | src/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 })