بازارفويس هي منصة لتقييمات ومراجعات العملاء ومحتوى المستخدمين، تستخدمها متاجر التجزئة والعلامات التجارية لجمع مراجعات العملاء ومراجعتها وعرضها، ونشر هذا المحتوى عبر شبكة من مواقع شركاء التجزئة. على عكس قنوات الإعلانات أو محركات مقارنة الأسعار، لا تعرض بازارفويس منتجاتك للمتسوقين الجدد مباشرةً على متجرها، بل تُشغّل تقييمات النجوم وعدد المراجعات ونصوصها الكاملة التي تظهر على صفحات منتجاتك (وعبر النشر، على صفحات شركاء التجزئة أيضًا). وللقيام بذلك بشكل صحيح، تحتاج بازارفويس أولًا إلى معرفة كتالوج منتجاتك: ما هي المنتجات الموجودة، وما أسمائها، والفئة والعلامة التجارية التي ينتمي إليها كل منتج. تُقدّم بيانات الكتالوج هذه من خلال ما يُسمى في وثائق بازارفويس "موجز المنتجات"، وهي الآلية التي تُمكّن بازارفويس من ربط كل مراجعة تجمعها برمز المنتج الصحيح (SKU) بدلًا من إدراجها في قائمة عامة أو غير متطابقة.
لا يركز موجز منتجات Bazaarvoice على الظهور أو الإنفاق كما هو الحال في موجز الإعلانات، بل على الدقة. يصف Bazaarvoice غرض الكتالوج بوضوح: يتم إرسال موجز كتالوج المنتجات إلى Bazaarvoice "لمطابقة كل منتج مع المحتوى الذي ينشئه المستهلكون". إذا كان أحد المنتجات مفقودًا في موجزك، أو يحمل اسمًا خاطئًا، أو مصنفًا ضمن فئة غير مناسبة، فلن يجد Bazaarvoice أي مرجع موثوق لمطابقة التقييمات الواردة، مما يؤدي إلى عدم ظهور التقييمات، أو ربطها بالمنتج الخطأ، أو عدم قدرة نموذج إرسال التقييم على موقعك على تحديد المنتج الذي يقيّمه المتسوق.
يُقدّم فريق الهندسة في Bazaarvoice الأمر من منظور موثوقية النظام: فاسم المنتج الواضح والدقيق والمتسق "يُمكّن واجهات برمجة التطبيقات (APIs) من استرجاع وعرض معلومات المنتج بشكل صحيح، مما يضمن ربط تقييماتك ومراجعاتك دائمًا بالمنتج المناسب". وتلعب بيانات الفئات دورًا مشابهًا في عمليات إرسال المراجعات الجديدة، حيث "تُسهّل عملية إرسال المحتوى بسلاسة من خلال توجيه مساهمات المستخدمين إلى مجموعات المنتجات الصحيحة". ويُبقي Feedance بيانات الكتالوج مُحدّثة تلقائيًا مع تغيّر منتجات متجرك وأسمائها وفئاتها، بدلًا من ترك Bazaarvoice يعمل بنسخة قديمة مُصدّرة لمرة واحدة.
يربط تطبيق Bazaarvoice كل مراجعة بمنتج باستخدام المعرفات التي ترسلها في موجز البيانات - بشكل أساسي ExternalId و ProductPageUrl — تتم مقارنة هذا المعرّف بمعرّف المنتج الذي يمرره موقعك عند تحميل أداة عرض التقييمات على صفحة المنتج. عندما لا يتطابق هذان المعرّفان، فإن النتيجة العملية التي وثّقتها بازارفويس هي "ظهور محتوى مستخدم خاطئ": إما عدم ظهور أي تقييمات، أو ظهور تقييمات لمنتج مختلف.
بالنسبة لأنواع المنتجات المختلفة - نفس المنتج بألوان أو أحجام مختلفة، على سبيل المثال - يدعم مخطط تغذية Bazaarvoice آلية عائلات المنتجات باستخدام سمتين مخصصتين: BV_FE_FAMILY تُصنّف المنتجات ذات الصلة ضمن قيمة عائلية مشتركة (في مثال موجز Bazaarvoice، المنتجات التي تحمل علامة Round و Green)، و BV_FE_EXPAND يطلب من موقع Bazaarvoice جلب تقييمات من كل منتج آخر في تلك المجموعة (BV_FE_FAMILY:Roundوبالتالي يرى المتسوق تقييمات مجمعة بدلاً من عدد قليل من المراجعات المتناثرة بشكل متفرق عبر قوائم المنتجات المتشابهة تقريبًا.
بيانات المنتجات الموثقة في بازارفويس هي بتنسيق XML، ومُهيكلة على شكل ملف واحد. <Feed> العنصر الجذري الذي يحمل ثلاثة أقسام فرعية بالترتيب التالي: <Brands>, <Categories> و <Products>يستخدم مثال التغذية الرسمي الخاص بـ Bazaarvoice مساحة الاسم http://www.bazaarvoice.com/xs/PRR/ProductFeed/14.7 على العنصر الجذر، إلى جانب name السمة التي تحدد هوية العميل، و incremental يصف (true/false) و extractDate الطابع الزمني.
يدعم النظام افتراضيًا تحميل الكتالوجات الكاملة فقط، مع حد أقصى موثق يبلغ 750,000 منتج لكل ملف. لذا، ما لم تكن قد أنشأت عملية تحديث تدريجية/تراكمية مخصصة لحسابك، يجب أن يُمثل كل إرسال كتالوجك الحالي بالكامل، وليس فقط التغييرات. تُجمع الملفات عادةً وتُرسل عبر بروتوكول نقل الملفات (FTP/SFTP) إلى الموقع المُخصص لحسابك في Bazaarvoice، بدلاً من جلبها من عنوان URL تستضيفه. تجدر الإشارة إلى أن واجهة برمجة تطبيقات التجارة الاجتماعية الأحدث من Bazaarvoice (المستخدمة في بعض الحسابات، خاصةً بعد دمج خط إنتاج Bazaarvoice مع PowerReviews) تقبل ملفات CSV وTSV وXML وRSS وATOM مع مجموعة حقول مختلفة، على غرار Google Shopping. يعتمد المسار المُطبق على حسابك على إعدادات Bazaarvoice الخاصة بك، لذا يُنشئ Feedance ملفات المنتجات وفقًا لبنية XML الكلاسيكية الموضحة هنا، لأن هذا هو التنسيق الذي تُسميه وثائق Bazaarvoice "ملفات المنتجات".
يستخدم الجدول أدناه أسماء الحقول الخاصة بـ Bazaarvoice تمامًا كما تظهر في مثال ملف XML الرسمي لبيانات المنتجات الخاص بـ Bazaarvoice. وتُحدد وثائق Bazaarvoice الهندسية أسماء الحقول بشكل صريح. ExternalId, Name وتحديد الفئة (CategoryExternalIdبالإضافة إلى قطعة مطابقة Name (المدخل في قسم الفئات) باعتباره أساسيًا؛ الحقول المتبقية هي أجزاء موثقة من نفس المخطط، ومُصنفة على أنها "موصى بها" حيث لم أتمكن من تأكيد وجود تعيين إلزامي صارم.
| الحقل | مطلوب: | شكل | مثال | ملاحظة |
|---|---|---|---|---|
ExternalId | نعم | سلسلة | 11111111111abc | معرّف منتجك الفريد؛ وهو المفتاح الأساسي الذي يستخدمه Bazaarvoice لمطابقة التقييمات. استخدم الشرطات السفلية والواصلات فقط كفواصل - فالمسافات وعلامات الجمع وأحرف HTML الأخرى قد تُسبب مشاكل في الترميز. |
Name | نعم | سلسلة | المنتج الأول دائري مع اللون الأخضر | يتم عرضها في صفحات المراجعات وتستخدمها واجهات برمجة تطبيقات Bazaarvoice لتحديد المنتج |
CategoryExternalId | نعم | يجب أن تتطابق السلسلة مع معرّف خارجي مُعرّف في قسم الفئات. | 1010 | يوجه طلبات التقييم الجديدة إلى مجموعة المنتجات الصحيحة. |
Description | منتجات ينصح بها | سلسلة | نص وصف المنتج الأول | موجود على كل منتج في مثال موجز Bazaarvoice الخاص |
ProductPageUrl | منتجات ينصح بها | عنوان URL مطلق | http://www.example.com/product.htm?prod=2000001 | عنوان URL الكامل لصفحة تفاصيل المنتج المباشرة؛ يُستخدم مع ExternalId للمطابقة |
ImageUrl | منتجات ينصح بها | عنوان URL مطلق | http://images.example.com/prodimages/2000001.gif | تُستخدم في واجهة المستخدم الخاصة بتقديم المراجعات وتحديد المنتجات |
BrandExternalId | منتجات ينصح بها | يجب أن تتطابق السلسلة مع معرّف خارجي مُحدد في قسم العلامات التجارية. | AAA | يربط المنتج بعلامة تجارية محددة في مكان آخر ضمن نفس موجز البيانات. |
ManufacturerPartNumbers / ManufacturerPartNumber | لا | سلسلة قابلة للتكرار، متداخلة تحت ManufacturerPartNumbers | 26-12345-8 ز | معرّف إضافي يعزز مطابقة المنتجات |
EANs / EAN | لا | سلسلة قابلة للتكرار، متداخلة ضمن رموز EAN | 0213354752286 | يتم دعم عدة أرقام EAN لكل منتج |
UPCs / UPC | لا | سلسلة قابلة للتكرار، متداخلة تحت رموز UPC | 382157229380 | يتم دعم رموز UPC متعددة لكل منتج |
ModelNumbers / ModelNumber | لا | سلسلة قابلة للتكرار، متداخلة تحت أرقام الطراز | 1235832 | معرّف مطابقة إضافي، مفيد بشكل خاص للمنتجات على مستوى العائلة |
Attributes / Attribute id="BV_FE_FAMILY" | لا | سمة مخصصة، قابلة للتكرار، مع عنصر فرعي <Value> | أخضر | يجمع هذا القسم وحدات SKU المختلفة في مجموعة مشتركة لعرض التقييمات المجمعة. |
Attributes / Attribute id="BV_FE_EXPAND" | لا | سمة مخصصة، تنسيق القيمة BV_FE_FAMILY:<value> | BV_FE_FAMILY: دائري | يستخلص هذا المنتج تقييمات من جميع المنتجات الأخرى التي تشترك في نفس القيمة العائلية إلى صفحته. |
ExternalId، ملكية Name، رابط المنتج الأساسي إلى ProductPageUrl، الصورة الرئيسية إلى ImageUrl، والفئة والعلامة التجارية إلى CategoryExternalId / BrandExternalId — مع مطابقة Category و Brand يتم إنشاء الإدخالات في قسمي "الفئات" و"العلامات التجارية" في الخلاصة بحيث يتم حل تلك المراجع.ExternalId و CategoryExternalId، واستبدالها بشرطات أو شرطات سفلية، لأن المعرفات المشوهة هي سبب موثق لمشاكل الترميز.BV_FE_FAMILY و BV_FE_EXPAND لذلك يقوم موقع Bazaarvoice بتجميع المراجعات عبر المجموعة بدلاً من تقسيمها بشكل متفرق عبر كل وحدة تخزين.Feed/Brands/Categories/Products يقوم النظام بهيكلة البيانات وتسليمها إلى موقع SFTP الذي تم تكوين حساب Bazaarvoice الخاص بك لاستقبالها - تأكد من وصول أول عملية تسليم بنجاح، حيث يتم تسجيل عملية الاستيراد الفاشلة وإرسال تنبيه عبر البريد الإلكتروني بدلاً من ظهور خطأ مرئي داخل التطبيق.نظرًا لأن التحميلات تدعم الكتالوج الكامل فقط بشكل افتراضي، يجب أن يُمثل كل طلب تغذية مجموعة منتجاتك الحالية بالكامل، وليس التغييرات الجزئية. لا يمتلك Bazaarvoice آلية قياسية لقبول "التغييرات فقط" إلا إذا تم إنشاء عملية تحديث تدريجي مخصصة لحسابك. تختلف وتيرة التحديث حسب التكامل: فبعض الإعدادات تُشغّل التصدير ليلًا، بينما تُرسل أخرى يوميًا. كما أن مسار استيعاب كتالوج التجارة الاجتماعية الأحدث من Bazaarvoice موثق بأنه يُحدّث كل ست ساعات تقريبًا بشكل افتراضي، لذا لا يوجد رقم موحد مستهدف، بل مبدأ مشترك فقط. يجب أن تكون المنتجات الجديدة موجودة في التغذية المُرسلة قبل إضافة التقييمات إليها، لذا فإن أفضل ممارسة هي إرسال تغذية مُحدّثة وفقًا لجدول زمني ثابت يوميًا أو ليلًا، ودائمًا قبل نشر المنتج على موقعك، بدلًا من التفاعل مع تغييرات الكتالوج بعد حدوثها. إذا كان كتالوجك عند الحد الأقصى الموثق البالغ 750,000 منتج للتغذية الكاملة أو يقترب منه، فخطط لعملية تغذية تدريجية/تفاضلية مسبقًا بدلًا من اكتشاف الحد عند رفض طلب التغذية.
| خطأ | سبب محتمل | حل |
|---|---|---|
| التقييمات مفقودة أو مرفقة بالمنتج الخطأ | ExternalId or ProductPageUrl لا يتطابق مُعرّف المنتج في الخلاصة مع مُعرّف المنتج الذي يمرره رمز صفحتك عند تحميل أداة عرض المراجعات | احتفظ ExternalId ويكون عنوان URL للمنتج متطابقًا تمامًا بين موجز البيانات وتطبيقك على الصفحة. |
| فشلت عملية استيراد البيانات ولم يتم تحديث أي شيء، ولم تُجرَ أي محاولات أخرى. | فشلت عملية التحقق من صحة البيانات المُرسلة؛ يسجل بازارفويس الفشل ويرسل تنبيهًا عبر البريد الإلكتروني، لكنه لا يعيد المحاولة تلقائيًا. | انتبه لإشعار الفشل بعد كل عملية إرسال، وأعد إرسال ملف مصحح على الفور بدلاً من افتراض أن المشكلة ستُحل من تلقاء نفسها. |
| أخطاء في الترميز أو معرفات تالفة | تحتوي معرّفات المنتجات أو الفئات على مسافات وعلامات زائد (+أو أحرف HTML أخرى | استخدم الواصلات فقط (-) والخطوط السفلية (_) كفواصل في ExternalId و CategoryExternalId القيم |
| المنتجات مفقودة بصمت بعد التحميل | يتجاوز حجم الكتالوج الحد الأقصى البالغ 750,000 منتج للأعلاف الكاملة | قم بإنشاء عملية تغذية دلتا/تزايدية مخصصة إذا كان حجم الكتالوج الخاص بك أكبر من حد التغذية الكاملة، حيث أن تحميل الكتالوج الكامل فقط هو المدعوم افتراضيًا |
| تم توزيع المراجعات بشكل متفرق عبر متغيرات متطابقة تقريبًا بدلاً من تجميعها | لا يتم ربط رموز المنتجات البديلة من خلال BV_FE_FAMILY السمة | قم بتعيين مشترك BV_FE_FAMILY إضافة قيمة عبر المنتجات المتنوعة BV_FE_EXPAND لعرض تقييمات جميع أفراد العائلة على صفحة كل نوع من أنواع المنتجات |
| لا يتم حل المشكلة عند الرجوع إلى العلامة التجارية أو الفئة | منتج CategoryExternalId or BrandExternalId يشير إلى معرّف غير مُعرّف في أي مكان في قسم الفئات أو العلامات التجارية في تلك الخلاصة | تأكد من أن كل معرف يُشار إليه بواسطة منتج ما له مُعرّف مطابق. Category or Brand تم تعريف الإدخال في نفس ملف التغذية |
قم بمطابقة معرّفات موجزك مع رمز صفحتك بدقة. السبب الأكثر شيوعًا لعدم ظهور التقييمات، أو ظهورها على المنتج الخطأ، هو ExternalId أو عدم توافق رابط المنتج بين موجز الأخبار وأداة مراجعة المنتجات على موقعك.
اتبع قاعدة تسمية المعرفات الخاصة بـ Bazaarvoice. استخدم فقط الواصلات والشرطات السفلية في ExternalId و CategoryExternalId — تشير إرشادات الهندسة الخاصة بـ Bazaarvoice إلى المسافات وعلامات الجمع وأحرف HTML الأخرى باعتبارها سببًا موثقًا لمشاكل الترميز.
قم بتجميع المتغيرات مع عائلات المنتجات. استعمل BV_FE_FAMILY و BV_FE_EXPAND لذا فإن اختلافات اللون/الحجم لنفس المنتج تتشارك وتجمع التقييمات بدلاً من تشتيت عدد قليل من التقييمات عبر العديد من القوائم المتشابهة تقريبًا.
أرسل المعرفات الثانوية عندما تكون متوفرة لديك. UPC, EAN و ManufacturerPartNumber هي اختيارية ولكنها تعطي Bazaarvoice إشارات إضافية لمطابقة الكتالوج الخاص بك بشكل صحيح، وهو أمر مفيد بشكل خاص أثناء الإعداد الأولي أو عمليات نقل الكتالوج.
قم بالإرسال قبل الإطلاق، وليس بعده. ولأن الدعم الافتراضي يقتصر على خلاصات الكتالوج الكاملة فقط، لا يمكن لمنتج جديد جمع أو عرض التقييمات إلا بعد أن يكون موجودًا بالفعل في خلاصة مُرسلة.
حافظ على ثبات أسماء الفئات ومعرّفاتها بمرور الوقت. بما أن بيانات الفئات توجه طلبات التقييم الجديدة إلى مجموعة المنتجات الصحيحة، فإن إعادة تسمية معرّفات الفئات أو تغيير ترتيبها دون تحديث البيانات قد يؤدي إلى توجيه التقييمات الواردة بشكل خاطئ.
ما هو تنسيق موجز المنتجات الذي يستخدمه موقع Bazaarvoice؟
XML — أ <Feed> عنصر جذر يحتوي على Brands, Categories و Products يتم تسليم الأقسام عبر بروتوكول نقل الملفات (FTP) / بروتوكول نقل الملفات الآمن (SFTP) إلى حسابك في بازارفويس.
هل هذا هو نفسه موجز الإعلانات أو موجز مقارنة الأسعار؟
لا. إن موجز منتجات Bazaarvoice موجود لمطابقة كتالوجك مع المراجعات والتقييمات المجمعة لعرضها ونشرها - ولا يتم استخدامه لوضع الإعلانات أو مقارنة الأسعار بالطريقة التي يتم بها استخدام مركز Google Merchant Center أو موجز مقارنة التسوق.
كم عدد المنتجات التي يمكنني إضافتها؟
تم توثيق أن موجزات الكتالوج الكاملة تدعم ما يصل إلى 750,000 منتج بشكل افتراضي.
هل يمكنني إرسال التغييرات فقط بدلاً من إرسال الكتالوج الكامل؟
ليس بشكل افتراضي - يتم دعم عمليات تحميل الكتالوج الكامل فقط ما لم يتم إعداد عملية تزايدية/تفاضلية مخصصة لحسابك.
ماذا يحدث إذا فشل استيراد موجز البيانات الخاص بي؟
يقوم برنامج Bazaarvoice بتسجيل الفشل وإرسال تنبيه عبر البريد الإلكتروني؛ فهو لا يعيد محاولة الاستيراد تلقائيًا، لذلك يجب إعادة إرسال ملف مصحح.
كيف يمكنني الاحتفاظ بالتقييمات معًا بغض النظر عن اختلاف الألوان أو المقاسات؟
استخدم BV_FE_FAMILY يُنسب إلى وحدات SKU المتغيرة للمجموعة و BV_FE_EXPAND للحصول على آراء بقية أفراد العائلة.
لماذا تظهر التقييمات على المنتج الخطأ؟
دائماً تقريباً ExternalId أو عدم تطابق عنوان URL للمنتج بين ما هو موجود في الخلاصة وما يمرره رمز صفحتك إلى أداة عرض المراجعات.