سیستم رهگیری سفارش‌های ترب در فروشگاه اینترنتی

این سیستم چیست؟

فرض کن سایت شما یک مغازه است و ترب یک خیابان شلوغ که مشتری‌ها از آن رد می‌شوند. وقتی کسی از ترب روی مغازه شما کلیک می‌کند و می‌آید داخل و خرید می‌کند، ترب می‌خواهد بداند آن خرید از مسیر ترب بوده یا نه.

سیستمی که ساختیم دقیقاً همین را انجام می‌دهد: به ترب می‌گوید «بله، این مشتری از طرف تو آمد و این مقدار خرید کرد».

چرا به آن نیاز دارید؟

سه دلیل اصلی:

۱) همکاری با ترب به شکل درست

ترب با فروشگاه‌ها به شکل «درصدی از فروش» همکاری می‌کند. اگر ترب نداند چه فروشی از طرف او بوده، نمی‌تواند سهم خودش را حساب کند و همکاری شکل نمی‌گیرد. بدون این سیستم، شما در ترب به‌عنوان فروشگاه همکار شناخته نمی‌شوید.

با این سیستم ترب فقط درصد کلیک هایی که تبدیل به خرید شده را محاسبه میکند و میتواند در کاهش هزینه ها به شما کمک کند

۲) گزارش لغو سفارش‌ها

مشتری خرید می‌کند، بعد پشیمان می‌شود و سفارش را لغو می‌کند. ترب باید تا ۷ روز از این لغو باخبر شود. اگر خبر نداشته باشد، فکر می‌کند سفارش موفق بوده و آن را در محاسباتش نگه می‌دارد. این باعث می‌شود آمار شما با واقعیت نخواند و رتبه فروشگاهتان در ترب آسیب ببیند.

۳) شفافیت

شما هم می‌بینید ترب چه سفارش‌هایی را دیده و چه زمانی. این‌طوری اگر اختلافی پیش بیاید، هر دو طرف سند دارند.

این سیستم چطور کار می‌کند؟ (به زبان ساده)

قدم ۱: مشتری از ترب می‌آید

وقتی کسی در ترب روی محصول شما کلیک می‌کند، ترب یک «برچسب مخصوص» به آدرس سایت شما می‌چسباند. این برچسب یک کد یکتاست که فقط برای همان کلیک ساخته شده.

قدم ۲: سایت شما برچسب را نگه می‌دارد

سایت شما این برچسب را می‌گیرد و در یک «یادداشت امن» به نام کوکی ذخیره می‌کند. این یادداشت ۷ روز می‌ماند. یعنی اگر مشتری همان روز خرید کند یا ۵ روز بعد، سایت شما می‌داند که این مشتری از ترب آمده.

قدم ۳: هنگام خرید، برچسب به سفارش می‌چسبد

وقتی مشتری خرید می‌کند، آن برچسب مخصوص کنار اطلاعات سفارش ذخیره می‌شود. یعنی هر سفارش در سیستم شما علامت‌گذاری شده که «این از ترب آمده» یا «این از ترب نیامده».

قدم ۴: ترب سفارش‌ها را می‌خواند

ترب هر چند ساعت یک بار به سایت شما مراجعه می‌کند و می‌پرسد: «از دفعه قبل تا حالا چه سفارش‌های جدیدی داشتی که از طرف من بودند؟» سایت شما لیست را می‌دهد.

قدم ۵: اگر سفارشی لغو شد، ترب خبردار می‌شود

وقتی شما سفارشی را لغو می‌کنید، سایت شما این تغییر را علامت می‌زند. در مراجعه بعدی، ترب می‌بیند که این سفارش لغو شده و آن را از محاسباتش حذف می‌کند.

چه چیزی ساخته شده؟

سایت شما الان سه قابلیت دارد:

  1. می‌فهمد مشتری از ترب آمده — با همان برچسب مخصوص که ترب می‌فرستد.

  2. این اطلاعات را روی سفارش ذخیره می‌کند — پس بعداً قابل پیگیری است.

  3. یک «پنجره امن» به ترب می‌دهد که از آن فقط سفارش‌های آمده از ترب را ببیند.

