خلاصه
ترب محصولات فروشگاه را از دو راه می‌خواند: متاتگ‌های صفحهی محصول یا API نسخه ۳. نکسکارت هر دو را پیاده کرده است. تو فقط در ترب ثبتنام می‌کنی و آدرس API و سایتمپ را که پنل نشان می‌دهد برای پشتیبانی ترب می‌فرستی.
چرا اتصال به ترب برای فروشگاه مهم است؟
بسیاری از خریداران ایرانی قبل از خرید، قیمت کالا را در ترب جستجو و مقایسه می‌کنند. وقتی محصولاتت در ترب دیده شوند، مشتری‌ای که دنبال همان کالاست مستقیم به صفحهی محصولت در فروشگاه می‌آید. این ترافیک به‌خصوص برای کالاهای قابل مقایسه، مثل موبایل، لوازم دیجیتال، لوازم خانگی و آرایشی، ارزشمند است.
شرط اصلی ترب این است که اطلاعات محصول (نام، قیمت، موجودی، تصویر) دقیق و به‌روز باشد. اگر قیمت سایت با قیمت ترب نخواند یا کالای ناموجود «موجود» نمایش داده شود، هم تجربه‌ی مشتری خراب میشود و هم ترب ممکن است فروشگاه را محدود کند.
API نسخه ۳ ترب
نکسکارت مشخصات API نسخه ۳ ترب را کامل پیاده کرده است. ترب این آدرس را روی دامنهی خود فروشگاه صدا میزند:
https://<دامنهی فروشگاه>/torob_api/v3/products
- احراز هویت: درخواست‌ها با توکن JWT و کلید عمومی Ed25519 ترب بررسی میشوند و فقط درخواست واقعی ترب برای همان دامنه پذیرفته میشود.
- همه‌ی حالت‌های درخواست: درخواست با آدرس صفحه، با شناسه‌ی یکتای کالا، صفحه‌بندی با هر سه نوع مرتب‌سازی (از جمله «جدیدترین تغییرات» که برای فروشگاه‌سازها الزامی است) و حالت cursor.
- تنوع‌ها: هر تنوع (مثلاً رنگ آبی، حافظه‌ی ۲۵۶ گیگ) یک ردیف جدا با شناسه‌ی گروه مشترک است، پس ترب قیمت و موجودی هر تنوع را جدا می‌بیند.
متاتگ‌های محصول برای ترب
علاوه بر API، صفحهی هر محصول این متاتگها را در HTML سمت سرور دارد؛ یعنی ترب بدون اجرای جاوااسکریپت هم آن‌ها را می‌بیند:
| متاتگ | محتوا |
|---|---|
product_id | شناسه‌ی یکتای کالا یا تنوع (همان شناسه‌ی API) |
product_name | نام کالا |
product_price و product_old_price | قیمت نهایی و قیمت قبل از تخفیف |
availability | وضعیت موجودی |
guarantee | گارانتی (اگر تعریف شده باشد) |
og:image | تصویر اصلی |
اگر آدرس صفحه پارامتر ?variant= داشته باشد، متاتگها مقدار همان تنوع را نشان می‌دهند و صفحه همان تنوع را از پیش انتخاب میکند. به این ترتیب ترب می‌تواند مستقیم به تنوع درست لینک بدهد.
مراحل اتصال فروشگاه به ترب
- ثبتنام در پنل فروشندگان ترب اطلاعات فروشگاه و دامنه را در ترب ثبت کن.
- کپی آدرس‌ها از پنل نکسکارت در «یکپارچهسازیها ← ترب»، آدرس API و آدرس سایتمپ نمایش داده میشود.
- ارسال برای پشتیبانی ترب بگو فروشگاهت روی فروشگاه‌ساز نکسکارت است و API نسخه ۳ دارد، و آدرس‌ها را بفرست.
- بررسی و فعال‌سازی بعد از بررسی ترب، محصولات به‌صورت خودکار و دوره‌ای به‌روزرسانی میشوند.
سایتمپ و فید XML
سایتمپ فروشگاه به ترتیب جدیدترین محصولات مرتب میشود و محصولات حذفشده در آن نیستند. فید XML قدیمی هم برای سازگاری حفظ شده و حالا دامنهی اختصاصی، آدرس درست تصویر، قیمت قبل از تخفیف و تنوع‌ها را پوشش می‌دهد.