متجرك على زد يُنتج بيانات ثريّة كل ساعة — طلبات، بنود طلبات، منتجات، عملاء، سلال متروكة، مرتجعات. لكن معظم أدوات التحليل تكتفي بسحب «الطلبات المكتملة» فقط، فتفقد نصف الصورة. هذا الدليل يشرح ما يجب سحبه بالضبط، وكيف تُبنى المؤشّرات التنفيذيّة من بيانات زد الخام.

لماذا التكامل السطحي لا يكفي

معظم لوحات التحليل تربط زد عبر REST API وتسحب الطلبات فقط، غالبًا الطلبات ذات الحالة «مكتمل» فحسب. هذا التكامل السطحي يُعطي أرقامًا أوّليّة لكنّه يعجز عن حساب مؤشّرات أساسيّة:

  • UPO (Units Per Order): يحتاج مجموع الكمّيّات على مستوى بنود الطلبات، لا مجموع عدد الطلبات.
  • معدّل الإرجاع: يحتاج جلب الطلبات ذات حالة «مسترجع» وليس تجاهلها.
  • صافي المبيعات: يحتاج طرح المرتجعات والإلغاءات، وهذا يستحيل إن سحبت المكتملة فقط.
  • معدّل التكرار (Repeat Rate): يحتاج ربط الطلبات بالعملاء تاريخيًّا، لا الاعتماد على قائمة العملاء الحاليّة.

علامة تحذير: إن كانت لوحتك التنفيذيّة تُظهر «AOV = 285 ريال» لكن متوسط طلباتك في زد 340 ريال، فأنت أمام تكامل ناقص.

الطبقات الثلاث للتكامل الكامل

التكامل الاحترافي مع زد يبني ثلاث طبقات:

  • الطبقة 1 — REST API: لجلب الطلبات الرئيسيّة، المنتجات، العملاء، والقوائم الأساسيّة. مفيدة لكل شيء «رأس الطلب» لكن لا تُعطي بنود الطلب بدقّة.
  • الطبقة 2 — Webhooks: لتلقّي إشعارات فوريّة بكل حدث (طلب جديد، تغيّر حالة، سلة متروكة، تحديث منتج). ما يجعل اللوحة تعكس التغييرات خلال ثوانٍ، لا في نهاية اليوم.
  • الطبقة 3 — Zid MCP: بروتوكول متقدّم يُتيح جلب بنود الطلبات (Order Items) بدقّة SKU + Quantity + Price لكل عنصر. بدونه، لا يمكنك حساب UPO ومعدّل الإرجاع ودقّة صافي المبيعات.

ما يجب أن تسحبه بالضبط — قائمة كاملة

لبناء لوحة تنفيذيّة كاملة من زد، تحتاج سحب كل ما يلي:

  • الطلبات (كل الحالات): معرّف الطلب، تاريخ الإنشاء، تاريخ آخر تحديث، الحالة، الإجمالي، الخصم، الشحن، الضريبة، معرّف العميل، مدينة التسليم.
  • بنود الطلبات (عبر Zid MCP): معرّف بند، معرّف الطلب، معرّف المنتج، SKU، اسم المنتج، الكمّيّة، سعر البند، قيمة الخصم على البند.
  • المنتجات: معرّف المنتج، اسم المنتج، الفئة، السعر، حالة المخزون، الكمّيّة المتاحة، حالة النشر.
  • العملاء: معرّف العميل، تاريخ الإنشاء، مصدر التسجيل، عدد الطلبات التاريخي، إجمالي الإنفاق، المدينة.
  • السلال المتروكة: معرّف السلة، معرّف العميل (إن وُجد)، محتويات السلة، القيمة، تاريخ الترك.
  • المرتجعات: معرّف الإرجاع، معرّف الطلب الأصلي، البنود المرتجعة، القيمة المستردّة، السبب.

كيف تتحوّل هذه البيانات إلى مؤشّرات

بعد سحب البيانات الخام، تُبنى المؤشّرات التنفيذيّة عبر معادلات محدّدة:

المعادلات الأساسيّة
AOV = (مجموع إجماليّات الطلبات المكتملة) ÷ (عدد الطلبات المكتملة)
UPO = مجموع (الكمّيّات في بنود الطلبات) ÷ (عدد الطلبات)
صافي المبيعات = المبيعات الإجماليّة − المرتجعات − الإلغاءات − الخصومات
معدّل الإرجاع = (قيمة المرتجعات) ÷ (المبيعات الإجماليّة) × 100
معدّل التكرار = (عملاء بأكثر من طلب) ÷ (إجمالي العملاء) × 100

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

التزامن الفوري — لماذا Webhooks ليست رفاهيّة

أدوات التحليل التقليديّة تسحب البيانات مرّة كل ساعة أو يوم (batch sync). المشكلة: لوحتك تعكس واقع البارحة، ليس الآن. إن حدث ارتفاع مفاجئ في المبيعات صباحًا، لن تعرفه إلا مساءً.

Webhooks يقلب المعادلة: زد يُخطر أداتك فورًا عند كل حدث. النتيجة:

  • طلب جديد → يظهر على اللوحة خلال ثوانٍ.
  • تغيّر حالة الطلب (من قيد المراجعة إلى مكتمل) → المبيعات الصافية تتحدّث فورًا.
  • سلة متروكة → قمع التحويل يعكس التغيّر لحظيًّا.
  • إرجاع → صافي المبيعات وROAS الفعلي يُعاد حسابهما تلقائيًّا.

الأحداث المهمّة في زد Webhooks: order.create · order.status.update · cart.abandoned · product.update · order.refund · customer.create.

backfill التاريخي — الفرق بين متجر جديد ومتجر بسنوات

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

التكامل الاحترافي يعمل backfill تلقائي: يسحب كل بياناتك التاريخيّة إلى 24 شهرًا خلفًا، فتحصل من اليوم الأوّل على:

  • مقارنة سنة على سنة (Year-over-Year) لأي مؤشّر.
  • اتّجاهات فصليّة (Q1 مقارنة بـ Q4 من العام الماضي).
  • تحليل موسميّة (رمضان، البلاك فرايدي، اليوم الوطني) بناءً على أرقام حقيقيّة.

الأمان والملكيّة

قبل ربط متجرك بأي أداة، تأكّد من:

  • الاتصال يستخدم OAuth أو تكامل رسمي من زد (لا تُشارك رمز حسابك مباشرة).
  • بياناتك معزولة على مستوى قاعدة البيانات — لا مستأجر آخر يمكنه رؤيتها.
  • الرمز مشفَّر بمعيار صناعي (AES-256 أو ما يُكافئه).
  • لديك خيار قطع الاتصال في أي وقت، مع حذف البيانات عند الطلب.

الخلاصة — قائمة تحقّق قبل اختيار أداة

قبل الاشتراك بأي أداة تحليل لمتجر زد، اسألها هذه الأسئلة:

  • هل تسحبون كل حالات الطلبات (وليس المكتملة فقط)؟
  • هل تستخدمون Zid MCP لجلب بنود الطلبات؟
  • هل التحديث لحظي عبر Webhooks؟
  • هل يعمل backfill تاريخي 24 شهرًا؟
  • هل تحسبون صافي المبيعات (بعد المرتجعات) أم الإجماليّة فقط؟
  • هل UPO وAOV وROAS ومعدّل الإرجاع محسوبة من بنود الطلبات الفعليّة؟

إن كانت الإجابة «لا» على أكثر من سؤالين، فأنت أمام أداة سطحيّة.