تعرّف على كيفية إعداد حزمة تطوير تحليلات المتتبع في OpenReplay.

إن حزمة تطوير التحليلات اختيارية التفعيل (opt-in). فهي لا تُنشأ إلا عندما تمرّر analytics.active إلى مُنشئ (constructor) أداة التتبّع — وحتى ذلك الحين تكون tracker.analytics مساوية لـ null ولا يُنفّذ tracker.track() أي شيء.

import Tracker from '@openreplay/tracker'

const tracker = new Tracker({
  projectKey: "YOUR_PROJECT_KEY",
  analytics: { active: true },
})

tracker.start()

• active: boolean يُفعّل حزمة تطوير التحليلات. القيمة الافتراضية: false.
• ingestPoint?: string نقطة النهاية التي تُرسَل إليها دفعات التحليلات. لعمليات النشر ذاتية الاستضافة فقط — على OpenReplay Cloud يتم تجاهلها ويُستخدم https://api.openreplay.com/ingest. القيمة الافتراضية هي ingestPoint الخاص بأداة التتبّع.

لمعرفة المزيد عن إدارة بيانات التحليلات الخاصة بك في واجهة OpenReplay، تفضّل بزيارة إدارة البيانات.

// Identify a user with an id (e.g. email, username, etc.)
tracker.analytics.identify(userId: string): void
// same as
tracker.analytics.people.identify(userId)

// Add event to batch with option to send it immediately
tracker.analytics.track(eventName: string, tempProperties?: Record<string, any>, options?: { send_immediately: boolean })
// same as
tracker.analytics.events.track(eventName, tempProperties, options)

// Clear user id, people properties and super properties, and stop the batcher
tracker.analytics.reset(): void

توجد هذه الطرق على أداة التتبّع نفسها، لذا من الآمن استدعاؤها دون الوصول إلى tracker.analytics (فهي لا تُنفّذ أي شيء طالما كانت التحليلات معطّلة):

// Same as tracker.analytics.track(...)
tracker.track(eventName: string, properties?: Record<string, any>, options?: { send_immediately: boolean })

// Sets the replay's user ID *and* calls analytics.people.identify() with it
tracker.setUserID(id: string): void
tracker.identify(id: string): void // alias of setUserID

// Send analytics events under your own token, without session recording
tracker.setAnalyticsToken(token: string): void

تمسح المستخدم المُتعرَّف عليه (بما في ذلك معرّف الجهاز الدائم)، وجميع خصائص people، وجميع الخصائص الفائقة، وتوقف أداة التجميع في دفعات (batcher). استدعِها عند تسجيل الخروج.

tracker.analytics.reset()

إذا واجهت أي مشكلات، تواصل معنا عبر Slack أو اطّلع على المنتدى واحصل على المساعدة من مجتمعنا.