Skip to main content
استخدم أحداث المنتج لتدوين إجراءات المستخدم المسماة في تطبيقك، مثل فتح صفحة إتمام الشراء أو إكمال عملية شراء. لا يثبّت الـ SDK مستمعات للنقرات ولا يجمع محتويات النماذج. شيفرتك هي التي تدوّن كل حدث. لقواعد العدّ وأنواع التقارير، راجع تحليلات المنتج.

جهّز الاختبار

استخدم تطبيق 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. وأعد استخدامه طوال الجلسة.
لا تستخدم أبدًا الأسماء أو عناوين البريد الإلكتروني أو عناوين IP أو رموز الوصول المميزة معرّفاتٍ. يربط المعرّف الثابت إجراءات المستخدم ببعضها، ولا يجعل البيانات مجهولة الهوية. لا تضبط مستخدمًا أو جلسة افتراضية على عميل خادم مشترك. مرّر الكيان والجلسة الخاصين بالطلب الذي أنتج كل حدث. لا ينشئ الـ SDK هذه المعرّفات، ولا يكتشف تسجيل الدخول أو تسجيل الخروج أو تبديل الحسابات. لا يدمج LogBrew الكيان مجهول الهوية في المستخدم بعد تسجيل الدخول.

شغّل المثال محليًا

احفظ هذا المثال باسم product-events.mjs. يدوّن 5 إجراءات تجريبية عبر زيارات مجهولة الهوية وعمليات تسجيل دخول ومستخدمَين اثنين. لا يحمل العميل إلا سياق الخدمة والنشر المشترك. التسليم التلقائي متوقف في هذا الاختبار.
شغّل البرنامج النصي دون --send. لا يرسل هذا الأمر أي طلب:
المخرجات المتوقعة:
علامتا الإصدار والبيئة ليستا إجراءات منتج. تعرض هذه النتيجة الطابور المحلي فقط، ولا تثبت أن LogBrew استلم الأحداث. لا تطبع previewJson() في تطبيق فيه سياق عملاء حقيقي.

تعامل مع تسجيل الدخول وتسجيل الخروج

  • قبل تسجيل الدخول، أرسل الكيان مجهول الهوية الحالي مع كل حدث.
  • بعد تسجيل الدخول، أرسل المعرّف الثابت للمستخدم مع النوع user.
  • عند تسجيل الخروج، توقف عن استخدام سياق ذلك المستخدم. وأنشئ كيانًا جديدًا مجهول الهوية وفق سياسة الخصوصية لديك.
  • عند تبديل الحساب، استخدم معرّف المستخدم الجديد.
يبدأ المثال جلسة جديدة عندما تتغير الهوية. اختر قاعدة الجلسات الخاصة بك وطبّقها على كل حدث. سياق الحدث يحل محل كيان العميل وجلسته لذلك الحدث. إذا حذف الحدث أحدهما، فسيستخدم الحدث قيمة العميل. لهذا السبب، لا يضبط المثال كيانًا أو جلسة على العميل. للعمل الذي يُنفَّذ لاحقًا، احتفظ بهوية المستخدم الذي بدأه.

أرسل مرة واحدة واقرأ النتائج

اضبط مفتاح الخادم الخاص بمشروع الاختبار في بيئة العملية. شغّل هذا الأمر مرة واحدة:
كل تشغيل ينشئ معرّفات أحداث جديدة، لذا يضيف التشغيل الثاني 5 أحداث أخرى. إذا فشلت العملية، فستحتوي المخرجات على رمز خطأ الـ SDK. المفتاح المرفوض يعطي:
تأكد من أن مفتاح الاستيعاب نشط وأنه يتبع مشروع الاختبار. تسجيل الدخول إلى حسابك لا يصلح مفتاح SDK. راجع أخطاء API واستكشاف الأخطاء وإصلاحها لحالات الفشل الأخرى. بعد أن يقبل LogBrew الدفعة، اعثر على الأحداث في لوحة التحكم:
  1. افتح التحليلات.
  2. ضمن المشروع، اختر مشروع الاختبار.
  3. ضمن النطاق الزمني، اختر 24 ساعة.
  4. اعثر على أسماء الأحداث الثلاثة ضمن أبرز الأحداث، وعلى /checkout ضمن أبرز الواجهات.
أي نشاط آخر في المشروع يغيّر هذه المجاميع. للتحقق من الخدمة والإصدار والبيئة بدقة، اقرأ النظرة العامة باستخدام CLI بعد تسجيل الدخول:
لتشغيل واحد في نطاق خالٍ من أي نشاط آخر، توقّع:
  • 5 تفاعلات، كلها مع سياق جلسة، على الواجهة /checkout.
  • 3 أحداث من مستخدمين وحدثين من كيانات مجهولة الهوية.
  • مستخدمَين اثنين وكيانين مجهولي الهوية و4 جلسات.
أعداد المستخدمين والكيانات والجلسات الفريدة تقريبية. مجاميع الأحداث دقيقة ضمن النطاق الزمني المحدد. لا يقيس هذا الاختبار التحويل أو الاحتفاظ بالمستخدمين.

اختبر الأحداث في تطبيقك

انقل استدعاءات الالتقاط إلى معالجات التطبيق. حافظ على معنى كل حدث ونوعه وقاعدة هويته. اختبر بحسابات اصطناعية أولًا. المعاينة المحلية تختبر الالتقاط. والدفعة المقبولة تختبر التسليم. ولا تثبت أيٌّ منهما أن استدعاء الالتقاط يعمل في الموضع الصحيح من تطبيقك.