نمایش محصولات در جستجوی اسنپپی
راهنمای جامع: نصب افزونه، جمعآوری مستقیم، و خوراک محصول
با اجرای این راهنما، محصولات فروشگاه ووکامرسی شما در موتور جستجوی اسنپپی قابل جستجو میشوند. دو روش اصلی برای ارائه دادهها وجود دارد: خوراک محصول (Product Feed) که توسط افزونه خودکار میشود، و جمعآوری مستقیم توسط ربات خزنده. در ادامه هر دو روش بهطور کامل آموزش داده شدهاند.
این افزونه رسمی و تخصصی ووکامرس، یک خوراک REST API استاندارد از محصولات شما ایجاد میکند. این بهترین و پایدارترین راه برای حضور در جستجوی اسنپپی است.
- خروجی JSON در آدرس:
https://your-site.com/wp-json/v1/product/feed - سازگار با همه قالبهای فروشگاهی و نسخه استاندارد ووکامرس
فایل فشرده افزونه را از لینک رسمی دریافت کنید:
📦 searchwise-woocommerce-plugin 1.0.2_2.zip
بدون خارج کردن از حالت فشرده، فایل را در مسیر زیر روی هاست خود قرار دهید:
/wp-content/plugins/
از File Manager هاست یا FTP استفاده کنید.
در پیشخوان وردپرس، از منوی «افزونهها» افزونه جدید را فعال کنید.
در صورتی که تغییرات قیمت و موجودی محصولات فروشگاه در طول روز زیاد باشد، استفاده از خوراک محصول مبتنی بر API توصیه میشود. این روش دسترسی بالدرنگ یا نزدیک به بالدرنگ به اطلاعات پایگاهداده محصولات را فراهم میکند. نکات زیر را هنگام استفاده از این روش مدنظر قرار دهید:
- صفحهبندی (Pagination): دادهها را میتوان به صورت بخشبندی شده ارسال کرد تا اطلاعات محصولات در چندین درخواست مجزا جمعآوری شود. برای این کار میتوان از پارامترهای page و size استفاده کرد.
- احراز هویت (Authentication): میتوانید اطلاعات مورد نیاز را در Headers قرار دهید.
- دسترسی به تک محصول: پیشنهاد میشود امکان دریافت اطلاعات یک محصول را نیز بر اساس id و slug آن فراهم شود تا برای محصولاتی که بیشتر مورد توجه هستند، نرخ بهروزرسانی سریعتر انجام شود.
ربات خزنده (Crawler) اسنپپی/سرچوایز روزانه (حدود نیمهشب) صفحات محصولات را میخواند. برای موفقیت این روش، نکات زیر را رعایت کنید:
۲. نقشه سایت (Sitemap): یک sitemap کامل و روزانه که همه لینکهای محصولات را در بر داشته باشد باید فعال باشد (افزونههای سئو این امکان را فراهم میکنند).
<meta> قرار بگیرند.
به علت شرایط اینترنت؛ جهت اینکه در فرایند کرال مشکلی ایجاد نشود؛ بهتر است این server name ها توسط هاستینگ در دسترس باشند .
- نامگذاری کامل و کلیدواژهمحور: عنوان محصول شامل برند، مدل، مشخصات اصلی باشد. برای افزایش دیدهشدن در جستجوی کاربران و تطبیق محصولات با یکدیگر، محصولات خود را بهصورت کامل، یکتا و با استفاده از کلیدواژههای مناسب نامگذاری کنید. نامگذاری مناسب شامل نوع محصول، مدل، برند و جزئیات اصلی محصول است.
✅ نامگذاری مناسب: گوشی موبایل سامسونگ، مدل Galaxy A14 5G، ظرفیت 64GB، رم 4GB
❌ نامگذاری ضعیف: Galaxy A14 64G
✅ نامگذاری مناسب: کفش پیادهروی مردانه آدیداس مدل ...
❌ نامگذاری ضعیف: آدیداس ... - لینکهای ثابت: از تغییر لینک محصولات خودداری کنید.
- اطلاعرسانی تغییرات: در صورت تغییر نام، ویژگیها، تصاویر، لینک یا قالب سایت، حتماً به پشتیبانی اسنپپی اطلاع دهید تا از حذف محصولات جلوگیری شود. تغییرات در نام، ویژگیهای محصول و لینک تصاویر بهصورت خودکار اعمال نمیشوند.
اگر به هر دلیل از افزونه استفاده نمیکنید، میتوانید یک فایل خوراک (JSON, XML, CSV, TSV) بسازید و لینک ثابت آن را به اسنپپی بدهید. این روش یکی از سادهترین و مرسومترین راهها برای جمعآوری اطلاعات محصولات است. این فایل باید روزانه بهروز شود. افزونههایی مانند CTX Feed یا Product Feed PRO این کار را ساده میکنند. همچنین میتوانید از پلاگین اختصاصی سرچوایز برای فروشگاههای WooCommerce استفاده کنید.
فیلدهای اصلی:
- id : آیدی یا SKU محصول که باید برای هر محصول یکتا باشد.
- title : نام محصول بهصورت کامل و دقیق.
- subtitle : نام انگلیسی یا زیرعنوان
- link : لینک محصول
- image_link : لینک تصاویر محصول بهصورت یک آرایه که اولین لینک، تصویر اصلی محصول باشد. تصاویر نباید به حالت thumbnail و در سایز کوچک باشند.
- availability : وضعیت موجودیت محصول (in stock/out of stock)
- regular_price : قیمت قبل از تخفیف بر حسب ریال
- sale_price : قیمت فروش محصول بر حسب ریال (قیمت بعد از تخفیف)
- category : دستهبندی محصول تا حد امکان دقیق باشد و به نوع محصول ختم شود. برای مثال: مد و پوشاک < مردانه < لباس مردانه < پیراهن
- brand : نام برند محصول
- description : جزئیات مهم و ویژگیهای محصول. توضیحات بهشکل ویژگی-مقدار در اولویت بالاتری برای نمایش قرار دارند و لازم است بهشکل یک object در خروجی باشد.
- GTIN : شناسه جهانی کالا
{
"برند": "Samsung",
"مدل": "Galaxy S24 Ultra",
"سیستم عامل": "Android",
"حافظه داخلی": "512GB",
"رم": "12GB",
"پردازنده": "Snapdragon 8 Gen 3",
"دوربین اصلی": "200MP + 50MP + 12MP + 10MP",
"دوربین سلفی": "12MP",
"اندازه صفحه": "6.8 اینچ",
"نوع صفحه نمایش": "Dynamic AMOLED 2X",
"باتری": "5000mAh",
"رنگ": "تیتانیوم"
}
- افزونه Search API Data Feed نصب، آپلود و فعال شده است (یا خوراک دستی با لینک ثابت دارم).
- چهار IP اسنپپی در فایروال / افزونه امنیتی وایتلیست شدهاند.
- Sitemap کامل محصولات روزانه بهروز میشود.
- اطلاعات محصول بدون جاوااسکریپت در صفحه موجود است یا در meta tagها قرار دارد.
- نام محصولات کامل، شامل برند و مدل و کلیدواژههای اصلی است.
- در صورت تغییر لینک/نام/تصاویر، پشتیبانی اسنپپی را مطلع کردهام.
- آدرس فید (در صورت استفاده از افزونه) پاسخ صحیح میدهد.
📚 با تکمیل این مراحل، فروشگاه شما در جستجوی اسنپپی حضور خواهد داشت. برای اطلاعات بیشتر به آکادمی اسنپپی مراجعه کنید.
