البدء

1. أنشئ حسابًا وافتح لوحة التحكم.
2. اكتب اسمًا تحت مشروع جديد وأنشئه. ستحصل على مفتاح API للمشروع (ea_...).
3. الصق مقتطف الشيفرة المعروض في صفحة المشروع داخل <head> في موقعك. وهو يبدو هكذا:

<script defer src="https://api.analytics.house/tracker.js" data-key="YOUR_PROJECT_KEY"></script>

تُتتبَّع مشاهدات الصفحات تلقائيًا ولا تُعيَّن أي ملفات تعريف ارتباط. أما حاجتك إلى شريط طلب الموافقة أو خيار الانسحاب فتعتمد على أماكن وجود زوارك: راجع الموافقة وأشرطة ملفات تعريف الارتباط.

سمات اختيارية

• data-api: لتحديد أصل (origin) بديل لواجهة API، وهو مفيد عند التوجيه عبر وكيل Cloudflare Worker الخاص بك من الطرف الأول.
• integrity="sha384-..." crossorigin="anonymous": لتثبيت تجزئة Subresource Integrity الدقيقة لملف /tracker.js (متاحة في إعدادات المشروع).
• data-localhost="true": لتتبّع localhost أيضًا (يُتجاهَل افتراضيًا).
• data-respect-dnt="false": لتعطيل الالتزام الافتراضي بإشارتَي Global Privacy Control (Sec-GPC: 1) وDo Not Track (DNT: 1).
• data-hash="true": لتضمين location.hash في المسار (لتطبيقات الصفحة الواحدة التي تعتمد التوجيه عبر hash).
• data-vitals="true": لقياس Core Web Vitals تلقائيًا بدون ملفات تعريف الارتباط (LCP وCLS وINP) عبر PerformanceObserver.
• data-clicks="true": لتسجيل خرائط النقرات. يحمّل سكربتًا منفصلًا بحجم 1 KB يحصي النقرات لكل عنصر في الصفحة (أسماء الوسوم والمواضع فقط، دون أي نص) ويرصد النقرات الغاضبة والنقرات غير المستجيبة. راجع صفحة السلوك.
• data-errors="true": للإبلاغ عن أخطاء JavaScript (الرسالة والملف والسطر، بحد أقصى 5 أخطاء لكل مشاهدة صفحة، مع إزالة البيانات الشخصية). لا تُحتسب الأخطاء أبدًا ضمن حركة المرور.

لا يعيّن السكربت أي ملفات تعريف ارتباط ولا يخزّن أي شيء في المتصفح. تجمع خوادمنا مشاهدات الصفحات الخاصة بالزائر في زيارة واحدة (بمعرّف الزائر اليومي نفسه، وبفارق لا يتجاوز 30 دقيقة بينها)، وتطبّق وسوم الحملة (UTM) الخاصة بصفحة الهبوط على بقية تلك الزيارة.

التتبع التلقائي

• مشاهدات الصفحات، بما في ذلك التنقل داخل تطبيقات الصفحة الواحدة.
• الروابط الخارجية: تُسجَّل النقرات المؤدية إلى مواقع أخرى باسم Outbound Link (عنوان URL بدون سلسلة الاستعلام).
• تنزيلات الملفات: تُسجَّل الروابط إلى الملفات ذات الامتدادات pdf وzip وcsv وxlsx وما شابهها باسم File Download.
• تؤدي إضافة data-404="true" إلى وسم السكربت إلى إرسال حدث 404 أيضًا عندما يوحي عنوان الصفحة بأنها صفحة غير موجودة.
• تسجّل data-scroll="true" مدى تمرير كل مشاهدة صفحة (حدث مخزَّن إضافي واحد لكل مشاهدة صفحة، وهي معطّلة افتراضيًا). فعّلها من إعدادات المشروع.

الإيرادات

analyticsHouse.track('Purchase', { revenue: 49.99, currency: 'EUR' })

تُخزَّن المبالغ حسب كل عملة ولا تُجمع أبدًا عبر عملات مختلفة. وتظهر تحت «الإيرادات» في لوحة التحكم.

الأحداث المخصّصة والأهداف

لا حاجة إلى كتابة أي شيفرة: أضِف سمة إلى أي عنصر وستُتتبَّع النقرات عليه.

<button data-ea-event="Signup" data-ea-prop-plan="pro">Start free trial</button>

أو من خلال JavaScript:

analyticsHouse.track('Signup', { plan: 'pro' })

يظهر كل حدث مخصّص ضمن الأهداف والأحداث المخصّصة مع معدل التحويل الخاص به. ويمكنك استخدامها أيضًا خطواتٍ في مسارات التحويل.

نصائح لاستخدام لوحة التحكم

• انقر على أي صف (صفحة، أو دولة، أو متصفح، أو حدث...) لتصفية لوحة التحكم بأكملها. يمكنك الجمع بين خمسة عوامل تصفية كحدٍّ أقصى.
• يعرض زر مقارنة كل مقياس مقارنةً بالفترة السابقة.
• ينشئ زر مشاركة رابطًا عامًا للقراءة فقط يمكنك إلغاؤه في أي وقت. ويُنزّل زر تصدير CSV ما تراه.
• للاطلاع على واجهة API كاملةً، راجع مرجع API.