واجهات API وحزم SDK والأتمتة

أنظمتك تستدعيه.
أو هو يستدعي أنظمتك.

واجهة REST API واحدة لكل كائن في الحساب، وحزم SDK للخادم بلغات Node وPHP وPython، وحزم SDK أصلية للجوال، وواجهة JavaScript API من جهة العميل، وخادم MCP للمساعدين. ثم قواعد أتمتة وتقارير مجدولة تستمر في العمل حين لا يكون أحد قد فتح لوحة التحكم.

اقرأ الوثائق ←احجز عرضًا

4.8

4.6

1معرّف واحد، على موقعك

RESTمن جهة الخادم

Northwindابدأ مجانًا

للفرق التي تتجاوز 200

تسعير حسب الحجم، لا الخطة المبدئية.

اطّلعت على Enterprise مرتين هذا الأسبوع. هذه تكلفته مع 240 مقعدًا.

اعرف سعرك

مختار لفريقكلأنك تقيّم Enterprise

Marco Reyesالزيارة الثالثة · التجربة تنتهي الجمعةشاهد Enterprise240 مقعدًالا بطاقة مسجلةvis_8f21c6

قُرّر على خادمك قبل أن تُعرض الصفحة — لم يرَ Marco السعر المبدئي قط.

2المعرّف نفسه، في تطبيقك

SDK أصليةiOS / ANDROID

خزانة خوادم — خادمكأُجيب خلال 40 مللي ثانية، من مركز بياناتكdecide(user)node / php / pythonplan: "volume", seats: 240

استدعاء https واحد

9:41

Northwind

لحجم فريقك

تسعير حسب الحجم لـ 240 مقعدًا

العرض الذي كنت تقرؤه الليلة الماضية.اطّلع على عرض السعر

المقاعد المستخدمة240

مدير حسابكRosa

الرئيسيةالاستخدامالفوترةأنت

القرار نفسه، يطلبه الهاتف — دون WebView، والمحرك هو خادمك.

3من وكيل إلى وكيل

MCPOAUTH 2.1

مساعدكPersonyze MCP · متصل

مَن تنتهي تجربته هذا الأسبوع دون بطاقة مسجلة؟

personyze › list_visitors3 تطابقات · 240 مللي ثانية

ثلاثة. Marco Reyes هو من يستحق مكالمة اليوم — الزيارة الثالثة هذا الأسبوع، وسُعّر بالفعل على 240 مقعدًا، وتجربته تنتهي الجمعة.

Marco Reyesالجمعة · 240 مقعدًاvis_8f21c6

Priya Raghavanالجمعة · 40 مقعدًاvis_1c07ba

Tom Okaforالأحد · 12 مقعدًاvis_4de920

قراءة + كتابة، بنطاق محددصلاحياتك، قابلة للإلغاء بنقرة واحدة

القرار نفسه، مُسلَّم إلى مساعد — عبر بروتوكول مفتوح، لا شاشة منسوخة.

4إلى فريقك

قاعدة أتمتةWEBHOOK

#new-businessقاعدة أتمتة

يبدو أن Marco Reyes جاهز للشراء.

الزيارة الثالثة هذا الأسبوع، وسُعّر على 240 مقعدًا، ولا بطاقة مسجلة بعد — وتجربته تنتهي الجمعة.

التجربة تنتهي خلال يومينشاهد Enterprise مرتينلا بطاقة مسجلة

افتح حسابه

POST /your-webhookأطلقته قاعدة، دون أن يراقب أحد لوحة التحكم

القاعدة التي انطلقت

التجربة تنتهي خلال يومينوشاهد Enterpriseولا بطاقة

تُفحص كل ساعة. لم يكن أحد قد فتح لوحة التحكم.

Rosa Ibarraمديرة حساب · نُبّهت بعد ثلاث دقائقاسم، لا تقرير

القرار نفسه، مرة أخيرة — كسبب للشخص القادر على رفع سماعة الهاتف.

5وأيّها فاز

A / Bتقرير مجدول

Northwindنظرة عامةالحملاتالتجاربالتقاريرالإعدادات

اختبار أسعار Enterprise

النسخة A

تجاوزت Growth بـ 40 مقعدًاهذه تكلفة التخلص من القلق

4.1%إلى عرض السعر

الفائزالنسخة B

