الدخول المستند إلى API

تحتاج إلى مساعدة المطورين

ستحتاج إلى مساعدة من فريق التطوير لديك لإعداد رحلة دخول مستندة إلى API. يرجى مشاركة هذا الدليل معهم.

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

فيما يلي بعض حالات الاستخدام للدخول المستند إلى API:

• إعلام العملاء عند عودة المنتجات إلى المخزون
• إخبار المستخدمين بانخفاض سعر منتج شائع
• إشعار المشتركين عند صدور حلقة بودكاست جديدة

على عكس Events العادية، قد تحدث كل أحداث العمل هذه خارج التطبيق. على سبيل المثال، لا يمكن التحقق من توفر منتج إلا في قاعدة بيانات خارجية. هنا يأتي دور الدخول المستند إلى API: يمكنك إعداد إرسال طلب لإطلاق رحلة كلما حدثت تغييرات معينة خارج التطبيق (على سبيل المثال، في قاعدة بياناتك الخارجية).

يعمل على النحو التالي:

1. أنشئ رحلة بدخول مستند إلى API. في إعدادات الدخول، ستجد قالب الطلب الذي يطلق الرحلة.
2. أضف شروط التجزئة إلى الطلب باستخدام لغة التجزئة. يمكنك أيضًا إضافة عناصر نائبة للمحتوى إلى الطلب لتغيير محتوى الرسالة حسب السياق.
3. قم بأتمتة الطلب إذا لزم الأمر. على سبيل المثال، يمكن إرسال معلومات حول تغيير السعر فورًا من قاعدة البيانات إلى الـ webhook. بمجرد حدوث ذلك، يجب على الـ webhook إرسال الطلب تلقائيًا لإطلاق الرحلة. يمكنك أيضًا إرسال الطلب يدويًا إذا لم تكن بحاجة إلى الأتمتة.

يمكنك إرسال الطلب عددًا غير محدود من المرات لتغيير شروط التجزئة أو محتوى الرسالة.

لمزيد من التفاصيل، اتبع التعليمات أدناه.

إعداد رحلة بدخول مستند إلى API

1. أنشئ رحلة بدخول مستند إلى API:

2. انقر نقرًا مزدوجًا على خطوة الدخول المستند إلى API. ستفتح نافذة تكوين الدخول.

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

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

أولاً، أضف أسماء العناصر النائبة في نافذة إعداد الدخول المستند إلى API. يمكنك استخدام أي أسماء مناسبة لك.

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

• {placeholder_name|format_modifier|} – إذا لم يتم تحديد قيمة العنصر النائب عند إطلاق الحملة، سيرى المستخدمون مساحة فارغة في مكانه.
• {placeholder_name|format_modifier} – إذا لم يتم تحديد قيمة العنصر النائب ولم يتم تعيينها بالفعل لمستخدم (في حال استخدمت Tag كعنصر نائب)، فلن يتم إرسال الرسالة.

معدِّلات التنسيق

• CapitalizeFirst – يحول الحرف الأول في قيمة العنصر النائب إلى حرف كبير
• CapitalizeAllFirst – يحول الحرف الأول في كل كلمة في قيمة العنصر النائب إلى حرف كبير
• UPPERCASE – يحول كل الحروف إلى أحرف كبيرة
• lowercase – يحول كل الحروف إلى أحرف صغيرة
• regular – يدرج قيمة العنصر النائب تمامًا كما هي محددة في الطلب

نصيحة

يمكنك أيضًا استخدام اسم Tag موجود بدلاً من اسم العنصر النائب. في هذه الحالة، يجب عليك تكوين الكتابة فوق قيمة هذا الـ Tag بالقيمة المحددة في الطلب كما هو موضح أدناه.

عند تكوين عنصر Push أو Email في رحلتك، حدد الإعداد المسبق الذي تم إنشاؤه وقم بتشغيل خيار Personalize message with event attributes.

حدد العناصر النائبة التي تريد تعديلها في الطلب عند إطلاق الرحلة. اختر API-based entry entry كمصدر واسم العنصر النائب كسمة ديناميكية:

انقر على Apply لحفظ التغييرات.

4. في نافذة تكوين الدخول، انسخ قالب الطلب لتعديله:

ملاحظة

لإطلاق رحلة عبر API، يجب عليك تضمين رمز تفويض صالح في ترويسة Authorization.

تنسيق الترويسة المطلوب

Authorization: Api <your_api_token>

مثال

Authorization: Api c8dc6435-xxxxxxxxxxxxxxx

5. أضف مرشحات الجمهور إلى معامل "filter" باستخدام لغة التجزئة أو انسخ منطق التجزئة من شرائحك. قم بإعداد Tags اللازمة مسبقًا.

على سبيل المثال، لاستهداف المستخدمين الذين أضافوا عنصر Socks إلى Wishlist الخاصة بهم، يجب أن تبدو قيمة "filter" كما يلي:

"filter": "A(\"12345-12345\") * "T(\"Wishlist\", EQ, \"Socks\")"

في هذا المثال، يجب أن يكون لديك Tag باسم Wishlist مهيأ في تطبيقك.

ملاحظة

يُضاف رمز تطبيقك تلقائيًا إلى معامل "filter" بتنسيق A(\"12345-12345\"). لا تقم بإزالته أو تعديله.

أيضًا، يرجى مراعاة أن علامات الاقتباس ("") والشرطات المائلة العكسية (\) يجب أن يتم تخطيها (escaped) باستخدام شرطة مائلة عكسية (\) في استعلامات JSON.

6. إذا قمت بإعداد عناصر نائبة، فحدد المحتوى المطلوب كقيم لها:

7. إذا كنت تخطط لإعادة تشغيل حملتك بشكل متكرر ولا تريد أن يدخل نفس المستخدمين الرحلة عدة مرات، فقم بتعيين حدود دخول الحملة.

على سبيل المثال، لقد أنشأت حملة لإشعار المستخدمين بتخفيض سعر منتج معين. وتريد إعادة إطلاق الرحلة عدة مرات عن طريق إرسال عدة طلبات بمرشحات جمهور مختلفة. في هذه الحالة، يمكنك إضافة حدود دخول الحملة (Campaign entry limits) حتى لا يتم إرسال الإشعار بشكل متكرر للمستخدمين الذين يتطابقون مع مرشحات متعددة.

8. إذا كنت تريد إطلاق رحلة كلما حدث حدث عمل معين، فقم بأتمتة الطلب باستخدام الـ webhook. بمجرد وقوع الحدث، يجب على الـ webhook إرسال الطلب تلقائيًا لبدء الرحلة.

يمكنك أيضًا إرسال الطلب يدويًا إذا لم تكن بحاجة إلى الأتمتة.

ملاحظة

• إذا قمت بتغيير شروط التجزئة عند إرسال طلب جديد، فلن يؤثر ذلك على المستخدمين الذين دخلوا الرحلة بالفعل.
• إذا قمت بتغيير محتوى الرسالة عند إرسال طلب جديد، فسيتلقى جميع المستخدمين الإصدار الجديد من الرسالة (بما في ذلك أولئك الذين دخلوا الرحلة بالفعل ولكنهم لم يتلقوا هذه الرسالة بعد).