طلبات سلة توصل ناقصة القيمة، وهذا يعمي الخوارزمية

الجواب المختصر:لأن قيمة الطلب في سلة ما تجي بحقل واحد ثابت؛ مكانها يتغيّر بين نسخ حمولة الـ webhook، وتحتاج حدثين لا حدث واحد عشان تكتمل الصورة. ولو الربط يقرأ الحقل الخطأ أو يشترك بحدث واحد فقط، يوصلك طلب “تم” بقيمة صفر أو ناقصة. وهذا أخطر من عدم إرسال الطلب أصلاً، لأنه يعلّم خوارزمية المنصة إن العميل اللي شافته يشتري بصفر ريال.

التفصيل التقني

توثيق سلة يصف حدثين مختلفين في دورة حياة الطلب: order.created يفتح الطلب لحظة إنشائه، وorder.payment.updated يحدّث حالة الدفع لما تتأكد. وربط يشترك بـ order.created فقط، لأنه الاسم الأوضح، يفوّت أي تحديث يجي بعده على نفس الطلب.

وحتى داخل الحدث نفسه، القيمة ما تجي بمسار واحد. حمولة سلة تُظهر القيمة تحت amounts.total.amount في بعض الحالات، وتحت total في حالات أخرى، وتحت total.amount في حالة ثالثة. وربط مكتوب على مسار واحد بس يرجّع له قيمة فارغة بمجرد ما تتغيّر النسخة، وبعض الأنظمة تحوّل القيمة الفارغة إلى صفر بصمت بدل ما توقف وتنبّه.

النتيجة: منصة الإعلان تستقبل عملية شراء فعلاً، بس بقيمة صفر أو ناقصة. وأنظمة المزايدة المبنية على القيمة تستخدم هذا الرقم عشان تعرف مين تلاحق. ولو علّمتها إن عملاءك يشترون بصفر، تروح تلاحق أشخاصاً يشبهون هذا النمط بالضبط.

وش يسويه مِيقاس هنا

ربط سلة في مِيقاس يشترك من البداية بالحدثين معاً، order.created و order.payment.updated، عشان القيمة النهائية تصل بعد ما يتأكد الدفع، مو لحظة إنشاء الطلب فقط. وقراءة القيمة نفسها مبنية على تجربة المسارات الثلاثة المعروفة في التوثيق، وترجع أول قيمة رقمية حقيقية تلقاها، مو قيمة فارغة تتحول صفراً بصمت.

هذا يعني إن المنصة تستقبل رقماً يعكس الطلب الحقيقي، مو رقماً ناقصاً لأن شكل الحمولة تغيّر.

وش تتحقق منه بنفسك

افتح Events Manager في حسابك، وشوف قيمة آخر عشر عمليات شراء وصلت من سلة. ولو شفت أرقاماً بصفر أو غريبة وسط أرقام طبيعية، فهذا مؤشر إن الربط يفوّت الحقل الصحيح، لا إن مبيعاتك تراجعت فعلاً.