افزونه سرچ | ویژه قرارگیری محصولات در جست‌وجوی اسنپ‌پی

4,505بار مشاهده شده
نمایش محصولات در جستجوی اسنپ‌پی | راهنمای افزونه

نمایش محصولات در جستجوی اسنپ‌پی؛ راهنمای افزونه

نصب افزونه، جمع‌آوری مستقیم و ساخت خوراک محصول — راهنمای کامل برای فروشگاه‌های ووکامرس

زمان مطالعه: ۱۲ دقیقه مناسب برای مدیران فروشگاه‌های ووکامرس نسخه ۱.۰
نمایش محصولات در جستجوی اسنپ‌پی؛ دو روش اصلی

🎯 با اجرای این راهنما، نمایش محصولات در جستجوی اسنپ‌پی برای فروشگاه ووکامرسی شما امکان‌پذیر می‌شود و کاربران می‌توانند محصولات شما را در اپلیکیشن اسنپ‌پی پیدا کنند.

دو روش اصلی برای ارائه داده‌ها وجود دارد: خوراک محصول (Product Feed) که توسط افزونه خودکار می‌شود، و جمع‌آوری مستقیم توسط ربات خزنده. در ادامه هر دو روش به‌طور کامل آموزش داده شده‌اند.

روش پیشنهادی
افزونه Search API Data 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

در صورتی که تغییرات قیمت و موجودی محصولات فروشگاه در طول روز زیاد باشد، استفاده از خوراک محصول مبتنی بر API توصیه می‌شود. این روش دسترسی بالدرنگ یا نزدیک به بالدرنگ به اطلاعات پایگاه‌داده محصولات را فراهم می‌کند.

صفحه‌بندی (Pagination)

داده‌ها را می‌توان به صورت بخش‌بندی شده ارسال کرد تا اطلاعات محصولات در چندین درخواست مجزا جمع‌آوری شود. برای این کار می‌توان از پارامترهای page و size استفاده کرد.

احراز هویت (Authentication)

می‌توانید اطلاعات مورد نیاز را در Headers قرار دهید.

دسترسی به تک محصول

پیشنهاد می‌شود امکان دریافت اطلاعات یک محصول را نیز بر اساس id و slug آن فراهم شود تا برای محصولاتی که بیشتر مورد توجه هستند، نرخ به‌روزرسانی سریع‌تر انجام شود.

روش دوم
جمع‌آوری مستقیم توسط ربات خزنده

ربات خزنده (Crawler) اسنپ‌پی روزانه (حدود نیمه‌شب) صفحات محصولات را می‌خواند. برای موفقیت این روش، نکات زیر را رعایت کنید:

۱. ربات مسدود نشود

اگر سرور شما IPهای با درخواست بالا را بلاک می‌کند، تمام IPهای زیر را وایت‌لیست کنید:

185.206.93.115 185.206.94.25 37.152.176.176 188.121.106.231
⚠️ این IPها برای عملکرد صحیح فید (افزونه) و ربات خزنده ضروری هستند و در تمامی روش‌های جمع‌آوری داده در وایت‌لیست هاست باشند.

۲. نقشه سایت (Sitemap)

یک sitemap کامل و روزانه که همه لینک‌های محصولات را در بر داشته باشد باید فعال باشد (افزونه‌های سئو این امکان را فراهم می‌کنند).

۳. داده‌های قابل مشاهده

اطلاعات اصلی (نام، دسته، قیمت، موجودی، تصویر، توضیحات) باید بدون وابستگی به جاوااسکریپت در صفحه باشند یا در تگ‌های <meta> قرار بگیرند.

مشکل DNS

به علت شرایط اینترنت، جهت اینکه در فرایند کرال مشکلی ایجاد نشود، بهتر است این server name ها توسط هاستینگ در دسترس باشند:

217.218.127.127 217.218.155.155 185.161.112.33 185.161.112.34 5.202.100.100 5.202.100.101 2.189.44.44 2.188.21.100 78.157.42.101
📌 اگر سایت شما از CDN یا سرویس‌های امنیتی استفاده می‌کند، این IPها را در فایروال خود استثنا (Whitelist) کنید.
نکات طلایی نام‌گذاری و مدیریت تغییرات
  • نام‌گذاری کامل و کلیدواژه‌محور: عنوان محصول شامل برند، مدل، مشخصات اصلی باشد. برای افزایش دیده‌شدن در جستجوی کاربران و تطبیق محصولات با یکدیگر، محصولات خود را به‌صورت کامل، یکتا و با استفاده از کلیدواژه‌های مناسب نام‌گذاری کنید.
    ✅ نام‌گذاری مناسب: گوشی موبایل سامسونگ، مدل 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 : شناسه جهانی کالا
💡 توضیحات ساختاریافته: برای دیده شدن بهتر، توضیحات (description) را به‌صورت یک شیء (object) با ساختار ویژگی-مقدار ارائه دهید:
{
  "برند": "Samsung",
  "مدل": "Galaxy S24 Ultra",
  "سیستم عامل": "Android",
  "حافظه داخلی": "512GB",
  "رم": "12GB",
  "پردازنده": "Snapdragon 8 Gen 3",
  "دوربین اصلی": "200MP + 50MP + 12MP + 10MP",
  "دوربین سلفی": "12MP",
  "اندازه صفحه": "6.8 اینچ",
  "نوع صفحه نمایش": "Dynamic AMOLED 2X",
  "باتری": "5000mAh",
  "رنگ": "تیتانیوم"
}
📎 فیلدهای اختیاری: color (رنگ)، size (سایز)، cost_shipping (هزینه ارسال)، delivery_time (زمان ارسال بر حسب روز)
📦 فشرده‌سازی: برای تسریع در روند به‌روزرسانی، می‌توانید این فایل را با فرمت ZIP یا GZIP فشرده کرده و لینک آن را ارائه دهید.
📌 در صورتی که محصول شما یک خدمت است، می‌توانید بخش‌های اطلاعاتی خوراک محصول را بر اساس نیاز تغییر دهید.

لینک‌های مفید:

چک‌لیست نهایی آماده‌سازی فروشگاه

  • افزونه Search API Data Feed نصب، آپلود و فعال شده است (یا خوراک دستی با لینک ثابت دارم).
  • چهار IP اسنپ‌پی در فایروال / افزونه امنیتی وایت‌لیست شده‌اند.
  • Sitemap کامل محصولات روزانه به‌روز می‌شود.
  • اطلاعات محصول بدون جاوااسکریپت در صفحه موجود است یا در meta tagها قرار دارد.
  • نام محصولات کامل، شامل برند و مدل و کلیدواژه‌های اصلی است.
  • در صورت تغییر لینک/نام/تصاویر، پشتیبانی اسنپ‌پی را مطلع کرده‌ام.
  • آدرس فید (در صورت استفاده از افزونه) پاسخ صحیح می‌دهد.

📚 با تکمیل این مراحل، فروشگاه شما در جستجوی اسنپ‌پی حضور خواهد داشت. برای اطلاعات بیشتر به آکادمی اسنپ‌پی مراجعه کنید.

اشتراک گذاری
فهرست مطالب