الملفات الناتجة

يحصل كل متجر على مجموعة ملفات تُبنى من جديد في كل تحديث. تضيف واحدًا منها إلى الكتالوج، والبقية موجودة عندما تحتاج إليها.

الملفات

الملف	ما يحتويه	استخدمه في
`meta-full.xml`	كل منتجات ملفك بكل الحقول التي أرسلتها، بصيغة RSS الخاصة بميتا. رابط الصورة يشير إلى صورتنا المربعة 1:1، وصورتا 4:5 و9:16، عند تفعيلهما، تأتيان أولًا في الصور الإضافية ثم صورك أنت.	كتالوج ميتا الذي يعمل من ملف مجدول: استبدل رابطه بهذا الرابط.
`meta-supp.csv`	الأعمدة `id` و`image_link` و`additional_image_link` فقط، للمنتجات التي لها صورة من صورنا.	كتالوج ميتا الذي أنشأته شوبيفاي أو سلة أو تطبيق في زد: أضفه كملف تكميلي. لا يغيّر إلا الصور، ولا يمسّ الأسعار أو المخزون.
`snap-full.xml`	المنتجات والحقول نفسها التي في ملف ميتا الكامل، بالصورة المربعة 1:1.	الملف المجدول لكتالوجك على سناب شات.
`meta-lang-en.csv`، `meta-lang-ar.csv`	ملفات اللغة في ميتا: الاسم والرابط والصورة بلغتك الثانية، للمنتجات التي لها اسم بتلك اللغة.	أضفه كملف لغة في مدير التجارة، ليرى مستخدمو فيسبوك وإنستغرام بتلك اللغة الصورة الخاصة بها.
`tiktok-full.csv`، `tiktok-full.xml`	كل المنتجات المتوفرة والسليمة التي تقبلها تيك توك، والمعرّف في `sku_id`، مع الصورة المربعة 1:1 وصورتي 4:5 و9:16 كصور إضافية.	مدير إعلانات تيك توك، Assets ثم Catalogs: أضف المنتجات بملف بيانات، بجدول كل ساعة وطريقة التحديث Replace. لا يوجد ملف تكميلي في تيك توك، فهذا دائمًا الملف الكامل.
`pinterest-full.xml`، `pinterest-full.csv`	كل المنتجات المتوفرة والسليمة التي تقبلها بنترست، بصورة 2:3 عندما تفعّل هذا المقاس (القواعد، المقاسات واللغة)، وإلا بصورتك الأصلية.	إعلانات بنترست، Catalogs: أضف مصدر بيانات بهذا الرابط. تقرؤه بنترست مرة في اليوم.
`snap-supp.csv`، `snap-supp.xml`	الشكل التكميلي لسناب شات: المعرّفات وصورتنا المربعة 1:1.	كتالوج سناب شات الذي يملؤه تكامل منصة: أضفه كملف تكميلي.
`meta-full.csv`، `snap-full.csv`، `meta-supp.xml`	الملفات نفسها بالصيغة الأخرى، CSV أو XML.	كتالوج يقبل الصيغة الأخرى، أو إن كنت تفضّلها.

المنتجات التي لم نتمكّن من تصميم صورتها، والصفوف غير الصالحة، والمنتجات المستثناة تبقى في الملفات الكاملة بصورتها الأصلية. راجع دليلَي ميتا وسناب شات لمعرفة مكان كل ملف.

نسخ التصميم

من خطة النمو فما فوق، يمكن للمتجر أن يحدّد تصميمًا للنسخة ب وآخر للنسخة ج. لكل نسخة كل الملفات أعلاه بالرابط نفسه مع إضافة ?v=b أو ?v=c، مثل meta-full.xml?v=b. ملفات النسخة فيها المنتجات والأسعار والحقول نفسها التي في ملفاتك الأساسية، والصور فقط مختلفة. ضع كل نسخة في كتالوج خاص بها (المعرّفات نفسها في كتالوج واحد تستبدل صور بعضها) وشغّلها كمجموعة إعلانية مستقلة.

ملفات لكل بلد

من خطة النمو فما فوق، يمكن للمتجر الذي يبيع في بلدان أخرى أن يضيف حتى 10 أسواق، لكل منها أعمدة الملف التي فيها سعره (مثل price:US). ويحصل كل سوق على ملفاته الكاملة مع رمز البلد في الاسم: meta-full-us.xml وmeta-full-us.csv وsnap-full-us.xml وtiktok-full-us.csv وpinterest-full-us.xml ونسخها بالصيغة الأخرى. ولا نحوّل العملات أبدًا: المنتج الذي ليس له سعر في سوق ما لا يظهر في ملفات ذلك السوق.

فيديو المنتج

في الاحترافية والمؤسسات، وعند تفعيل الفيديو، تحمل ملفات ميتا رابط فيديو كل منتج في video[0].url (وفيديو 9:16 في video[1].url عندما تصنع هذا المقاس)، ويحمله ملف تيك توك في video_link. ولا يحصل المنتج على الرابط إلا بعد أن يجهز الفيديو، ولا تحمل ملفات سناب شات وبنترست واللغة أي فيديو.

روابط الملفات

https://feeds.catalogbadge.com/{public_id}/{token}/{name}

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

تعامل مع رابط الملف ككلمة مرور: من يملكه يستطيع قراءة ملف منتجاتك. لا تشاركه إلا مع الكتالوج، ولا تنشره في مكان عام.

تغيير الرمز

إذا تسرّب رابط ملف، غيّر الرمز من صفحة نظرة عامة على المتجر في لوحة التحكم. تعمل الروابط الجديدة فورًا، ويبقى الرمز القديم صالحًا 7 أيام حتى تحدّث الكتالوجات دون انقطاع.

كيف نقدّم الملفات

ملفات XML تُقدَّم بنوع application/rss+xml وملفات CSV بنوع text/csv، وكلاهما بترميز UTF-8.
Cache-Control: no-store مع ETag: الطلب الذي يرسل If-None-Match لملف لم يتغيّر يحصل على 304 Not Modified.
المعرّف أو الرمز أو اسم الملف الخاطئ يحصل على 404 نفسه، فلا يُكشف أي جزء كان خاطئًا.
المتجر الموقوف يردّ بـ 503، فتحتفظ منصات الإعلان بآخر نسخة جلبتها بدل إفراغ الكتالوج.
ملفات المتجر الواحد تجيب على 60 طلبًا في الدقيقة كحد أقصى. منصات الإعلان تجلب مرة كل ساعة على الأكثر، فلا يقيّدها هذا الحد أبدًا.
لا يحلّ الملف الجديد محلّ القديم إلا بعد اجتياز فحوصنا: أن يُكتب كاملًا، وأن يحتوي على 80% على الأقل من عدد منتجات الملف السابق، وأن تكون كل صورة فيه من صورنا لمتجرك.