تم تحديث هذا المستند.
لم تكتمل الترجمة إلى اللغة ‏العربية‏ حتى الآن.
تاريخ تحديث المصدر باللغة الإنجليزية: ‏١٠ نوفمبر

إعداد الكتالوج المُترجم

استخدم هذا الدليل لإعداد الكتالوج المُترجم. راجع أيضًا كيفية إعداد كتالوج لعدة لغات وبلدان، مركز مساعدة الإعلانات.

المتطلبات

  • يجب عليك إنشاء لغة أو بلد تتجاوز قائمة البيانات والتي ستحتوي فقط على الحقول (مع القيم) التي ترغب في تغييرها.
  • يجب تضمين حقل id في قائمة بيانات التجاوز. يجب أن يتطابق id لكل عنصر مع id في أحد قوائم بيانات الكتالوج الرئيسي و/أو معرف المحتوى من البيكسل.
  • يجب تضمين حقل override.
  • يمكنك تطويع (تجاوز) حقول محددة فقط محليًا، وليس جميعها. راجع الحقول المدعومة — الكتالوجات المُترجمة للحصول على قائمة بحقول الكتالوج المدعومة.
  • تأكد من أن صور المنتج تلبي متطلبات الكتالوج.
  • تأكد من أن عناوين المنتجات تلبي متطلبات الكتالوج.
  • تأكد من أن أوصاف المنتج تلبي متطلبات الكتالوج.

التوصيات

أثناء التخطيط لإعداد الكتالوج، نطلب منك اتباع التوصيات التالية:

  • على الرغم من أنه يمكنك تضمين عدة لغات في قائمة بيانات اللغة وعدة بلدان في قائمة بيانات البلد، إلا أننا نوصي بإنشاء قوائم بيانات البلد واللغة بشكل منفصل.
  • إذا كان لديك كتالوج كبير (أكثر من 100 ألف عنصر)، فيجب عليك إنشاء قائمة بيانات واحدة لكل لغة أو بلد.
  • إذا كنت تقوم بإنشاء قائمة بيانات اللغة وقائمة بيانات البلد، نوصي بأن تكون الحقول المضمنة في كل قائمة بيانات فريدة لهذا النوع من قائمة البيانات. على سبيل المثال، لا تحدد اسم المنتج في كل من قائمة بيانات اللغة وقائمة بيانات البلد
  • بالنسبة للمنتجات (التجارة الإلكترونية)، نوصي بتضمين title وdescription في قائمة بيانات اللغة وتضمين price وsale_price وsale_price_effective_date وavailability وlink في قائمة بيانات البلد.
  • لأمثلة على ذلك، نقدم قالب تجاوز اللغة وقالب تجاوز البلد.

راجع أيضًا

الخطوة 1: إنشاء قوائم بيانات اللغة والبلد

أنواع قائمة البيانات

يمكنك توفير خصائص مطوعة محليًا لعناصر الكتالوج، باستخدام أنواع إضافية من قوائم البيانات.

نوع قائمة البياناتالوصفمثال

قائمة بيانات البلد

تحتوي على تجاوزات لبلدان محددة. يمكنك إنشاء قوائم بيانات البلد وتحميلها باستخدام مدير المعاملات التجارية أو عبر واجهة API. راجع تنسيق قائمة البيانات المدعوم.

يمكن أن يكون للعنصر أسعار مختلفة في بلدان مختلفة.

قائمة بيانات اللغة

تحتوي على ترجمات لحقول محددة. يمكنك إنشاء قوائم بيانات اللغة وتحميلها باستخدام مدير المعاملات التجارية أو عبر واجهة API. راجع تنسيق قائمة البيانات المدعوم.

يمكن أن يكون للعنصر أوصاف مختلفة في لغات مختلفة.

قائمة بيانات اللغة والبلد

مخصصة لحالات الاستخدام المتقدمة، حينما لا تكون قائمة بيانات البلد أو قائمة بيانات اللغة كافيتان لوصف ترجمة عناصرك. يجب استخدام قائمة بيانات اللغة والبلد فقط في الحقول الضرورية للغاية.


لا يمكنك إنشاء قائمة بيانات اللغة والبلد إلا عبر واجهة API، ولكن يمكنك تعديل قائمة البيانات وتحميلها من مدير المعاملات التجارية أو عبر واجهة API. يوفر مدير المعاملات التجارية تفاصيل حول إعداد كل من البلد واللغة.


ملاحظة: لتطويع حقل محليًا لكل من اللغة والبلد، يجب أن تكون القيمة الموجودة في عمود override عبارة عن رمز ISO مدعومًا للغة ورمز ISO مدعومًا للبلد، ومفصولين بالرمز '|'، على سبيل المثال، en_XX|US

قد تعتمد عناوين URL لمنتجك على لغة المشاهد وبلده.

على سبيل المثال: http://www.mysite.com/ca/item12345?lang=fr
أو
http://www.mysite.com/ca/fr/item12345

يمكنك تحديد الحقول المطوعة محليًا بحد أقصى 350 زوجًا من اللغات والبلاد لكل عنصر في الكتالوج.

تنسيقات قائمة البيانات

قائمة بيانات البلد

