ما تفعله خطافات الويب
خطاف الويب هو اشتراك في حدث محدد من أحداث المتجر. عند وقوع ذلك الحدث، يرسل Storeep بيانات الحدث فورًا إلى عنوان URL تحدده (نوع API) أو عنوان بريد إلكتروني تحدده (نوع البريد الإلكتروني). تُستخدم خطافات الويب بشكل شائع لتكاملات تتبع الطلبات ومزامنة إدارة علاقات العملاء وتحويلات منصات الإعلانات والإشعارات الآلية.
لإدارة خطافات الويب، انتقل إلى الإعدادات → خطافات الويب.
حدود خطافات الويب
- الحد الأقصى 20 خطافًا للويب لكل متجر. إضافة الخطاف الحادي والعشرين تُعيد خطأ.
- تُدرج خطافات الويب من الأحدث إلى الأقدم، بحد 40 لكل صفحة.
إنشاء خطاف ويب
انقر إضافة خطاف ويب جديد.
زر تبديل التفعيل
عند تحديده (الافتراضي)، يكون خطاف الويب فعليًا منذ لحظة الحفظ. تُرسل الأحداث فورًا. ألغِ التحديد لحفظ خطاف الويب في حالة معطلة دون استقبال أحداث. يمكنك تفعيل خطاف الويب أو تعطيله في أي وقت بتعديله.
الاسم
- مطلوب.
- الحد الأقصى 50 حرفًا.
- تسمية وصفية تظهر في قائمة خطافات الويب. مثال: Facebook CAPI، طلب مُنشأ.
النوع
يتحكم في طريقة تسليم حمولة الحدث. خياران:
- API: يُرسل Storeep طلب HTTP POST يحمل بيانات الحدث إلى عنوان URL الذي تحدده.
- البريد الإلكتروني: يُرسل Storeep بريدًا إلكترونيًا يحتوي بيانات الحدث إلى العنوان الذي تحدده.
الحدث
حدث المتجر الذي يُشغّل هذا الخطاف. ثلاثة أحداث متاحة:
- إنشاء جلسة: يُطلق عند إنشاء جلسة زائر جديدة في متجرك.
- إنشاء طلب: يُطلق عند تقديم طلب جديد.
- تحديث طلب: يُطلق عند تغيير حالة طلب موجود أو بياناته.
الصيغة
صيغة بيانات حمولة الحدث. خيار واحد حاليًا:
- JSON: تُرسل الحمولة كمستند JSON.
عنوان URL (نوع API فقط)
- مطلوب عندما يكون النوع API.
- الحد الأقصى 500 حرف. الحد الأعلى يستوعب عناوين URL التي تتضمن أجزاء مكان متعددة.
- أدخل عنوان URL لنقطة النهاية دون البادئة
https://. تُضاف تلقائيًا. مثال:api.example.com/events/order. - محددات مواضع URL الديناميكية: يمكن إدراج أي حقل من حمولة الحدث في عنوان URL باستخدام بناء الأقواس المزدوجة:
{{field_name}}. مثال:https://example.com/postback?cid={{fbclid}}&payout={{order_total}}
يتيح لك ذلك إرسال بيانات التحويل إلى منصات الإعلانات مباشرةً من عنوان URL للخطاف دون الحاجة إلى خادم وسيط منفصل. - إذا كان هيكل عنوان URL غير صحيح بعد تحليل المحددات، ستتلقى خطأ تحقق.
عنوان البريد الإلكتروني (نوع البريد الإلكتروني فقط)
- مطلوب عندما يكون النوع البريد الإلكتروني.
- يجب أن يكون عنوان بريد إلكتروني صحيحًا، الحد الأقصى 127 حرفًا.
تعديل خطاف ويب
انقر أي صف من خطافات الويب لفتح المحرر. جميع الحقول قابلة للتعديل. يُملأ حقل عنوان URL مسبقًا فقط إذا كان النوع الحالي API؛ ويُملأ حقل البريد الإلكتروني مسبقًا فقط إذا كان النوع البريد الإلكتروني. تبديل النوع يُفرغ الحقل الآخر.
تفعيل خطافات الويب وتعطيلها
تتحكم خانة اختيار التفعيل في أعلى المحرر في ما إذا كان الخطاف يُطلق. تعرض الحالة في القائمة مُفعّل أو معطل. خطاف الويب المعطل لا يُسجل أي تسليمات لكنه لا يُحذف، لذا يمكنك إعادة تفعيله لاحقًا دون إعادة تهيئته.
أعمدة قائمة خطافات الويب
- الاسم: تسمية الخطاف مع تاريخ الإنشاء.
- URL / البريد الإلكتروني: عنوان الوجهة.
- النوع: API أو البريد الإلكتروني.
- الحدث: اسم الحدث (إنشاء جلسة أو إنشاء طلب أو تحديث طلب).
- الصيغة: JSON.
- الحالة: مُفعّل أو معطل.
حذف خطاف ويب
اختر خطافًا أو أكثر وانقر حذف خطافات الويب. هذا الإجراء دائم ويوقف جميع عمليات التسليم المستقبلية لذلك الاشتراك.
نصائح ونقاط يجب التحقق منها
- يمكنك إنشاء عدة خطافات ويب للحدث ذاته، مثلًا إرسال حدث إنشاء طلب إلى نظام إدارة علاقات العملاء ومنصة الإعلانات، كل منهما كإدخال خطاف ويب منفصل.
- إذا كانت نقطة نهايتك تتطلب مصادقة، أضف بيانات الاعتماد إلى سلسلة استعلام عنوان URL باستخدام
{{placeholder}}مصدره بيانات الحدث، أو أنشئ خادمًا وسيطًا يتولى المصادقة قبل إعادة التوجيه إلى نقطة النهاية الفعلية. - يُطلق حدث إنشاء جلسة لكل جلسة زائر فريدة، وقد يكون ذلك بحجم مرتفع في المتاجر الشائعة. اشترك فيه فقط إذا كانت نقطة نهايتك تتحمل هذا الحجم.