حل المشاكل

أغلب المشاكل تطلع كتحذير في الكونسول على localhost. ابدأ من هناك.

ما وصل ولا حدث

  1. هل المشروع يطلب الموافقة أولًا، أو الزائر رفض التتبع؟ إذا "اطلب الموافقة قبل التتبع" مفعّل، ما ينرسل شيء قبل datacub.consent.grant(). والزائر اللي استدعى datacub.consent.revoke() يبقى رافض على نفس المتصفح. وعلى localhost يحذّرك الـ SDK بـ no consent yet.
  2. هل المفتاح صحيح؟ يبدأ بـ pk_live_ أو pk_test_ وبعده من 24 إلى 48 حرف ورقم. والمفتاح المثال pk_live_YOUR_PROJECT_KEY ينرفض: init: bad key.
  3. هل موقعك مسموح له؟ شيّك على من وين تجي البيانات في الإعدادات، عام. و localhost يشتغل بس مع مفتاح pk_test_. وفي تبويب الشبكة في المتصفح، إذا /v1/batch رجّع 403 مع origin_not_allowed فمعناه إن الموقع مو في القائمة.
  4. هل Global Privacy Control مفعّل؟ المتصفحات اللي فيها GPC تنحسب رفض للتتبع. شوف الموافقة.
  5. هل مانع الإعلانات يوقف الطلب؟ استخدم بروكسي على نطاقك.

بعدها اضغط تأكد من الربط في الإعدادات، الربط: ينتظر الحدث الجاي ويعلمك أول ما يوصل.

التحذيرات ومعناها

التحذيرالحل
init: bad keyاستخدم مفتاح pk_ حقيقي؛ و apiHost لازم يكون https (أو http://localhost)
refused a secret key. Use a pk_ key.أبد لا تحط مفتاح sk_ في كود الواجهة
bad nameأسماء الأحداث ما تبدأ بـ $ ولا تشبه المعرّفات. شوف الأسماء
bad idالمعرّف يشبه إيميل أو جوال أو هوية أو قيمة وهمية. أرسل معرّف المستخدم الداخلي حقك
no consent yetبس مع تفعيل "اطلب الموافقة قبل التتبع": طبيعي لين يعطي كود الموافقة عندك الموافقة

وفي React Native نفس الفحوصات تطلع كـ track: invalid event name و identify: ID refused و init: expected a pk_live_ or pk_test_ key، و init: no app id إذا ناقص app.

ردود datacub

الحالةمعناهاوش يسوي الـ SDK
401 invalid_keyالمفتاح مو موجود أو انلغىيوقف لهذي الصفحة أو هذي الفتحة
403 origin_not_allowed، 403 app_not_allowedالموقع أو التطبيق مو في القائمة المسموحةيوقف لهذي الصفحة أو هذي الفتحة
403 project_suspended، 403 project_in_reviewالمشروع موقوفيوقف لهذي الصفحة أو هذي الفتحة
403 ingestion_pausedالفترة التجريبية انتهت بدون باقة (الاشتراك)يوقف لهذي الصفحة أو هذي الفتحة
429 rate_limitedأحداث كثيرة مرة وحدةيعيد المحاولة بعد الوقت اللي يطلبه datacub
5xx أو ما فيه نتdatacub أو الشبكة واقفةيعيد المحاولة بفواصل متزايدة، ويحتفظ لين 1,000 حدث

مشاهدات الصفحات ناقصة أو مكررة

  • بس أول صفحة تنحسب في تطبيق الصفحة الواحدة: ممكن الراوتر عندك يستخدم الهاش. فعّل hashRouting: true.
  • الصفحة تنحسب مرتين: init انستدعى بإعدادين مختلفين، أو وسم السكربت وحزمة npm محمّلين مع بعض. حمّل الـ SDK مرة وحدة.
  • المسارات فيها :id أو :redacted: هذا مقصود. المعرّفات والبيانات الشخصية تنشال من الروابط.

مستخدمين مكررين أو مدموجين

  • شخص واحد يطلع كأكثر من مستخدم: استدعِ identify بعد كل تسجيل دخول، وفي كل جهاز. ومستخدمين Safari اللي يغيبون 7 أيام يرجعون زوار جدد لين يسجّلون دخول.
  • شخصين يطلعون كواحد: استدعِ reset() عند تسجيل الخروج.

الجوال

  • ما يبقى شيء بعد إعادة التشغيل: مرّر storage لـ init.
  • الأحداث من Expo Go تنرفض: Expo Go يشتغل بس مع مفتاح pk_test_.
  • ما ينرسل شيء في الاختبارات: سوّ await datacub.flush() قبل ما يخلص الاختبار.