ربط منصات المراجعة الخارجية

تكامل منصة المراجعات الخارجية

قم بربط منصة المراجعات الخارجية الموجودة لديك مع LoyaltyTree لمزامنة المراجعات ومنح البذور للعملاء تلقائيًا.

نظرة عامة

إذا كنت تستخدم بالفعل منصة مراجعات مثل Judge.me أو Loox أو Yotpo، يمكنك دمجها مع LoyaltyTree بدلاً من الانتقال إلى نظام المراجعات الأصلي لدينا. هذا يتيح لك:

• الاحتفاظ بمراجعاتك الحالية: لا حاجة للهجرة أو البدء من جديد
• منح البذور للمراجعات: يكسب العملاء مكافآت الولاء عند تركهم للمراجعات
• تجربة موحدة للعملاء: تساهم المراجعات في رحلتهم العامة للولاء
• مزامنة تلقائية: تتدفق المراجعات إلى LoyaltyTree عبر الويب هوكس

الخطوة 1: الوصول إلى إعدادات المراجعة

1. انتقل إلى المتاجر في إدارة LoyaltyTree الخاصة بك
2. ابحث عن بطاقة المتجر الخاصة بك وانقر على زر إعدادات المراجعة 
3. اذهب إلى علامة التبويب الإعدادات

الخطوة 2: اختيار وضع المنصة الخارجية

في إعدادات نظام المراجعة:

1. ابحث عن قائمة نظام المراجعة
2. قم بتغييرها من "LoyaltyTree Native" إلى المنصة الخارجية
3. تأكد من تحديد تمكين نظام المراجعة

الخطوة 3: اختر منصة المراجعة الخاصة بك

اختر مزود المراجعة الخاص بك من قائمة منصة المراجعة:

الخطوة 4: تمكين معالجة الويب هوك

حدد خيار تمكين معالجة الويب هوك. هذا يسمح لـ LoyaltyTree باستقبال ومعالجة بيانات المراجعة من منصتك الخارجية.

الخطوة 5: تكوين عنوان URL للويب هوك

بمجرد اختيار منصة، يقوم LoyaltyTree بإنشاء عنوان URL للويب هوك فريد لمتجرك.

انسخ عنوان URL للويب هوك الخاص بك:

1. ابحث عن حقل عنوان URL للويب هوك في لوحة التكامل
2. انقر على زر نسخ لنسخ عنوان URL الكامل
3. احتفظ بهذا العنوان URL بأمان - فهو فريد لمتجرك

أضف الويب هوك إلى منصة المراجعة الخاصة بك:

تختلف الخطوات الدقيقة حسب المنصة، ولكن بشكل عام:

1. اذهب إلى إعدادات إدارة منصة المراجعة الخاصة بك
2. ابحث عن قسم الويب هوكس أو التكاملات
3. أضف ويب هوك جديد باستخدام عنوان URL الذي نسخته
4. اختر حدث تم إنشاء مراجعة أو مراجعة جديدة
5. احفظ تكوين الويب هوك الخاص بك

الخطوة 6: سر الويب هوك (اختياري)

لزيادة الأمان، يمكنك تكوين سر الويب هوك للتحقق من أن الويب هوكس الواردة أصلية.

كيف يعمل:

1. أدخل مفتاح سري في حقل سر الويب هوك
2. قم بتكوين منصة المراجعة الخاصة بك لتوقيع الطلبات بهذا السر
3. سيتحقق LoyaltyTree من التوقيع باستخدام رأس x-webhook-signature أو x-signature

ملاحظة: ليست جميع المنصات تدعم توقيعات الويب هوك. إذا لم تدعم منصتك ذلك، يمكنك ترك هذا الحقل فارغًا.

الخطوة 7: خيار عام/مخصص - تنسيق JSON المتوقع

عندما ترسل منصة المراجعة الخاصة بك ويب هوك، يتوقع LoyaltyTree تنسيق البيانات التالي:

{
  "customer_email": "customer@example.com",
  "rating": 5,
  "body": "منتج رائع!",
  "has_photos": true,
  "product_id": "12345",
  "product_title": "اسم المنتج"
}

الحقول المطلوبة:

دعم تنسيق متداخل:

يدعم LoyaltyTree أيضًا تنسيقات البيانات المتداخلة المستخدمة عادةً من قبل منصات المراجعة:

{
  "data": {
    "email": "customer@example.com",
    "rating": 5,
    "body": "منتج رائع!"
  }
}

مكافآت البذور للمراجعات الخارجية

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

عند استلام ويب هوك للمراجعة:

1. يقوم LoyaltyTree بمطابقة customer_email مع عميل موجود
2. إذا تم العثور عليه، يتم منح البذور بناءً على تكوين إعدادات البذور الخاصة بك
3. يمكن أن تكسب مراجعات الصور بذورًا إضافية إذا تم تكوينها
4. يمكن للمراجعين لأول مرة كسب بذور إضافية

استكشاف الأخطاء وإصلاحها

المراجعات لا تتزامن؟

• تحقق من عنوان URL للويب هوك: تأكد من أنك نسخت العنوان URL الكامل بما في ذلك جميع معلمات الاستعلام
• تحقق من تمكين الويب هوك: تأكد من تحديد "تمكين معالجة الويب هوك" في LoyaltyTree
• تحقق من منصة المراجعة الخاصة بك: تأكد من أن الويب هوك نشط ويشير إلى العنوان URL الصحيح
• اختبر بمراجعة جديدة: قدم مراجعة اختبار لتحفيز الويب هوك

العميل لا يتلقى البذور؟

• يجب أن يتطابق البريد الإلكتروني: يجب أن يتطابق customer_email في الويب هوك مع عميل في قاعدة بيانات LoyaltyTree الخاصة بك
• تحقق من إعدادات البذور: تحقق من أن مكافآت المراجعة تم تكوينها في مجموعة الولاء الخاصة بك
• يجب أن يكون العميل مسجلاً: قد لا يحصل العملاء المجهولون أو الضيوف على مكافآت البذور

أخطاء توقيع الويب هوك؟

• يجب أن يتطابق السر: يجب أن يتطابق السر في LoyaltyTree تمامًا مع ذلك المكون في منصة المراجعة الخاصة بك
• تنسيق الرأس: يبحث LoyaltyTree عن رؤوس x-webhook-signature أو x-signature

تحتاج إلى مساعدة؟

اتصل بفريق الدعم لدينا على support@loyaltytree.eco للحصول على المساعدة في تكامل منصة المراجعة الخارجية.