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