كل المقالات

دليل ملف المنتجات للمطوّر (موقع خاص)

إذا كان متجرك يعمل على موقعك الخاص لا على منصة مثل سلة أو أودو، يستطيع ناشر قراءة منتجاتك مع ذلك. ينشر مطوّرك ملفًا واحدًا يسرد منتجاتك على عنوان في الإنترنت، وتلصق أنت هذا العنوان في ناشر. يقرأ ناشر الملف ويستورد منتجاتك، ثم يقرؤه من جديد كل 6 ساعات ليبقي الأسعار والتوفر محدّثة.

أعطِ هذه الصفحة لمطوّرك، ففيها كل ما يحتاج إليه.

اربط الملف من هنا:

/stores

ما هو ملف المنتجات

ملف المنتجات ملف يولّده موقعك ويسرد كل منتج تبيعه، مدخل واحد لكل منتج. يستخدم ناشر الصيغة نفسها المستخدمة في ملف المنتجات لدى Google Merchant Center، فإذا كان لديك ملف جاهز لـ Google Shopping أو لكتالوج Meta فالعنوان نفسه يعمل هنا.

  • يجب أن يبدأ العنوان بـ https:// وأن يكون متاحًا لأي شخص على الإنترنت، بلا كلمة مرور ولا تسجيل دخول.
  • يمكن أن يكون الملف بصيغة XML ‏(RSS 2.0 أو Atom) أو نصًا (مفصولًا بعلامات جدولة أو بفواصل، مع صف عناوين).
  • يجب أن يحتوي الملف على كل منتجاتك في كل مرة، لا على المنتجات التي تغيّرت فقط.
  • يجب أن يحمل كل سعر رمز العملة بمعيار ISO 4217، مثل 35000 IQD. المنتج الذي لا يحمل سعره رمز عملة يُتخطّى.
  • الحد الأقصى للحجم: 25 ميغابايت و50,000 صف. ويُقبل الملف المضغوط بصيغة .gz.
  • ترميز النص: UTF-8.

ملفات نموذجية

ابدأ من ملف نموذجي واستبدل بمنتجاته منتجاتك:

الحقول

في ملف XML يكون كل حقل عنصرًا داخل عنصر المنتج <item> ويُكتب بالبادئة g:، مثل <g:price>35000 IQD</g:price>. ويعرّف العنصر الجذر هذه البادئة هكذا: <rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">. وفي الملف النصي يكون كل حقل عمودًا، ويحمل السطر الأول أسماء الأعمدة.

الحقلمطلوبما يُكتب فيهمثال
idنعمرمزك الفريد للمنتج. لا تغيّره ولا تستخدمه لمنتج آخر.SKU-1001
titleنعماسم المنتج.محفظة جلدية
priceنعمالرقم، ثم مسافة، ثم رمز العملة بمعيار ISO 4217 المكوّن من 3 أحرف. من دون الرمز يُتخطّى المنتج.35000 IQD
descriptionمستحسنوصف نصي بسيط.محفظة جلدية بنية مصنوعة يدويًا.
linkمستحسنصفحة المنتج في موقعك. يرسلها مساعدك إلى العميل الذي يريد الشراء.https://www.example.com/products/leather-wallet
image_linkمستحسنالصورة الأساسية (JPEG أو PNG على عنوان https).https://www.example.com/images/wallet-1.jpg
additional_image_linkاختياريصور إضافية، حتى 10 صور. في XML كرّر العنصر، وفي الملف النصي افصل العناوين بفواصل.https://www.example.com/images/wallet-2.jpg
sale_priceاختياريسعر مخفّض بصيغة price نفسها. يجب أن يكون أقل من price.28000 IQD
sale_price_effective_dateاختياريمدة سريان الخصم: البداية والنهاية وبينهما /.2026-12-01T00:00+0300/2026-12-10T23:59+0300
availabilityمستحسنإحدى القيم in_stock أو out_of_stock أو preorder أو backorder.in_stock
product_typeاختياريتصنيفك الخاص. استخدم > بين المستويات.Accessories > Wallets
brandاختيارياسم العلامة التجارية.Example
sizeاختياريمقاس هذا الخيار.M
colorاختياريلون هذا الخيار.Blue
item_group_idللمقاسات والألوانالقيمة نفسها في كل مقاس أو لون للمنتج الواحد. انظر الشرح أدناه.SKU-2001

يمكن أن يبقى في الملف أي حقل آخر من مواصفات Google، فناشر يتجاهل ما لا يستخدمه.

الأسعار

