PostHog

ماذا تفعل

تضيف الإضافة محمِّل JavaScript القياسي الخاص بـ PostHog إلى الصفحات العامة في مدوّنتك. تعطيها مفتاح مشروعك في PostHog الذي يبدأ بـ phc_، وتختار المنطقة التي يقيم فيها مشروعك: الولايات المتحدة أو الاتحاد الأوروبي. وعند تحميل الصفحة يجلب المحمِّل حزمة سكربت PostHog من مضيف الأصول في تلك المنطقة ويشغّل PostHog بمفتاحك، ثم يسجّل سكربت PostHog النشاط في الصفحة ويرسله إلى مشروعك. تضبط الإضافة خيارًا إضافيًا واحدًا هو person_profiles بقيمة identified_only، ولا تعرّف أحدًا بنفسها. والزائر الذي تلزم موافقته لا يصله شيء من PostHog حتى يقبل شريط ملفات تعريف الارتباط. أما المخططات والتسجيلات وأعلام الميزات فتُقرأ وتُدار كلها داخل PostHog لا في VeloCMS.

لمن يناسب

للمدوّنين والناشرين وفرق المنتجات الصغيرة الذين يستخدمون PostHog أصلًا أو يريدون استخدامه، ويرغبون في أن يرفع موقعهم على VeloCMS تقاريره إلى المشروع نفسه الذي يخدم بقية منتجهم. وهي تناسب من يعنيهم موضع تخزين بيانات التحليلات، فمضيف الاتحاد الأوروبي على بعد نقرة واحدة. أما إن كنت تحتاج عدّادات زيارات بسيطة بلا ملفات تعريف ارتباط، فستكون Plausible أو Fathom أخف.

كيف تعمل

1. 01

   في PostHog افتح Project Settings وانسخ Project API Key. وهو مفتاح عام مخصص للاستخدام في المتصفحات، ولذلك يمكن وضعه على صفحاتك دون خطر.

2. 02

   الصق المفتاح في الإضافة، واختر المنطقة الأمريكية أو الأوروبية، ثم احفظ. يتحقق النموذج من أن المفتاح يبدأ بـ phc_ وأن طوله ضمن الطول المتوقع.

3. 03

   في كل صفحة عامة يقرأ VeloCMS مفتاحك المحفوظ، ويتحقق من صيغته مرة أخرى، ويضيف محمِّل PostHog إلى رأس الصفحة. والمفتاح ذو الصيغة الخاطئة لا يضيف شيئًا.

4. 04

   يرى الزوار في الاتحاد الأوروبي والنرويج وآيسلندا وليختنشتاين والمملكة المتحدة، ومن لا يُعرف بلده، شريط ملفات تعريف الارتباط. ولا يبدأ PostHog إلا بعد «قبول الكل».

5. 05

   أما الزوار من البلدان الأخرى فلا يرون شريطًا، ويبدأ PostHog بمجرد تشغيل الصفحة في متصفحهم.

الإعدادات التي تضبطها

مفتاح واجهة برمجة تطبيقات المشروع

يبدأ بـ phc_ يليه من 20 إلى 64 حرفًا أو رقمًا. يُخزَّن مشفّرًا ويظهر نقاطًا بعد الحفظ. ولا يقبل النموذج النقاط، فأعد إدخال المفتاح كلما حفظت من جديد.

مضيف واجهة برمجة التطبيقات (المنطقة)

الولايات المتحدة (us.i.posthog.com) أو الاتحاد الأوروبي (eu.i.posthog.com). اختر المنطقة التي أُنشئ فيها مشروعك في PostHog. الولايات المتحدة محددة مسبقًا.

ما تستطيع الوصول إليه

لا تقرأ الإضافة أيًّا من تدويناتك أو أعضائك أو طلباتك، ولا تمرّر أسماء أو عناوين بريد إلى PostHog. وكل ما تحتاجه مفتاح مشروعك ومنطقته. ففي متصفح الزائر تحمّل حزمة PostHog من us-assets.i.posthog.com أو eu-assets.i.posthog.com، ثم يرسل PostHog ما يسجّله إلى us.i.posthog.com أو eu.i.posthog.com. ويخزّن PostHog ملفات تعريف ارتباط من الطرف الأول للتعرف على الزوار العائدين والجلسات.

حدود نذكرها بصراحة

• لا يُعرض إلا إقليما PostHog السحابيان. ولا يمكن إدخال عنوان PostHog مستضاف ذاتيًا ولا وكيل عكسي، وأي مضيف آخر يعود إلى المنطقة الأمريكية.

• لا إعدادات هنا لإعادة تشغيل الجلسات أو الاستبيانات أو أعلام الميزات أو الأحداث المخصصة. فالمقتطف لا يمرّر إلا مفتاحك والمنطقة وخيار الملف الشخصي identified_only.

• يعرض الشريط «قبول الكل» و«رفض الكل». والقبول يشغّل أيضًا أي أدوات أخرى تنتظر الموافقة في موقعك، مثل Google Analytics أو بكسلات التسويق، دون اختيار لكل أداة.

• يُضاف السكربت إلى صفحات مدوّنتك العامة، ولا يُضاف إلى لوحة إدارة VeloCMS.

• مشروع PostHog واحد لكل موقع. ولا تعرض VeloCMS بيانات PostHog داخل لوحتها هي.

• تبقى أنت المسؤول عن سياسة الخصوصية وعن أي التزامات قانونية تتعلق بالتتبع. والإضافة لا تجعل الموقع متوافقًا مع أي قانون.

الأسئلة الشائعة

إضافات ذات صلة

• Google Analytics 4
• Microsoft Clarity
• Plausible Analytics
• Google Tag Manager

المواصفات

الفئة

analytics

السعر

مضمَّن

الإصدار

1.0.0

المصدر

من الطرف الأول