تسعير حسب الحجم لـ 240 مقعدًاالخطة المناسبة لفرق بحجمك

6.8%إلى عرض السعر

+66%2,140 زائرًا · ثقة 97% · حُسم في اليوم 6دالّ إحصائيًا

personyze.decide(user)يعرض الفائز من الآن فصاعدًا، دون إعادة نشر

تقرير مجدولالاثنين 08:00 · إلى 4 أشخاص، دون أن يصدّره أحد

48عروض أسعار أُنشئت+22%11تجارب تحوّلت+4$18,400إيرادات جديدة+31%

القرار نفسه، مختبَر ومحسوب — فائز واحد، يعرضه كل المستدعين في آن واحد.

محرك واحد، ومستدعون كثر

استدعه من أي مكان. القرار نفسه.

نموذج الجماهير والاستهداف والتقارير هي نفسها التي تستخدمها لوحة التحكم. ما يتغير هو من يسأل وما الذي يعرض الإجابة.

من خادمكاستدعاء واحد يعود، وأنت تعرضه — دون أي متصفح

من داخل تطبيقكالقرار نفسه، بصيغة JSON، على iOS وAndroid

من مساعدالكائنات نفسها مجددًا، هذه المرة كأدوات

خادمك يسأل

POST /rest/decide { "user_id": "u_8241", "session_id": "s_5f3a91", "page": "/pricing" }

المستدعي يقدّم المعرّف ويحمل الجلسة. تنتهي صلاحيتها بعد 90 دقيقة.

Personyze يجيب

{ "actions": [{ "audience": ~~"Enterprise، قيد التقييم"~~, "show": ~~"pricing-cta-b"~~, "goal": ~~"demo_request"~~ }], "dismissed": [~~"welcome-bar"~~] }

أي جمهور تطابق، وما الذي يُعرض، وما الذي أُغلق من قبل. وأنت تعرضه.

يعرضه تطبيقك

iOS وAndroid وReact Native الأصلية، لكلٍّ منها واجهات API خاصة للتتبع والشروط والإجراءات.

نقطة النهاية نفسها، والبنية نفسها

{ "actions": [{ "type": ~~"card"~~, "slot": ~~"home_top"~~, "items": [ … ] }] }

لا WebView ولا HTML. يتلقى التطبيق JSON ويرسمه بمكوناته الخاصة، فيبقى مظهره مظهر تطبيقك.

مساعدكمتصل عبر MCPقراءة + كتابة، بنطاق محدد

أي الحملات خسرت زيارات الأسبوع الماضي، وما الذي ينبغي أن أختبره بعد ذلك؟

get_traffic_analyticsتراجعت ثلاث، وكانت صفحة الأسعار الأكثر تراجعًا. وهي أيضًا الصفحة التي يصل إليها جمهور Enterprise لديك أكثر من غيرها. يمكنه إعداد هذا الاختبار وإرساله إلى بيئة الاختبار دون أن يفتح أحد لوحة التحكم.

صفحة الأسعار−18%

الدفع−12%

الفئة−6%

الكائنات نفسها التي تتيحها REST API — هذه المرة كأدوات، بالصلاحيات التي منحتها.

حزم SDK ونقاط النهاية

ثلاث نسخ من نقطة نهاية واحدة.

من جهة الخادم، أو في التطبيق، أو في الصفحة. اختر ما يناسب المكان الذي يجب أن يصل إليه القرار.

من جهة الخادم

Node وPHP وPython

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

decide()identify()track()

الجوال

iOS وAndroid وReact Native

حزم SDK أصلية بواجهات API خاصة للتتبع والشروط والإجراءات — الجماهير نفسها والأهداف نفسها كما في الموقع، تُعاد بصيغة JSON ترسمها مكوناتك.

التتبعالشروطالإجراءات

في الصفحة

JavaScript API من جهة العميل

اقرأ الملف الشخصي، أو أطلق هدفًا، أو اطلب قرارًا، أو أعد تشغيل موضع عرض من السكربت الخاص بك — مفيد حين تكون الصفحة تطبيقًا أحادي الصفحة ولا يُعاد تحميل شيء.

الملف الشخصيالأهدافمواضع العرض

1,500+

علامات تجارية تشغّل Personyze في بيئة الإنتاج

4.6/5

G2CapterraCrozdesk

