إعداد CatalogBadge مع بريستاشوب

يُربط بريستاشوب بمفتاح Webservice: تنشئه مرة واحدة بصلاحية قراءة كتالوجك، ويقرأ CatalogBadge منتجاتك مباشرة في كل تحديث. لا يُثبَّت شيء في متجرك، ولا نكتب فيه أبدًا. يعمل مع بريستاشوب 1.7 و8.

1. أنشئ مفتاح Webservice

من لوحة الإدارة افتح Advanced Parameters (إعدادات متقدمة)، ثم Webservice. اجعل Enable PrestaShop’s webservice Yes واحفظ. يجب تفعيل الروابط الودية (Shop Parameters ثم Traffic & SEO)، لأننا نتصل بـ https://your-shop/api/.
اختر Add new webservice key ثم Generate لتوليد مفتاح، وأعطه وصفًا مثل “CatalogBadge, read only”.
تحت Permissions (الصلاحيات) فعّل عمود View (GET) فقط لـ: configurations وcurrencies وcountries وlanguages وproducts وstock_availables. اترك كل الأعمدة الأخرى فارغة. احفظ وانسخ المفتاح.
إذا قال الاختبار أدناه إن المفتاح مرفوض وهو صحيح، فخادمك يحذف ترويسة Authorization: اجعل Enable CGI mode for PHP Yes في صفحة Webservice نفسها.

ما نقرؤه

عنصر لكل منتج مفعّل، بمعرّف المنتج في بريستاشوب. التركيبات (combinations) ليست عناصر منفصلة بعد.
الأسعار كما يحسبها بريستاشوب للعميل، شاملة الضريبة: السعر الأصلي، والسعر الخاص (تخفيضك) كسعر التخفيض.
الصور من ملفات صور متجرك العامة (/img/p/…) التي تُفتح دون المفتاح، والصورة الرئيسية أولًا.
الاسم والوصف المختصر بلغة ملفك إن توفّرت في المتجر، والعلامة التجارية، والمخزون إن كنت تديره.

2. اربط المفتاح في CatalogBadge

أنشئ حسابك على app.catalogbadge.com واختر Onboard a store (إضافة متجر). أضف المتجر بأي رابط ملف منتجات لديه (يتحقق المعالج منه ويعرض أسعارًا كنماذج). إن لم يكن لديه رابط بعد، راسلنا ونضيف المتجر معك.
افتح المتجر، ثم Connection (الربط). تحت Connect with a key (الربط بمفتاح) اختر PrestaShop، وأدخل عنوان المتجر (عنوان https الذي يفتح عليه متجرك)، والصق Webservice key.
اختر Test and connect (اختبار وربط). نقرأ مرة واحدة بالمفتاح قبل حفظه، وإن فشلت القراءة لا يُحفظ شيء وتوضّح الصفحة السبب.
يتحقق التحديث التالي أولًا من أن 95 % على الأقل من المنتجات التي تنشرها ملفاتك تحتفظ بمعرّفاتها في PrestaShop. بعدها يقرأ المتجر من PrestaShop مباشرة، وتبقى روابط ملفاتك كما هي. إن تطابق عدد أقل، يحتفظ المتجر بملفه وتوضّح صفحة النظرة العامة عدد ما تطابق.

يُحفظ المفتاح مختومًا، ولا يُعرض مجددًا، ولا يوضع في رابط، ولا يُسجَّل أبدًا. للإيقاف اختر Disconnect (فصل) في الصفحة نفسها، أو احذف المفتاح في PrestaShop: يتوقف التحديث التالي وتبقى ملفاتك المنشورة كما هي تمامًا.

3. ضع ملفك بهوية متجرك حيث تقرأ إعلاناتك

روابط ملفاتك في صفحة Overview (نظرة عامة) لمتجرك تحت Feed URLs (روابط الملفات)، ولكل رابط زر نسخ. تعامل معها ككلمة مرور: من يملك الرابط يستطيع قراءة الملف.

أين تعمل إعلاناتك	الملف	أين تلصقه
ميتا (فيسبوك وإنستغرام)	`meta-full.xml`	مدير التجارة، ثم الكتالوج، ثم مصادر البيانات. إذا كان الكتالوج يقرأ رابط ملف متجرك أصلًا، فعدّل مصدر البيانات ذاك واستبدل الرابط برابطنا، فتبقى مجموعاتك الإعلانية على الكتالوج نفسه. وإلا فأضف ملف بيانات مجدولًا برابطنا. الخطوات في دليل ميتا.
تيك توك	`tiktok-full.csv`	مدير إعلانات تيك توك، ثم Assets (الأصول)، ثم Catalogs (الكتالوجات): أضف المنتجات بجدول ملف بيانات، واجعله كل ساعة، وطريقة التحديث Replace (استبدال)، كي يخرج من الكتالوج كل منتج يخرج من الملف. الخطوات في دليل تيك توك.
سناب شات	`snap-full.xml`	مدير إعلانات سناب شات، ثم Catalogs (الكتالوجات): أضف مصدر منتجات برابط ملف مجدول وجدول يومي. الخطوات في دليل سناب شات.
بنترست	`pinterest-full.xml`	فعّل أولًا مقاس بنترست 2:3 في Rules (القواعد) تحت Sizes and language (المقاسات واللغة). ثم من إعلانات بنترست، ثم Catalogs (الكتالوجات)، أضف مصدر بيانات برابطنا. يقرأ بنترست الملف مرة في اليوم. الخطوات في دليل بنترست.

تلتقط كل منصة الصور الجديدة في جلبها التالي، وقد يستغرق الجلب الأول بضع ساعات. لا تحذف الكتالوج وتنشئه من جديد للتبديل: إعلاناتك تبقى مرتبطة بالكتالوج القديم.

لديك سؤال؟ راسلنا على hello@catalogbadge.com.