Skip to main content
حلول لأشهر مشكلات ترقيات الاشتراك. إذا بقيت عالقًا بعد تجربة هذه الحلول، تواصل مع الدعم مزوّدًا بالتفاصيل المذكورة في الاختبار والتحقق.

​
مراقبة إخفاقات الترقية

يراقب Aftersell إخفاقات الترقية النهائية على مدى نافذة متجددة مدتها 7 أيام. إذا تجاوز عدد الإخفاقات حد التنبيه، يظهر شريط تحذير على صفحتك الرئيسية يوضح عدد الترقيات التي فشلت وعلى مدى كم يومًا. يظهر التنبيه نفسه أيضًا في لوحة Needs attention في الصفحة الرئيسية. يتضمن التنبيه زر Review orders الذي ينقلك مباشرة إلى متصفح الطلبات مع تصفية على مشكلات ترقية الاشتراك، حتى تتمكن من رؤية الطلبات المتأثرة والسبب المحدد لكل إخفاق. يزول التنبيه تلقائيًا بمجرد انخفاض عدد الإخفاقات إلى ما دون الحد خلال النافذة المتجددة. إذا رأيت هذا التنبيه، افتح متصفح الطلبات وتحقق من السبب المعروض على كل طلب متأثر، ثم راجع خطوات استكشاف الأخطاء ذات الصلة أدناه.
قالب Subscription Upgrade لا يُخفى أبدًا — فهو مدرج دائمًا ضمن Add Funnel، أيًا كان إعداد مزوّدك. ما يمنعك هو فحص الاتصال في الخطوة 1: يبقى زر Continue معطّلًا حتى يعيد Test API key النتيجة API key verified مع علامة صح خضراء.نتيجتان مختلفتان تعرضان أيقونة الإلغاء الحمراء نفسها، لذا اقرأ الرسالة بجانبها:
  • رفض مزوّدك المفتاح. تنقص الرمز النطاقات المطلوبة أو تم إلغاؤه، وتذكر الرسالة المشكلة تحديدًا. أصدر رمزًا جديدًا في لوحة تحكم مزوّدك بالنطاقات المدرجة في الإعداد والتكوين، والصقه، وأعد الاختبار.
  • لم يتمكن Aftersell من الوصول إلى مزوّدك — “Could not verify the API key. Please try again.” لا يعني ذلك بالضرورة وجود خطأ في الرمز؛ الاستدعاء نفسه هو الذي فشل. انقر على Test API key مرة أخرى.
تعديل المزوّد أو الرمز يمسح النتيجة السابقة، لذا أعد الاختبار بعد أي تغيير.
هذا سلوك متوقع. المنتج هو منتج العرض، وهو البند النائب المُضاف إلى طلب Shopify كسجل للترقية المقبولة. لتقليل الالتباس، أعد تسمية منتج العرض إلى اسم واضح وأضف وصفًا في Shopify Admin يشرح ما يمثله. راجع ما يراه العميل.
مجموعة تغييرات Shopify واستدعاء API الخاص بالمزوّد مستقلان. إذا أُضيف منتج العرض إلى الطلب لكن الاشتراك لم يتغير، فأكثر الأسباب شيوعًا هي:
  • رمز API الخاص بمزوّدك منتهي الصلاحية أو تنقصه الأذونات المطلوبة. بالنسبة إلى Recharge، يجب أن يملك الرمز النطاقات read_orders وread_subscriptions وwrite_subscriptions وread_plans. انتقل إلى الخطوة 1: ربط المزوّد، وأعد اختبار مفتاحك، وتحقق من رسالة الخطأ لمعرفة النطاقات المفقودة تحديدًا.
  • المنتج المؤهل في المسار لا يطابق ما اشترك فيه العميل فعليًا.
  • بالنسبة إلى Loop، خطة البيع المستهدفة غير موجودة في لوحة تحكم Loop للتكرار المكوّن.
  • قد يكون سير عمل إعادة المحاولة لا يزال يعمل وفق جدوله: بعد استدعاء فاشل يحاول مرة أخرى بعد ساعة واحدة، ثم بعد 24 ساعة. هذا هو نفسه لكل مزوّد — بما في ذلك Loop، الذي تكون استدعاءات الترقية فيه متزامنة وتظهر في لوحة التحكم فورًا عند نجاحها.
