إعداد CatalogBadge مع سكوير سبيس

يُربط سكوير سبيس بمفتاح API لا يستطيع إلا قراءة منتجاتك. يرسله CatalogBadge إلى واجهة سكوير سبيس البرمجية فقط (api.squarespace.com) ويقرأ منتجاتك في كل تحديث. لا يتغيّر شيء في موقعك، ولا نكتب فيه أبدًا.

1. أنشئ مفتاح API للقراءة فقط

افتح Settings (الإعدادات)، ثم Developer Tools (تحت Advanced في بعض المواقع)، ثم Developer API Keys، واختر Generate key. يتيح سكوير سبيس مفاتيح API في خطط التجارة (Commerce).
سمّه “CatalogBadge”. في الصلاحيات اجعل Products فقط Read only (قراءة فقط)، واترك الطلبات والمخزون والمعاملات والملفات الشخصية غير مفعّلة.
انسخ المفتاح: يعرضه سكوير سبيس مرة واحدة. لا تنتهي صلاحيته ما دام موقعك فعّالًا، ويمكنك إلغاؤه من الصفحة نفسها.

ما نقرؤه

عنصر لكل متغيّر من منتج مادي، وعنصر لكل خدمة أو منتج رقمي؛ وتُستبعد بطاقات الهدايا والمنتجات المخفية. المعرّف هو معرّف المتغيّر، والمجموعة هي المنتج.
السعر الأساسي، وسعر التخفيض عندما يكون المتغيّر في تخفيض. العملة هي عملة متجرك.
صورة المتغيّر أولًا، ثم صور المنتج بترتيبك.
المخزون: متوفّر عندما يكون المتغيّر غير محدود أو كميته أكبر من صفر.

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

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

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

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.