متوسط التقييم على G2 وCapterra وCrozdesk

لا تصدير

لا مزامنة ليلية، ولا نسخة ثانية من الملف الشخصي تتقادم

مفتاح واحد

كل ما تعدّله لوحة التحكم، عبر نقطة نهاية واحدة.

ليست موجز قراءة فقط لما حدث. بل الكائنات نفسها، تُنشأ وتُعدَّل من كودك.

الحملات والإجراءاتالحملات · الإجراءاتالجماهير والأعضاءالجماهير · الأعضاءالزوار وحقولهمالزوار · الحقولكتالوجات المنتجات والمقالاتالمنتجات · المقالاتالأهداف والتحويلاتالأهداف · التحويلاتالتقارير والتحليلاتالتقارير · التحليلات

الحملات · الإجراءاتقراءةإنشاءتعديل

كل ما تعدّله شاشة الحملات، من كودك.

أنشئ حملة، وأضف إليها إجراءات، وغيّر محتواها، وفعّلها. إنها السجلات نفسها التي تكتبها لوحة التحكم، مع نظام الإصدارات نفسه، لذا يمكن استعادة تعديل أجراه سكربت تمامًا مثل تعديل أجراه شخص.

ما يمكنك فعله4

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

من المفيد معرفته2

الإصدارات تُدار لكل إجراء — تغيير المحتوى ينشئ إصدارًا، والإصدار المنشور هو ما يحصل عليه الزوار.
الكتابة المباشرة في قاعدة البيانات لا تُنسخ أبدًا — استخدم API أو لوحة التحكم، وإلا سيستمر الزوار في رؤية المحتوى القديم.

GET POST PUT /rest/campaigns

الجماهير · الأعضاءقراءةإنشاءتعديل

شرائح تبنيها، أو شرائح تغذّيها.

يمكن أن يكون الجمهور مجموعة شروط يقيّمها المحرك، أو قائمة ثابتة يحدّثها نظامك بإضافة الأعضاء وإزالتهم كلما استوفى الأشخاص المعايير. ويمكن استهداف أي شيء على المنصة بكلا النوعين.

ما يمكنك فعله3

حدّد الشروط على السلوك أو حقول CRM أو الموقع الجغرافي أو الجهاز أو قيمة السلة.
أرسل الأعضاء واحدًا تلو الآخر أو دفعة واحدة، وأزلهم حين لا يعودون مستوفين للمعايير.
جمّع الصفحات لتعني القاعدة "صفحات الأسعار" بدلًا من قائمة روابط.

من المفيد معرفته2

الجمهور الثابت مسؤوليتك — لا شيء ينهي عضوية الأعضاء نيابة عنك.
الشروط هي شروط لوحة التحكم — المعاملات نفسها، فتُقرأ الشريحة بالطريقة نفسها في المكانين.

POST /rest/audience_members

الزوار · الحقولقراءةإنشاءتعديل

ملف شخصي واحد، أيًّا كان من يطلبه.

اقرأ ملفًا شخصيًا، أو اكتب فيه حقولك الخاصة، أو سلّم المحرك هوية من CRM الخاص بك، ليتحدث الموقع والتطبيق والبريد الإلكتروني وWebhook عن الشخص نفسه بدلًا من أربع جلسات مجهولة.

ما يمكنك فعله3

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

من المفيد معرفته2

الهوية هي مفتاح الربط — مرّر الهوية نفسها في كل مكان يكن هناك ملف واحد؛ ومرّر هويات مختلفة تكن هناك ملفات عدة.
جلسة الخادم تدوم 90 دقيقة من آخر استدعاء، مرتبطة بتلك الهوية.

POST /rest/identify

المنتجات · المقالاتقراءةإنشاءتعديل

كتالوجك، مرتّب لشخص واحد.

أرسل المنتجات أو المقالات، وأبقِ الأسعار والمخزون محدّثة، ودع محرك التوصيات يرتّب وفق ما تبيعه فعلًا اليوم، لا وفق تصدير ليلي لما بعته أمس.

ما يمكنك فعله3

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

من المفيد معرفته2

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

PUT /rest/products

الأهداف · التحويلاتقراءةإنشاءتعديل

ما يُحتسب، مُبلَّغ عنه من حيث يحدث.

