المنتجات

تعرض صفحة المنتجات كتالوج منتجاتك الكامل مع إمكانات التصفية والبحث.

ميزات لوحة التحكم

إحصاءات الكتالوج

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

الفلاتر

صفِّ المنتجات باستخدام عدة معايير:

الفلتر	الوصف
البحث	اعثر على المنتجات بالاسم أو الوصف أو SKU
الفئة	صفِّ حسب فئة المنتج
العلامة التجارية	صفِّ حسب اسم العلامة
حالة المخزون	كل المخزون أو متوفر في المخزون أو مخزون منخفض أو نفد من المخزون

جدول المنتجات

جدول قابل للفرز يعرض:

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

عرض المنتجات

1. انتقل إلى التجارة الإلكترونية > المنتجات.
2. استخدم مربع البحث للعثور على منتجات محددة.
3. طبق الفلاتر لتضييق النتائج.
4. استعرض النتائج المرقمة.

فهم بيانات المنتج

حقول المنتج

الحقل	الوصف
externalId	معرّف المنتج الفريد لديك (مثل SKU)
name	اسم عرض المنتج
price	سعر البيع الحالي. يكون فارغًا عندما لا يعطي المتجر المنتج سعرًا: يعرض الكتالوج "بلا سعر"، ولا يطابق المنتج أي شرط سعر أبدًا (شرط "السعر أقل من 10" لا يعامله على أنه 0). السعر 0 المحدد في المتجر يبقى 0
compareAtPrice	السعر الأصلي (يعرض الخصم)
currency	رمز عملة السعر
categories	مصفوفة أسماء الفئات
tags	مصفوفة علامات المنتج
brand	اسم العلامة التجارية أو البائع
imageUrl	صورة المنتج الرئيسية
inStock	حالة التوفر
variants	تنويعات الحجم/اللون

التنويعات

يمكن أن يكون للمنتجات عدة تنويعات بأسعار أو SKUs أو حالات مخزون أو خيارات مختلفة (الحجم واللون وغيرها).

مزامنة المنتجات

تتزامن المنتجات عادة من منصة التجارة الإلكترونية. تدعم Joryio:

• Shopify: مزامنة تلقائية عبر Webhook
• WooCommerce: تكامل REST API
• Magento: امتداد Joryio Connect
• منصات مخصصة: استخدم Products API

الاستيراد المجمع

استخدم API التحديث/الإدراج المجمع لاستيراد المنتجات: أرسل POST لمصفوفة JSON مباشرة (حد أقصى 500) إلى نقطة نهاية المنتجات:

POST /catalog/products
[
  { "productId": "SKU-001", "name": "Product 1", "price": 19.99, "source": "shopify" },
  { "productId": "SKU-002", "name": "Product 2", "price": 29.99, "source": "shopify" }
]

استخدام المنتجات في الحملات

توصيات المنتجات

ضمّن المنتجات في حملات Email باستخدام قوالب Liquid:

{% assign picks = 'featured' | products %}
{% for product in picks %}
  <div class="product">
    <img src="{{ product.imageUrl }}" alt="{{ product.name }}">
    <h3>{{ product.name }}</h3>
    <p>${{ product.price }}</p>
    <a href="{{ product.url }}">Shop Now</a>
  </div>
{% endfor %}

'featured' هو اسم تحديد منتجات محفوظ في صفحة المنتجات. يعمل المرشح products في كل إرسال وفي المعاينة؛ راجع مرجع Liquid.

لاختيارات لكل عميل (مخصصة، واشتُريت معًا، وعناصر مشابهة، ووصل حديثًا وغيرها) في أي قناة، راجعوا توصيات المنتجات.

التخصيص

ثلاثة متغيرات تصف ما اشتراه المستلم، أو ما هو على وشك شرائه. تُحلّ لكل جهة اتصال وقت الإرسال وفي المعاينة، في كل قناة، للحملات والرحلات على حد سواء - وتكون فارغة لجهة اتصال ليس لديها طلبات في المتجر، لذا غلّف كلًا منها بـ {% if %}.

المتغير	ما يحتويه	متى تستخدمه
cart	سلة المتجر المتزامنة لجهة الاتصال: items وvalue وsubtotal (المجموع الفرعي للعناصر، قبل الشحن) وcurrency وitemCount وcheckoutUrl. فارغ عندما تكون السلة فارغة	استرداد السلة - "تركت هذه خلفك"، مع رابط إتمام الشراء
last_order	أحدث طلب لهم لم يُلغَ ولم يُسترد: id وplacedAt وtotal وcurrency وstatus وitemCount وitems وorderUrl	إعادة الطلب والمتابعة - "كيف كان طلبك؟"، "اطلبه مجددًا"
top_products	المنتجات التي يطلبونها أكثر، حتى 5، الأكثر تكرارًا أولًا: name وsku وimageUrl وurl وtimesOrdered وlastOrderedAt	عروض قائمة على العادة - "طلبك المعتاد؟"

