في هذا الدليل
قبل أن تبدأ، ستحتاج إلى:
- باقة فعّالة في سِيَاق. ولاستخدام رابط ملف المنتجات أو رفع ملف، يجب أن يكون المتجر مُعَدًّا لمنصة أخرى.
- منتجاتك في ملف CSV أو JSON، أو رابط ملف منتجات يعرضها قائمةً بصيغة JSON، بأسماء أعمدة النموذج نفسها.
- عنوان متجرك الخاص؛ فالمنتجات التي تضيفها يدويًا يجب أن تشير روابطها إلى صفحات فيه.
متجرك ليس على سلة أو Shopify أو WooCommerce؟ أعطِ سِيَاق كتالوجك عبر رابط ملف المنتجات، فتقرؤه كل يوم، أو عبر ملف ترفعه بنفسك. ويمكنك أيضًا إضافة منتجات مفردة يدويًا في أي متجر.
رابط ملف المنتجات
يُقرأ من جديد كل يوم
ملف CSV أو JSON
ابدأ من النموذج الجاهز
إضافة يدوية
في صفحة «المنتجات»
كتالوجك في سِيَاق
مع التحقق من المعلومات الناقصة
جدولة أول فحص
تلقائيًا بعد اكتمال المزامنة الأولى
استورد منتجاتك عبر رابط أو ملف#
احفظ رابط متجرك في صفحة «ربط المتجر»
افتح صفحة «ربط المتجر» من القائمة الجانبية. اكتب عنوان متجرك، مثل
shop.sa، ثم اضغط زر «حفظ رابط المتجر».لقطة من لوحة تحكم سِيَاق (متجر تجريبي) نزّل نموذجًا واملأه
في الصفحة نفسها، اضغط «نموذج CSV» أو «نموذج JSON». أبقِ أسماء الأعمدة كما هي، وخصّص صفًا لكل منتج.
ارفع الملف أو احفظ رابط الملف
- ملف: اضغط زر «رفع ملف CSV / JSON» واختر ملف .csv أو .json. يجري الاستيراد فورًا، ويخبرك بعدد المنتجات المضافة والمحدَّثة.
- رابط ملف: الصق رابط قائمة منتجاتك بصيغة JSON في حقل «رابط ملف المنتجات»، ثم اضغط زر «حفظ رابط الملف». تقرؤه سِيَاق فورًا، ثم مرة كل يوم.
راجع النتيجة في قسم «مزامنة بيانات متجرك»
يعرض عدد المنتجات وقائمة «عمليات المزامنة السابقة» كل عملية استيراد، وتظهر رسالة الخطأ أسفل أي عملية متعثّرة. وبعد رفع ملف، تظهر الصفوف التي تعذّر استيرادها أسفل زر الرفع مع سبب رفضها: أول خمسة صفوف، ثم عدد البقية. أما الصفوف الصحيحة فقد استُوردت بالفعل، فصحّح الصفوف المذكورة وارفع الملف كاملًا مرة أخرى.
لقطة من لوحة تحكم سِيَاق (متجر تجريبي)
أعمدة الملف#
يحمل الصف الأول أسماء الأعمدة كما في النموذج تمامًا. ولا يلزم إلا عمودا handle وprice.
| العمود | ما تكتبه فيه |
|---|---|
handle | إلزامي. معرّف فريد بحروف إنجليزية وأرقام وشرطات، مثل cotton-throw-pillow. وتطابق سِيَاق المنتجات بواسطته. |
price | إلزامي. رقم دون رمز عملة أو فواصل للآلاف، مثل 145.50. |
title_en، title_ar | اسم المنتج بالإنجليزية والعربية. |
desc_en، desc_ar | الوصف بالإنجليزية والعربية. |
url | صفحة المنتج في متجرك. |
image_urls | حتى 10 روابط صور، يُفصل بينها في ملف CSV بالرمز |. ويُرفض الصف إن زادت على 10. |
stock | الكمية المتوفرة. وتُعدّ صفرًا إن تُركت فارغة. |
category، category_ar | اسم التصنيف، واسمه بالعربية. |
brand | اسم العلامة التجارية. |
status | active (الافتراضي)، أو draft (مخفي عن مساعدي الذكاء الاصطناعي)، أو archived — بأحرف صغيرة. |
currency | رمز من ثلاثة أحرف مثل SAR. وتُعتمد عملة متجرك إن تُرك فارغًا. |
external_id | معرّف المنتج لديك، من نظام آخر مثلًا. |
أضف منتجًا يدويًا#
استخدم هذه الطريقة للمنتجات المفردة، أو للمنتجات التي لا تصل عبر مزامنة متجرك. وهي متاحة في أي متجر، مربوطًا كان أو غير مربوط.
افتح صفحة «المنتجات» من القائمة الجانبية واضغط «إضافة منتج جديد»
لقطة من لوحة تحكم سِيَاق (متجر تجريبي) املأ الحقول الإلزامية الثلاثة
- اسم المنتج في حقل «الاسم (بالإنجليزية)» أو «الاسم (بالعربية)»، وملء اللغتين أفضل لنتائجك.
- السعر، بعملة متجرك.
- حقل «رابط صفحة المنتج»: صفحة المنتج في متجرك التي يُباع فيها، إذ يرسل مساعدو الذكاء الاصطناعي المشترين إليها لإتمام الشراء.
أضف ما لديك من تفاصيل
الأوصاف، وروابط الصور (تبدأ بـ https، رابط في كل سطر، حتى 10 روابط)، والمخزون، ورمز SKU، والعلامة التجارية، وتصنيف موجود، وحقل «الاسم في الرابط (اختياري)» — كلها تجعل بيانات المنتج أكمل.
اختر الحالة واضغط «حفظ المنتج»
اختر «نشط — يظهر لأنظمة الذكاء الاصطناعي»، أو «مسودة — مخفي» ما دمت تجهّز المنتج.
تحمل المنتجات التي تضيفها هنا شارة «أُضيف هنا». ولتعديل أحدها، اضغط «تعديل» في صفه، وتجد زر «حذف المنتج» في النموذج نفسه. أما المنتجات المُزامَنة فلا تُعدَّل في سِيَاق، بل عدّلها في متجرك ثم زامنها من جديد.
أبقِ كتالوجك محدَّثًا#
- رابط الملف: تقرؤه سِيَاق كل يوم، ولقراءته الآن اضغط «مزامنة المنتجات». وإن انتقلت إلى رفع الملفات، فاضغط «إزالة رابط الملف»؛ فيتوقف التحديث اليومي وتبقى منتجاتك.
- الملف: ارفع الملف كاملًا من جديد كلما تغيّر كتالوجك.
- يُعدّ كل ملف أو رابط كتالوجك الكامل: المنتجات النشطة الغائبة عنه تُؤرشَف، فتخرج من صفحة الكتالوج التي تقرؤها أدوات الذكاء الاصطناعي. أما المنتجات المضافة يدويًا فتبقى، إلا إذا جاء الاستيراد بمنتج له قيمة
handleنفسها، فتحلّ النسخة المستوردة محلّه. - تُحتسب المنتجات النشطة ضمن حد المنتجات في باقتك، وكذلك كل منتج تضيفه يدويًا ولو كان مسودة. وإذا تجاوز الاستيراد الحد، يتوقف عنده وينبّهك إلى ذلك في قسم «مزامنة بيانات متجرك». قارن الباقات.
- بعد أول استيراد يصبح متجرك فعّالًا. ومتى كانت لمنتجاتك تصنيفات، تبدأ سِيَاق أول فحص لك تلقائيًا. ولإضافة بيانات منتجاتك إلى واجهة متجرك أيضًا، راجع دليل اجعل متجرك مقروءًا لأدوات الذكاء الاصطناعي.
إذا لم يعمل شيء كما ينبغي#
| ما تراه | ما الذي تفعله |
|---|---|
| «لم نتمكن من قراءة أي منتج من الملف. راجع أسماء الأعمدة وفق القالب وحاول مرة أخرى.» | قارن الصف الأول بالنموذج: يجب أن تطابق أسماء الأعمدة، مثل handle وprice، وأن يستخدم ملف CSV الفاصلة بين الأعمدة. |
| «تعذّر استيراد» بعض الصفوف | صحّح السبب الظاهر لكل صف (يظهر بالإنجليزية)، ثم ارفع الملف مجددًا. ومن الأسباب الشائعة: handle أو price فارغ، أو سعر ليس رقمًا، أو handle مكرر. |
| مزامنة رابط الملف بحالة «فشلت» | اقرأ الخطأ الظاهر أسفلها. وتأكد أن الرابط يُفتح دون تسجيل دخول، ويستجيب خلال ثوانٍ، ويعرض قائمة منتجاتك بصيغة JSON بأسماء أعمدة النموذج. ثم اضغط «مزامنة المنتجات». |
| «أضف عنوان متجرك في صفحة ربط المتجر أولًا، فروابط المنتجات يجب أن تشير إلى متجرك.» | احفظ رابط متجرك في صفحة «ربط المتجر»، ثم أضف المنتج مرة أخرى. |
| «يجب أن يكون رابط صفحة المنتج على متجرك» | استخدم رابط المنتج على النطاق الذي حفظته رابطًا لمتجرك. |
| رسالة تفيد بأن باقتك تسمح بعدد محدد من المنتجات | احذف منتجًا أضفته يدويًا ولم تعد تحتاجه، أو اجعل حالة بعض المنتجات في ملفك draft أو archived وارفعه مجددًا، أو قارن الباقات. والمسودات المضافة يدويًا تُحتسب أيضًا. |
هل كان هذا الدليل مفيدًا؟
أدلة ذات صلة
- جهّز متجرك للذكاء الاصطناعياجعل متجرك مقروءًا لأدوات الذكاء الاصطناعيأضف بيانات منتجات سِيَاق وملف llms.txt إلى متجرك، وتحقّق من عملها، وحدّث سياساتك لتقرأها أدوات الذكاء الاصطناعي المتوافقة.
- افهم نتائجكنفّذ توصياتكاعمل على أهم توصيات التحسين، وأكمل بيانات منتجاتك، وتابع ما تغيّر في الفحوص اللاحقة، باتباع روتين أسبوعي بسيط.
- الحساب والفوترة والدعمحلّ المشكلات الشائعةابحث عن المشكلة التي تواجهها، مثل متجر عالق في الربط أو مزامنة فاشلة أو تقرير غائب أو متجر متوقف أو رسائل لا تصل، وأصلحها خطوة بخطوة.