مثال CSV — تحتوي قائمة البيانات هذه على المحتوى المطوع محليًا لبلدي المملكة المتحدة (GB) وإيطاليا (IT).

      
id; override; price; link; delete
FB_product_1234; GB; 9.00 GBP; http://www.example.com/en_GB/FB_product_1234; false
FB_product_1234; IT; 10.49 EUR; http://www.example.com/it_IT/FB_product_1234; false
    

يجب توفير price، وsale_price، وunit_price، وbase_price، وstatus (إمكانية العرض)، وavailability فقط في قائمة بيانات البلد. لا يمكن توفير هذه الحقول في قائمة بيانات اللغة. يساعد هذا في ضمان حصول العملاء على بيانات المنتج الصحيحة وفقًا للإعدادات المحلية للغة (التطويع).


قائمة بيانات اللغة

مثال CSV — تحتوي قائمة البيانات هذه على المحتوى المطوع محليًا للّغتين الفرنسية (fr_XX) والإنجليزية (en_XX).

      
id; override; description; title; delete
FB_product_1234; fr_XX; Le t-shirt American Apparel préféré de tous. Le t-shirt comporte une encolure ajustée de 3/4 pouce au cou, une bande épaule à épaule et un ourlet de 1 pouce sur les manches.; T-shirt Unisexe d'American Apparel; false
FB_product_1234; en_XX ; Everyone's favorite American Apparel T-shirt. The t-shirt features 3/4 inches set-in neck, shoulder to shoulder tape and 1 inch hem on sleeves.; American Apparel Unisex T-Shirt; false
    

قائمة بيانات اللغة والبلد

مثال - تحتوي قائمة البيانات هذه على المحتوى المطوع محليًا لـ "اللغة والبلد" للمتحدثين بالفرنسية في الولايات المتحدة (fr_XX|US) والمتحدثين بالفرنسية في كندا (fr_XX|CA).

id; override; url; delete
FB_product_1234; fr_XX|US; http://us.example.com/fr/product_1234; false
FB_product_1234; fr_XX|CA; http://ca.example.com/fr/product_1234; false

الخطوة 2: التحقق من قائمة البيانات - ترتيب الأولوية

عند تحديد المعلومات المطوعة محليًا التي سيتم عرضها للمستخدم، فإننا نتحقق من محتويات قائمة البيانات بالترتيب التالي:

  1. قيم قائمة بيانات اللغة والبلد للغات التي يتحدث بها المستخدم وبلده الأصلي
  2. قيم قائمة بيانات اللغة للغات التي يتحدث بها المستخدم
  3. قيم قائمة بيانات البلد للموطن الأصلي للمستخدم

الخطوة 3: تحميل قوائم بيانات اللغة والبلد

بمجرد إنشاء قوائم البيانات، يمكنك اختيار تحميلها يدويًا عبر مدير المعاملات التجارية أو عبر واجهة API، كما هو موضح أدناه.

تحميل قوائم البيانات عبر واجهة API

  1. اجعل قوائم البيانات متاحة على الخادم.
  2. اربط قوائم البيانات بالكتالوج، باستخدام معلمة override_type إضافية.

قائمة بيانات اللغة

مثال - تحميل قائمة بيانات اللغة

curl \
  -F 'name=Language feed' \
  -F 'schedule={
    "interval": "DAILY",
    "url": "http:\/\/www.example.com\/sample_language_feed.tsv",
    "hour": 22
  }' \
	-F 'override_type=language'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

قائمة بيانات البلد

مثال — تحميل قائمة بيانات البلد

curl \
  -F 'name=Country Feed' \
  -F 'schedule={
    "interval": "DAILY",
    "url": "http:\/\/www.example.com\/sample_country_feed.tsv",
    "hour": 22
  }' \
	-F 'override_type=country'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

قائمة بيانات اللغة والبلد

مثال - تحميل قائمة بيانات اللغة والبلد

curl \
  -F 'name=language and country Feed' \
  -F 'schedule={
        "interval": "DAILY",
        "url": "http:\/\/www.example.com\/sample_language_and_country_feed.tsv",
        "hour": 22
      }' \
  -F 'override_type=language_and_country'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

المعلمات

المعلمة القيمة

url

الموقع الذي يمكننا استرداد ملف قائمة البيانات منه

interval

معدل التكرار الذي نحضر به ملف قائمة البيانات

hour

الساعة من اليوم (استنادًا إلى نظام 24 ساعة) التي نحضر فيها قائمة البيانات

الخطوة 4: إزالة معلومات البلد أو اللغة الخاصة بمنتج ما (اختياري)

لإزالة المعلومات المطوعة محليًا من أحد العناصر:

  1. حدد عمود "حذف" في قائمة بيانات البلد أو اللغة.
  2. اضبط القيمة على true.

بعد ذلك تتم إزالة المعلومات المطوعة محليًا لهذا المنتج.

ملاحظة: يمكنك أيضًا delete العناصر الموجودة في قائمة بيانات العناصر الرئيسية. عند حذف عنصر رئيسي، تتم إزالة جميع التجاوزات.

الخطوة 5: التحقق من الإعداد في مدير المعاملات التجارية

يوفر مدير المعاملات التجارية تفاصيل حول معلومات حقول البلد واللغة لكل منتج في صفحة العناصر > التفاصيل.



يمكنك أيضًا الوصول إلى التغطية الدولية للكتالوج بأكمله في علامة التبويب العناصر > التغطية الدولية.