> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# لماذا لا يظهر عرض زيادة المبيعات في صفحة الدفع لديّ؟

> شرح كامل لكل سبب قد يمنع ظهور عرض زيادة المبيعات في صفحة الدفع، بما في ذلك مشكلات الإعداد والموضع والمحفّزات والمنتج/العرض.

قد يفشل ظهور عروض زيادة المبيعات في صفحة الدفع لعدة أسباب مختلفة. اتّبع الخطوات أدناه بالترتيب لتحديد السبب.

<Note>
  عروض زيادة المبيعات في صفحة الدفع متاحة فقط لتجار Shopify Plus، لأن واجهة Checkout Extensibility API في Shopify مقصورة على Plus. إذا لم تكن على خطة Shopify Plus، فلن تظهر عروض صفحة الدفع بغض النظر عن إعداداتك. راجع [لماذا لا يمكنني رؤية علامة تبويب الدفع؟](/ar/aftersell/why_cant_i_see_the_checkout_tab)
</Note>

<Tip>
  إذا لم يظهر عرض زيادة المبيعات، فلن تتأثر تجربة الدفع لدى العميل — لا شيء يتعطل من جهة العميل.
</Tip>

***

<div id="where-to-start">
  ## من أين تبدأ
</div>

تعود معظم مشكلات العرض إلى أحد أربعة أمور: الأداة غير مفعّلة، أو كتلة التطبيق غير مضافة/محفوظة في Shopify، أو الموضع غير متطابق، أو شروط المحفّزات غير مستوفاة. تأكد من الأساسيات أولًا:

* أنت على خطة **Shopify Plus**
* الأداة **مفعّلة** في محرر Checkout في Aftersell (مفتاح **Enable** في أعلى يمين إعدادات الأداة مشغّل)
* كتلة التطبيق **مضافة ومحفوظة** في محرر Shopify Checkout Editor
* الموضع المحدد في Shopify **يطابق** الموضع المضبوط في Aftersell

إذا تحققت من كل ذلك وما زال عرض الزيادة لا يظهر، فاتّبع الأسباب المفصلة أدناه.

