المنصّة
الأسعارتسجيل الدخولاحجز عرضاؑ تجريبياؑ
جميع الأدلةدليل الإعداد التقني

اجعل Personyze يعمل في دقائق.

مرجع خطوة بخطوة للمطوّرين والفرق التقنية — ثبّت كود التتبع، وحدّد placeholders المحتوى، واضبط الأهداف، واربط مكدّس بياناتك.

ابدأ الآن →
13 موضوع إعدادمقاطع للنسخ واللصقخيارات بلا كود
المتعقّب نشط
مزامنة البيانات
install.js
// أضف إلى كل صفحة
<script src="//counter.personyze.com/...js">
// تم تحميل متعقّب Personyze
✓ تم تثبيت التتبع
✓ التخصيص مباشر

1ثبّت Personyze على موقعك

لتفعيل التخصيص، يجب أن تثبّت مقطع التتبع على كل صفحة من موقعك. اختر الطريقة التي تتطابق مع منصّتك.

استرجع كودك: انتقل إلى Account Settings > General > Tracker Settings لنسخ Site ID الفريد ومقطع التتبع الخاصّين بك.

الخيار 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». يبقي هذا حاويتك نظيفة.

إعداد حاسم: اضبط Tag Firing Priority على مرتفع (مثلاً، 100) لتقليل وميض المحتوى. لـSPAs، تحقّق من أنّ «All Pages» يتعامل مع تغييرات السجلّ أو إذا كنت بحاجة إلى محفّز «History Change» محدّد.

الخيار 2: HTML قياسي

ألصق المقطع مباشرة في tag <head> ملف القالب الرئيسي لديك. تأكّد من وضعه عالياً قدر الإمكان، مباشرة بعد meta tags الخاصّة بـcharset وviewport.

الخيار 3: تعليمات CMS

WordPress: ثبّت إضافة «Personyze Personalization». تتطلّب App Password.
Shopify: حرّر theme.liquid. ألصق الكود قبل </head>.
Magento 2: Content > Configuration > HTML Head > Scripts.
Wix: Settings > Custom Code > Head > Load on all pages.
Squarespace: Settings > Advanced > Code Injection > Header.
Webflow: Project Settings > Custom Code > Head Code.
Weebly: Settings > SEO > Header Code.
Magnolia: احقن في header.ftl القالب.

2حدّد placeholders (المناطق)

Placeholders هي مناطق على موقعك يحقن فيها Personyze محتوى. استخدام placeholders بدلاً من النوافذ المنبثقة يجعل التخصيص يبدو أصلياً.

الخيار A: المحدّد المرئي (بلا كود)

  1. أنشئ حملة جديدة وأضف إجراء «Banner».
  2. في إعدادات العرض، اختر «Show in placeholder».
  3. انقر «Find on pages» لفتح المحاكي.
  4. تنقّل في موقعك وانقر ببساطة على العنصر (مثلاً، 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).
منطق متقدّم: يمكنك استخدام التعابير النمطية (Regex) لتنظيف البيانات المُلتَقطة (مثلاً، إزالة «أهلاً » لترك الاسم فقط) وضبط الثبات (احفظ هذه البيانات في الملف الدائم للمستخدم مقابل الجلسة فقط).

5CRM داخلي وتكامل البيانات

اربط قواعد بياناتك الداخلية (CRM مخصّص، SQL، ERP) بسلوك الموقع في الوقت الفعلي.

حاسم: كيف يعمل المطابقة لربط زائر مجهول ببيانات CRM التي رفعتها، يحتاج Personyze إلى معرّف مشترك (مفتاح). أوّلاً، يجب أن تحتوي قائمتك المرفوعة على مفتاح فريد (مثلاً، البريد الإلكتروني، CRM ID، أو رقم الولاء). ثانياً، هذا نفس المفتاح يجب أن يكون متاحاً على موقعك (في كوكي، URL، متغيّر JS، أو عنصر صفحة). أخيراً، يجب أن تعدّ قاعدة «Grab Data» (انظر الخطوة 4) لإخبار Personyze بمكان إيجاد هذا المفتاح على الموقع المباشر. بمجرّد أن «يلتقط» Personyze هذا المفتاح من زائر، يربط جلسته بملف CRM الغنيّ الذي رفعته.

طرق التكامل:

  • رفع 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 إلى أدوات التحليل لديك للتقارير.
Google Analytics
Segment
Tealium
Mixpanel

CRM والتسويق

مزامنة ثنائية الاتجاه للعملاء المحتملين وسمات المستخدمين بين Personyze وCRM الخاص بك.
Salesforce
HubSpot
Zoho
Pardot
ActiveCampaign

بيانات ABM وB2B

أثرِ حركة المرور المجهولة بيانات اسم الشركة والقطاع والإيرادات.
Clearbit
6sense
Leadfeeder
Albacross
ZoomInfo
LeadRebel
Demandbase

البنية التحتية

اربط أنظمة الـbackend والمصادقة وأتمتة سير العمل.
WordPress
Single Sign On
Webhooks
Zapier

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 لديك لقراءة أو كتابة البيانات.

التوثيق: اطّلع على مراجع API الكاملة هنا: دليل REST API

القدرات

  • بيانات المستخدم: ادفع بيانات CRM أو حدّث ملفات المستخدمين.
  • المحتوى: حدّث كتالوج المنتجات أو المحتوى لديك.
  • الأحداث: أبلغ عن التحويلات offline أو أحداث الـbackend.

12Mobile SDK (iOS وAndroid)

وسّع التخصيص إلى تطبيقاتك المحمولة الأصلية.

التوثيق: اعرض دليل إعداد SDK: دليل Mobile SDK

الميزات

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

13Single Sign-On (SSO)

أدِر الوصول إلى لوحة Personyze باستخدام مزوّد الهوية enterprise الخاص بك.

الفوائد:

إدارة مستخدمين مركزية، وصول بنقرة واحدة للموظفين، وامتثال أمني مُعزَّز.

المزوّدون المدعومون

  • Auth0
  • Okta
  • OneLogin
  • Xecurify

تعليمات الإعداد

  1. انتقل إلى Settings > Integrations > Single Sign On في وحدة تحكّم Personyze.
  2. اختر مزوّدك من القائمة.
  3. أدخل URL البيانات الوصفية المطلوب أو تفاصيل الشهادة من IdP الخاص بك.
  4. احفظ واختبر الاتصال.
الأسئلة الشائعة

أسئلة الإعداد، مُجابة.

الأشياء التي تسألها الفرق قبل الانتقال للوضع المباشر. لأي شيء آخر، فريقنا على بعد رسالة واحدة.

هل سيُبطئ كود التتبع موقعي؟

لا. يُحمَّل 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 الأول، وراقب موقعك يتكيّف مع كل زائر.

مجاني للبدء · بدون بطاقة ائتمان · إعداد في دقائق