اتصال فروشگاه اینترنتی به ترب؛ راهنمای کامل و دام‌هایی که کسی درباره‌شان نمی‌نویسد
از شرط‌های واقعی پذیرش تا مسیر API رسمی و مهم‌ترین سؤال همه: چرا محصولاتم در ترب «ناموجود» نشان داده می‌شوند؟ راهنمای عملی از دل یک پیاده‌سازی واقعی.
ترب برای خیلی از فروشگاههای اینترنتی ایرانی مهم‌ترین کانال ورودی بعد از گوگل است، و دلیلش ساده است: کسی که در ترب جست‌وجو میکند دیگر در مرحله‌ی کنجکاوی نیست. اسم دقیق محصول را می‌داند، دارد قیمت‌ها را مقایسه میکند و به‌احتمال زیاد امروز می‌خرد. یعنی ترافیکی که از ترب می‌آید، از نظر آمادگی برای خرید تقریباً بهترین ترافیکی است که یک فروشگاه میتواند بگیرد.
اما بین «می‌خواهم در ترب باشم» و «محصولاتم درست در ترب دیده می‌شوند» یک فاصله‌ی فنی هست که بیشتر راهنماهای فارسی از آن رد می‌شوند. آن راهنماها معمولاً تا مرحله‌ی ثبتنام در پنل فروشندگان جلو می‌روند و بعد تمام می‌شوند. مشکلات واقعی دقیقاً از همان‌جا شروع میشود.
این نوشته از دل یک پیاده‌سازی واقعی درآمده، نه از خواندن مستندات. جاهایی که خودمان به دیوار خوردیم و ساعت‌ها طول کشید تا بفهمیم مشکل کجاست، همان‌ها را با جزئیات نوشته‌ام؛ چون همان‌هاست که در جای دیگری پیدا نمی‌کنی.
ترب دقیقاً چه کاری انجام میدهد و چه کاری نمی‌کند
اولین سوءتفاهم رایج این است که ترب را با دیجی‌کالا یکی می‌گیرند. ترب فروشگاه نیست و چیزی نمی‌فروشد؛ یک موتور جست‌وجو و مقایسه‌ی قیمت است. کاربر محصول را پیدا میکند، قیمت فروشنده‌های مختلف را کنار هم می‌بیند، و بعد روی فروشنده‌ی انتخابی کلیک میکند و به سایت خودِ او می‌رود. خرید در سایت تو انجام میشود، نه در ترب.
این تفاوت چند نتیجه‌ی مهم دارد. اول اینکه کارمزد فروش به آن شکلی که در بازارگاه‌ها هست وجود ندارد: ترب در صفحهی رسمی ثبتنام فروشندگانش نوشته که برای فروش کالا کمیسیون نمیگیرد، و طبق راهنمای ثبتنام خودِ ترب، تا مهر ۱۴۰۵ مدلش پرداخت بهازای هر کلیک است؛ حسابت را شارژ میکنی و هزینه‌ی کلیکهایی که به سایتت میرسد از همان اعتبار کم میشود. تعرفهی کلیک عوض میشود، پس عدد روز را از صفحهی تعرفهی خدمات ترب بگیر. دوم اینکه مشتری مستقیم به سایت تو می‌آید، پس اطلاعاتش مال توست و می‌توانی دوباره بهش بفروشی — چیزی که در بازارگاه‌ها معمولاً از دستت می‌رود. و سوم، مهم‌ترینش: چون کاربر به سایت تو منتقل میشود، کیفیت خودِ سایت مستقیماً تعیین میکند که آن کلیک به فروش تبدیل شود یا نه.
همین نکته‌ی سوم است که خیلی‌ها نادیده می‌گیرند. اگر صفحهی محصولت کند باز شود، اگر سبد خرید پیچیده باشد یا اگر نماد اعتماد نداشته باشی، ترب برایت ترافیک می‌آورد ولی آن ترافیک از دستت می‌رود و فقط رقبایت را در مقایسه بهتر نشان میدهد.
شرط‌های واقعی برای حضور در ترب
برای فروش اینترنتی، داشتن نماد اعتماد الکترونیکی شرط است. ترب در صفحهی ثبتنام فروشندگانش همین را قدم اول فرایند گذاشته و در راهنمای ثبت‌نامش اضافه کرده که سایت باید دامنهی مستقل داشته باشد؛ زیردامنه‌ای که فروشگاهسازها می‌دهند پذیرفته نمیشود. این نکته را جدی بگیر چون خیلی‌ها بعد از ساخت فروشگاه تازه متوجهش می‌شوند و کار عقب می‌افتد. فرایند اینماد خودش زمان‌بر است و بهتر است موازی با ساخت سایت شروعش کنی، نه بعد از آن؛ مراحلش را در راهنمای گرفتن اینماد نوشتهایم.
دومین شرط عملی، داشتن صفحهی محصول مستقل برای هر کالاست. یعنی هر محصول باید آدرس اختصاصی خودش را داشته باشد که مستقیم قابل باز شدن باشد. فروشگاه‌هایی که همه‌ی محصولاتشان را در یک صفحهی فهرست ریخته‌اند یا محصول را در پنجره‌ی بازشو نشان می‌دهند، عملاً چیزی برای معرفی به ترب ندارند.
سومین شرط، قیمت و موجودی واقعی و به‌روز است. ترب حساسیت بالایی روی این دارد و منطقی هم هست: کل ارزش پیشنهادی‌اش برای کاربر این است که قیمت‌هایی که نشان میدهد درست باشند. فروشگاهی که قیمت‌های قدیمی نشان میدهد، تجربه‌ی کاربر ترب را خراب میکند.
و زمان‌بندی را واقع‌بینانه ببین. طبق صفحهی رسمی ثبتنام ترب، تا مهر ۱۴۰۵ بررسی درخواست حداکثر ۴۸ ساعت طول میکشد و نتیجه پیامک میشود؛ بعد از شارژ حساب، ربات ترب محصولات را میخواند و تیم محتوای ترب آنها را دستهبندی و ادغام میکند، و هرکدام از این دو مرحله بسته به تعداد محصولاتت میتواند تا یک هفته طول بکشد. پس اگر برای کمپین یا فصل فروش برنامه داری، اتصال را دست‌کم دو هفته زودتر شروع کن.
دو مسیر اتصال؛ و اینکه کدام برای تو مناسب است
برای رساندن محصولات به ترب دو راه وجود دارد و انتخاب بینشان به این بستگی دارد که فروشگاهت روی چه چیزی ساخته شده.
مسیر اول، افزونه یا خروجی آماده. اگر فروشگاهت روی وردپرس یا یکی از سایت‌سازهای آماده است، معمولاً افزونه یا قابلیت داخلی برای این کار وجود دارد. ساده‌ترین راه است و برای فروشگاههای کوچک تا متوسط کاملاً کافی. عیبش این است که وابسته به به‌روز ماندن همان افزونه‌ای و کنترل کمی روی جزئیات داری.
مسیر دوم، پیاده‌سازی مستقیم API. ترب یک مشخصات فنی رسمی دارد که مسیری در سایت تو تعریف میکند و ترب بهصورت دورهای آن را میخواند و محصولات را برمی‌دارد. این مسیر برای فروشگاههای اختصاصی است و مزیتش کنترل کامل روی این است که چه چیزی و چطور فرستاده شود. آلادخت، فروشگاه پارچهای که با کدنویسی اختصاصی ساختهایم، محصولاتش را از همین مسیر و بدون هیچ افزونه‌ای خودکار در ترب نمایش میدهد.
چند نکته‌ی فنی که در پیاده‌سازی مستقیم به آنها برخوردیم و ارزش نوشتن دارند:
صفحهبندی را درست پیاده کن. خروجی باید صفحه‌به‌صفحه برگردد و ترتیب نتایج باید پایدار باشد. اگر مرتب‌سازی‌ات یکتا نباشد — مثلاً فقط بر اساس تاریخ که ممکن است برای چند محصول یکسان باشد — بعضی محصولات در مرز صفحه‌ها تکرار می‌شوند و بعضی کلاً جا می‌مانند. یک شناسه‌ی یکتا به‌عنوان معیار دوم مرتب‌سازی، این را کامل حل میکند.
خطا را با فهرست خالی جواب نده. اگر پایگاه داده‌ات لحظه‌ای در دسترس نبود و تو یک فهرست خالی برگرداندی، پیام به ترب این است که «این فروشنده دیگر هیچ محصولی ندارد». برگرداندن خطای صریح، از برگرداندن فهرست خالی خیلی امن‌تر است.
واحد پول و ضریب را دوبار چک کن. یکی از پرتکرارترین اشتباه‌ها، جابه‌جایی ریال و تومان است. نتیجه‌اش این میشود که قیمت‌هایت ده برابر یا یک‌دهم نمایش داده شوند و در مقایسه‌ی قیمت یا مضحک به نظر برسی یا سیل سفارشی بگیری که نمی‌توانی تحویل بدهی.
قبل از هر قراردادی، پیش‌نمایش صفحهی اصلی سایتت را ببین — طراحی‌اش رایگان است.
شروع کنچرا محصولاتم در ترب «ناموجود» نشان داده می‌شوند؟
این پرتکرارترین مشکل است و جواب واقعی‌اش تقریباً هیچ‌جا نوشته نشده. ما هم مدتی درگیرش بودیم تا ریشه‌اش را پیدا کردیم، و وقتی پیدا شد، غافلگیرکننده بود.
ترب علاوه بر داده‌ای که از تو می‌گیرد، خودِ صفحهی محصول را هم میخواند و متنش را بررسی میکند. حالا تصور کن صفحهی محصولی که خودش کاملاً موجود است، اما پایینش یک نوار «محصولات مرتبط» دارد و یکی از آن محصولات مرتبط ناموجود است و کنارش برچسب «ناموجود» خورده. از نظر یک خواننده‌ی متن، کلمه‌ی «ناموجود» در همان صفحه وجود دارد.
نتیجه‌اش این میشود که محصول موجود، ناموجود علامت می‌خورد. راه‌حلش هم ساده است وقتی بدانی مشکل کجاست: در نوار محصولات مرتبط فقط کالاهای موجود را نشان بده. همین یک تغییر کوچک، مسئله را کامل حل کرد.
دلایل رایج دیگری هم هست که ارزش چک‌کردن دارند. مقدار موجودی در خروجی‌ات ممکن است همیشه صفر باشد، چون فیلد اشتباهی را وصل کرده‌ای. یا صفحهی محصول برای ربات باز نمیشود چون محتوایش فقط بعد از اجرای جاوااسکریپت ساخته میشود. یا آدرس محصول عوض شده و آدرس قدیمی به صفحهی خطا میرسد.
یک نکته‌ی مهم دیگر: از آدرس‌های غیرانگلیسی برای محصولات پرهیز کن. آدرسی که با حروف فارسی ساخته شده در بعضی سرورها و در اشتراک‌گذاری بین سامانه‌ها خراب میشود و به صفحهی خطا میرسد؛ در حالی که روی مرورگر خودت درست باز می‌شد و به همین دلیل دیر متوجهش می‌شوی.
ترب یا دیجی‌کالا؟ مقایسه‌ی صادقانه
این سؤال را زیاد می‌پرسند و جواب کوتاهش این است که این دو رقیب هم نیستند و میشود همزمان در هر دو بود؛ فقط نقششان فرق دارد.
دیجی‌کالا بازارگاه است: مشتری آن‌جا خرید میکند، اعتماد از برند دیجی‌کالا می‌آید، و در عوض کارمزد می‌دهی، قوانین آنها را می‌پذیری و مشتری عملاً مشتری آن‌هاست نه تو. برای شروع سریع و برای کالاهایی که تمایز خاصی ندارند، منطقی است.
ترب کانال ورودی است: مشتری به سایت خودت می‌آید، اعتماد باید از سایت خودت بیاید، اما رابطه‌ی مستقیم با مشتری مال توست و می‌توانی دوباره به او بفروشی. حاشیه‌ی سودت هم دست خودت است.
استراتژی‌ای که در عمل بهتر جواب میدهد ترکیب هر دو است، ولی با یک شرط: سایت خودت باید واقعاً آماده‌ی فروش باشد. اگر سایتت کند و بی‌اعتماد باشد، ترافیک ترب فقط هدر می‌رود و در آن حالت بهتر است اول سایت را درست کنی، بعد سراغ کانال‌ها بروی.
فروش در ترب بدون سایت؛ ممکن است؟
جواب کوتاه: برای فروش اینترنتی، نه؛ برای معرفی یک مغازه‌ی حضوری، بله. ترب در صفحهی ثبتنام فروشندگانش دو مسیر جدا گذاشته است. مسیر «سایت فروش اینترنتی دارم» همان چیزی است که تا اینجا گفتیم: سایت با دامنهی مستقل و اینماد. مسیر «بدون سایت» اما فقط برای بخش خرید حضوری است؛ یعنی مغازه‌ای با نشانی واقعی که مشتری بتواند به آن سر بزند.
در این مسیر، مشخصات کارت ملی صاحب مغازه تأیید میشود، محصولات را با جست‌وجو در فهرست کالاهای خود ترب پیدا میکنی و فقط قیمتت را کنارشان می‌گذاری، و اتصال صفحهی اینستاگرام هم اختیاری است. مشتری در این حالت از ترب خرید نمی‌کند؛ مغازه‌ات را پیدا میکند و تلفنی یا حضوری می‌خرد. خود ترب در پرسش‌های متداول همان صفحه صریح نوشته که برای نمایش در بخش خرید اینترنتی، سایت فروشگاهی دارای اینماد الزامی است و بدون سایت امکان فعالیت در آن بخش وجود ندارد؛ در قوانین پنل فروشندگان ترب هم آمده که فروشگاه بدون سایت چون اینماد نمیگیرد، در بخش حضوری قرار می‌گیرد.
پس اگر مغازه‌ی فیزیکی داری و بیشتر مشتری‌هایت از شهر خودت‌اند، بخش حضوری ترب یک ویترین ساده و سریع برای شروع است و ارزش امتحان دارد. ولی اگر می‌خواهی به کل کشور بفروشی، پرداخت آنلاین بگیری و مشتری شهر دیگر را هم داشته باشی، راهی جز سایت فروشگاهی با اینماد نیست. فروشگاهی که از اول با ترب در ذهن ساخته شود — صفحهی محصول مستقل، آدرس انگلیسی و خروجی موجودی درست — همان چیزی است که در طراحی سایت فروشگاهی برای ترب باز کرده‌ایم.
چک‌لیست قبل از اتصال
قبل از اینکه سراغ ثبتنام بروی، این‌ها را چک کن. هر کدامشان اگر بعداً معلوم شود، کار را عقب می‌اندازد.
نماد اعتماد الکترونیکی گرفته یا دست‌کم فرایندش شروع شده. هر محصول آدرس اختصاصی و قابل باز شدن دارد و آدرس‌ها انگلیسی‌اند. قیمت و موجودی از پنل مدیریت به‌سادگی به‌روز می‌شوند. صفحهی محصول روی موبایل سریع باز میشود. برچسب «ناموجود» فقط روی کالاهای واقعاً ناموجود دیده میشود و در نوارهای جانبی صفحهی محصولِ موجود ظاهر نمیشود. و درگاه پرداخت فعال و تست‌شده است.
اگر همه‌ی این‌ها را داری، اتصال به ترب فقط یک کار فنی کوچک است. اگر نداری، ترب مشکل اصلی‌ات نیست.
در پلن‌های طراحی سایت فروشگاهی ما، اتصال به ترب از پله‌ی نقره‌ای (۵۵ میلیون تومان) به بالا جزو کار است، نه سرویسی که جداگانه فروخته شود؛ امکانات هر پله روی صفحهی قیمت طراحی سایت آمده. اگر می‌خواهی ببینی فروشگاهی که از روز اول با ترب در ذهن ساخته میشود — صفحهی محصول، خروجی و موجودی — چه فرقی دارد، صفحهی طراحی سایت فروشگاهی برای ترب را ببین. و اگر فروشگاه فعلی‌ات مشکل «ناموجود» دارد، همان را برایمان بفرست تا نگاهش کنیم.
پرسش‌های پرتکرار
آیا ثبت فروشگاه در ترب هزینه دارد؟
ترب روی فروش تو کمیسیون نمیگیرد. تا مهر ۱۴۰۵ مدلش این است که بعد از تأیید فروشگاه، حسابت را شارژ میکنی و هزینه بهازای کلیکهایی که از ترب به سایتت میرسد از همان اعتبار کم میشود؛ خواندن محصولات هم بعد از شارژ حساب شروع میشود. تعرفهی کلیک ثابت نمیماند، پس عدد روز را از صفحهی تعرفهی خدمات ترب بگیر.
برای اتصال فروشگاه به ترب حتماً اینماد لازم است؟
بله. ترب در صفحهی ثبتنام فروشندگانش داشتن نماد اعتماد الکترونیک را شرط اول فروشگاههای اینترنتی گذاشته و سایت هم باید دامنهی مستقل داشته باشد؛ زیردامنهی فروشگاهسازها پذیرفته نمیشود. چون گرفتن اینماد خودش زمان میبرد، بهتر است آن را همزمان با ساخت فروشگاه شروع کنی، نه بعد از آن. مراحلش را در راهنمای اینماد نوشتهایم.
چقدر طول میکشد تا محصولاتم در ترب نمایش داده شوند؟
طبق صفحهی رسمی ترب، بررسی درخواست حداکثر ۴۸ ساعت طول میکشد و نتیجه پیامک میشود. بعد از شارژ حساب، ربات ترب محصولات را میخواند و تیم محتوای ترب آنها را دستهبندی و ادغام میکند؛ هرکدام از این دو مرحله بسته به تعداد محصولاتت میتواند تا یک هفته طول بکشد. پس برای یک فروشگاه تازه، تا حدود دو هفته را در برنامهات بگذار.
چرا محصول موجود من در ترب «ناموجود» نشان داده میشود؟
دلیلی که ما در عمل به آن خوردیم این بود که ترب متن خودِ صفحهی محصول را هم میخواند؛ اگر در نوار «محصولات مرتبط» کلمه‌ی «ناموجود» کنار کالای دیگری باشد، ممکن است کل صفحه ناموجود فهمیده شود. دلایل رایج دیگر: فیلد موجودی اشتباه در خروجی، صفحه‌ای که محتوایش فقط بعد از اجرای جاوااسکریپت ساخته میشود، یا آدرسی که عوض شده و به صفحهی خطا میرسد.
فروشگاه کدنویسیشدهی اختصاصی را هم میشود به ترب وصل کرد؟
بله، و کنترلش حتی بیشتر است. بهجای افزونه، خروجیای مطابق مشخصات فنی ترب روی خود سایت ساخته میشود که ترب بهصورت دورهای آن را میخواند. آلادخت، فروشگاه پارچهای که با Next.js ساختهایم، محصولاتش را از همین مسیر خودکار در ترب نمایش میدهد. نکتههای حیاتیاش صفحهبندی پایدار، واحد پول درست و برنگرداندن فهرست خالی هنگام خطاست.
سایتی می‌خواهی که درست ساخته شود؟
صفحهی اصلی سایتت را در کمتر از ۴۸ ساعت می‌سازیم و نشانت می‌دهیم. طراحیِ پیش‌نمایش رایگان است و فقط ۶۸۰ هزار تومان بابت ساخت عکس‌ها و بنرهایش می‌پردازی؛ پسندیدی ادامه می‌دهیم، نپسندیدی تعهدی نداری.