يحتاج كل سعر إلى رمز عملة بمعيار ISO 4217. المنتج الذي لا يحمل سعره رمز عملة يُتخطّى: لا يُستورد، ولا يعرف مساعدك عنه شيئًا. ناشر لا يخمّن العملة أبدًا. أما sale_price الذي لا يحمل رمز عملة فيُتجاهل، ويُستورد المنتج بسعره العادي.

  • اكتب السعر كما يدفعه العميل، ورمز العملة بعد الرقم: 35000 IQD أو 49.99 USD أو 120 SAR.
  • استخدم رمز ISO 4217 المكوّن من 3 أحرف (IQD، SAR، AED، EGP، USD…) لا علامة مثل $ أو د.ع، ولا اسمًا مثل dinar.
  • استخدم النقطة للكسور العشرية: 49.99 لا 49,99.
  • 35000 وحدها تُتخطّى. 35000 IQD تُستورد.
  • يعرض الفحص في صفحة المتاجر كل صف متخطّى مع رقمه، لتصحّحه قبل الربط. وبعد الربط تعرض بطاقة المتجر عدد الصفوف المتخطّاة.

المقاسات والألوان

إذا كان المنتج الواحد متاحًا بعدة مقاسات أو ألوان، فاكتب مدخلًا لكل واحد منها، وأعطِ كل مدخل id خاصًا به، وضع قيمة item_group_id نفسها في جميعها. يعرضها ناشر للعميل منتجًا واحدًا له خيارات.

مثال: قميص بمقاسين M وL يُكتب في مدخلين معرّفاهما SKU-2001-M وSKU-2001-L، وقيمة item_group_id في كليهما SKU-2001. ويمكن أن يكون لكل مدخل سعره وتوفره.

لا تضع item_group_id في منتج ليس له خيارات.

لغتان

إذا كانت أسماء منتجاتك بالعربية والإنجليزية، فانشر ملفين: ملفًا بلغتك الأساسية وملفًا بالإنجليزية، على أن يحمل المنتج الواحد id نفسه في الملفين. في ناشر افتح أسماء منتجاتي بلغتين والصق عنوان الملف الإنجليزي. يأخذ ناشر الأسماء الإنجليزية من الملف الثاني، أما الأسعار والتوفر فتؤخذ دائمًا من الملف الأساسي.

كيف يبقي ناشر منتجاتك محدّثة

  • يقرأ ناشر الملف من جديد كل 6 ساعات. ويمكنك أيضًا الضغط على إعادة الاستيراد في صفحة المتاجر في أي وقت.
  • المنتج الجديد في الملف يُضاف، والسعر أو التوفر الذي تغيّر يُحدَّث.
  • مساعدك يعرف ما هو متوفر. عندما يسأل العميل عن منتج قيمته out_of_stock يخبره بأنه غير متوفر حاليًا ويقترح منتجات متوفرة من القسم نفسه (product_type)، ولكل منتج سعره ورابطه. وإذا اختلف توفر خيارات المنتج الواحد يوضّح للعميل الخيارات المتوفرة. والمنتج الذي لا يحمل قيمة availability لا يوصف بأنه متوفر أو غير متوفر.
  • المنتج الذي لم يعد في الملف يُؤرشف: يتوقف مساعدك عن عرضه. لا يُحذف، ويعود إذا رجع إلى الملف.
  • إذا تعذّر الوصول إلى الملف، أو كان فارغًا، أو تعذّرت قراءته، فلا يتغيّر شيء: تبقى منتجاتك كما كانت بعد آخر قراءة ناجحة. وبعد 3 محاولات فاشلة متتالية تعرض صفحة المتاجر تنبيهًا ويصل بريد إلكتروني إلى مالك الفريق.
  • إذا كان خادمك يرسل الترويسة ETag أو Last-Modified، يستخدمها ناشر لتخطي التنزيل عندما لا يتغيّر شيء. هذا اختياري.

افحص قبل الربط

  1. افتح عنوان الملف في المتصفح. يجب أن ترى الملف، لا صفحة ويب ولا شاشة تسجيل دخول.
  2. في صفحة المتاجر الصق العنوان واضغط فحص الملف. يعرض ناشر عدد المنتجات التي وجدها، وأولها كما قرأها، وكل صف فيه مشكلة. لا يُستورد شيء في هذه الخطوة.
  3. عندما تبدو النتيجة صحيحة، اضغط الربط والاستيراد.

مشكلات شائعة

  • «ردّ عنوان ملف المنتجات بخطأ»: العنوان يُرجع صفحة خطأ. افتحه في المتصفح وراجع مطوّرك.
  • «لم يُرجع ملف منتجات»: العنوان يُرجع صفحة ويب بدل الملف. يجب أن يُرجع العنوان ملف XML أو الملف النصي مباشرة.
  • «السعر بلا رمز عملة»: أضف الرمز المكوّن من 3 أحرف بعد الرقم، مثل 35000 IQD.
  • «المعرّف مكرر»: منتجان يحملان id واحدًا. يجب أن يكون كل id فريدًا.
  • لم تُستورد بعض المنتجات بسبب باقتك: تتضمن باقتك عددًا محددًا من المنتجات. راجع صفحة الباقات لاستيراد المزيد.

/billing

لمتاجر سلة وأودو، راجع دليل ربط المتجر:

/help/connect-your-store

دليل ملف المنتجات للمطوّر (موقع خاص) — ناشر