جهّز الاختبار
استخدم تطبيق Node.js بالإصدار 18 أو أحدث، ومشروع LogBrew تستطيع قراءته. إذا لم ترسل بيانات قياس عن بُعد من قبل، فابدأ من البدء السريع. أبقِ هذا الاختبار منفصلًا عن نشاط العملاء. ثبّت الحزم في مجلد التطبيق:LOGBREW_SERVER_API_KEY،
خارج نظام التحكم في المصدر. لا تضع أبدًا مفتاح خادم في حزمة المتصفح. رمز وصول
الحساب المميز يقرأ النتائج، ولا يضبط الـ SDK.
حدّد معنى الحدث الواحد
ابدأ بسؤال عن المنتج. مثلًا: هل يرسل المستخدمون نموذج إتمام الشراء بعد أن يفتحوه؟ أعطِ كل حدث اسمًا ثابتًا ومحفّزًا محددًا تمامًا ومكانًا واحدًا في التطبيق يدوّنه.
أبقِ أسماء الأحداث ثابتة عبر الإصدارات واللغات. لا تبنِ الأسماء من عنوان بريد
إلكتروني أو رقم طلب أو URL أو نص يدخله المستخدم.
استخدم خصائص مخصصة بمجموعة صغيرة من القيم المعتمدة. مثلًا، يمكن أن تكون قيمة
checkout_mode هي guest أو signed_in. لا تضف اسم حدث جديدًا لكل قيمة.
لا ترسل محتويات النماذج.
دوّن كل إجراء تجاري في مكان واحد فقط. إذا دوّن المتصفح والخادم الإجراء نفسه،
فستتضاعف المجاميع.
استخدم نوع النشاط الصحيح
تضبط
createProductActionAttributes القيمتين analyticsSchemaVersion: 1
وanalyticsKind: "interaction" في البيانات الوصفية للحدث. ويضبط قالب المسار
أو اسم الشاشة فيها analyticsSurface. استخدم قالب مسار، مثل
/orders/:id، لا URL فعليًا.
اسم الحدث لا يحدد النوع. التفاعل المسمى page_view يبقى تفاعلًا. السجلات
والمشكلات والـ Spans ليست أحداث منتج. لبيئات التشغيل الأخرى، راجع
دمج SDK.
اضبط المستخدم والجلسة في كل حدث
- للمستخدم الذي سجّل الدخول، اضبط
context.subjectعلى معرّف ثابت معkind: "user". - للزائر المجهول الهوية، استخدم معرّفًا منفصلًا مع
kind: "anonymous". - ضع معرّف الجلسة الخاص بالتطبيق في
context.session.id. وأعد استخدامه طوال الجلسة.
شغّل المثال محليًا
احفظ هذا المثال باسمproduct-events.mjs. يدوّن 5 إجراءات تجريبية عبر زيارات
مجهولة الهوية وعمليات تسجيل دخول ومستخدمَين اثنين. لا يحمل العميل إلا سياق
الخدمة والنشر المشترك. التسليم التلقائي متوقف في هذا الاختبار.
--send. لا يرسل هذا الأمر أي طلب:
previewJson() في تطبيق فيه
سياق عملاء حقيقي.
تعامل مع تسجيل الدخول وتسجيل الخروج
- قبل تسجيل الدخول، أرسل الكيان مجهول الهوية الحالي مع كل حدث.
- بعد تسجيل الدخول، أرسل المعرّف الثابت للمستخدم مع النوع
user. - عند تسجيل الخروج، توقف عن استخدام سياق ذلك المستخدم. وأنشئ كيانًا جديدًا مجهول الهوية وفق سياسة الخصوصية لديك.
- عند تبديل الحساب، استخدم معرّف المستخدم الجديد.
أرسل مرة واحدة واقرأ النتائج
اضبط مفتاح الخادم الخاص بمشروع الاختبار في بيئة العملية. شغّل هذا الأمر مرة واحدة:- افتح التحليلات.
- ضمن المشروع، اختر مشروع الاختبار.
- ضمن النطاق الزمني، اختر 24 ساعة.
- اعثر على أسماء الأحداث الثلاثة ضمن أبرز الأحداث، وعلى
/checkoutضمن أبرز الواجهات.
- 5 تفاعلات، كلها مع سياق جلسة، على الواجهة
/checkout. - 3 أحداث من مستخدمين وحدثين من كيانات مجهولة الهوية.
- مستخدمَين اثنين وكيانين مجهولي الهوية و4 جلسات.
اختبر الأحداث في تطبيقك
انقل استدعاءات الالتقاط إلى معالجات التطبيق. حافظ على معنى كل حدث ونوعه وقاعدة هويته. اختبر بحسابات اصطناعية أولًا.
المعاينة المحلية تختبر الالتقاط. والدفعة المقبولة تختبر التسليم. ولا تثبت أيٌّ
منهما أن استدعاء الالتقاط يعمل في الموضع الصحيح من تطبيقك.
