أسئلة وحلول
أجوبة قصيرة ومبنية على الواقع. وإذا كان للموضوع صفحة خاصّة، الجواب يوصلك لها بدل ما يكرّرها. وإذا كان الجواب الصادق «مو بعد»، يقولها كذا.
الالتقاط
Section titled “الالتقاط”سنيبت ولا إضافة: وش أستعمل؟
Section titled “سنيبت ولا إضافة: وش أستعمل؟”وسم <script> في موقعك. لا تسجيل دخول ولا شيء يركّبه الزائر: مستخدمون حقيقيون يبلّغون من الصفحة اللي واقفين عليها. والودجت يقرأ lang حقّ تلك الصفحة ويتكلّم عربي أو إنجليزي؛ وأي صفحة بلغة ثالثة تجيها النسخة الإنجليزية. وهذا هو المسار الأساسي. شوف تركيب السنيبت.
لمختبِرين مسمّين: فريق جودة داخلي، أو مراجعي الوكالة. كل واحد يدخل برمز اتصال تصدره له، ويلتقط بس على المشاريع اللي ربطته فيها. شوف تركيب الإضافة.
وأغلب الفرق تستعمل الاثنين، والتقارير من الاثنين تنزل في نفس الوارد.
هل الإضافة في متجر كروم؟
Section titled “هل الإضافة في متجر كروم؟”إيه. منشورة للعموم في متجر كروم باسم uMarker — Visual Feedback، ويركّبها منه كروم وEdge وBrave وOpera وVivaldi. وشاشة الإضافة في المشروع تعرض نفس الرابط تحت تثبيت الإضافة، فترسله للمختبِر مع رمز اتصاله. أمّا فايرفوكس وسفاري فلسه ما لهم متجر، وإيصال نسخة لهم شي ترتّبه معنا مباشرة. وسنيبت الموقع ما يحتاج شي من هذا.
هل يحتاج اللي يبلّغ حساباً؟
Section titled “هل يحتاج اللي يبلّغ حساباً؟”لا. الزائر اللي يستعمل السنيبت ما يدخل على شيء. ومختبِرو الإضافة يدخلون برمز اتصال تصدره أنت — وهو الطريق الوحيد للدخول. تدوير الرمز يقطع أيّاً كان عنده القديم، وسحب المختبِر يرفضه مهما كان رمزه، وهذا اللي تسوّيه لمّا يطلع أحد.
وش فيه التقرير بالضبط؟
Section titled “وش فيه التقرير بالضبط؟”يعتمد على وضع الالتقاط للمشروع (الودجت ← الإعداد ← ما الذي تلتقطه الملاحظة)، والسنيبت والإضافة يتبعونه سواء — لأنهم يشغّلون نفس محرّك الودجت.
- عادي (الوضع اللي تبدأ عليه المشاريع الجديدة): اللقطة، والملاحظات المرقّمة اللي حطّها المُبلِّغ عليها — كل وحدة مرسومة صندوقاً حول العنصر اللي انحطّت عليه بالضبط — والصفحة والجهاز: الرابط ونوع الجهاز والمتصفّح ونظام التشغيل واللغة ومقاس الشاشة والنافذة. ولا شي تقني.
- تقني: كل هذا، وفوقه رسائل الكونسول، وكل طلب سوّته الصفحة (مع تعليم الفاشلة والبطيئة)، وأخطاء JavaScript مع الـstack، وأرقام الأداء، وفتات المسار (آخر النقرات وتغييرات المسار)، وتفاصيل البيئة.
والتقرير يحتفظ بالوضع اللي انرسل فيه. ومُحدِّد CSS حقّ العنصر يُخزَّن مع الملاحظة ويرجع في الـAPI، لكن ما فيه ولا شاشة في اللوحة تطبعه؛ في التقرير تشوف الصندوق، مو المُحدِّد. شوف وش يُلتقط بالضبط والسياق التقني.
وين يصير إخفاء البيانات؟
Section titled “وين يصير إخفاء البيانات؟”على جهاز المُبلِّغ نفسه، قبل ما تُلتقط الصورة، فاللي يغطّيه ما يوجد عندنا أصلاً لين يتسرّب. وفيه جزء ما له شرط: قيم باراميترات الرابط اللي أسماؤها تدلّ على سرّ تنمسح على كل مشروع. والجزء الثاني مفتاح لكل مشروع مطفي لين تشغّله — يموّه قيم الحقول المكتوبة وأي منطقة توسمها بمُحدِّد CSS — تلقاه في المشروع تحت الودجت ← الإعداد. شوف إخفاء البيانات الحسّاسة.
هل يُرسَل شيء لنموذج ذكاء اصطناعي؟
Section titled “هل يُرسَل شيء لنموذج ذكاء اصطناعي؟”مو إلا إذا شغّلته أنت. المساعدات مبنيّة ومشحونة، وثلاثة مفاتيح مستقلّة لازم تقول «نعم» كلّها قبل ما توصل كلمة وحدة لأي نموذج. الأول المنصّة: لازم يكون فيه مزوّد نماذج مضبوط، وسلسلة المنصّة اليوم فيها Groq وGoogle Gemini. والثاني موافقة حسابك نفسه، وهي مطفيّة على كل حساب لين يشغّلها إنسان. والثالث باقتك — الذكاء من «احترافي» وفوق، ومعه رصيد شهري (3,000 على «احترافي» و12,000 على «الوكالات»).
وفيه شيئان مكانهما مراجعة أمنية مو هامش: العميل اللي باقته تشمل الذكاء يقدر يجيب مفتاح مزوّده الخاص، وحينها يروح نصّه لذاك المزوّد بدل مزوّدي المنصّة. ولمّا يشتغل شي، اللي يُرسَل هو نصّ التقرير وبياناته الوصفية فقط — واللقطة ما تطلع أبداً — ويبقى كل مخرَج استشارياً لين يقبله إنسان. شوف مساعد الفرز الذكي.
الباقات والدفع
Section titled “الباقات والدفع”كم يطلع علينا؟
Section titled “كم يطلع علينا؟”شهرياً بالريال السعودي: مجاني، والبداية 99 ، واحترافي 249 ، والوكالات 499 ، والمؤسسات بالتواصل. وبالدفع السنوي يصير الإجمالي 990 و2,490 و4,990: شهران مجاناً. وما فيه أي عملة ثانية.
وش يعطيني المجاني فعلاً؟
Section titled “وش يعطيني المجاني فعلاً؟”مشروع واحد، ونطاق واحد، ومقعدان، ومختبِرا إضافة، واتصال تكامل واحد (قناة webhook)، وقيقابايت تخزين واحد، وسبعة أيام من تاريخ التقارير، وثلاثين يوماً من تخزين اللقطات.
والتقارير المجهولة من السنيبت العام مسقوفة بـ5 في اليوم، وهذا هو السقف الوحيد اللي يمنع وصول تقرير. أمّا البقيّة فترفض واحداً جديداً لمّا تكون عند الحدّ — مشروع ثانٍ، نطاق ثانٍ، مقعد ثالث، مختبِر ثالث، اتصال ثانٍ. والتخزين يتصرّف بشكل ثالث: فوق الحدّ، التقارير تنزل كاملة وتُسقَط اللقطة وحدها.
أمّا أداة الالتقاط نفسها والتعليقات والتسميات فما تُقيَّد أبداً. وشيئان في الوارد يُقيَّدان: التقارير الأقدم من سبعة أيام تنخفي منه (تنخفي، ما تنحذف — ترجع لمّا ترقّي)، وميزتان من الفرز محجوزتان — العروض المحفوظة تبدأ من «البداية»، والحقول المخصّصة من «احترافي».
أقدر أدفع بالبطاقة؟
Section titled “أقدر أدفع بالبطاقة؟”لا، ما فيه بوّابة دفع بالبطاقة. تختار باقة، ونعرض لك بيانات الدفع، تحوّل وترفع الإيصال، ثم يراجعه إنسان ويفعّل الباقة. ويوصلنا تنبيه بلحظة نزول إيصالك، ويوصلك بريد بالقرار — لكن ما ننشر مدّة مراجعة ولا نقيسها، فاعتبر التفعيل شي تبدأه قبل ما تحتاجه.
يجيني فاتورة ضريبية؟
Section titled “يجيني فاتورة ضريبية؟”يجيك فاتورة مرقّمة بالريال، مسجّل عليها الطرفان، وتقدر تطبعها. لكنها مو فاتورة ضريبية: uMarker غير مسجّلة بضريبة القيمة المضافة، فما فيها سطر ضريبة وما تُحصَّل ضريبة أصلاً. ولو فريقك المالي يحتاج فاتورة ضريبية، هذي هي النقطة اللي تثيرها قبل الشراء.
أي تكاملات تجي مع أي باقة؟
Section titled “أي تكاملات تجي مع أي باقة؟”عددها سبعة: أربع قنوات (webhook وسلاك وتيليجرام ومايكروسوفت تيمز) وثلاثة متتبّعات (GitHub وLinear وJira).
- المجاني: قناة webhook فقط.
- البداية: أربعة منها (webhook وسلاك وتيليجرام وGitHub).
- احترافي والوكالات: السبعة كلّها.
وكم اتصالاً تقدر تمسك بنفس الوقت رقم منفصل: 1 على المجاني، و3 على «البداية»، و10 على «احترافي»، و25 على «الوكالات». وإشعارات البريد لفريقك كمان تبدأ من «البداية».
الـREST API موجود في الباقة المجانية؟
Section titled “الـREST API موجود في الباقة المجانية؟”لا — ولا في «البداية» كمان. الـREST API وخادم MCP كلاهما يتصادق بمفتاح API، وسكّ المفتاح يبدأ من «احترافي» (249 بالشهر). والباقة تُفحص على كل طلب مو بس عند السكّ، فالمفتاح يعيش بعد التخفيض لكنه يوقف عن الجواب لين ترقّي من جديد. شوف مفاتيح الـAPI.
أقدر أستضيفه عندي؟
Section titled “أقدر أستضيفه عندي؟”لا. uMarker خدمة مستضافة وما فيه شي تركّبه على خوادمك. والقطعتان الاختياريتان اللي تشتغلان عندك تشتغلان على أجهزة فريقك، مو على خادم لك: إضافة المتصفّح، وخادم MCP لو مطوّروك يستعملونه.
الأمان والامتثال
Section titled “الأمان والامتثال”وين تُستضاف بياناتنا؟
Section titled “وين تُستضاف بياناتنا؟”منطقة الاستضافة ما تقرّرت بعد. السعودية هي وين ننوي نستضيف، وبتشوفها مذكورة كذا ومعها التحفّظ. والنيّة مو التزام: ما فيه شي تعاقدي لين تتثبّت المنطقة وتنكتب. اسأل قبل التوقيع ويجيك الجواب الحالي مكتوباً.
والادّعاء اللي ما يعتمد على هذا الجواب هو اللي فوق: القيم الحسّاسة تُخفى على جهاز المُبلِّغ قبل ما يُرفع أي شيء.
عندكم SOC 2 أو ISO 27001 أو اتفاقية معالجة بيانات موقّعة؟
Section titled “عندكم SOC 2 أو ISO 27001 أو اتفاقية معالجة بيانات موقّعة؟”لا، ولا واحدة من الثلاث اليوم: لا شهادة، ولا تدقيق مكتمل، ولا اتفاقية معالجة بيانات موقّعة من الطرفين. اللي موجود بدلها مكتوب وقابل للفحص. وأربعة منها ما تعتمد على اللي تدفعه: عزل الحسابات، والوصول لكل مشروع، وتصدير كامل تاخذه في أي وقت، وحذف حساب يمشي على الصور المخزّنة معه. واثنتان تعتمدان عليه: المصادقة الثنائية تبدأ من «البداية»، وضبط نافذة احتفاظ خاصّة فيك من «الوكالات». شوف نظرة عامة على الأمان ومعالجة البيانات.
كم تحتفظون بتقاريرنا؟
Section titled “كم تحتفظون بتقاريرنا؟”للأبد، إلا إذا ضبطت نافذة احتفاظ — وضبطها قدرة «الوكالات». ومع نافذة مضبوطة، مهمّة ليلية تحذف اللي تجاوزها؛ وبدون نافذة، المهمّة تعدّي حسابك وما ينحذف شي أبداً.
واللقطات على جدول منفصل، وهذا الجدول مو من اختيارك: باقتك هي اللي تقرّر كم تبقى الصورة (30 يوماً على المجاني، و180 على «البداية»، و365 على «احترافي»، و730 على «الوكالات»). ومهمّة ليلية ثانية تمسحها ويبقى التقرير ونقاشه. شوف التخزين.
الفريق والصلاحيات
Section titled “الفريق والصلاحيات”وش يقدر «العضو» يسوي مقارنةً بـ«المدير»؟
Section titled “وش يقدر «العضو» يسوي مقارنةً بـ«المدير»؟”العضو يفرز: يفتح الوارد، ويغيّر الحالة والأولوية، ويُسند، ويطبّق التسميات، ويدمج، ويعلّق، ويحفظ العروض، ويدفع التقرير لمتتبّع موصول. والمدير فوق كذا يضبط: المشاريع والودجت والتكاملات والمساحات والناس والفوترة.
وفعلان من أفعال العضو يجاوبان الباقة مثل ما يجاوبان المقعد: حفظ عرض يحتاج العروض المحفوظة («البداية» وفوق)، والدفع لمتتبّع يحتاج متتبّعاً موصولاً — والمجاني عنده قناة webhook وما عنده ولا متتبّع. شوف الأدوار والصلاحيات.
أقدر أكتب دوراً خاصّاً بي؟
Section titled “أقدر أكتب دوراً خاصّاً بي؟”نعم، من أكثر من 130 صلاحية مفردة. وإنشاء دور يحتاج «احترافي» وفوق؛ وتحته عندك المقعدان المدمجان. والأدوار اللي بنيتها وأنت على «احترافي» ما تنحذف لو نزلت لباقة أقل — تبقى قابلة للإسناد والتحرير، بس ما تقدر تضيف جديداً.
أقدر أخلي شخصاً يشوف مشروعاً واحداً وبس؟
Section titled “أقدر أخلي شخصاً يشوف مشروعاً واحداً وبس؟”نعم، لـالعضو — وهذا شغل تبويب الوصول داخل المشروع. ربط الشخص بالمشروع هو اللي يمنحه المشروع، فاللي مربوط بمشروع واحد يشوف ذاك المشروع بالضبط.
لكنه ما يحصر أحداً غيره. مالك الحساب، والمدير، وأي شخص دوره يحمل فتح كل مشاريع هذي المساحة — كلّهم يوصلون كل شي مهما كان تبويب الوصول يقول. وكل الآليّة معلّقة بمفتاح واحد على مستوى الحساب: إطفاء وضع تعدّد المساحات من إعدادات الحساب يشيل الحصر لكل مشروع عن كل الأعضاء دفعة وحدة. والروابط تبقى موجودة وتبويب الوصول يظلّ يعرضها؛ بس تكفّ عن حصر أي أحد لين يتشغّل المفتاح من جديد.
لازم أستعمل المساحات؟
Section titled “لازم أستعمل المساحات؟”أنت مستعملها أصلاً: كل حساب عنده وحدة على الأقل، ونظرة المساحات هي وين تنزل بعد الدخول. اللي تقرّره الباقة هو هل تقدر تنشئ أكثر من وحدة، وهذا يبدأ من «احترافي».
الـAPI والتكاملات
Section titled “الـAPI والتكاملات”وش حدود الطلبات على الـAPI؟
Section titled “وش حدود الطلبات على الـAPI؟”لكل مفتاح، ومعها سقف ثانٍ لكل عنوان IP. الافتراضي 300 طلب بالدقيقة لكل مفتاح، وقابل للضبط من المشغّل، فاعتبر الـ429 وترويسة Retry-After هما العقد، لا الرقم. ونقطة قائمة التقارير تاخذ per_page — 25 افتراضياً، محصورة بين 5 و100. أمّا قائمة المشاريع فما هي مُرقَّمة: ترجع كل مشروع يقدر المفتاح يشوفه. شوف مفاتيح الـAPI.
هل تتزامن التذكرة رجعةً؟
Section titled “هل تتزامن التذكرة رجعةً؟”الحالة تتزامن. تدفع التقرير لـGitHub أو Linear أو Jira، وwebhook المتتبّع يقلب تقرير uMarker إلى «تمّ الحل» لمّا تُغلق التذكرة، ويخبر فريق المشروع. لكنه ما يوصل اللي بلّغ: المُبلِّغ ما يوصله بريد إلا لمّا تنشر مدخل سجل تغييرات مربوطاً بتقريره وتأشّر خيار الإبلاغ عند ذاك النشر. أمّا المزامنة الثنائية حقلاً بحقل فمو مبنيّة. شوف متتبّعات المهام.
لازم أدخل توكن المتتبّع لكل مشروع؟
Section titled “لازم أدخل توكن المتتبّع لكل مشروع؟”لا. الاعتماد يُدخَل مرّة وحدة للحساب، ثم يُوجَّه لكل مشروع بمفاتيح لكل حدث. فالوكالة ما تعيد لصق توكن Jira لكل عميل.
ندائي للـAPI يرجع 401 أو 403 أو 404 أو 422 أو 429
Section titled “ندائي للـAPI يرجع 401 أو 403 أو 404 أو 422 أو 429”401: مفتاح ناقص أو مشوّه أو مسحوب.403: المفتاح مو مصرّحاً له بذلك المشروع.404: السجلّ يخصّ حساباً ثانياً، أو مو موجود. ونجاوب بنفس الشكل على الحالتين عمداً، عشان ما يصير الخطأ طريقة يعرف فيها أحد وش الموجود.422: فشل التحقّق؛ وكائنerrorsيسمّي الحقول.429: تجاوزت الحدّ؛ احترمRetry-After.
حلول المشاكل
Section titled “حلول المشاكل”الودجت ما يظهر
Section titled “الودجت ما يظهر”امشِ على هذي القائمة. السنيبت صامت عمداً: يرسم لا شيء بدل ما يرمي خطأ في موقعك.
- ما فيه نطاقات على المشروع. المشروع بقائمة نطاقات فارغة ما يشتغل في أي مكان، على السطحين. وهذا أكثر سبب متكرّر.
- المشروع مسودّة. النشر هو اللي يخلي الودجت مباشراً، والنشر يحتاج بريداً مُتحقَّقاً ونطاقاً واحداً على الأقل.
- السنيبت يشير لمضيف غلط. لازم يحمّل من
https://api.umarker.com/widget/v1.js. الودجت يقرأ عنوان الـAPI من أصل سكربته نفسه، فسنيبت يشير لمضيف اللوحة ما يحمّل شيئاً وما يوصل أي تقرير أبداً. - الاستهداف. قواعد الرابط الموجبة تتجمّع بـOR، والقواعد السالبة لازم تتحقّق كلّها. وقاعدة جهاز أو جمهور ممكن تستبعد هذا الزائر. وفي الإضافة الاستهداف يرشّح الاستبيانات والإعلانات بس، وما يخفي زرّ الملاحظات عن المختبِر أبداً.
- حدّ التكرار — من «احترافي» وفوق بس. وحيث ينطبق الاستهداف، الزائر اللي شاف الودجت أصلاً تحت حدّ «مرّة لكل زائر» يبقى مخفيّاً عنه في ذاك المتصفّح لين تُمسح بيانات الموقع. أمّا على المجاني و«البداية» فالقاعدة تُخزَّن وما تُرسَل للمتصفّح أبداً، فهي مو التفسير هناك.
- السطحان على نفس الصفحة. لو مختبِر عنده الإضافة على صفحة فيها السنيبت كمان، الإضافة تغلب وتشيل زرّ السنيبت، لأنها تلتقط التبويب الحقيقي، وهو الالتقاط الأفضل.
المختبِر ما يقدر يدخل
Section titled “المختبِر ما يقدر يدخل”- ممكن رمز اتصاله انسحب، أو مقعده كمختبِر متوقّف، أو الحساب كلّه معلّق. والثلاثة تفشل مغلقة، والرمز المسحوب والرمز الغلط يرجعان نفس الرسالة عمداً.
- الرمز يُصدر مرّة: لو أُعيد توليده، القديم ميت. أصدر له واحداً جديداً.
- محاولات الدخول محدودة المعدّل: انتظر دقيقة وأعد المحاولة.
ولو دخل عدل والمُشغِّل ما ظهر أصلاً، فهذي مشكلة ثانية وحلّها ثانٍ: المختبِر اللي مو مربوط بأي مشروع يدخل بنجاح وبعدها ما يشوف شي في أي مكان. افتح تبويب الودجت ← الإضافة في المشروع واربطه.
تقرير بلا سجلّ كونسول أو فتات مسار
Section titled “تقرير بلا سجلّ كونسول أو فتات مسار”الأرجح إنه انرسل في الوضع العادي — شوف الشارة على التقرير. تقارير الوضع العادي تحمل اللقطة والملاحظات والصفحة والجهاز بس؛ الكونسول والشبكة والأخطاء والأداء وفتات المسار ما تُسجَّل أصلاً، والمشاريع الجديدة تبدأ على العادي. عشان تجيك، حوّل المشروع للوضع التقني من الودجت ← الإعداد ← ما الذي تلتقطه الملاحظة. يسري من تحميل الصفحة اللي بعده؛ والتقارير اللي انرسلت قبل تحتفظ باللي فيها.
ولو كان التقرير تقنياً وقائمة الكونسول فاضية برضه، فالصفحة ما طبعت شي والودجت يسجّل — واللي انطبع قبل ما يبدأ الودجت ما كان عندنا أصلاً. شوف السياق التقني.
التذكرة انكتبت مرّتين
Section titled “التذكرة انكتبت مرّتين”ما صار. الإنشاء idempotent: التقرير اللي عنده تذكرة مربوطة يقول «مربوط أصلاً» بدل ما ينشئ ثانية، فالنقرة المزدوجة تعطي تذكرة وحدة بالضبط.
اللي بلّغ ما وصله ردّ
Section titled “اللي بلّغ ما وصله ردّ”هذي الرسالة تروح بس لمُبلِّغ عنوانه متحقَّق منه عند uMarker — يعني مختبِر إضافة مسجّل دخوله — وما هو في قائمة الكتم، وتُتخطّى لمّا يُبلَغ سقف الحساب بالساعة. أمّا العنوان اللي ينكتب في السنيبت العام فما يُراسَل أبداً، حتى لو الزائر هو اللي أعطاه، لأن ما فيه شي يثبت إنه عنوانه. شوف إقفال الحلقة.
الشاشة تقول إن الشي مو مشمول في باقتي
Section titled “الشاشة تقول إن الشي مو مشمول في باقتي”هذي الباقة تتكلّم، مو الصلاحيات. فدورك ممكن يكون صحيحاً والميزة غير موجودة أصلاً. وأغلب هذي الرسائل تسمّي باقتك الحالية والباقة اللي تفتح الميزة معاً؛ واثنتان ما تسمّيانها — سقف النطاقات، وإعادة تفعيل عضو معلّق — تسمّيان باقتك الحالية وتقولان «رقِّ باقتك» بدون ما تسمّيان باقة. شوف الأدوار والصلاحيات ليش هذولا سؤالان مختلفان.