إذا كان متجرك يعمل على موقعك الخاص لا على منصة مثل سلة أو أودو، يستطيع ناشر قراءة منتجاتك مع ذلك. ينشر مطوّرك ملفًا واحدًا يسرد منتجاتك على عنوان في الإنترنت، وتلصق أنت هذا العنوان في ناشر. يقرأ ناشر الملف ويستورد منتجاتك، ثم يقرؤه من جديد كل 6 ساعات ليبقي الأسعار والتوفر محدّثة.
أعطِ هذه الصفحة لمطوّرك، ففيها كل ما يحتاج إليه.
اربط الملف من هنا:
ما هو ملف المنتجات
ملف المنتجات ملف يولّده موقعك ويسرد كل منتج تبيعه، مدخل واحد لكل منتج. يستخدم ناشر الصيغة نفسها المستخدمة في ملف المنتجات لدى 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، يستخدمها ناشر لتخطي التنزيل عندما لا يتغيّر شيء. هذا اختياري.
افحص قبل الربط
- افتح عنوان الملف في المتصفح. يجب أن ترى الملف، لا صفحة ويب ولا شاشة تسجيل دخول.
- في صفحة المتاجر الصق العنوان واضغط فحص الملف. يعرض ناشر عدد المنتجات التي وجدها، وأولها كما قرأها، وكل صف فيه مشكلة. لا يُستورد شيء في هذه الخطوة.
- عندما تبدو النتيجة صحيحة، اضغط الربط والاستيراد.
مشكلات شائعة
- «ردّ عنوان ملف المنتجات بخطأ»: العنوان يُرجع صفحة خطأ. افتحه في المتصفح وراجع مطوّرك.
- «لم يُرجع ملف منتجات»: العنوان يُرجع صفحة ويب بدل الملف. يجب أن يُرجع العنوان ملف XML أو الملف النصي مباشرة.
- «السعر بلا رمز عملة»: أضف الرمز المكوّن من 3 أحرف بعد الرقم، مثل
35000 IQD. - «المعرّف مكرر»: منتجان يحملان
idواحدًا. يجب أن يكون كلidفريدًا. - لم تُستورد بعض المنتجات بسبب باقتك: تتضمن باقتك عددًا محددًا من المنتجات. راجع صفحة الباقات لاستيراد المزيد.
لمتاجر سلة وأودو، راجع دليل ربط المتجر: