أدلة الميزات

مزامنة الكتالوج مع Meta وTikTok في ڤاريونس للمتاجر في مصر

مزامنة الكتالوج في ڤاريونس تربط منتجات متجرك بكتالوج Meta وكتالوج TikTok حتى تصبح جاهزة للإعلانات: تُرسَل المنتجات المؤهلة تلقائياً عند الإنشاء والتعديل والحذف، مع شريط جاهزية يوضح المحظور، وتقدّم مباشر، وجدول مشكلات لإعادة المحاولة، ورابط تغذية XML/CSV للرفع اليدوي.

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

ڤاريونس منصة تجارة إلكترونية للشركات التي تبيع أونلاين في مصر. مزامنة الكتالوج ميزة تسويق مدمجة في صفحة «مزامنة الكتالوج» بلوحة التحكم (/dashboard/catalog-sync).

ما الذي يحلّه؟ التجار الذين يشغّلون إعلانات Meta وTikTok يحتاجون كتالوج منتجات محدّثاً دائماً: الأسعار والصور والتوفر. التحديث اليدوي لكل منتج في مدير الإعلانات هش ويتقادم مع أول تعديل سعر أو نفاد مخزون.

كيف يعمل التدفق فعلياً؟ التاجر يفتح /dashboard/catalog-sync ويرى شريط الجاهزية (ready / needs-attention / blocked) وبطاقتي Meta وTikTok. ربط Meta بضغطة واحدة: موافقة فيسبوك ثم يختار النظام أول Business وأول كتالوج تلقائياً (أو ينشئ كتالوجاً باسم المتجر) ويبدأ مزامنة كاملة. ربط TikTok عبر نموذج: توكن الوصول وBusiness Center ID (ومعرف الكتالوج ومعرف البكسل اختياريان) ثم إنشاء تلقائي للكتالوج عند الحاجة.

خلف الكواليس، خطافات إنشاء وتعديل وحذف المنتج تُدرج عناصر للمزامنة دون حجب الاستجابة، ومحرّك المزامنة يعالجها دفعات مع بصمة محتوى تتخطى ما لم يتغير، وتراجع أسّي حتى 6 محاولات، وحذف ضمني على المنصة عند اختفاء المنتج. مجدول كل 5 دقائق يعالج المعلق والمستحق لإعادة المحاولة على مستوى المنصة كلها.

الحالة تُخزَّن في ثلاثة نماذج: CatalogConnection (الاتصال والتوكنات المشفّرة والإعدادات) وProductCatalogSync (حالة كل عنصر وبصمته وعدّاد المحاولات) وCatalogSyncLog (سجل تدقيق بحذف تلقائي بعد 30 يوماً). رابط التغذية العام (/api/catalog-feed/[slug].xml|csv مع توكن) يبقى متاحاً في قسم متقدم للرفع اليدوي في مديري الإعلانات.

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

  1. افتح مزامنة الكتالوج

    من لوحة تحكم التاجر، ادخل إلى /dashboard/catalog-sync (مزامنة الكتالوج). الصفحة تتطلب صلاحية التسويق للموظفين، وللتجار يجب أن تسمح الخطة بصفحة التسويق.

  2. اربط Meta بضغطة واحدة

    اضغط ربط على بطاقة Meta، وافق على أذونات فيسبوك. سيختار النظام أول Business وأول كتالوج تلقائياً (أو ينشئ كتالوجاً باسم «Vareons - متجرك») ثم يبدأ مزامنة كاملة مع شريط تقدم مباشر يتوقف تلقائياً عند اكتمال المعلق. لمسار System User Token استخدم اختيار الكتالوج اليدوي.

  3. اربط TikTok بالتوكن

    افتح نموذج بطاقة TikTok: الصق توكن الوصول وBusiness Center ID (معرف الكتالوج ومعرف البكسل اختياريان في الحقول المتقدمة) ثم اضغط ربط. يتحقق النظام من التوكن وينشئ الكتالوج تلقائياً عند الحاجة ويبدأ المزامنة الكاملة.

  4. راجع شريط الجاهزية وأصلح المحظور

    شريط الجاهزية يعرض ready وneeds-attention وblocked مع عينات من المنتجات. المنتج المحظور (مسودة/مؤرشف، مخفي، بلا صورة، سعر غير صالح، رابط سيئ) لا يُرسل أبداً — انشر المنتج وأضف صورة رئيسية وسعراً صالحاً ثم أعد المزامنة. غياب العلامة التجارية تحذير فقط (يُستخدم اسم المتجر كبديل).

  5. تابع التقدم وأعد محاولة الفاشل

    أثناء المزامنة تظهر أشرطة تقدم لكل منصة مع تحديث كل 5 ثوانٍ. جدول المشكلات يظهر فقط عند وجود أخطاء: زر إعادة لكل صف، وزر إعادة الكل، مع رسائل خطأ بشرية. أخطاء التفويض تحوّل الاتصال إلى reauth_required وتتطلب إعادة الربط.

  6. استخدم رابط التغذية للرفع اليدوي (متقدم)

    داخل القسم المتقدم القابل للطي ستجد رابطي XML وCSV مع التوكن. انسخ الرابط والصقه كـ Data Feed في مدير إعلانات Meta أو TikTok للرفع اليدوي. تدوير التوكن يتطلب تأكيداً لأنه يُبطل الرابط القديم فوراً.

  7. افصل الاتصال عند الحاجة

    زر الفصل يفتح نافذة بثلاثة أوضاع: إيقاف (يتوقف عن المزامنة مع بقاء السجلات)، أو إزالة (حذف الاتصال)، أو تنظيف شامل (يرسل أوامر حذف للمنصة أولاً ثم يحذف). الكتالوج البعيد لا يُحذف أبداً من جهة ڤاريونس.

