اجعل Personyze يعمل في دقائق.
مرجع خطوة بخطوة للمطوّرين والفرق التقنية — ثبّت كود التتبع، وحدّد placeholders المحتوى، واضبط الأهداف، واربط مكدّس بياناتك.
ابدأ الآن →1ثبّت Personyze على موقعك
لتفعيل التخصيص، يجب أن تثبّت مقطع التتبع على كل صفحة من موقعك. اختر الطريقة التي تتطابق مع منصّتك.
الخيار 1: Google Tag Manager (GTM)
الخيار A: HTML مخصّص (يدوي)
أنشئ tag «Custom HTML»، ألصق فيه مقطع JS Personyze الكامل، وحفّزه على «All Pages».
الخيار B: تكامل القالب (الأسهل)
ابحث في GTM Community Gallery عن «Personyze Tracking Code». أضفه، أدخل Site ID الخاص بك، وحفّزه على «All Pages». يبقي هذا حاويتك نظيفة.
الخيار 2: HTML قياسي
ألصق المقطع مباشرة في tag <head> ملف القالب الرئيسي لديك. تأكّد من وضعه عالياً قدر الإمكان، مباشرة بعد meta tags الخاصّة بـcharset وviewport.
الخيار 3: تعليمات CMS
theme.liquid. ألصق الكود قبل </head>.header.ftl القالب.2حدّد placeholders (المناطق)
Placeholders هي مناطق على موقعك يحقن فيها Personyze محتوى. استخدام placeholders بدلاً من النوافذ المنبثقة يجعل التخصيص يبدو أصلياً.
الخيار A: المحدّد المرئي (بلا كود)
- أنشئ حملة جديدة وأضف إجراء «Banner».
- في إعدادات العرض، اختر «Show in placeholder».
- انقر «Find on pages» لفتح المحاكي.
- تنقّل في موقعك وانقر ببساطة على العنصر (مثلاً، Hero Banner) الذي تريد تحويله إلى منطقة.
الخيار B: محدّدات CSS اليدوية
أدخل IDs أو Classes يدوياً مثل #home-hero أو .sidebar-widget.
الحد الأقصى للإجراءات المتزامنة: يتيح تكديس بانرات متعدّدة عمودياً (مثلاً، اعرض البانر A والبانر B).
3أهداف التحويل وتتبّع KPI
تتبّع ROI بتحديد شكل النجاح. يمكنك تتبّع نقرات بسيطة أو بيانات إيرادات معقّدة.
1. أنواع الأهداف
- وجهة URL: يُحفَّز عندما يزور المستخدم URL محدّداً مثل
/thank-youأو/order-confirmed. مثالي لتوليد العملاء المحتملين. - تتبّع النشاط: تتبّع تفاعلات محدّدة مثل النقر على «Add to Cart»، التمرير فوق قائمة، أو مشاهدة فيديو. استخدم المحدّد المرئي لاختيار العنصر.
- Grab Data (الإيرادات): استخرج قيماً ديناميكية (مثلاً، «$150.00») من HTML الصفحة أو كوكي. ضروري لحساب ROI والإيرادات.
- أحداث خارجية: التقط تلقائياً الأحداث المدفوعة إلى GTM Data Layer أو أحداث Google Analytics دون إعداد إضافي.
2. الإعدادات المتقدّمة
- قيمة الهدف: اضبط قيمة ثابتة (مثلاً، عميل محتمل = $10) أو قيمة ديناميكية (تُلتَقط من الصفحة، مثل إجمالي الشراء).
- التكرار: اضبط «Once per visit» للعملاء المحتملين (لتجنّب العدّ المكرّر عند التحديث) أو «No Limit» للمشتريات (لتتبّع كل معاملة).
3. مقاييس التجارة الإلكترونية
إذا فعّلت تتبّع المنتجات/الإيرادات، يحسب Personyze تلقائياً إجمالي الإيرادات، AOV (متوسّط قيمة الطلب)، ومعدّل المساهمة (كم من الإيرادات تأثّرت بالتخصيص).
4استخرج بيانات الموقع (المتغيّرات)
حسّن الاستهداف بـ«التقاط» البيانات من متصفّح الزائر أو جلسة الصفحة لبناء ملف مستخدم غنيّ.
مصادر البيانات المدعومة
يمكنك إنشاء «User Profile Variable» من أيّ من هذه المصادر:
- عناصر الصفحة (HTML): Scrape النصّ المرئي على الصفحة (مثلاً، «مرحباً، [الاسم]» أو «النقاط: 500»). استخدم المحدّد المرئي.
- الكوكيز: اقرأ القيم المخزّنة في كوكيز المتصفّح (مثلاً،
login_status,affiliate_id). - متغيّرات JavaScript: اقرأ متغيّرات JS العامّة (مثلاً،
window.userLevelأوdataLayer[0].userId). - Meta Tags: اقرأ meta tags الخاصة بـSEO لفهم سياق المحتوى (مثلاً،
<meta name="author" content="John">). - بارامترات URL: اقرأ UTMs أو query strings (مثلاً،
?campaign=summer_sale).
5CRM داخلي وتكامل البيانات
اربط قواعد بياناتك الداخلية (CRM مخصّص، SQL، ERP) بسلوك الموقع في الوقت الفعلي.
طرق التكامل:
- رفع CSV: ارفع يدوياً قوائم IDs المستخدمين + السمات (حالة VIP، القطاع، المشتريات offline).
- تدفّق مباشر: زامن عبر URL Google Sheet أو تدفّق HTTP يُحدَّث تلقائياً.
- API: استخدم Personyze API لدفع تحديثات المستخدم في الوقت الفعلي من الـbackend.
6تدفّق المنتجات والمحتوى
هذا مطلوب لتشغيل توصيات المنتجات و توصيات المقالات/المحتوى.
1. حضّر تدفّقك
يقبل Personyze تدفّقات CSV أو XML أو JSON أو RSS أو Atom أو Google Merchant.
2. اربط أعمدتك
انتقل إلى Settings > Data & Content > Product Feed. يجب أن تربط الحقول في تدفّقك بسمات Personyze:
- ID داخلي: يجب أن يتطابق مع ID المنتج/المقالة الموجود على صفحتك المباشرة (SKU/ID) أو متغيّر GTM. يتيح هذا لـPersonyze معرفة العنصر الذي يشاهده المستخدم حالياً.
- العنوان: اسم المنتج أو المقالة.
- URL الصورة: للعرض في ودجات التوصية.
- URL الرابط: إلى أين تنقر التوصية.
- السعر / الفئة: للتصفية والمنطق.
طرق بديلة
- Site Crawler: إذا لم يكن لديك تدفّق، تواصل مع account manager لإعداد crawler يبني التدفّق من موقعك تلقائياً.
- رفع SFTP: لكتالوجات enterprise الكبيرة، اطلب من account manager تفعيل رفع SFTP الآمن.
7الخصوصية وOpt-Out
اضمن الامتثال لـGDPR/CCPA بالتكامل مع Consent Management Platform (CMP) لديك.
JavaScript API:
استخدم هذه الأوامر داخل منطق «Accept» أو «Decline» الخاص ببانر الكوكيز لديك:
_S_T.system.off(): أوقف التتبع. استدعِ هذا إذا رفض المستخدم الكوكيز. لن تُرسَل أيّ بيانات._S_T.system.on(): ابدأ التتبع. استدعِ هذا عندما يقبل المستخدم الكوكيز._S_T.system.is_on(): يُعيدtrue/falseللتحقّق من الحالة الحالية.
الوضع الصارم: يمكنك تكوين Personyze للعمل في «الوضع الصارم» حيث لا يتتبّع IPs أو PII افتراضياً حتى تُعطى الموافقة الصريحة عبر الأمر أعلاه.
8تكاملات الطرف الثالث
تكاملات plug-and-play مع الأدوات التي تستخدمها بالفعل. للوصول إليها، انتقل إلى: Settings > Integrations.
التحليلات والبيانات
أرسل بيانات الجمهور والحملات الخاصة بـPersonyze إلى أدوات التحليل لديك للتقارير.CRM والتسويق
مزامنة ثنائية الاتجاه للعملاء المحتملين وسمات المستخدمين بين Personyze وCRM الخاص بك.بيانات ABM وB2B
أثرِ حركة المرور المجهولة بيانات اسم الشركة والقطاع والإيرادات.البنية التحتية
اربط أنظمة الـbackend والمصادقة وأتمتة سير العمل.9تكوين مرسل البريد الإلكتروني
اضبط كيف يرسل Personyze رسائل البريد الإلكتروني المحفّزة والنشرات الإخبارية لديك.
الخيار A: المرسل الافتراضي (Amazon SES)
افتراضياً، يستخدم Personyze Amazon SES. يمكنك تفويض عنوان «From» خاصّ بك (مثلاً، info@yourdomain.com).
- أضف البريد الإلكتروني المرغوب في إعدادات Personyze.
- ستستلم طلب تحقّق من AWS.
- التوصية: تواصل مع account manager للحصول على سجلّات DKIM لرفعها إلى DNS الخاص بك لتسليم أفضل.
الخيار B: SMTP مخصّص
استخدم خادم البريد الخاص بك (SendGrid, Mailgun, Outlook، إلخ) للتحكّم الكامل.
- اختر «Mail provider (SMTP)».
- أدخل Host، Port (مثلاً، 465 أو 587)، User، وPassword.
الخيار C: Webhook (HTTP POST)
أرسل payload بيانات البريد الإلكتروني إلى endpoint الخاص بك أو أداة الأتمتة (مثل Zapier) لتحفيز الإرسال خارجياً.
10إعداد إشعارات Web Push
لتفعيل إشعارات الدفع في المتصفّح، يجب أن تثبّت Service Worker.
1. نزّل Service Worker
نزّل الملف القياسي: sw.js
2. ثبّت على خادمك
- السيناريو A (لا يوجد Service Worker حالياً): ارفع ملف `sw.js` إلى الدليل الجذر لموقعك (مثلاً، `yoursite.com/sw.js`).
- السيناريو B (لديك Service Worker بالفعل): لا تستبدل ملفك. بدلاً من ذلك، اطلب من مطوّرك دمج محتويات `sw.js` الخاص بنا في أعلى ملف service worker الموجود لديك.
ملاحظة: لا يمكن أن يكون لكل موقع إلا ملف Service Worker نشط واحد.
11Personyze REST API
ادمج Personyze برمجياً مع أنظمة الـbackend لديك لقراءة أو كتابة البيانات.
القدرات
- بيانات المستخدم: ادفع بيانات CRM أو حدّث ملفات المستخدمين.
- المحتوى: حدّث كتالوج المنتجات أو المحتوى لديك.
- الأحداث: أبلغ عن التحويلات offline أو أحداث الـbackend.
12Mobile SDK (iOS وAndroid)
وسّع التخصيص إلى تطبيقاتك المحمولة الأصلية.
الميزات
- ملف موحّد: تتبّع المستخدمين عبر الويب والتطبيق.
- الاستهداف الأصلي: استخدم سلوكيات خاصة بالتطبيق للتقسيم.
- إشعارات الدفع: حفّز تنبيهات مخصّصة.
13Single Sign-On (SSO)
أدِر الوصول إلى لوحة Personyze باستخدام مزوّد الهوية enterprise الخاص بك.
إدارة مستخدمين مركزية، وصول بنقرة واحدة للموظفين، وامتثال أمني مُعزَّز.
المزوّدون المدعومون
- Auth0
- Okta
- OneLogin
- Xecurify
تعليمات الإعداد
- انتقل إلى Settings > Integrations > Single Sign On في وحدة تحكّم Personyze.
- اختر مزوّدك من القائمة.
- أدخل URL البيانات الوصفية المطلوب أو تفاصيل الشهادة من IdP الخاص بك.
- احفظ واختبر الاتصال.
أسئلة الإعداد، مُجابة.
الأشياء التي تسألها الفرق قبل الانتقال للوضع المباشر. لأي شيء آخر، فريقنا على بعد رسالة واحدة.
هل سيُبطئ كود التتبع موقعي؟
لا. يُحمَّل tag Personyze بشكل غير متزامن، أي أنّه يعمل في الخلفية ولا يمنع عرض المحتوى الرئيسي لصفحتك. يضمن هذا أنّه يؤثّر بشكل لا يُذكَر على سرعة موقعك أو Core Web Vitals.
هل يمكنني التثبيت عبر Google Tag Manager؟
نعم. هذه هي الطريقة الموصى بها. يمكنك استخدام قالب GTM الرسمي الخاص بنا (ابحث عن «Personyze») أو إنشاء tag HTML مخصّص. تأكّد فقط من ضبط الـtag لينطلق على «All Pages».
هل Personyze متوافق مع GDPR؟
نعم. نوفّر أدوات لمساعدتك على الامتثال، بما في ذلك «الوضع الصارم» الذي يعطّل التتبع حتى تُعطى الموافقة. يمكنك أيضاً تحفيز التتبع فقط بعد أن يقبل المستخدم الكوكيز عبر CMP (Consent Management Platform) لديك.
كيف أزامن كتالوج منتجاتي؟
يمكنك رفع Product Feed (CSV، XML، JSON) أو المزامنة مباشرة من Google Merchant Center. إذا لم يكن لديك تدفّق، يمكن لـSite Crawler الخاص بنا scrape بيانات المنتجات من صفحاتك تلقائياً.
ماذا لو كان لديّ Single Page Application (SPA)؟
يدعم Personyze تماماً SPAs (React، Angular، Vue). يكتشف متعقّبنا تلقائياً «virtual pageviews» عندما يتغيّر URL دون إعادة تحميل كاملة، مما يضمن تتبّع السلوك بشكل صحيح عبر الجلسة.
هل يمكنني تتبّع المستخدمين عبر الأجهزة؟
نعم. إذا سجّل مستخدم الدخول على كل من Desktop وMobile (أو نقر على رابط بريد إلكتروني على كليهما)، يدمج Personyze ملفّاتهم باستخدام معرّف فريد (مثل User ID أو Email Hash)، مما يمنحك رؤية موحّدة لرحلتهم.
هل أحتاج إلى مطوّر لإعداد الأهداف؟
ليس بالضرورة. يمكن إعداد أهداف بسيطة مثل «URL Visits» أو «Button Clicks» باستخدام واجهتنا المرئية. قد تتطلّب الأهداف الأكثر تعقيداً، مثل التقاط قيم الإيرادات الديناميكية، معرفة CSS selector أو اسم متغيّر JavaScript.
كيف يعمل تكامل CRM؟
نزامن البيانات بطريقة ثنائية الاتجاه. يمكنك دفع سلوك الموقع (مثلاً، «شاهد صفحة التسعير») إلى CRM الخاص بك، وسحب سمات CRM (مثلاً، «عميل VIP») إلى Personyze لتخصيص تجربة الموقع.
هل يمكنني استخدام مرسل البريد الإلكتروني الخاص بي؟
نعم. بينما نوفّر مرسلاً افتراضياً عبر Amazon SES، يمكنك تكوين خادم SMTP الخاص بك (SendGrid، Mailgun، Outlook) في الإعدادات لضمان قدوم رسائل البريد الإلكتروني من نطاقك الخاص مع تحكّم كامل في التسليم.
ماذا يحدث إذا غيّرت قالب موقعي؟
إذا غيّرت بنية HTML (CSS IDs أو Classes)، قد تتعطّل بعض placeholders أو قواعد «grab data». نوصي بفحص حملات Personyze لديك بعد أيّ إعادة تصميم رئيسية للموقع لضمان أنّ المحدّدات لا تزال صالحة.
هل يمكنني استبعاد حركة المرور الداخلية؟
نعم. يمكنك تصفية حركة المرور من عناوين IP محدّدة (مثل IP مكتبك) في إعدادات الحساب لكي لا تشوّش زيارات الموظفين على بيانات التحليلات.
هل يعمل التتبع offline؟
لتتبّع الويب، اتصال الإنترنت مطلوب. لكن إذا كنت تستخدم Mobile SDK الخاص بنا، يمكننا تخزين الأحداث محلياً على الجهاز ومزامنتها عندما يعود المستخدم للاتصال.
ما مدى أمان نقل البيانات؟
تُنقل جميع البيانات عبر تشفير HTTPS. نلتزم ببروتوكولات أمان صارمة، بما في ذلك الامتثال لـSOC 2، لضمان بقاء بيانات عملائك آمنة.
هل يمكنني إدارة نطاقات متعدّدة في حساب واحد؟
نعم. يدعم Personyze تتبّع نطاقات متعدّدة. يمكنك إدارة مواقع منفصلة تحت حساب واحد أو ربطها لمشاركة بيانات المستخدمين عبر نطاقات مختلفة (Cross-Domain Tracking).
ما هو «Service Worker» لإشعارات الدفع؟
Service Worker هو سكربت يعمل في خلفية المتصفّح. مطلوب لاستلام رسائل الدفع حتى عندما لا يكون المستخدم نشطاً على موقعك. يجب أن ترفع هذا الملف إلى الدليل الجذر لخادمك.
اجعل التخصيص مباشراً على موقعك.
لديك دليل الإعداد الكامل — ضعه الآن قيد العمل. ثبّت المتعقّب، حدّد placeholder الأول، وراقب موقعك يتكيّف مع كل زائر.