استخدم هذا الدليل لإعداد الكتالوج المُترجم. راجع أيضًا كيفية إعداد كتالوج لعدة لغات وبلدان، مركز مساعدة الإعلانات.
id
في قائمة بيانات التجاوز. يجب أن يتطابق id
لكل عنصر مع id
في أحد قوائم بيانات الكتالوج الرئيسي و/أو معرف المحتوى من البيكسل.override
.
override
هي رمز ISO المعتمد للغة. (راجع أيضًا رموز ISO المعتمدة للغات.)أثناء التخطيط لإعداد الكتالوج، نطلب منك اتباع التوصيات التالية:
title
وdescription
في قائمة بيانات اللغة وتضمين price
وsale_price
وsale_price_effective_date
وavailability
وlink
في قائمة بيانات البلد. يمكنك توفير خصائص مطوعة محليًا لعناصر الكتالوج، باستخدام أنواع إضافية من قوائم البيانات.
نوع قائمة البيانات | الوصف | مثال |
---|---|---|
قائمة بيانات البلد | تحتوي على تجاوزات لبلدان محددة. يمكنك إنشاء قوائم بيانات البلد وتحميلها باستخدام مدير المعاملات التجارية أو عبر واجهة API. راجع تنسيق قائمة البيانات المدعوم. | يمكن أن يكون للعنصر أسعار مختلفة في بلدان مختلفة. |
قائمة بيانات اللغة | تحتوي على ترجمات لحقول محددة. يمكنك إنشاء قوائم بيانات اللغة وتحميلها باستخدام مدير المعاملات التجارية أو عبر واجهة API. راجع تنسيق قائمة البيانات المدعوم. | يمكن أن يكون للعنصر أوصاف مختلفة في لغات مختلفة. |
قائمة بيانات اللغة والبلد | مخصصة لحالات الاستخدام المتقدمة، حينما لا تكون قائمة بيانات البلد أو قائمة بيانات اللغة كافيتان لوصف ترجمة عناصرك. يجب استخدام قائمة بيانات اللغة والبلد فقط في الحقول الضرورية للغاية. لا يمكنك إنشاء قائمة بيانات اللغة والبلد إلا عبر واجهة API، ولكن يمكنك تعديل قائمة البيانات وتحميلها من مدير المعاملات التجارية أو عبر واجهة API. يوفر مدير المعاملات التجارية تفاصيل حول إعداد كل من البلد واللغة. ملاحظة: لتطويع حقل محليًا لكل من اللغة والبلد، يجب أن تكون القيمة الموجودة في عمود | قد تعتمد عناوين URL لمنتجك على لغة المشاهد وبلده. على سبيل المثال: http://www.mysite.com/ca/item12345?lang=fr يمكنك تحديد الحقول المطوعة محليًا بحد أقصى 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
عند تحديد المعلومات المطوعة محليًا التي سيتم عرضها للمستخدم، فإننا نتحقق من محتويات قائمة البيانات بالترتيب التالي:
بمجرد إنشاء قوائم البيانات، يمكنك اختيار تحميلها يدويًا عبر مدير المعاملات التجارية أو عبر واجهة API، كما هو موضح أدناه.
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
المعلمات
المعلمة | القيمة |
---|---|
| الموقع الذي يمكننا استرداد ملف قائمة البيانات منه |
| معدل التكرار الذي نحضر به ملف قائمة البيانات |
| الساعة من اليوم (استنادًا إلى نظام 24 ساعة) التي نحضر فيها قائمة البيانات |
لإزالة المعلومات المطوعة محليًا من أحد العناصر:
true
. بعد ذلك تتم إزالة المعلومات المطوعة محليًا لهذا المنتج.
ملاحظة: يمكنك أيضًا delete
العناصر الموجودة في قائمة بيانات العناصر الرئيسية. عند حذف عنصر رئيسي، تتم إزالة جميع التجاوزات.