أسئلة شائعة

هل يدعم ڤاريونس مزامنة الكتالوج؟

نعم. صفحة /dashboard/catalog-sync تربط متجرك بكتالوج Meta وكتالوج TikTok مع مزامنة تلقائية وشريط جاهزية وتقدم مباشر ورابط تغذية XML/CSV.

أين أجد صفحة مزامنة الكتالوج؟

من لوحة التحكم: /dashboard/catalog-sync (مزامنة الكتالوج ضمن قسم التسويق). تتطلب صلاحية التسويق للموظفين وخطة تسمح بصفحة التسويق للتجار.

ماذا يحدث عند تعديل منتج بعد الربط؟

خطاف التعديل يُدرج المنتج للمزامنة تلقائياً دون حجب الحفظ. بصمة المحتوى تتخطى العناصر التي لم تتغير فعلياً، والعناصر المتغيرة تُرسل ضمن الدفعة التالية أو مجدول الـ 5 دقائق.

ماذا يحدث عند حذف منتج من المتجر؟

خطاف الحذف يُدرج المنتج للمزامنة قبل إزالته من قاعدة البيانات، فيُرسل أمر حذف ضمني للمنصة (Meta/TikTok) بدل أن يبقى المنتج عالقاً في الكتالوج البعيد.

كيف أستبعد منتجات أو فئات من المزامنة؟

من إعدادات الاتصال: excludedProductIds لاستبعاد منتجات محددة وexcludedCategoryIds لاستبعاد فئات كاملة. القائمتان للاستبعاد فقط، والافتراضي (فارغ) يعني مزامنة كل المؤهل.

ماذا تعني حالة reauth_required؟

تعني أن المنصة رفضت التوكن (خطأ تفويض). أعد الربط من بطاقة المنصة: Meta بضغطة OAuth جديدة، وTikTok بلصق توكن صالح جديد. تظهر أيضاً شارة تحذير عند بقاء 7 أيام أو أقل على انتهاء توكن Meta.

هل يمكن ربط أكثر من كتالوج واحد لكل منصة؟

حالياً كتالوج واحد نشط لكل منصة لكل متجر (النموذج يحمل حقل isActive للتوسع المستقبلي). لإدارة كتالوجات متعددة، استخدم أدوات Meta/TikTok نفسها لتقسيم Product Sets من الكتالوج الواحد المزامَن.

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

إذا لم تظهر المنتجات في الكتالوج البعيد: 1) افتح شريط الجاهزية وتأكد أن المنتج ليس محظوراً (UNPUBLISHED أو HIDDEN أو MISSING_IMAGE أو INVALID_PRICE أو INVALID_URL). 2) تأكد من حالة الاتصال connected وليس reauth_required أو error — أعد الربط عند الحاجة. 3) من جدول المشكلات اضغط إعادة المحاولة للصف، أو إعادة الكل، وراقب شريط التقدم. 4) تحقق أن المنتج ليس ضمن excludedProductIds وأن فئته ليست ضمن excludedCategoryIds. 5) لرابط التغذية اليدوي: تأكد أنك تستخدم الرابط الحالي بعد أي تدوير للتوكن (القديم يُبطل فوراً).

حدود مهمة

• كتالوج واحد نشط لكل منصة لكل متجر (حقل isActive موجود للتوسع المستقبلي). • أسعار بعملة المتجر لكل العناصر — لا تقسيم أسعار حسب الدولة لكل كتالوج. • لا يوجد منشئ Product Sets داخل ڤاريونس — التقسيم يتم في أدوات Meta/TikTok. • لا يوجد مُصلح علامات تجارية جماعي — غياب العلامة يُغطى ببديل اسم المتجر فقط. • حالة «البكسل يستقبل الأحداث» استدلالية (متصل/آخر مزامنة) وليست تحققاً حياً من سجل الأحداث. • التحقق من الصور يقتصر على الوجود وhttps — لا يُفرض حد أدنى للأبعاد.

روابط ذات صلة

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