إعداد CatalogBadge مع إكويد

يُربط إكويد (Lightspeed E-Series) بالرمز السري لتطبيق مخصص لا يستطيع إلا قراءة كتالوجك. يرسله CatalogBadge إلى واجهة إكويد البرمجية فقط (app.ecwid.com) ويقرأ منتجاتك في كل تحديث. لا يُثبَّت شيء في متجرك، ولا نكتب فيه أبدًا.

1. أنشئ تطبيقًا مخصصًا

من لوحة إدارة إكويد افتح Apps (التطبيقات)، ثم My Apps، ثم Develop apps، وأنشئ تطبيقًا مخصصًا باسم “CatalogBadge”.
امنحه صلاحيتي read_catalog وread_store_profile فقط.
افتح تفاصيل التطبيق وانسخ Store ID (رقم) وSecret token (يبدأ بـ secret_). لا تستخدم الرمز العام (public token) لهذا.

ما نقرؤه

عنصر لكل منتج مفعّل، بمعرّف المنتج في إكويد.
السعر الذي يراه العميل غير المسجّل في متجرك، شاملًا الضرائب إن كنت تعرضها؛ وسعر “compare to” كسعر أصلي عندما يكون أعلى.
صورتك الرئيسية وحتى ثلاث صور من المعرض، من خوادم صور إكويد.
الاسم والوصف بلغة ملفك إن ترجمتهما، والعلامة التجارية.

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

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

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

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.