ملفات المنتجات
يقرأ CatalogBadge ملف المنتجات الذي ينشره متجرك أصلًا. تعطينا رابطه، فنجلبه في كل تحديث ولا نغيّر فيه شيئًا.
الصيغ المقبولة
- XML: ملفات RSS 2.0 بصيغة ميتا أو جوجل للتسوق (الحقول مع البادئة
g:أو بدونها)، وملفات Atom، والملفات التي تضع المنتجات داخل عناصر<item>مثل كثير من إضافات ماجنتو. - CSV وTSV: أعمدة ملف بيانات ميتا. نكتشف الفاصل من سطر العناوين: الفاصلة أو الجدولة أو الفاصلة المنقوطة أو الخط العمودي.
- روابط المنصات: رابط الكتالوج في سلة، وروابط الملفات من تطبيقات زد وشوبيفاي وماجنتو وووكومرس. راجع أدلة الإعداد.
يجب أن يكون الملف بترميز UTF-8. نجلبه عبر http أو https، مع 5 تحويلات كحد أقصى، خلال 60 ثانية وبحجم يصل إلى 300 ميجابايت.
الأعمدة
| الحقل | الأسماء التي نقرؤها | الحاجة |
|---|---|---|
| المعرّف | id، sku، product_id | مطلوب |
| الاسم | title، name | مطلوب |
| رابط المنتج | link، url، product_url | مطلوب |
| الصورة | image_link، image، image_url | مطلوب، رابط كامل يبدأ بـ http أو https |
| السعر | price | مطلوب |
| سعر التخفيض وتواريخه | sale_price، sale_price_effective_date | اختياري |
| التوفر | availability | اختياري، وغيابه يعني أن المنتج متوفر |
| حقول أخرى | brand، product_type، item_group_id، من custom_label_0 إلى custom_label_4، gtin، mpn، color، size وغيرها | اختيارية، تُستخدم في القواعد وتنتقل كما هي إلى ملفك |
نقرأ الأسعار بكل عملات الخليج وبأي كتابة شائعة: 249.00 SAR وSAR 249 و1.249,00 SAR و1,249.500 KWD، وبالأرقام العربية، وبالاختصارات العربية مثل ر.س ود.إ. والسعر بأي عملة أخرى نقرأه مع رمزها في معيار ISO 4217، مثل 1249.50 EUR أو 2499 INR. والسعر الذي بلا عملة يأخذ عملة متجرك. وقيم التوفر مثل متوفر وinstock و1 نحوّلها إلى قيم ميتا.
الصفوف ذات المشكلات
المنتج الذي ينقصه المعرّف أو الاسم أو الرابط أو الصورة أو سعر يمكن قراءته يُعدّ غير صالح. ويبقى في ملفك الكامل كما أرسلته تمامًا، بصورته الأصلية، فتستلمه ميتا كالمعتاد. وإذا تكرّر المعرّف نفسه، نعتمد الأول.
كل تحديث يُنتج تقرير جودة في لوحة التحكم، يحصي:
- المنتجات غير الصالحة حسب السبب، والمعرّفات المكرّرة؛
- أسعار التخفيض المساوية للسعر أو الأعلى منه، وأسعار التخفيض بلا تواريخ؛
- الأسماء التي تتجاوز 65 حرفًا، لأن ميتا تقصّها؛
- المنتجات التي ليس لها علامة تجارية ولا GTIN ولا MPN، لأن ميتا تحتاج إلى واحد منها؛
- قيم التوفر التي ليست ضمن قائمة ميتا؛
- الصور الأصغر من 500 بكسل؛
- التغيّر في عدد المنتجات منذ التحديث السابق.
ربط الأعمدة للملفات غير القياسية
بعض الملفات تستخدم أسماء أعمدة خاصة بها، مثل Identity وfinal_price وis_in_stock. وبدل التخمين، الذي قد يضع سعرًا خاطئًا على الصورة، يحصل متجرك على ربط للأعمدة: يحدّد لكل حقل العمود الذي يحمله، ويمكنه تحويل قيم التوفر.
{
"fields": {
"id": "Identity",
"image_link": "Imageurl",
"price": "final_price",
"availability": "is_in_stock"
},
"availability_values": {
"1": "in stock",
"0": "out of stock"
}
}تجربة تشغيل تقرأ ملفك الحالي بهذا الربط وتعرض تقرير الجودة قبل حفظ أي شيء. والمتجر الذي ليس له ربط يُقرأ ملفه تمامًا كما وصفنا أعلاه. وإذا احتاج ملفك إلى ربط ولم تكن متأكدًا من كتابته، راسلنا على hello@catalogbadge.com ونجهّزه معك.