حدّد ما هو التحويل، ثم أبلغ عنه من خادمك حين يحدث في مكان لم يكن المتصفح ليراه أبدًا — طلب هاتفي، أو عقد موقَّع، أو استرداد يجب أن يُسقط تحويلًا من العداد.

ما يمكنك فعله3

أبلغ عن تحويل بقيمة وعملة، من أي مستدعٍ.
انسبه إلى هوية الزائر التي تمرّرها في كل مكان آخر.
اقرأ الأهداف لتحسب لوحة معلوماتك ولوحتنا الشيء نفسه.

من المفيد معرفته2

الهدف المُبلَّغ عنه مرتين يُحتسب مرتين — أرسل مفتاح عدم التكرار الخاص بك إن كان المستدعي قد يعيد المحاولة.
الإيرادات اختيارية لكنها ما يحوّل نتيجة اختبار A/B إلى رقم يتصرف بناءً عليه أحد خارج التسويق.

POST /rest/goal_reached

التقارير · التحليلاتقراءةإنشاءتعديل

الأرقام نفسها التي تعرضها الشاشات.

أداء الحملات، والزيارات، وإحصاءات المنتجات، ونتائج اختبارات A/B، بتعريفات المقاييس التي تستخدمها لوحة التحكم. اسحبها عند الطلب، أو أرسلها وفق جدول إلى أشخاص لن يسجلوا الدخول أبدًا.

ما يمكنك فعله3

اسحب تقريرًا بالمعرّف، لأي نطاق تتيحه الشاشة.
جدول تقريرًا يوميًا أو أسبوعيًا أو لكل حملة، إلى قائمة عناوين.
اقرأ نتائج A/B بما فيها مستوى الثقة، لتقرر أدواتك بنفسها.

من المفيد معرفته2

للقراءة فقط، عن قصد — الأرقام مشتقة، فلا شيء هنا لتكتبه.
التعريفات مطابقة للوحة التحكم — الرقم الذي تسحبه هو الرقم الذي يراه غيرك على الشاشة، وهذا بيت القصد.

GET /rest/reports/:id

يستمر في العمل

قواعد واختبارات وتقارير لا تحتاج إليك.

الأجزاء التي يجب أن تحدث دون أن يقرر أحد حدوثها — والفائز يُنشر من تلقاء نفسه بمجرد أن يفوز.

قواعد الأتمتة

إذا حدث هذا، فافعل ذاك

راقب شريحة أو هدفًا أو موجزًا وتصرّف بناءً عليه — فعّل حملة، أو انقل شخصًا إلى قائمة، أو أرسل حدثًا إلى أداة التحليلات. تعمل القاعدة وفق الجدول الذي تحدده، لا حين يتذكر أحد.

المشغّلاتالشروطالإجراءات

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

يصل قبل الاجتماع

التقرير الذي كنت ستصدّره، يُرسل وفق جدول إلى من يطلبونه — بالتقسيمات نفسها وتعريفات المقاييس نفسها كالشاشة التي جاء منها.

يوميأسبوعيلكل حملة

التجارب

نسختان، وفائز واحد

قسّم الزيارات بين النسخ، وتابع الأرقام حيث تتابعها أصلًا، ودع المحرك يعرض الفائز حين يتأكد. يبدأ كل المستدعين عرضه في اللحظة نفسها — لا شيء لإعادة نشره، ولا شيء لتتذكره.

تقسيمدلالة إحصائيةعرض تلقائي

المساعدون

أو دع مساعدًا يطرح الأسئلة.

يضع خادم MCP الحساب خلف بروتوكول مفتوح، ليتمكن Claude أو ChatGPT أو أي عميل MCP من قراءته وتعديله بالمحادثة — بالصلاحيات التي منحتها، وقابلًا للإلغاء بمفرده.

MCP

اسأله عن الحساب

«أي الحملات تراجعت هذا الشهر؟» — فيقرأ أرقام الأداء نفسها التي تعرضها لوحة التحكم، لا لقطة شاشة لها.

MCP

دعه يُعدّ المسودة

مسودة حملة، أو جمهور من وصف، أو مجموعة صفحات، أو هدف. تعود كمسودة تفتحها وتراجعها، لا كشيء منشور بالفعل.

MCP

دعه يتصرف بناءً على ما وجده

