أدلة الميزات

تطبيق مزامنة الكتالوج في ڤاريونس: التثبيت وربط Meta وTikTok والتغذية

تطبيق مزامنة الكتالوج هو بطاقة id catalog-sync في السوق تفتح مسار /dashboard/catalog-sync: يربط منتجات المتجر بكتالوجي Meta وTikTok للإعلانات الديناميكية عبر OAuth ورمز وصول، مع شريط جاهزية وتقدم مباشر وروابط تغذية.

آخر تحقق: 2026-09-19

يثبَّت التطبيق من سوق /dashboard/apps بزر تثبيت على بطاقة «مزامنة الكتالوج» المميزة بشارة Featured بوصف مزامنة المنتجات مع كتالوج Meta وTikTok، ثم يظهر زر فتح ينقل إلى /dashboard/catalog-sync. والبطاقة بشارة مجاني.

الصفحة بعنوان «مزامنة الكتالوج» ووصف المنتجات الجاهزة للإعلانات، وشريط جاهزية بعدّاد المحظور، وعمودين: لوحة ربط Meta ولوحة ربط TikTok، ثم جدول حالة المزامنة عند وجود أخطاء أو محظور، وقسم متقدم لروابط التغذية. وحالات اللوحات: ربط Meta ثم مزامنة الكل وإعادة المحاولة وفصل وإعادة ربط، ومنتهي الصلاحية مع إعادة ربط، ومُزامَن مع «منذ X»، ونموذج رمز TikTok مع معرفات النشاط والكتالوج والبكسل.

فلو Meta يبدأ بزر الربط إلى رابط OAuth ثم الاسترجاع على /meta/callback برمز وحالة HMAC لعشر دقائق، ثم اختيار النشاط التجاري والكتالوج، ثم مزامنة شاملة تلقائية مع استطلاع الحالة والتقدم كل خمس ثوانٍ حتى صفر معلّق. وفلو TikTok بلصق رمز الوصول ومعرفات BC والكتالوج والبكسل ثم تحقق ثم مزامنة شاملة. ومسار التغذية دون موافقات: نسخ رابط /api/catalog-feed/[slug].xml أو .csv بالرمز ولصقه في مدير التجارة.

الأزرار تشمل إعادة توليد الرمز (رابط تغذية جديد أو فشل)، وإعادة المحاولة لعنصر أو لكل الفاشل عبر retry-failed. وتُدار الحالة بمخزن zustand يجلب الحالة والتغذية والجاهزية عند التحميل. وتُخزَّن الاتصالات في CatalogConnection (رمز مشفر AES-256-GCM ومعرفات النشاط والكتالوج والبكسل والحالة والإعدادات)، والعناصر في ProductCatalogSync (الحالة والبصمة وعدّاد المحاولات)، والسجلات في CatalogSyncLog بانتهاء ثلاثين يوماً، ورمز التغذية في User.catalogFeedToken. ومحرك المزامنة في sync-engine.js بقوائم نارٍ وانسٍ ودفعات مئة وتراجع أسّي حتى ست محاولات.

خطوات الإعداد في ڤاريونس

  1. ثبّت التطبيق من السوق

    افتح /dashboard/apps واضغط تثبيت على بطاقة مزامنة الكتالوج، ثم اضغط فتح للانتقال إلى /dashboard/catalog-sync.

  2. اربط Meta

    اضغط ربط Meta وأكمل OAuth ثم اختر النشاط التجاري والكتالوج لتبدأ المزامنة الشاملة تلقائياً.

  3. اربط TikTok

    الصق رمز الوصول ومعرفات BC والكتالوج والبكسل ثم تحقق وأطلق المزامنة الشاملة.

  4. راجع الجاهزية والتقدم

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

  5. استخدم التغذية عند الحاجة

    من القسم المتقدم انسخ رابط XML أو CSV بالرمز والصقه في مدير التجارة، وأعد توليد الرمز عند التسرب.

أسئلة شائعة

هل تطبيق مزامنة الكتالوج مجاني؟

نعم، بطاقة التطبيق بشارة مجاني، والربط والمزامنة والتغذية تعمل دون شراء.

ما الفرق بين المزامنة والتغذية؟

المزامنة دفع تلقائي عبر API بعد الربط، والتغذية رابط XML/CSV تلصقه يدوياً في مدير التجارة دون ربط.

ماذا يعني شريط الجاهزية؟

عدّاد المنتجات المحظورة من المزامنة (نواقص بيانات)؛ إصلاحها يرفع نسبة الجاهزية قبل الإعلانات.

ماذا أفعل عند انتهاء صلاحية الربط؟

تظهر حالة منتهي الصلاحية مع زر إعادة ربط؛ أكمل OAuth من جديد ثم أطلق مزامنة شاملة.

هل تُحذف المنتجات من الكتالوج عند حذفها؟

نعم، إعدادات الاتصال تشمل المزامنة عند الإنشاء والتعديل والحذف، والحذف يعلّم العنصر محذوفاً.

استكشاف الأخطاء

1) الاسترجاع يفشل: حالة HMAC عشر دقائق فقط؛ أعد الربط من جديد. 2) عناصر عالقة معلّقة: استخدم إعادة المحاولة لكل الفاشل وراقب الاستطلاع. 3) محظور مرتفع: أكمل بيانات المنتجات الناقصة ثم أعد المزامنة الشاملة. 4) التغذية 404: أعد توليد رمز التغذية وانسخ الرابط الجديد الكامل بالرمز.

حدود مهمة

• رمز HMAC للاسترجاع عشر دقائق فقط. • الاستطلاع كل خمس ثوانٍ أثناء المزامنة النشطة فقط. • سجلات المزامنة تنتهي بعد ثلاثين يوماً. • معرفات العناصر مشتقة من مفاتيح الألوان والمقاسات الثابتة.

روابط ذات صلة

تواصل معنا على واتساب