* [الأداة غير مفعّلة أو غير مضافة إلى صفحة الدفع](#widget-is-not-enabled-or-not-added-to-checkout)
* [عدم تطابق الموضع بين Aftersell وShopify](#placement-mismatch-between-aftersell-and-shopify)
* [شروط المحفّزات غير مستوفاة](#trigger-conditions-are-not-being-met)
* [هناك مشكلة في المنتج أو العرض](#there-is-a-product-or-offer-issue)
* [أدوات Shop Pay لا تظهر](#shop-pay-widgets-not-showing)
* [الاختبار في معاينة Shopify](#testing-in-the-shopify-preview)
* [لا شيء مما سبق ينطبق](#nothing-above-applies)

***

<div id="widget-is-not-enabled-or-not-added-to-checkout">
  ## الأداة غير مفعّلة أو غير مضافة إلى صفحة الدفع
</div>

لكي يظهر عرض زيادة المبيعات في صفحة الدفع، يجب أن يتحقق أمران في الوقت نفسه:

1. يجب أن تكون الأداة **مفعّلة** في محرر Checkout في Aftersell
2. يجب أن تكون كتلة التطبيق **مضافة ومحفوظة** في محرر Shopify Checkout Editor

إذا كان أي منهما مفقودًا، فلن تظهر الأداة.

**لتفعيل الأداة في Aftersell:**

1. انتقل إلى **Apps ← Aftersell ← Checkout**
2. افتح أداة زيادة المبيعات التي تريد عرضها
3. تأكد من تشغيل الأداة — يعرض الرأس مفتاحًا بجانب شارة **Active** / **Inactive**. (في محرر Checkout الأقدم يكون هذا زوج زرّي **Enable** / **Disable** في رأس بطاقة الأداة.)

**لإضافة كتلة التطبيق في Shopify:**

1. انتقل إلى **Settings ← Checkout** في لوحة إدارة Shopify
2. انقر على **Customize** بجانب ملف تعريف الدفع الخاص بك
3. انقر على **Add app block** وحدد أداة زيادة المبيعات من Aftersell
4. ضعها في المكان الذي تريد ظهورها فيه
5. انقر على **Save** — لا تُطبَّق التغييرات حتى يتم حفظها

***

<div id="placement-mismatch-between-aftersell-and-shopify">
  ## عدم تطابق الموضع بين Aftersell وShopify
</div>

عدم تطابق الموضع هو أحد أكثر الأسباب شيوعًا لفشل ظهور عرض زيادة المبيعات في صفحة الدفع.

يدعم Aftersell مواضع متعددة بحيث يمكنك تشغيل أكثر من أداة من النوع نفسه على صفحة الدفع نفسها. يقابل كل موضع **كتلة تطبيق منفصلة** في محرر Shopify Checkout Editor، ويجب أن يطابق الموضع المحدد في Shopify الموضع المضبوط في Aftersell.

تقدم قائمة **Placement** المنسدلة الخاصة بكتلة تطبيق Upsell Widget ثماني قيم: **Default placement (Upsell Widget 1)** و**Additional placement 1 (Upsell Widget 2)** و**Additional placement 2 (Upsell Widget 3)** وخمس خانات لأدوات الصفحات من **page-upsell-001** إلى **page-upsell-005**.

إذا لم تتطابق المواضع، فلن تظهر الأداة أو قد تظهر في المكان الخطأ.

**لإصلاح عدم تطابق الموضع:**

1. في محرر Checkout في Aftersell، افتح أداة زيادة المبيعات ولاحظ الموضع المحدد (مثلًا، **Additional placement 1**)
2. في محرر Shopify Checkout Editor، أزل كتلة التطبيق الحالية لهذه الأداة
3. انقر على **Add app block**، وحدد أداة زيادة المبيعات من Aftersell، واختر **نفس الموضع** المضبوط في Aftersell
4. احفظ تغييراتك

[تعرّف على المزيد حول مطابقة المواضع ←](/ar/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)

***

<div id="trigger-conditions-are-not-being-met">
  ## شروط المحفّزات غير مستوفاة
</div>

إذا كانت أداة زيادة المبيعات لديك تحتوي على محفّزات مضبوطة، فلن تظهر إلا عندما تستوفي السلة تلك الشروط. إذا لم تستوفِ السلة شروط المحفّزات، فلن تظهر الأداة — وهذا سلوك متوقع.

تشمل أنواع المحفّزات المتاحة:

* **منتجات / تشكيلات محددة:** منتج أو متغيّر أو تشكيلة مختارة موجودة (أو غير موجودة) في السلة
* **كمية منتج محدد:** مثلًا قطعتان أو أكثر من منتج
* **وسم المنتج / نوع المنتج / اسم المتغيّر:** أي عنصر في السلة يطابق وسم Shopify أو نوع المنتج أو عنوان المتغيّر (دون حساسية لحالة الأحرف)
* **حقل تعريف المنتج / حقل تعريف المتغيّر:** منتج أو متغيّر في السلة له قيمة metafield مطابقة
* **المجموع الفرعي للسلة:** المجموع الفرعي يبلغ حدًا معينًا (راجع الملاحظة أدناه حول كيفية حساب المجموع الفرعي)
* **كمية السلة:** إجمالي عدد العناصر في السلة
* **اشتراك في السلة:** ما إذا كان أي عنصر في السلة اشتراكًا
* **سمة السلة:** مفتاح/قيمة سمة على مستوى السلة يتطابق (مفيد للبيانات التي تضبطها تطبيقات أخرى)
* **الخصم المطبّق / قيمة الخصم:** تم تطبيق رمز خصم محدد، أو بلغ إجمالي الخصم حدًا معينًا
* **بلد الشحن:** بلد شحن العميل (والمقاطعة اختياريًا) يتطابق
* **لغة العميل:** لغة صفحة الدفع تتطابق (مثلًا، عرض محتوى فرنسي فقط لصفحات الدفع الفرنسية)
* **وسوم العميل:** العميل المسجّل الدخول لديه الوسوم المطلوبة
* **نوع الجهاز:** العميل يستخدم الجهاز المضبوط (سطح مكتب أو جوال)

<Note>
  **المجموع الفرعي للسلة** المستخدم في تقييم المحفّزات يستثني أي بنود أُضيفت بالفعل بواسطة عروض زيادة مقبولة (تلك الموسومة بسمة السلة `__as_offer_id`). لذا فإن قبول عرض زيادة واحد لن يدفع المجموع الفرعي بحد ذاته فوق حد يتحكم في أداة أخرى.
</Note>

**دمج الشروط:** عندما تحتوي الأداة على عدة شروط، تُربط بواسطة **AND** أو **OR** (حسب اختيارك)، ويمكن تجميع الشروط في مجموعات متداخلة لمنطق أكثر تعقيدًا. في حالة ربط **AND**، يجب استيفاء كل شرط — شرط واحد غير مطابق يمنع الأداة بصمت. في حالة ربط **OR**، تكفي مطابقة واحدة. راجع كل شرط على حدة مقابل سلة الاختبار الخاصة بك.

**لاستكشاف مشكلات المحفّزات:**

1. افتح الأداة في محرر Checkout في Aftersell وراجع شروط محفّزاتها
2. اضبط المحفّز مؤقتًا على **Show for all customers** للتأكد من أن الأداة نفسها تعمل، ثم أعد تفعيل محفّزاتك المحددة
3. تأكد من أن أداة واحدة على الأقل تستخدم محفّز **Show for all customers** بأدنى أولوية كمحفّز شامل، بحيث يُعرض دائمًا عرض ما حتى عندما لا تتطابق أي أداة مستهدفة

[تعرّف على المزيد حول محفّزات صفحة الدفع ←](/ar/aftersell/checkout_triggers)

***

<div id="there-is-a-product-or-offer-issue">
  ## هناك مشكلة في المنتج أو العرض
</div>

حتى عندما تكون الأداة مفعّلة وموضوعة بشكل صحيح ومحفّزاتها متطابقة، قد يُستبعد العرض نفسه قبل ظهوره.

<AccordionGroup>
  <Accordion title="منتج زيادة المبيعات نفد من المخزون">
    إذا كان مخزون المنتج متتبعًا ولا يوجد متغيّر متاح للبيع، فلن يظهر العرض. تأكد من توفر مخزون لمتغيّر واحد على الأقل من منتج زيادة المبيعات، أو استخدم منتجًا لا يتتبع المخزون.
  </Accordion>

  <Accordion title="منتج زيادة المبيعات بحالة مسودة (Draft) أو مؤرشف (Archived)">
    يجب أن يكون منتج زيادة المبيعات منتجًا حيًا وقابلًا للبيع. المنتجات بحالة **Draft** أو **Archived** في Shopify تُستبعد ولن تظهر كعروض. افتح المنتج في لوحة إدارة Shopify وتأكد من أن حالته **Active**.
  </Accordion>

  <Accordion title="منتج زيادة المبيعات موجود بالفعل في السلة وخيار 'الإخفاء إذا كان في السلة بالفعل' مفعّل">
    يخفي إعداد **Hide offer if product already in cart** العرض عندما يكون ذلك المنتج موجودًا بالفعل في سلة العميل. وهو مفعّل افتراضيًا لعروض المنتجات القياسية. إذا أردت أن يظهر عرض الزيادة رغم ذلك، فعطّل هذا الإعداد في إعدادات العرض.
  </Accordion>

  <Accordion title="منتج زيادة المبيعات اشتراك ولكن ليس لديه خطط بيع">
    إذا كان **Subscription purchase option** مضبوطًا على **Subscription** ولكن المنتج ليس لديه خطط بيع مضبوطة في Shopify، فسيُستبعد العرض. تأكد من أن المنتج لديه خطة بيع نشطة واحدة على الأقل، أو غيّر **Subscription purchase option** إلى **One-time product** (الخياران الآخران هما **Subscription** و**Subscription and a one-time product**).
  </Accordion>

  <Accordion title="المنتج المستهدف لعرض الاستبدال غير موجود في السلة">
    إذا كان العرض مضبوطًا كعرض استبدال، فلن يظهر إلا عندما يكون المنتج المراد استبداله موجودًا في السلة. تأكد من تحديد المنتج المستهدف الصحيح في إعدادات عرض الاستبدال.

    يُتخطى عرض الاستبدال أيضًا عندما يكون **هناك خصم مطبّق بالفعل** على البند المستهدف — ما لم تحدد **Allow replacement if product has discount applied** — أو عندما تكون **كمية** البند المستهدف أكبر من واحد، ما لم تحدد **Allow replacement if product quantity greater than 1**.
  </Accordion>

  <Accordion title="تم بلوغ الحد الأقصى لعدد العروض المقبولة">
    إذا كان **Max number of accepted offers** مضبوطًا على الأداة، فسيتوقف عرض الزيادة عن الظهور بمجرد قبول العميل ذلك العدد من العروض من الأداة في عملية الدفع الحالية. هذا مقصود — بمجرد بلوغ الحد، تخفي الأداة نفسها. ينطبق هذا الحقل على عروض المنتج الفردي والمنتجات المتعددة فقط؛ أما عروض علامة الاختيار (Checkmark) فليس لها مثل هذا الحد.
  </Accordion>

  <Accordion title="تمت إضافة العرض إلى السلة بالفعل بواسطة هذه الأداة">
    بالنسبة لعروض **المنتج الفردي** و**المنتجات المتعددة**، بمجرد إضافة العميل منتج العرض إلى سلته، يُخفى العرض (المنتج موجود بالفعل في السلة). تتصرف عروض **علامة الاختيار (Checkmark)** بشكل مختلف — فهي تظل مرئية مع تحديد مربع الاختيار بعد قبولها.
  </Accordion>
</AccordionGroup>

***

<div id="shop-pay-widgets-not-showing">
  ## أدوات Shop Pay لا تظهر
</div>

لا تظهر أدوات صفحة الدفع في Shop Pay افتراضيًا. لعرض عرض الزيادة الخاص بك في Shop Pay، يجب تفعيله صراحةً:

1. افتح كتلة تطبيق زيادة المبيعات من Aftersell في محرر Shopify Checkout Editor
2. في إعدادات الكتلة، ابحث عن قسم **Checkout behaviour**
3. حدد خيار **Include app block in Shop Pay**
4. احفظ تغييراتك

[تعرّف على المزيد حول أدوات Shop Pay ←](/ar/aftersell/show_checkout_widgets_in_shop_pay)

***

<div id="testing-in-the-shopify-preview">
  ## الاختبار في معاينة Shopify
</div>

لا تعرض معاينة محرر Shopify Checkout Editor الأدوات بشكل موثوق. يمكن أن تكون الأداة مضبوطة بشكل صحيح ومع ذلك لا تظهر في معاينة المحرر، لأن المعاينة لا تستطيع محاكاة وسم الصفحات وشروط المحفّزات. لا تعتمد على معاينة المحرر للتأكد من عمل الأداة.

**لاختبار عرض الزيادة بدقة:**

1. اضبط محفّز الأداة مؤقتًا على **Show for all customers**
2. قدّم طلبًا اختباريًا حقيقيًا باستخدام بوابة الدفع الاختبارية من Shopify (أو رمز خصم يجعل الطلب مجانيًا)
3. تأكد من ظهور الأداة أثناء تدفق الدفع الفعلي
4. أعد ضبط محفّزاتك بعد الاختبار

***

<div id="nothing-above-applies">
  ## لا شيء مما سبق ينطبق
</div>

إذا اتّبعت كل ما سبق وما زال عرض الزيادة لا يظهر، فتأكد مما يلي:

* الأداة **مفعّلة** في Aftersell وكتلة التطبيق **مضافة ومحفوظة** في محرر Shopify Checkout Editor
* **الموضع** في Aftersell يطابق الموضع المحدد في Shopify
* شروط المحفّزات تطابق سلة الاختبار الخاصة بك — تذكّر أنه في حالة ربط **AND**، يجب استيفاء كل شرط
* توجد أداة واحدة على الأقل بمحفّز **Show for all customers** بأدنى أولوية كمحفّز شامل
* منتج زيادة المبيعات بحالة **Active**، ومتوفر في المخزون، و(لعروض الاشتراكات) لديه خطط بيع نشطة
* أنت تختبر عبر **تدفق دفع حقيقي**، وليس معاينة محرر Shopify
* جرّب مسح ذاكرة التخزين المؤقت للمتصفح أو الاختبار في نافذة تصفح خفي — قد تستغرق التغييرات بضع دقائق حتى تنتشر

لم تُحل المشكلة بعد؟ تواصل معنا عبر الدردشة أو راسلنا على [support@aftersell.app](mailto:support@aftersell.app) مع تضمين وصف لإعداد الأداة لديك وتفاصيل الطلب الاختباري.