نقل شخص إلى جمهور، أو تفعيل حملة، أو تغيير جزء من المحتوى، أو فتح تذكرة دعم — كلٌّ منها أداة كان لا بد من منحه إذنًا بها.

تعرّف على خادم MCP ←

الوصول

مدخلان، يُلغيان بشكل منفصل.

ما يصادق على الخادم ليس ما يصادق على المساعد، وهذا مقصود.

لكودكمفتاح API للخادم

مكانهعلى خادمك، لا في صفحة أبدًا

نطاقهكل كائن في الحساب

التدويردون المساس بمسارات الكود

لمساعدتفويض OAuth 2.1

مكانهلدى عميل MCP، لا لديك أبدًا

نطاقهالأدوات التي سمحت بها فقط

الإلغاءبمفرده، دون تدوير المفتاح

في الحالتين، يعمل قرار الخادم ضمن نافذة جلسة مدتها 90 دقيقة مرتبطة بالهوية التي تمرّرها — فيمكن للهاتف والصفحة وWebhook أن تكون كلها الزيارة نفسها.

أسئلة

ما يسأل عنه الناس قبل ربطه.

بالإجابات التي كنا سنقدمها في مكالمة.

هل يجب أن أستخدم وسم JavaScript أصلًا؟

لا. تتخذ REST API وحزم SDK للخادم القرار من خادمك وتسلّمك المحتوى لتعرضه — لا شيء يجب أن يعمل في المتصفح. معظم الحسابات تستخدم الاثنين: الوسم لإشارات السلوك، وAPI للقرارات التي تريد التحكم بها.

كيف يبقى الشخص نفسه هو الشخص نفسه؟

تمرّر هوية — معرّف المستخدم لديك، أو بصمة البريد الإلكتروني، أو أيًّا كان ما يسميه نظامك به. كل مستدعٍ يمرّر الهوية نفسها يقرأ ملفًا شخصيًا واحدًا ويكتب فيه، وهذا ما يمنع الموقع والتطبيق من تقديم عرضين مختلفين.

هل يمكنني إنشاء الحملات عبر API، أم قراءتها فقط؟

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

ماذا يحدث إن كانت خدمتكم بطيئة أو غير متاحة؟

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

هل MCP منتج مختلف عن API؟

لا — إنه الحساب نفسه خلف بروتوكول مفتوح. الأدوات التي يراها المساعد تقابل الكائنات نفسها التي تتيحها REST API، بصلاحيات تمنحها ويمكنك إلغاؤها بمعزل عن مفتاح API.

هل تحتاج قواعد الأتمتة والتقارير المجدولة إلى شخص مسجّل الدخول؟

هذا هو الغرض منها تحديدًا. تُقيَّم القواعد وفق جدولها، وتُرسل التقارير وفق جدولها، سواء فتح أحد لوحة التحكم أم لا.

أنظمتك تستدعيه.أو هو يستدعي أنظمتك.

تسعير حسب الحجم، لا الخطة المبدئية.

تسعير حسب الحجم لـ 240 مقعدًا

يبدو أن Marco Reyes جاهز للشراء.

استدعه من أي مكان. القرار نفسه.

ثلاث نسخ من نقطة نهاية واحدة.

Node وPHP وPython

iOS وAndroid وReact Native

JavaScript API من جهة العميل

كل ما تعدّله لوحة التحكم، عبر نقطة نهاية واحدة.

كل ما تعدّله شاشة الحملات، من كودك.

شرائح تبنيها، أو شرائح تغذّيها.

ملف شخصي واحد، أيًّا كان من يطلبه.

كتالوجك، مرتّب لشخص واحد.

ما يُحتسب، مُبلَّغ عنه من حيث يحدث.

الأرقام نفسها التي تعرضها الشاشات.

قواعد واختبارات وتقارير لا تحتاج إليك.

إذا حدث هذا، فافعل ذاك

يصل قبل الاجتماع

نسختان، وفائز واحد

أو دع مساعدًا يطرح الأسئلة.

اسأله عن الحساب

دعه يُعدّ المسودة

دعه يتصرف بناءً على ما وجده

مدخلان، يُلغيان بشكل منفصل.

ما يسأل عنه الناس قبل ربطه.

اربطه مرة واحدة. واستدعه من كل مكان.

أنظمتك تستدعيه.
أو هو يستدعي أنظمتك.