ماذا تفعل
تُبقي هذه الإضافة Klaviyo على اطلاع بأمرين اثنين. حين يصبح قارئ جديد عضوًا في موقعك، تنشئ ملف تعريف في Klaviyo لعنوان بريده أو تحدّث الملف الموجود، وتضع فيه اسمه الأول، وتسجّل هذا الملف مشتركًا في قائمة إن حدّدتَ معرّف قائمة. وحين تتم عملية شراء، ترسل الإضافة إلى Klaviyo حدث Placed Order مع قيمة الطلب، فتستطيع تدفقاتك التي تلي الشراء أن تنطلق. وترسل أيضًا حدث Fulfilled Order عندما يُشحن منتج مادي، وحدث Refunded Order بعد الاسترداد. ويحمل كل حدث معرّفًا فريدًا، فلا يُحتسب مرتين إذا أُعيد إرساله. وحين يلغي القارئ اشتراكه أو يُحذف سجل عضويته، تحجب الإضافة ملف تعريفه في Klaviyo.
لمن يناسب
لأصحاب المتاجر والعضويات الذين يديرون رسائلهم البريدية والنصية في Klaviyo ويريدون أن تتفاعل تلك التدفقات مع ما يجري في موقعهم على VeloCMS: تسجيل جديد أو عملية شراء أو استرداد. وأنفع ما تكون إن كنت تبيع منتجات أو عضويات. أما إن كنت تجمع اشتراكات النشرة وحدها، فقد تكفيك إضافات المزامنة الأبسط لأدوات البريد الأخرى.
كيف تعمل
تلصق مفتاح API الخاص من Klaviyo، ومعه معرّف قائمة إن شئت، في إعدادات الإضافة ثم تحفظ. وما إن يُحفظ المفتاح حتى تستطيع تشغيل اختبار الاتصال.
ينضم عضو جديد إلى موقعك. فتنشئ الإضافة ملف تعريفه في Klaviyo أو تحدّثه، وتسجّله مشتركًا في قائمتك عندما يكون معرّف القائمة محدّدًا.
تتم عملية شراء. فترسل الإضافة حدث Placed Order ومعه معرّف الطلب وقيمة الطلب وبريد العميل الإلكتروني.
وحين يُعلَّم عنصر من طلب مادي على أنه شُحن، يُرسل حدث Fulfilled Order، وحين يُسترد الطلب يُرسل حدث Refunded Order إلى Klaviyo.
وحين يلغي قارئ اشتراكه أو يُحذف سجل عضويته، تحجب الإضافة ملف تعريفه في Klaviyo.
الإعدادات التي تضبطها
- مفتاح API الخاص
- تجده في Klaviyo ضمن Settings ثم API Keys. يُخزَّن مشفّرًا ولا يُعرض مجددًا بعد الحفظ. وما إن يُحفظ حتى يرسل زر «اختبار الاتصال» حدثًا اختباريًا صغيرًا للتحقق من أن Klaviyo يقبله.
- معرّف القائمة
- اختياري. يُشترك الأعضاء الجدد في قائمة Klaviyo هذه. وتجد المعرّف في Klaviyo ضمن Lists and Segments ثم Settings الخاصة بالقائمة.
- مزامنة الأعضاء الجدد
- مفعّل افتراضيًا. وعند إيقافه لا يُرسل الأعضاء الجدد إلى Klaviyo بعد ذلك، بينما يظل إلغاء الاشتراك وحذف العضوية يحجبان الملف في Klaviyo.
- إرسال أحداث «تقديم الطلب»
- مفعّل افتراضيًا. يبثّ حدث Placed Order إلى Klaviyo بعد كل عملية شراء ناجحة.
ما تستطيع الوصول إليه
تقرأ الإضافة عنوان البريد والاسم المعروض لكل عضو جديد عند التسجيل. وبعد إتمام عملية الشراء تقرأ معرّف الطلب وإجمالي الطلب وبريد العميل. ولا تقرأ بنود الطلب ولا تقرأ تدويناتك. وتتجه الاتصالات الصادرة إلى المضيف a.klaviyo.com وحده. ويُخزَّن مفتاح API الخاص مشفّرًا، ولا يُعرض مجددًا كنص صريح بعد ذلك.
الأذونات
- قراءة البريد الإلكتروني واسم العضو الجديد عند التسجيل
- قراءة إجمالي الطلب وبريد العميل الإلكتروني بعد الشراء
- إجراء اتصالات شبكية بـ a.klaviyo.com
- تخزين مفتاح Klaviyo الخاص (Private API key) بشكل مشفّر
الوصول إلى الشبكة الخارجية
ترسل هذه الإضافة طلبات إلى النطاقات التالية:
a.klaviyo.com
الإمكانات
members:readcommerce:readnetwork:fetchui:settingsmember:afterSignuporder:afterCreateorder:afterRefundedorder:afterFulfilled
لقطات الشاشة

حدود نذكرها بصراحة
لا يُرسل إلا الأعضاء والطلبات التي أُنشئت بعد أن تثبّت الإضافة وتضبطها. أما الأعضاء والطلبات السابقة فلا تُملأ بأثر رجعي.
المزامنة باتجاه واحد فقط. فلا يعود إلى VeloCMS أي شيء تغيّره في Klaviyo.
تحمل أحداث الطلبات معرّف الطلب وقيمته ومعرّف موقعك. أما بنود الطلب وأسماء المنتجات والكميات فلا تُرسل.
حقل «مفتاح API العام» يُحفظ لكنه لا يُستخدم بعد في أي شيء.
يُرسل حدثا Fulfilled Order وRefunded Order افتراضيًا، وليس في شاشة الإعدادات أي مفتاح تبديل للتحكم بهما.
إن تعذّر الوصول إلى Klaviyo أو رفض طلبًا، يُسجَّل الإخفاق ويمضي التسجيل أو الطلب في طريقه دون عائق. ويمكن إعادة مزامنة تسجيل فاشل يدويًا بزر «إعادة محاولة المزامنة» في صفحة «نشاط المزامنة» بلوحة الإدارة. أما حدث طلب فاشل فلا يُعاد.
الأسئلة الشائعة
أي مفتاح من Klaviyo أحتاج؟
المفتاح الخاص (Private API Key) من Klaviyo ضمن Settings ثم API Keys. وبعد أن تحفظ المفتاح، يخبرك زر «اختبار الاتصال» في شاشة الإعدادات بما إذا كان Klaviyo قد قبله.
أي أحداث يستقبلها Klaviyo؟
يستقبل Klaviyo حدث Placed Order بعد كل عملية شراء ناجحة، وحدث Fulfilled Order حين يُشحن منتج مادي، وحدث Refunded Order بعد الاسترداد. ويُرسل كل حدث منها ومعه معرّف الطلب وقيمته وبريد العميل.
هل يمكنني إيقاف أحداث الطلبات؟
يمكنك إيقاف أحداث Placed Order بمفتاح التبديل إرسال أحداث «تقديم الطلب». أما حدثا Fulfilled Order وRefunded Order فليس لهما أي مفتاح تبديل في شاشة الإعدادات.
هل سيُضاف أعضائي الحاليون وطلباتي السابقة؟
لا. تعمل الإضافة على التسجيلات الجديدة والطلبات الجديدة فقط. أما الأعضاء والطلبات السابقة فتحتاج إلى استيرادها إلى Klaviyo على حدة.
إضافات ذات صلة
المواصفات
- الفئة
- marketing
- السعر
- مضمَّن
- الإصدار
- 1.0.0
- المصدر
- من الطرف الأول
تصفّح المزيد من التكاملات
57 تكامل أصلي مجاني متاح.