العناصر في cart.items وlast_order.items لها شكل واحد - name وquantity وprice وtotal وimageUrl وurl وsku - لذا فإن حلقة مكتوبة لأحدهما تعمل على الآخر.

سلة متروكة:

{% if cart %}
{% for item in cart.items %}
  <p>{{ item.name }} x {{ item.quantity }} - {{ item.total | currency: cart.currency }}</p>
{% endfor %}
<p>إجمالي السلة: {{ cart.value | currency: cart.currency }}</p>
<a href="{{ cart.checkoutUrl }}">إتمام الشراء</a>
{% endif %}

أي رابط. {{ cart.checkoutUrl }} هو رابط الاسترداد الخاص بالمتجر نفسه لهذه السلة (WooCommerce وMagento وPrestaShop: الرابط الذي ترسله إضافة Joryio عند التخلي عن السلة؛ Shopify: رابط استرداد صفحة الدفع)، لذا يعيد بناء السلة على أي جهاز. فقط السلة التي لم يرسل لها المتجر رابط استرداد تحصل على صفحة الدفع في المتجر. ولا يُستخدم أبدًا رابط ليس على عنوان المتجر المتصل. السلة التي تُركت قبل هذه القاعدة (2026-11-01) تحتفظ بصفحة الدفع العادية إلى أن يبلّغ المتجر عن تركها مرة أخرى.

جهة اتصال بلا سلة. رسالة السلة التي يربط زرها {{ cart.checkoutUrl }} لا تُرسل إلى من ليس لديه سلة متزامنة (أو سلة لم يمنحها المتجر رابط استرداد): سيظهر الرابط فارغًا، زرًا لا يؤدي إلى أي مكان. يُسجَّل الإرسال كمتخطى، بالسبب لا يوجد رابط سلة للإرسال (cart_link_missing). للإرسال رغم ذلك، أعطِ الرابط قيمة احتياطية: {{ cart.checkoutUrl | default: 'https://your-store.com/cart' }}. تعرض معاينة البريد سلة نموذجية موسومة لجهة اتصال بلا سلة، وينبّه Launch Review عندما تقرأ رسالة في الرحلة cart بينما لا تبدأ الرحلة بحدث سلة (Cart Abandoned وCheckout Started وProduct Added وCart Updated وCart Viewed).

آخر طلب والمنتجات المعتادة:

{% if top_products.size > 0 %}
<p>طلبك المعتاد يا {{ user.firstName }}؟ {{ top_products | map: "name" | join: " + " }}</p>
{% endif %}
{% if last_order %}
<p>في المرة الماضية ({{ last_order.placedAt | date_format }}) طلبت:</p>
{% for item in last_order.items %}
  <p><a href="{{ item.url }}">{{ item.name }}</a> x {{ item.quantity }}</p>
{% endfor %}
{% endif %}

اختر واحدًا من مجموعة Shopping في منتقي التخصيص في أي محرر لإدراج مقتطف جاهز. القائمة الكاملة في مرجع Liquid.

اختيارات المنتجات

الاختيار فلتر محفوظ قابل لإعادة الاستخدام فوق كتالوج منتجاتك، مثل «الأحذية المخفضة» أو «العناصر المتوفرة بأقل من $50» أو «كل ما يحمل علامة new-arrival». ابنِها مرة وأعد استخدامها أينما تعرض المنتجات.

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

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

أفضل الممارسات

1. حافظ على مزامنة المنتجات: تأكد من المزامنة المنتظمة مع منصة التجارة الإلكترونية.
2. استخدم صورًا عالية الجودة: تحسن صور المنتجات التفاعل في Email.
3. حافظ على دقة المخزون: تتطلب إشعارات نفاد المخزون بيانات دقيقة.
4. صنف باستمرار: استخدم فئات متسقة لتصفية أفضل.
5. ضمّن عناوين URL: تمكّن عناوين URL للمنتجات تتبع النقر المباشر.

استكشاف الأخطاء وإصلاحها

المنتجات لا تظهر

• تحقق من مصادقة API.
• تحقق من صحة معرّف مساحة العمل.
• تأكد من أن المنتجات تحمل الحقول المطلوبة (externalId وname وprice).

الصور لا تُحمّل

• تحقق من إتاحة عناوين URL للصور للعامة.
• تحقق من متطلبات HTTPS.
• تأكد من عدم انتهاء صلاحية عناوين URL للصور.

حالة المخزون غير صحيحة

• قد يحتاج فاصل المزامنة إلى ضبط.
• تحقق من ضبط Webhook.
• تحقق من تفعيل تتبع المخزون.

الخطوات التالية

• إنشاء حملات توصيات المنتجات
• إعداد تدفقات السلات المتروكة
• عرض توثيق Products API