# إطلاق رحلات العملاء باستخدام الدخول المستند إلى API
يسمح لك الدخول المستند إلى API (API-based Entry) بإطلاق رحلة عميل في اللحظة التي يقع فيها حدث تجاري معين. لبدء حملة، يجب عليك إرسال طلب API خاص.
## الإعداد
1. أنشئ رحلة باستخدام عنصر الدخول المستند إلى API (API-based Entry)
2. انقر نقرًا مزدوجًا على خطوة الدخول المستند إلى API. ستُفتح نافذة إعدادات الدخول.
3. يمكنك تعديل محتوى الإشعارات الفورية (push) والبريد الإلكتروني (email) في كل مرة يتم فيها إطلاق الرحلة باستخدام العناصر النائبة للمحتوى (content placeholders). يمكن تغيير قيمة كل عنصر نائب في الطلب. إذا لم تكن بحاجة إلى هذا الخيار، يمكنك تخطي هذه الخطوة.
> على سبيل المثال، أنت تنشئ رحلة لإعلام المشتركين عند إصدار حلقة بودكاست جديدة. باستخدام عنصر نائب للمحتوى، يمكنك تغيير عنوان البودكاست في كل مرة تطلق فيها الرحلة.
أولاً، أضف أسماء العناصر النائبة في نافذة إعداد الدخول المستند إلى API. يمكنك استخدام أي أسماء مناسبة لك.
الآن، أنشئ [إعدادًا مسبقًا (Preset)](/ar/product/content/presets/) للإشعار الفوري أو البريد الإلكتروني وأدرج العنصر النائب بدلاً من النص الذي تريد تعديله. يجب أن يكون العنصر النائب بأحد التنسيقات التالية حسب احتياجاتك:
* `{placeholder_name|format_modifier|}` – إذا لم يتم تحديد قيمة العنصر النائب عند إطلاق الحملة، سيرى المستخدمون مساحة فارغة في مكانه.
* `{placeholder_name|format_modifier}` – إذا لم يتم تحديد قيمة العنصر النائب ولم يتم تعيينها بالفعل لمستخدم (في حال استخدمت وسمًا (Tag) كعنصر نائب)، فلن يتم إرسال الرسالة.
مُعدِّلات التنسيق
* CapitalizeFirst – يحول الحرف الأول في قيمة العنصر النائب إلى حرف كبير؛
* CapitalizeAllFirst – يحول الحرف الأول في كل كلمة في قيمة العنصر النائب إلى حرف كبير إذا كانت القيمة تتكون من أكثر من كلمة واحدة؛
* UPPERCASE – يحول جميع الحروف إلى أحرف كبيرة؛
* lowercase – يحول جميع الحروف إلى أحرف صغيرة؛
* regular – يدرج قيمة العنصر النائب تمامًا كما هي محددة في الطلب، بدون أي تعديلات.
عند تكوين خطوة الإشعار الفوري (Push) أو البريد الإلكتروني (Email) في رحلتك، حدد الإعداد المسبق الذي تم إنشاؤه وقم بتشغيل خيار **تخصيص الرسالة بسمات الحدث (Personalize message with event attributes)**. حدد العناصر النائبة التي تريد تعديلها في الطلب عند إطلاق الرحلة. اختر **الدخول المستند إلى API (API-based Entry)** كمصدر واسم العنصر النائب كسمة ديناميكية:
انقر على **تطبيق (Apply)** لحفظ التغييرات.
4. في نافذة إعدادات الدخول، انسخ قالب الطلب لتعديله:
5. أضف فلاتر الجمهور إلى معامل `filter` باستخدام [لغة التجزئة (Segmentation language)](/ar/developer/api-reference/segmentation-filters-api/segmentation-language/). يرجى ملاحظة أنك تحتاج إلى إعداد [الوسوم (Tags)](/ar/developer/guides/audience-and-segmentation/tags/) اللازمة مسبقًا.
على سبيل المثال، إذا كنت ترغب في استهداف الرحلة للمستخدمين الذين أضافوا عنصر _Socks_ إلى _Wishlist_ الخاصة بهم، فيجب أن تبدو قيمة `filter` كما يلي:
```
"filter": "A("12345-12345") * "T("Wishlist", EQ, "Socks")"
```
في هذا المثال، يجب أن يكون لديك وسم _Wishlist_ مهيأ في تطبيقك.
6. إذا قمت بإعداد العناصر النائبة، فحدد المحتوى المطلوب كقيم لها:
7. إذا تم تمكين خيار **حدود معدل الرسائل (Message Rate Limits)**، فسيتم تحديد عدد المستخدمين الذين يدخلون الرحلة في وقت واحد كل ثانية. يمكنك استخدام القيمة الافتراضية البالغة 5000 مستخدم في الثانية أو تعيين رقم آخر.
8. إذا كنت تخطط لإعادة تشغيل حملتك بشكل متكرر ولا تريد أن يدخل نفس المستخدمين الرحلة عدة مرات، فقم بتعيين [تحديد التكرار (Frequency Capping)](/ar/product/customer-journey/journey-settings#frequency-capping).
> على سبيل المثال، لقد أنشأت حملة لإعلام المستخدمين بانخفاض سعر منتج معين. وتريد إعادة إطلاق الرحلة عدة مرات عن طريق إرسال عدة طلبات بفلاتر جمهور مختلفة. في هذه الحالة، يمكنك إضافة تحديد التكرار حتى لا يتم إرسال الإشعار بشكل متكرر للمستخدمين الذين يتطابقون مع عدة فلاتر.
9. إذا كنت تريد إطلاق رحلة كلما حدث حدث تجاري معين، فقم بأتمتة الطلب باستخدام webhook. بمجرد وقوع الحدث، يجب أن يرسل webhook الطلب تلقائيًا لبدء الرحلة.
يمكنك أيضًا إرسال الطلب يدويًا إذا لم تكن بحاجة إلى الأتمتة.
عند تكوين خطوة الإشعار الفوري (Push) أو البريد الإلكتروني (Email) في رحلتك، حدد الإعداد المسبق الذي تم إنشاؤه وقم بتشغيل خيار **تخصيص الرسالة بسمات الحدث (Personalize message with event attributes)**. حدد العناصر النائبة التي تريد تعديلها في الطلب عند إطلاق الرحلة. اختر **الدخول المستند إلى API (API-based Entry)** كمصدر واسم العنصر النائب كسمة ديناميكية:
انقر على **تطبيق (Apply)** لحفظ التغييرات.
4. في نافذة إعدادات الدخول، انسخ قالب الطلب لتعديله:
5. أضف فلاتر الجمهور إلى معامل `filter` باستخدام [لغة التجزئة (Segmentation language)](/ar/developer/api-reference/segmentation-filters-api/segmentation-language/). يرجى ملاحظة أنك تحتاج إلى إعداد [الوسوم (Tags)](/ar/developer/guides/audience-and-segmentation/tags/) اللازمة مسبقًا.
على سبيل المثال، إذا كنت ترغب في استهداف الرحلة للمستخدمين الذين أضافوا عنصر _Socks_ إلى _Wishlist_ الخاصة بهم، فيجب أن تبدو قيمة `filter` كما يلي:
```
"filter": "A("12345-12345") * "T("Wishlist", EQ, "Socks")"
```
في هذا المثال، يجب أن يكون لديك وسم _Wishlist_ مهيأ في تطبيقك.
6. إذا قمت بإعداد العناصر النائبة، فحدد المحتوى المطلوب كقيم لها:
7. إذا تم تمكين خيار **حدود معدل الرسائل (Message Rate Limits)**، فسيتم تحديد عدد المستخدمين الذين يدخلون الرحلة في وقت واحد كل ثانية. يمكنك استخدام القيمة الافتراضية البالغة 5000 مستخدم في الثانية أو تعيين رقم آخر.
8. إذا كنت تخطط لإعادة تشغيل حملتك بشكل متكرر ولا تريد أن يدخل نفس المستخدمين الرحلة عدة مرات، فقم بتعيين [تحديد التكرار (Frequency Capping)](/ar/product/customer-journey/journey-settings#frequency-capping).
> على سبيل المثال، لقد أنشأت حملة لإعلام المستخدمين بانخفاض سعر منتج معين. وتريد إعادة إطلاق الرحلة عدة مرات عن طريق إرسال عدة طلبات بفلاتر جمهور مختلفة. في هذه الحالة، يمكنك إضافة تحديد التكرار حتى لا يتم إرسال الإشعار بشكل متكرر للمستخدمين الذين يتطابقون مع عدة فلاتر.
9. إذا كنت تريد إطلاق رحلة كلما حدث حدث تجاري معين، فقم بأتمتة الطلب باستخدام webhook. بمجرد وقوع الحدث، يجب أن يرسل webhook الطلب تلقائيًا لبدء الرحلة.
يمكنك أيضًا إرسال الطلب يدويًا إذا لم تكن بحاجة إلى الأتمتة.