Skip to main content

نظرة عامة

Upcart تطبيق منفصل عن Aftersell، لذا فإن الاستراتيجيات ليست مدمجة في وحدة Upsells كما هي في تدفقات ما بعد الشراء وصفحة الدفع في Aftersell. بدلاً من ذلك، تربط بين التطبيقين بسكريبت صغير يستدعي Strategies API مباشرة ويُغذي النتيجة إلى وحدة Upsells الحالية في Upcart عبر واجهة برمجة التطبيقات العامة الخاصة بـ Upcart. السكريبت جاهز للاستخدام - الصقه مرة واحدة في HTML المخصص في Upcart، واستبدل قيمتين (مفتاح Strategy API الخاص بك ومعرّف الاستراتيجية)، وستبدأ وحدة Upsells في عرض أي منتجات تعيدها الاستراتيجية.

ما ستحتاج إليه

  1. مفتاح Strategy API الخاص بك. في Aftersell، انتقل إلى Settings → Product Strategy، وفي بطاقة Security Token، انسخ الرمز الخاص بك (هذا هو مفتاح Strategy API).
  2. معرّف الاستراتيجية. افتح الاستراتيجية التي تريد تشغيلها في محرر الاستراتيجيات في Aftersell وانسخ معرّفها.
  3. تفعيل وحدة Upsells في Upcart. يتجاوز السكريبت قائمة المنتجات المعروضة في كتلة البيع الإضافي الحالية، لذا يجب أن تكون الوحدة مفعّلة حتى يظهر أي شيء.

إضافة السكريبت

في Upcart، انتقل إلى Settings → Custom HTML → Scripts (before load) والصق السكريبت أدناه. استبدل STRATEGY_ID وSTRATEGY_API_KEY بالقيم من Aftersell، ثم احفظ.
مفتاح Strategy API الخاص بك يفوّض الاستدعاءات مقابل استراتيجيات متجرك. يضع السكريبت أعلاه المفتاح في كود على جانب العميل، وهي الطريقة العملية الوحيدة لاستدعاء واجهة برمجة التطبيقات من درج السلة (cart drawer). تعامل مع المفتاح كما تتعامل مع أي بيانات اعتماد عامة أخرى لواجهة المتجر، وقم بتدويره من Settings → Product Strategy في Aftersell إذا تم كشفه بأي طريقة لم تكن مقصودة.

ما تراه الاستراتيجية

نظرًا لأن هذا يعمل من سلة واجهة المتجر، فإن السياق مجموعة فرعية مختصرة مما هو متاح في الأسطح الأصلية لـ Aftersell:

سياق المنتج

يتم إرسال العناصر الموجودة حاليًا في سلة Upcart كمنتجات إدخال. المشغّلات مثل نوع المنتج والمورّد ومعرّف المنتج (handle) وعنوان المنتج وأي مشغّلات معرّف المنتج / معرّف المتغير تُقيَّم جميعها مقابل هذه العناصر.

سياق السلة

  • الإجمالي الفرعي (Subtotal) - الإجمالي الفرعي للسلة بوحدات العملة الرئيسية للمتجر (مثل الدولارات). قيمة total_price في Upcart بالوحدات الصغرى (السنتات)، لذا يقسم السكريبت على 100 لمطابقة الوحدات التي تستخدمها بقية Strategies API - والوحدات التي كُتبت بها قواعد cart_subtotal الخاصة بك.
  • عدد العناصر (Item count) - إجمالي الكمية عبر جميع البنود.
  • عدد البنود (Line count) - عدد البنود المميزة.

سياق الجلسة

  • رمز العملة (Currency code) - يُؤخذ من window.Shopify.currency.active.
مشغّلات العميل ومشغّلات UTM لن تتطابق. لا يرسل السكريبت الافتراضي وسوم العملاء أو عدد الطلبات أو الموقع أو معلمات UTM - لذا فإن أي قاعدة تستخدم هذه المشغّلات لن تُفعَّل أبدًا. استخدم مشغّلات المنتج والسلة والعملة، أو Catch all، لضمان إعادة شيء ما دائمًا.

ماذا يحدث عندما تُعيد الاستراتيجية نتيجة

المنتجات التي تعيدها الاستراتيجية تحل تمامًا محل القائمة التي كان Upcart سيعرضها في وحدة Upsells. يتم تجاوز قائمة البيع الإضافي المحددة من التاجر طوال مدة تلك السلة - ولا يتم دمجها. يتم تحويل كل منتج من منتجات الاستراتيجية إلى شكل المنتج المتوقع في Upcart (المتغيرات والصور والخيارات وحقول التعريف وما إلى ذلك) بحيث يُعرض داخل كتلة البيع الإضافي تمامًا مثل أي منتج آخر.

عندما لا يُعاد أي منتج

إذا لم تُعِد الاستراتيجية أي منتجات، تُعرض وحدة Upsells فارغة - ولا تظهر أي عروض بيع إضافي. لتجنب ذلك، قم بإعداد Catch all في الاستراتيجية بحيث يكون هناك دائمًا منتج احتياطي يُعاد. راجع صفحة بناء الاستراتيجيات لمعرفة كيفية إعداد Catch all.

إعادة التقييم عند تغيّر السلة

على عكس عروض البيع الإضافي في صفحة الدفع، فإن تنفيذ Upcart يعيد تقييم الاستراتيجية في كل مرة تتغير فيها السلة - عند إضافة عناصر أو إزالتها أو تحديث الكميات. يشترك السكريبت في حدث cartUpdated الخاص بـ Upcart، ويرسل السلة الجديدة إلى Strategies API، ويحدّث درج السلة بقائمة البيع الإضافي الجديدة. يتخطى فحص توقيع السلة الاستدعاءات الزائدة إذا لم تتغير البنود والكميات فعليًا، لذا فإن أحداث السلة المتتالية التي لا تغيّر السلة جوهريًا لن تستدعي واجهة برمجة التطبيقات مجددًا.

نصائح لاستراتيجيات Upcart

  • صمم حول السلة. مشغّلات شكل السلة والمنتج هي أقوى الإشارات المتاحة لك هنا. لا يرسل السكريبت الافتراضي سجل العميل ولا الاستهداف المعتمد على UTM.
  • استخدم Catch all كشبكة أمان. بدونه، لن تعرض وحدة Upsells شيئًا كلما لم تتطابق أي قاعدة.
  • صديق للتخزين المؤقت بشكل افتراضي. يمنع حارس توقيع السلة إعادة استدعاء واجهة برمجة التطبيقات إذا لم تتغير السلة جوهريًا - وهو أمر جيد للمتسوقين الذين يفتحون السلة ويغلقونها دون تعديلها.