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

datacub يسجّل بنفسه مشاهدات الصفحات، ووقت البقاء في الصفحة، والنقرات، وإرسال النماذج.

مشاهدات الصفحات

الحدثمتى
$pageviewعند أول تحميل للصفحة، ومع كل تنقّل في تطبيقات الصفحة الواحدة، ولما يرجّع المتصفح صفحة من ذاكرة الرجوع والتقدّم
$pageleaveلما ينتقل المستخدم للصفحة اللي بعدها أو يخفي التبويب. فيه وقت الظهور الفعلي وعمق التمرير بخطوات 10%

التنقّل ينكشف عن طريق History API (pushState و replaceState والرجوع والتقدّم)، بعد 100 ملي ثانية من تحديث الراوتر للرابط. وإذا الراوتر أعاد كتابة نفس المسار ما ينحسب مرتين. الراوترات اللي تعتمد على الهاش تحتاج hashRouting: true (الأطر).

الروابط تتنظّف على الجهاز: الهاش ينشال، وقيم الـ query تنحفظ بس إذا كانت رموز، أبد ما ننجمع اللي كتبه الشخص أو أي شيء حساس (شوف وش يجمعه الـ SDK)، والمعرّفات في المسار تصير :id أو :uuid أو :hash أو :token، وأي شيء يشبه بيانات شخصية يصير :redacted. وتنحفظ معاملات UTM ومن أي شبكة إعلانية جت الزيارة (gclid و fbclid وغيرها، بدون قيمها) عشان تقارير المصادر.

النقرات

النقرات على الروابط والأزرار و summary وأزرار الإرسال، والعناصر اللي دورها في ARIA زر أو رابط أو عنصر قائمة أو تبويب، تنسجّل كـ $click. نص الأزرار والروابط الظاهر ينجمع (بعد تنظيفه، وبحد أقصى 100 حرف؛ التفاصيل). سمّ الأزرار المهمة باسم واضح عن طريق data-datacub-name:

<button data-datacub-name="upgrade_plan">ترقية الباقة</button>
<a href="/pricing" data-datacub-name="see_pricing">Pricing</a>

الاسم هذا هو اللي يطلع في التقارير، وبأي لغة تستخدمها واجهتك. لا تحط فيه بيانات المستخدم: ينظّف مثل أي قيمة ثانية.

إرسال النماذج

$form_submit يسجّل إن النموذج انرسل: الـ data-datacub-name حقه، ومسار الإرسال، وكم حقل فيه. وأبد ما يسجّل أسماء الحقول ولا قيمها ولا عناوينها.

<form data-datacub-name="signup" action="/signup">...</form>

النقرة مو نتيجة

النقرة على "ادفع" مجرد نقرة، وإرسال النموذج مجرد محاولة. ولا وحدة منهم تقول إن الدفع نجح. تتبّع النتيجة في المكان اللي يعرف فيه كودك إنها نجحت، عشان تبقى مسارات التحويل صحيحة حتى لو انرفضت البطاقة أو طلع خطأ في النموذج:

async function pay(planId: string) {
  const res = await fetch('/api/checkout', { method: 'POST', body: JSON.stringify({ planId }) })
  if (res.ok) datacub.track('checkout_completed', { plan: planId })
}

استثناء أجزاء من الصفحة

أضف class="datacub-no-capture" أو data-datacub-no-capture لأي عنصر، وكل اللي داخله ما ينسجّل، لا نقرات ولا إرسال:

<section class="datacub-no-capture">
  <!-- an admin panel, a support chat, anything you would rather not measure -->
</section>

ولو تبي توقف النقرات وإرسال النماذج في كل مكان وتخلي مشاهدات الصفحات:

datacub.init('pk_live_YOUR_PROJECT_KEY', { autocapture: false })

في تطبيقات الجوال

التطبيقات فيها شاشات بدل الصفحات، وما فيها نقرات تلقائية. شوف الشاشات.