البداية السريعة
ركّب datacub وشوف أول حدث يوصلك خلال دقائق.
1. خذ مفتاح مشروعك
افتح الإعدادات، الربط في لوحة التحكم. مفتاح مشروعك يبدأ بـ pk_live_ (أو pk_test_ وقت التطوير). المفتاح عام وآمن تحطه في كود الواجهة. تفاصيل المفاتيح.
في الإعدادات، عام أضف نطاق موقعك إلى المواقع المسموح لها بالإرسال، أو معرّف تطبيقك (bundle ID أو package name) إلى التطبيقات المسموح لها. datacub يرفض أي حدث يجي من غيرها.
2. أضف الـ SDK
الصق هذا في <head> الصفحة (وفي Next.js أو TanStack Start أو SvelteKit شوف وين الـ head). ينزّل الـ SDK من datacub ويعرّف المتغير العام x:
<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>على localhost استخدم مفتاح التجربة (pk_test_): datacub يرفض مفاتيح الإنتاج من localhost. كل مشروع يجي ومعه واحد، مكتوب جنبه اختبار في الإعدادات، الربط. تفاصيل المفاتيح.
مو موجود على npm. لا تثبّت
@datacub/webولا أي شيء تحت@datacubمن npm: هذا الاسم في npm مو تابع لـ datacub. و SDK الـ React Native ما انتشر للحين: تواصل مع فريق datacub عشان تجربه بدري.
3. هذا كل التركيب
datacub يتتبّع مشاهدات الصفحات، والجلسات، والمصادر، والنقرات من أول مشاهدة. وما عليك تربط نافذة موافقة. وإذا تبي تنتظر موافقة زوارك أول، شوف طلب الموافقة. وش يجمعه الـ SDK وكيف توقف أي جزء منه تلقاه في تثبيت SDK الويب.
4. تتبّع شيء واحد مهم
اختر اللحظة اللي يستفيد فيها المستخدم من منتجك، وتتبّعها بعد ما تنجح:
async function createProject(name: string) {
const project = await api.createProject(name)
datacub.track('project_created', { template: project.template })
return project
}5. تأكد إنه وصل
في الإعدادات، الربط اضغط تأكد من الربط وافتح موقعك أو تطبيقك: datacub يعلمك لحظة وصول أول حدث. وصفحة مباشر تعرض الأحداث أول بأول. ما وصل شيء؟ على localhost يطبع الـ SDK تحذير في الكونسول لكل استدعاء يرفضه. شوف حل المشاكل.
تشتغل مع وكيل برمجة بالذكاء الاصطناعي؟
الصق أمر الإعداد في Claude Code أو Cursor أو Codex أو ChatGPT. يقرأ تطبيقك، يركّب الـ SDK، يقترح عليك خطة أحداث قصيرة، وينتظر موافقتك.