يعيد Aftersell تلقائيًا محاولة استدعاءات المزوّد الفاشلة في سير عمل خلفي. يتحقق سير العمل من الحالة الحالية لدى المزوّد قبل إعادة التشغيل، لذا لا تُطبّق الترقية الناجحة لكن البطيئة مرتين.إذا تعذر على إعادة التشغيل إصلاح السبب، فإن سير العمل إما يسترد المبلغ — عندما لا تنجح أي عملية تعديل لدى المزوّد ويكون البند المُحصَّل عنصرًا نائبًا — أو يضع علامة على الترقية من أجل تسوية يدوية، مع ترك الطلب كما هو. الاشتراكات الجديدة كليًا وترقيات الصناديق لا تُسترد تلقائيًا أبدًا، لأن المتسوق يستلم منتجات حقيقية. تواصل مع الدعم مزوّدًا بالتفاصيل المذكورة في الاختبار والتحقق.
يجلب خيار “Use an existing selling plan” الخطط مباشرة من Recharge أو Skio أو Loop. إذا كانت القائمة المنسدلة فارغة:
  • تأكد من تكوين خطط البيع في لوحة تحكم مزوّدك.
  • تأكد من أن رمز API الخاص بك يملك صلاحية قراءة على الخطط (Recharge: نطاق read_plans) أو النطاقات المناسبة (Skio وLoop).
  • ارجع إلى الخطوة 1: ربط المزوّد، وأعد اختبار مفتاح API الخاص بك، ثم تابع.
هذا متوقع. في Loop لا يُعرض حقل Billing frequency على الإطلاق — فقط Delivery frequency، مع الملاحظة “Loop syncs billing to delivery — customers are charged on each renewal”. ما تعيّنه كتكرار تسليم هو أيضًا تكرار الفوترة.وهذا أيضًا سبب عدم دعم الاشتراكات المدفوعة مسبقًا — أي تكرار فوترة أطول من تكرار التسليم — على Loop: يرفضها التكامل رفضًا تامًا بدلًا من عرض حقل لا يمكنك استخدامه. المزوّدون الآخرون يعرضون كلا الحقلين.
منتج العرض متاح بالاشتراك فقط — إما المنتج نفسه أو كل متغير من متغيراته — وكانت عملية الدفع للعميل تحتوي بالفعل على اشتراك. لا يسمح Shopify باشتراك ثانٍ على الطلب نفسه، لذا تم تخطي العرض.توضح لوحة تفاصيل الطلب أي الحالتين هي: “The customer’s checkout already has a subscription, and the offer product is subscription-only”، أو “All variants of the offer product are subscriptions, and the customer’s checkout already has one.” تُحل الحالتان بالطريقة نفسها — عدّل اختيار المنتج في العرض واستبدله بمنتج شراء لمرة واحدة، أو استخدم خيار Create new في الخطوة 4: منتج العرض لإنشاء عنصر نائب.
  • تحقق من أن Show this funnel for all customers غير مفعّل. فهذا يتجاوز جميع المشغّلات الأخرى.
  • تحقق من مُشغِّل Variant on subscription. فهو يعرض المسار فقط عندما يتضمن الطلب أحد المنتجات المحددة المشتراة كاشتراك. في المسار الذي يحتوي على عرض ترقية اشتراك، يملك المعالج هذا المُشغِّل ويبقيه متزامنًا مع المنتج الذي تتم ترقيته، لذا فهو للقراءة فقط — تعرض اللوحة “Managed by this funnel’s subscription upgrade offer.” إذا كان يستهدف المنتجات الخاطئة، فصحّح المنتج المُشغِّل لعرض الترقية بدلًا من المُشغِّل نفسه.
  • تحقق من أولوية المسار. قد يُطلق مسار ذو أولوية أعلى ومشغّلات أوسع أولًا.
لا تحاول إعادة إنتاج هذا بمُشغِّل منتج منفصل مع مُشغِّل اشتراك. تلك التركيبة هي بالضبط ما حل محله Variant on subscription: كان الشرطان يتطابقان بشكل مستقل، لذا فإن طلبًا يحتوي على منتجك المُشغِّل كشراء لمرة واحدة وعنصر اشتراك غير ذي صلة كان يستوفي كليهما، ويُطلق المسار، ثم تفشل الترقية لاحقًا. مُشغِّل واحد يطابق المنتج وحالة الاشتراك معًا هو الإعداد المدعوم.