نمایش محصولات در جستجوی اسنپپی؛ راهنمای افزونه
نصب افزونه، جمعآوری مستقیم و ساخت خوراک محصول — راهنمای کامل برای فروشگاههای ووکامرس
🎯 با اجرای این راهنما، نمایش محصولات در جستجوی اسنپپی برای فروشگاه ووکامرسی شما امکانپذیر میشود و کاربران میتوانند محصولات شما را در اپلیکیشن اسنپپی پیدا کنند.
دو روش اصلی برای ارائه دادهها وجود دارد: خوراک محصول (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) اسنپپی روزانه (حدود نیمهشب) صفحات محصولات را میخواند. برای موفقیت این روش، نکات زیر را رعایت کنید:
۱. ربات مسدود نشود
اگر سرور شما IPهای با درخواست بالا را بلاک میکند، تمام IPهای زیر را وایتلیست کنید:
۲. نقشه سایت (Sitemap)
یک sitemap کامل و روزانه که همه لینکهای محصولات را در بر داشته باشد باید فعال باشد (افزونههای سئو این امکان را فراهم میکنند).
۳. دادههای قابل مشاهده
اطلاعات اصلی (نام، دسته، قیمت، موجودی، تصویر، توضیحات) باید بدون وابستگی به جاوااسکریپت در صفحه باشند یا در تگهای <meta> قرار بگیرند.
به علت شرایط اینترنت، جهت اینکه در فرایند کرال مشکلی ایجاد نشود، بهتر است این server name ها توسط هاستینگ در دسترس باشند:
- نامگذاری کامل و کلیدواژهمحور: عنوان محصول شامل برند، مدل، مشخصات اصلی باشد. برای افزایش دیدهشدن در جستجوی کاربران و تطبیق محصولات با یکدیگر، محصولات خود را بهصورت کامل، یکتا و با استفاده از کلیدواژههای مناسب نامگذاری کنید.
✅ نامگذاری مناسب: گوشی موبایل سامسونگ، مدل Galaxy A14 5G، ظرفیت 64GB، رم 4GB
❌ نامگذاری ضعیف: Galaxy A14 64G - لینکهای ثابت: از تغییر لینک محصولات خودداری کنید.
- اطلاعرسانی تغییرات: در صورت تغییر نام، ویژگیها، تصاویر، لینک یا قالب سایت، حتماً به پشتیبانی اسنپپی اطلاع دهید تا از حذف محصولات جلوگیری شود.
اگر به هر دلیل از افزونه استفاده نمیکنید، میتوانید یک فایل خوراک (JSON, XML, CSV, TSV) بسازید و لینک ثابت آن را به اسنپپی بدهید. این فایل باید روزانه بهروز شود.
فیلدهای اصلی
- id : آیدی یا SKU محصول که باید برای هر محصول یکتا باشد.
- title : نام محصول بهصورت کامل و دقیق.
- subtitle : نام انگلیسی یا زیرعنوان
- link : لینک محصول
- image_link : لینک تصاویر محصول بهصورت یک آرایه که اولین لینک، تصویر اصلی محصول باشد.
- 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",
"رنگ": "تیتانیوم"
}
لینکهای مفید:
- قوانین فعالسازی پذیرندگان اسنپپی — شرایط نمایش در اپ
- سیستم امتیازدهی پذیرندگان اسنپپی — راهنمای ارزیابی
- مشکلات ثبتنام اسنپپی — راهنمای عیبیابی
- مستندات REST API ووکامرس — منبع معتبر برای توسعهدهندگان
چکلیست نهایی آمادهسازی فروشگاه
- افزونه Search API Data Feed نصب، آپلود و فعال شده است (یا خوراک دستی با لینک ثابت دارم).
- چهار IP اسنپپی در فایروال / افزونه امنیتی وایتلیست شدهاند.
- Sitemap کامل محصولات روزانه بهروز میشود.
- اطلاعات محصول بدون جاوااسکریپت در صفحه موجود است یا در meta tagها قرار دارد.
- نام محصولات کامل، شامل برند و مدل و کلیدواژههای اصلی است.
- در صورت تغییر لینک/نام/تصاویر، پشتیبانی اسنپپی را مطلع کردهام.
- آدرس فید (در صورت استفاده از افزونه) پاسخ صحیح میدهد.
📚 با تکمیل این مراحل، فروشگاه شما در جستجوی اسنپپی حضور خواهد داشت. برای اطلاعات بیشتر به آکادمی اسنپپی مراجعه کنید.
پشتیبانی: 02196862222


