المراقبة
إعادة تشغيل الجلسات
يستطيع SDK المتصفح تسجيل الصفحة كما رآها المستخدم ورفع الدقيقة التي سبقت خطأً أو بلاغ عطل. يحدد إعداد «تسجيل الجلسات» لكل مشروع في لوحة التحكم متى يسجّل، فيعمل دون تعديل الشيفرة، وفي Odoo أيضًا. أداة التسجيل إضافة منفصلة بحجم 61 KB تُجلب من blipit.io فقط عندما يكون التسجيل مفعّلًا، فيبقى السكربت الأساسي صغيرًا.
1اختر متى يسجّل
افتح المشروع في app.blipit.io واختر إعداد «تسجيل الجلسات». الخيار «عند الأخطاء وبلاغات الأعطال»، وهو الافتراضي لكل مشروع، يحتفظ بآخر 60 إلى 120 ثانية في ذاكرة المتصفح ولا يرفعها إلا عند التقاط خطأ أو إرسال بلاغ عطل، ثم يواصل التسجيل؛ والزيارات التي تخلو من المشاكل لا تُرفع أبدًا. والخيار «كل الزيارات، بعيّنة» يسجّل النسبة التي تختارها من الزيارات (من 1 إلى 100%) من البداية سواء تعطّل شيء أم لا، ويُبقي مخزن الأخطاء على البقية. والخيار «إيقاف» لا يحمّل شيئًا. يستطيع المالكون والمسؤولون وكل من يملك صلاحية تعديل المشروع تغييره، وتلتقط المتصفحات التغيير خلال ساعة تقريبًا.
2ما يظهر وما يُخفى
يحدث الإخفاء في المتصفح قبل إرسال أي شيء. تتحول القيم المكتوبة ونصوص الصفحة وخلايا الجداول وأسماء السجلات إلى نجوم، فيظهر الحقل مثل العميل: ******. وتبقى التسميات والأزرار مقروءة لتتابع ما فعله الزائر: تسميات النماذج وعناوين المجموعات وعناوين أعمدة الجداول والقوائم والتعليقات التوضيحية والأزرار وعلامات التبويب وعناصر القوائم وروابط التنقل، وفي Odoo تسميات الحقول وشريط الحالة وعلامات تبويب الدفتر وقائمة التطبيقات وأزرار لوحة التحكم. وحتى هناك تُخفى الأرقام والتواريخ وعناوين البريد والروابط وأسماء @، فيظهر الزر مثل Pay $**.**، وتُخفى كذلك سمات title وalt وaria-label وplaceholder. ويبقى كل ما داخل قيمة حقل أو خلية جدول أو بطاقة كانبان أو نشاط أو محادثة مخفيًا حتى لو ظهر كزر، وتُخفى عناوين أعمدة كانبان لأنها قد تكون قيمًا مجمّعة. ويبقى مخفيًا دائمًا حتى داخل تسمية أو زر: حقول الإدخال ومربعات النص والقوائم المنسدلة وخياراتها والمناطق القابلة للتحرير وخلايا الجداول وقيم الحقول والعناوين ومسارات التنقل والمحادثة وبطاقات كانبان وقوائم الحساب والمستخدم والملف الشخصي وقوائم البحث والإكمال التلقائي. تصبح الصور والفيديو والصوت وعناصر canvas وإطارات iframe وحقول كلمات المرور مربعات فارغة بالحجم نفسه، ويُحجب كل ما يحمل data-blipit-block، وتُحجب القيم الشبيهة بالرموز في عنوان الصفحة. لإخفاء كل كلمة كما في السابق، أوقف «إظهار التسميات والأزرار في التسجيلات» في لوحة تسجيل الجلسات للمشروع. أضف data-blipit-mask إلى عنصر لإخفائه دائمًا، أو data-blipit-unmask لإظهار نص عنصر تختاره؛ وتكون الغلبة لـ data-blipit-mask.
<div data-blipit-mask>Always masked</div>
<span data-blipit-unmask>Plan</span>3مشاهدة إعادة تشغيل
تعرض صفحة إعادات التشغيل التسجيلات حسب المشروع، مع أخطاء أو بدونها، وحسب عنوان URL. يحتوي المشغّل على تشغيل و1x و2x و4x وتخطي الخمول وعلامة حمراء لكل خطأ ترتبط بمشكلته. تعرض المشكلة التي يحمل أحدث حدث فيها إعادة تشغيل زر «مشاهدة إعادة التشغيل».
4تجاوزه في الشيفرة
خيار replay في Blipit.init يغلب إعداد المشروع لذلك الموقع: onErrorSampleRate (الافتراضي 1) هي نسبة الزيارات التي تحتفظ بمخزن الأخطاء، وsessionSampleRate (الافتراضي 0) نسبة الزيارات المسجّلة من البداية، وlabels: false يخفي كل النصوص في ذلك الموقع. وreplay: false يوقف التسجيل في ذلك الموقع مهما كان إعداد المشروع.
Blipit.init({
key: "<public key>",
release: "2026.09.28",
replay: { sessionSampleRate: 0.05, onErrorSampleRate: 1 }
});5تطبيقات الجوال: Android
تعمل إعادة تشغيل الجلسات على الجوال في تطبيقات Android مع blipit-android 0.3.0 أو أحدث، وعلى أجهزة Huawei أيضًا، لأن الحزمة لا تستخدم خدمات Google Play ولا Firebase. قريبًا لـ iOS وReact Native وFlutter. ينطبق إعداد المشروع نفسه: «عند الأخطاء وبلاغات الأخطاء» يحتفظ بآخر 30 ثانية في ذاكرة الجهاز ولا يرفعها إلا عند حدوث خطأ أو إرسال بلاغ؛ و«كل الزيارات، بالعيّنة» يسجّل النسبة التي تختارها من جلسات التطبيق كاملة. تتطلب إعادة التشغيل Android 8.0 (API 26) أو أحدث؛ وتواصل الأجهزة الأقدم إرسال الأخطاء من دون تسجيل.
implementation("com.github.blipit-io:blipit-android:v0.7.5")Blipit.init(this) {
key = "<public key>"
project = "<project id>"
}6اطلب الموافقة أولًا
لا يُسجَّل أي شيء حتى يستدعي تطبيقك Blipit.setReplayConsent(true)، والقيمة الافتراضية false. اعرض الإفصاح (أدناه) واستدعِها عندما يوافق المستخدم. يُحفظ الاختيار على الجهاز، فلا تستدعِها مجددًا إلا إذا تغيّر. أما Blipit.setReplayConsent(false) فتوقف التسجيل فورًا وتحذف المخزن المؤقت، لذا وفّرها في إعدادات تطبيقك. وتعيد Blipit.hasReplayConsent() الاختيار الحالي.
allowButton.setOnClickListener { Blipit.setReplayConsent(true) }
replaySwitch.isChecked = Blipit.hasReplayConsent()
replaySwitch.setOnCheckedChangeListener { _, on -> Blipit.setReplayConsent(on) }7ماذا يسجّل تسجيل الجوال
نحو إطار واحد في الثانية من شاشات تطبيقك نفسه، يُرمَّز على الجهاز كفيديو H.264 صغير، إضافة إلى اللمسات وتغيّرات الشاشة ومسار الأحداث وطراز الجهاز وإصدار Android وإصدار التطبيق. لا تُسجَّل أبدًا التطبيقات الأخرى ولا واجهة النظام ولا الإشعارات ولا أي شيء أثناء وجود تطبيقك في الخلفية: يتوقف التسجيل مؤقتًا بمجرد انتقال التطبيق إلى الخلفية وينتهي بعد 30 ثانية هناك. لا يستخدم Blipit أبدًا AccessibilityService ولا MediaProjection، فلا يظهر طلب لتسجيل الشاشة ولا توجد خدمة في المقدّمة. تنخفض جودة الفيديو على الشبكات محدودة البيانات (الجوال)، ويُرسل كل شيء عبر HTTPS إلى Blipit فقط.
8ما الذي يُخفى على الجهاز
يتم الإخفاء على الجهاز قبل حفظ أي إطار: كل النصوص وكل الصور وكل حقول الإدخال (EditText وحقول النص في Jetpack Compose) وعناصر WebView ومشغّلات الفيديو تُرسم كتلًا مصمتة. اضبط replayLabels = true في Blipit.init لتبقى التسميات ونصوص الأزرار مقروءة في الشاشات المبنية على View؛ وتبقى حقول الإدخال والصور مخفية، وتبقى شاشات Jetpack Compose مخفية بالكامل. أضف android:tag="blipit-mask" إلى أي عنصر لإخفائه دائمًا.
<TextView
android:id="@+id/balance"
android:tag="blipit-mask" />9تطبيقات الأطفال
اترك إعادة التشغيل متوقفة في التطبيقات الموجّهة للأطفال (سياسة العائلات في Google Play، وقانون COPPA، وفئة الأطفال في App Store). اضبط childDirected = true في Blipit.init أو استدعِ Blipit.disableReplayForChildApp()؛ وعندها لا يبدأ التسجيل أبدًا حتى مع الموافقة.
Blipit.init(this) {
key = "<public key>"
project = "<project id>"
childDirected = true
}10قائمة الامتثال لمتاجر التطبيقات
- اطلب الموافقة قبل أي تسجيل: لا تستدعِ Blipit.setReplayConsent(true) إلا بعد موافقة المستخدم.
- اعرض إفصاحًا واضحًا داخل التطبيق قبل أن تطلب الموافقة، بالنص أدناه.
- اذكر Blipit وإعادة تشغيل الجلسات في سياسة الخصوصية؛ فقرة AppGallery أدناه تصلح لكل المتاجر.
- املأ نموذج «أمان البيانات» في Google Play وتصنيفات الخصوصية في AppGallery بالإجابات أدناه.
- أبقِ إعادة التشغيل متوقفة في التطبيقات الموجّهة للأطفال.
- احترم سحب الموافقة: وفّر في إعدادات تطبيقك مفتاحًا يستدعي Blipit.setReplayConsent(false).
11إجابات «أمان البيانات» في Google Play
استخدم هذه الإجابات في Play Console ضمن محتوى التطبيق > أمان البيانات. أسماء الفئات والأغراض مكتوبة كما تظهر في واجهة Console الإنجليزية.
- App activity > App interactions: تُجمع، لا تُشارك، اختيارية. الأغراض: App functionality وAnalytics.
- App info and performance > Crash logs: تُجمع، لا تُشارك. الأغراض: App functionality وAnalytics.
- App info and performance > Diagnostics: تُجمع، لا تُشارك. الأغراض: App functionality وAnalytics.
- هل تُشفَّر كل بيانات المستخدم التي يجمعها تطبيقك أثناء النقل؟ نعم.
- هل توفّر للمستخدمين طريقة لطلب حذف بياناتهم؟ نعم.
12إفصاح داخل التطبيق جاهز للّصق
اعرضه قبل طلب الموافقة، في شاشة مستقلة أو نافذة حوار فيها زرّا «السماح» و«ليس الآن»، وعدّل مسار الإعدادات ليطابق تطبيقك.
- يسجّل هذا التطبيق فيديو مخفي التفاصيل لشاشتك ولمساتك لمدة تصل إلى 30 ثانية قبل حدوث خطأ أو إرسال بلاغ عن خطأ، ويرسله إلى مزوّد مراقبة الأخطاء لدينا Blipit لإصلاح المشكلات. تُخفى النصوص والصور وما تكتبه. يمكنك إيقاف ذلك من الإعدادات.
13بيان الخصوصية لمتجر Huawei AppGallery
الصق هذا في بيان الخصوصية واستبدل الأجزاء بين الأقواس المعقوفة؛ وهو يصلح أيضًا لـ Google Play والمتاجر الأخرى. في AppGallery Connect صرّح في تصنيفات الخصوصية للتطبيق بأن حزمة من طرف ثالث تجمع نشاط التطبيق (التفاعلات) وبيانات التشخيص (سجلات الأعطال)، من دون مشاركتها أو استخدامها للإعلانات.
- مراقبة الأخطاء وإعادة تشغيل الجلسات. نستخدم Blipit، وهي خدمة لمراقبة الأخطاء تديرها Louward Labs FZC LLC (عجمان، الإمارات العربية المتحدة)، بصفتها معالجًا للبيانات. بموافقتك، يحتفظ التطبيق بتسجيل قصير مخفي التفاصيل لشاشات التطبيق نفسه (تُخفى النصوص والصور وما تكتبه على جهازك قبل حفظ أي شيء)، ولمساتك وتغيّرات الشاشة، وطراز الجهاز ونظام التشغيل وإصدار التطبيق. يُرسل عبر اتصال مشفّر (HTTPS) فقط عند حدوث خطأ أو عند إرسالك بلاغًا عن خطأ أو لعيّنة صغيرة من الجلسات، ولا يُستخدم إلا للعثور على مشكلات التطبيق وإصلاحها. لا يُباع ولا يُستخدم للإعلانات. تُحذف التسجيلات تلقائيًا بعد [7/14/30] يومًا. يمكنك سحب موافقتك في أي وقت من [الإعدادات > الخصوصية]، وطلب الاطلاع على بياناتك أو حذفها عبر [جهة الاتصال].
14تصنيف الخصوصية في App Store (لإصدار iOS)
لحزمة iOS القادمة. في App Store Connect ضمن App Privacy صرّح بما يلي:
- Usage Data > Product Interaction: لأغراض App Functionality وAnalytics.
- Diagnostics > Crash Data وOther Diagnostic Data: لأغراض App Functionality وAnalytics.
- غير مرتبطة بهوية المستخدم، إلا إذا استدعيت Blipit.setUser؛ فعندها صنّفها مرتبطة.
- لا تُستخدم للتتبّع (tracking).
من المفيد معرفته
- التسجيلات شهريًا: Free 25، وSolo 500، وTeam 2,500، وScale 5,000، ويُحتفظ بها 7 أيام في Free و14 في Solo و30 في Team وScale. عند نفاد تسجيلات الشهر يجيب إعداد المشروع بـ«إيقاف» حتى الشهر التالي ولا يُحتسب أي مبلغ.
- يتوقف التسجيل بعد 60 دقيقة أو 500 مقطع أو 20 ميغابايت. تُرسل الأجزاء كل 10 ثوانٍ أو عند 1 ميغابايت، مضغوطة بـ gzip، والجزء الأخير عند إغلاق التبويب.
- في المواقع، يسجّل سكربت Blipit للمتصفح الجلسات؛ وفي تطبيقات أندرويد، ترسلها حزمة Blipit لأندرويد.
- تتشارك تسجيلات الجوال الحصة الشهرية ومدة الاحتفاظ مع تسجيلات الويب، وتُحذف ملفات الفيديو مع التسجيل.
هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح ومعرّف كل مشروع موجودة تحت مفاتيح API في app.blipit.io.