این پنجره امن، سه محافظ دارد:

  • فقط ترب می‌تواند وارد شود — با یک امضای دیجیتال مخصوص (توکن) که کلیدش دست ترب است.

  • فقط برای دامنه شما معتبر است — اگر کسی این توکن را برای سایت دیگری استفاده کند، کار نمی‌کند.

  • شما کنترل دارید — هر وقت بخواهید می‌توانید این پنجره را ببندید و ترب دیگر دسترسی ندارد.

چطور به ترب بگویید فعالش کند؟

بعد از اینکه تست‌های نهایی انجام شد، این مراحل را طی کنید:

قدم ۱: تست‌های نهایی

از کسی که سایت را برایتان ساخته بخواهید این چیزها را چک کند:

  • وقتی ترب درخواست می‌فرستد، سایت جواب درست می‌دهد

  • وقتی کسی بدون اجازه بخواهد سفارش‌ها را ببیند، رد می‌شود

  • لغو سفارش درست به ترب گزارش می‌شود

قدم ۲: یک پیام به ترب بفرستید

به پشتیبانی ترب یا کسی که در ترب با شما در ارتباط است، پیامی به این شکل بفرستید:

آدرس API فروشگاه شما در منوی فروشگاه >مدیریت محصولات قبلی > در آخر همین صفحه موجود است که در متن زیر باید جایگزین کنید

سلام،

فروشگاه: myshop.ir

می‌خواهیم قابلیت «رهگیری سفارش‌های ترب» را در فروشگاهمان فعال کنیم.

آدرس سرویس: https://myshop.ir/torob/v1/orders

همه چیز طبق مستندات شما پیاده‌سازی شده و آماده تست است. لطفاً تست اولیه را انجام دهید.

همچنین سرویس محصولات ما از قبل فعال است:
https://myshop.ir/torob_api/v3/products

نکته مهم این صفحه فقط برای ترب قابل مشاهده است.

قدم ۳: منتظر تست ترب بمانید

ترب یک درخواست آزمایشی می‌فرستد. اگر همه چیز درست باشد، تأیید می‌کند و از آن به بعد خودکار سفارش‌ها را می‌خواند.

قدم ۴: تأیید نهایی

بعد از تأیید ترب:

  • هر سفارش جدید از ترب به‌صورت خودکار در گزارش‌ها ثبت می‌شود

  • لغوها تا ۷ روز به ترب می‌رسند

  • در داشبورد فروشنده ترب می‌توانید آمار فروش منتسب را ببینید

چیزهایی که باید قبل از تحویل به ترب چک شود

از برنامه‌نویس خود بخواهید این فهرست را تأیید کند:

  • ✅ اطلاعات هر سفارش به‌درستی ذخیره می‌شود

  • ✅ سفارشی که از ترب نیامده، به ترب گزارش نمی‌شود

  • ✅ سفارشی که از ترب آمده، درست گزارش می‌شود

  • ✅ اگر سفارشی لغو شود، ترب خبردار می‌شود

  • ✅ کسی جز ترب نمی‌تواند سفارش‌ها را ببیند

  • ✅ سفارش‌های تستی که قبلاً ساختید، از محاسبات خارج شده‌اند

چند سؤال رایج

س: آیا مشتری‌ها متوجه این سیستم می‌شوند؟
ج: نه. همه چیز در پس‌زمینه انجام می‌شود و تجربه خرید مشتری عوض نمی‌شود.

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

س: اگر سایت من چند فروشگاه داشته باشد؟
ج: هر فروشگاه می‌تواند جداگانه فعال یا غیرفعال کند. اگر فروشگاهی فعال نکرده باشد، ترب به اطلاعات او دسترسی ندارد.

س: اگر بخواهم بعداً قطع کنم؟
ج: بله، می‌توانید هر وقت بخواهید دسترسی ترب را قطع کنید. از آن به بعد ترب دیگر سفارش‌های شما را نمی‌بیند.

س: آیا این روی سرعت سایت اثر دارد؟
ج: خیر. رهگیری سفارش‌ها فقط در پس‌زمینه اجرا می‌شود و بازدیدکننده‌ها هیچ تفاوتی حس نمی‌کنند.

س: چقدر طول می‌کشد تا فعال شود؟
ج: بستگی به پاسخ‌دهی ترب دارد. معمولاً چند روز تا یک هفته.