يحدّ Shopify صور المنتجات بـ 20 ميغابايت و20 ميغابكسل، ويصغّر التطبيق الصور الأكبر تلقائيًا. تنتج معظم مشكلات المطابقة عن معرّفات مكررة أو فارغة أو أخطاء صغيرة في التسمية، وكلها تظهر في المعاينة قبل الرفع.
الحدود
| الحد | القيمة | ماذا يفعل التطبيق |
|---|---|---|
| حجم الملف | 20 ميغابايت (Shopify) | يصغّر ويعيد ترميز jpg وjpeg وpng وwebp وgif. لا يُظهر خطأ واضحًا إلا إذا ظل الملف غير مناسب. |
| الدقة | 20 ميغابكسل (Shopify) | يصغّر إلى نحو 18 ميغابكسل ويعيد المحاولة. |
| الصور لكل منتج | 250 (Shopify) | حد Shopify نفسه |
| الخطة المجانية | 25 صورة إجمالًا | تتوقف المهمة برسالة «Free upload limit reached». |
| جداول المعاينة | 5,000 صف معروض لكل جدول | العدّادات وتصدير CSV تشمل كل شيء. |
| نتائج المطابقة | تُحفظ لمدة ساعتين | أعد المطابقة إذا انتظرت أكثر. |
| حد معدّل الملفات في Shopify | للمتجر كله | انتظار تلقائي (3 ث ← 6 ث ← 12 ث) ثم إعادة المحاولة. |
تُدرج الصور التي تتجاوز الحدود في تنبيه بصفحة المعاينة قبل الرفع.
المواصفات الموصى بها: JPG أو WEBP، بطول 2048 إلى 4096 بكسل للضلع الأطول، وsRGB، وحجم أقل من 5 ميغابايت.
كم تستغرق عمليات الرفع الكبيرة
يحدّ Shopify من سرعة تغيير الملفات في المتجر كله. ينزّل التطبيق الصور ويرفعها بالتوازي ويبطئ تلقائيًا عند بلوغ الحد، لذا تتقدّم المهام الكبيرة بثبات لا بسرعة. احسب ساعات لا دقائق لعشرات الآلاف من الصور. يُحفظ التقدّم لكل صورة، فتستأنف إعادة التشغيل من حيث توقفت.
مشكلات المطابقة
| العَرَض | السبب المحتمل | الحل |
|---|---|---|
| لم تُطابَق أي صورة | نوع مطابقة أو مجلد خاطئ، أو المعرّف فارغ في متغيّراتك | قارن عمود Expected SKU ببيانات منتجاتك |
| بعض الصور غير مطابقة | أخطاء إملائية، أو مسافات في النهاية، أو امتداد مفقود، أو لاحقة غير رقمية | صدّر ملف CSV للصور غير المطابقة وقارنه بتصدير المنتجات |
| طابقت الصورة متغيّرًا خاطئًا | معرّفات مكررة، أو خيار «يتضمّن» طابق رمزًا أقصر | انتقل إلى خيار المطابقة التامة أو اجعل الرموز فريدة |
| مطابقات أقل مع تكرار SKU | يُحتفظ فقط بأول متغيّر يحمل المعرّف | اطلب المطابقة مع عدة متغيّرات أو اجعل المعرّفات فريدة |
| تفشل مطابقة العناوين ذات العلامات | تُرمَّز العلامات بشكل مختلف في أسماء الملفات (macOS) وفي Shopify | اطلب توحيد Unicode أو طابِق حسب SKU |
| ما زالت المنتجات المعدّلة تطابق القيم القديمة | الكتالوج مخزّن مؤقتًا | انقر على مسح الذاكرة المؤقتة |
| الصور الجديدة لا تظهر | قائمة المجلد مخزّنة مؤقتًا | انقر على إعادة المطابقة أو حدّث أداة اختيار المجلد |
| تنتهي مهلة المطابقة | كتالوج ومجلد كبيران جدًا | اطلب تصفية حسب المجموعة أو قسّم المجلد |
رسائل الرفع
| الرسالة | المعنى | ماذا تفعل |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | تعذّر تصغيرها تحت الحد | صدّر الصورة بحجم أصغر |
hit the Shopify file rate limit; retrying in Ns | تقييد معتاد من Shopify | لا شيء. يعيد التطبيق المحاولة |
Your shop reached Shopify API rate limit | تطبيق أو مهمة أخرى تستخدم الواجهة البرمجية | تجنّب تشغيل مهمتين كبيرتين في الوقت نفسه |
Free upload limit reached | استُهلكت الصور الـ 25 المجانية | رقِّ خطتك |
This folder already in process | ما زالت مهمة هذا المجلد قيد التشغيل | انتظر أو أوقفها |
product has only default variant… | ذهبت الصورة إلى المنتج لا إلى متغيّر | سلوك متوقع |
تنتهي المهمة بـ finished with errors | فشلت بعض الصور | اقرأ أسطر الأخطاء. يُعاد تلقائيًا رفع الصور التي فشلت |
قائمة تحقق للتجربة الأولى
- المنتج ذو الصورة الواحدة يحصل على صورة واحدة معيّنة كصورة للمتغيّر.
- المنتج ذو الصور المتعددة يحصل عليها بالترتيب
_0/_1/_2. - يعرض كل متغيّر في المنتج متعدد المتغيّرات صورته الخاصة.
- يطابق النص البديل في Shopify ما في المعاينة.
- يظهر اسم ملف خاطئ عمدًا في الصور غير المطابقة وفي ملف CSV.
- يترك وضع الاستبدال على منتج اختباري المجموعة الجديدة فقط.
الحصول على المساعدة
تواصل معنا مع نطاق متجرك واسم المجلد ونوع المطابقة والوقت التقريبي للتشغيل واسمين أو ثلاثة أسماء ملفات كأمثلة مع SKU أو الباركود الذي كان يجب أن تطابقه. يمكننا تسجيل تتبع كامل لعملية المطابقة وإخبارك بدقة لماذا طابقت الصورة ما طابقته.