# گزارش تجارت الکترونیک

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

## این گزارش از کجا تغذیه می‌شود

هر رویداد خرید یا بازپرداختی که می‌فرستید، به ازای هر قلم کالا یک ردیف در انبار اقلام سفارش می‌سازد. این گزارش تنها گزارشی است که از آن ردیف‌ها می‌خواند — بقیه گزارش‌ها همان رویداد را فقط به عنوان یک رویداد با پارامتر `value` می‌بینند.

دو مسیر آن ردیف‌ها را می‌سازند و هر دو به یک جا می‌ریزند:

- **مرورگر**، با فرمان `ap('ecommerce', name, {...})` برای قیف پیش از خرید: مشاهده محصول، افزودن به سبد، شروع پرداخت.
- **سرور**، با ارسال سرور به سرور برای خودِ خرید و بازپرداخت. این مسیر مسدودکننده تبلیغات ندارد، با ریدایرکت درگاه پرداخت گم نمی‌شود و ضمانت «دو بار شمرده نشدن» دارد. برای پول، این مسیر را ترجیح دهید.

جزئیات هر دو فرمان در [رویدادهای تجارت الکترونیک](analytics/collect/ecommerce-events) و [ردیابی سمت سرور](analytics/collect/server-side-tracking) آمده است.

## کارت‌های بالای صفحه

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

| کارت | تعریف دقیق |
| --- | --- |
| درآمد | جمع ارزش سفارش‌های خرید در بازه، **یک بار به ازای هر شناسه تراکنش**. |
| سفارش‌ها | شمار شناسه‌های یکتای تراکنش با رویداد خرید. |
| میانگین ارزش سفارش | درآمد تقسیم بر سفارش‌ها. |
| واحدها | جمع تعداد اقلام همه سفارش‌ها. |
| اقلام / سفارش | واحدها تقسیم بر سفارش‌ها. |
| بازپرداخت‌ها | جمع ارزش رویدادهای بازپرداخت در همان بازه. |

«یک بار به ازای هر شناسه تراکنش» مهم‌ترین جمله این جدول است. ارزش کل سفارش روی هر قلم کالا تکرار می‌شود؛ اگر ساده جمع زده می‌شد، یک سفارش سه‌قلمی سه برابر شمرده می‌شد. برای همین ابتدا اقلام هر سفارش به یک ردیف جمع می‌شوند و بعد پول شمرده می‌شود.

کارت بازپرداخت فقط مبلغ برگشتی را نشان می‌دهد و از کارت درآمد کم نمی‌شود؛ درآمد خالص را خودتان از تفاضل این دو بگیرید.

> درآمد، میانگین ارزش سفارش و قیف خرید. — [analytics.adpix.io/fa/ecommerce](https://analytics.adpix.io/fa/ecommerce)

> **ارز تبدیل نمی‌شود**
>
> ارز هر سفارش در همان واحد اصلی خودش ذخیره می‌شود و هیچ نرخ تبدیلی در کار نیست. اگر دارایی شما با بیش از یک ارز کار می‌کند، عدد یک‌پارچه درآمد جمع واحدهای ناهمگن است و نه فقط نادقیق، بلکه بی‌معنا است. سرویس درآمد را به تفکیک ارز هم برمی‌گرداند و ترکیب چند ارز را با نشان `mixed_currency` علامت می‌زند، ولی کارت‌های صفحه هنوز یک عدد واحد نشان می‌دهند. راه‌حل عملیاتی: هر ارز، یک دارایی.

> **برچسب «۳۰ روز اخیر» بالای صفحه قدیمی است**
>
> گوشه بالای صفحه هنوز متنی با «۳۰ روز اخیر» می‌نویسد. این متن از زمانی مانده که این گزارش پنجره ثابت داشت. بازه واقعی امروز همان است که در انتخابگر تاریخ انتخاب کرده‌اید.

## قیف خرید

قیف چهار گام ثابت دارد و نام هر گام همان نام رویداد استانداردی است که باید بفرستید:

| گام | رویداد |
| --- | --- |
| مشاهده محصول | `view_item` |
| افزودن به سبد | `add_to_cart` |
| شروع پرداخت | `begin_checkout` |
| خرید | `purchase` |

هر گام، شمار بازدیدکنندگان یکتایی است که آن رویداد را در بازه داشته‌اند، و درصد کنارش سهم همان گام از **گام اول** است.

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

- **گام‌ها زنجیره‌ای بررسی نمی‌شوند.** کسی که مستقیم از یک تبلیغ به سبد خرید رفته و هرگز صفحه محصول را ندیده، در گام «افزودن به سبد» شمرده می‌شود ولی در گام اول نه. به همین دلیل ممکن است یک گام از گام قبلش بزرگ‌تر شود. برای قیفی که ترتیب را واقعا رعایت کند و گام‌هایش را خودتان انتخاب کنید، [قیف تبدیل](analytics/reports/funnel) را به کار ببرید.
- **مبنای درصدها گام اول است.** اگر `view_item` را نمی‌فرستید، همه درصدها صفر می‌مانند حتی وقتی فروش دارید.

اگر هیچ‌کدام از این چهار رویداد در بازه نرسیده باشد، به جای نمودار پیام «هنوز رویداد تجاری‌ای نیست» را می‌بینید.

## محصولات برتر

جدول محصولات، اقلام را بر پایه شناسه محصول جمع می‌کند و بر اساس درآمد مرتب می‌شود؛ حداکثر ۵۰ محصول. نمودار حلقه‌ای کنارش شش محصول پردرآمد را نشان می‌دهد.

| ستون | معنا |
| --- | --- |
| محصول | نام قلم؛ اگر نام نفرستاده باشید، شناسه محصول جایش می‌نشیند. |
| دسته | دسته‌بندی همان قلم، همان‌طور که فرستاده‌اید. |
| واحدها | جمع تعداد فروخته‌شده. |
| سفارش‌ها | شمار سفارش‌های یکتایی که این محصول در آن‌ها بوده. |
| درآمد | جمع درآمد قلم: قیمت × تعداد منهای تخفیف. |

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

> **شناسه محصول را ثابت نگه دارید**
>
> جمع‌بندی روی شناسه محصول انجام می‌شود، نه روی نامش. اگر نام یک محصول را عوض کنید تاریخچه‌اش حفظ می‌شود؛ اگر شناسه‌اش را عوض کنید، به دو محصول جدا تبدیل می‌شود.

## تکرار و درستی اعداد

ردیف اقلام با کلید شناسه رویداد و شناسه قلم نوشته می‌شوند و هر ردیف یک شماره نسخه دارد. اگر همان رویداد دوباره برسد، نسخه تازه جای قبلی را می‌گیرد و در خواندن یکی بیشتر شمرده نمی‌شود. برای مسیر سرور به سرور یک لایه محکم‌تر هم هست: شناسه رویدادی که خودتان تعیین می‌کنید — مثلا `order_10482` — تضمین می‌کند تلاش دوباره یا اجرای مجدد یک صف، سفارش تکراری نسازد.

اگر یک سفارش را هم از مرورگر و هم از سرور بفرستید، دو تراکنش جدا ثبت می‌شود؛ چون دو مسیر شناسه‌های متفاوتی می‌سازند. یکی از دو مسیر را برای خرید انتخاب کنید و به آن پایبند بمانید.

## وقتی صفحه خالی است

1. مطمئن شوید بازه انتخابی واقعا سفارشی در خود دارد؛ پیام «در این بازه خریدی نیست» دقیقا همین را می‌گوید.
2. بررسی کنید نام رویداد دقیقا `purchase` باشد. نام‌های دیگر رویداد ثبت می‌شوند، ولی به این گزارش نمی‌رسند.
3. مطمئن شوید `transaction_id` می‌فرستید. بدون شناسه تراکنش، سفارش قابل شمردن نیست.
4. آرایه `items` را بفرستید. بدون آن، محصولات برتر و شمار واحدها خالی می‌ماند حتی اگر درآمد ثبت شده باشد.
5. اگر خرید را از سرور می‌فرستید، `anonymous_id` بازدیدکننده را هم همراهش بفرستید تا سفارش به همان کسی بچسبد که قیف را طی کرده بود.

## پرسش‌های پرتکرار

### درآمد این گزارش با درآمدی که در گزارش رویدادها می‌بینم فرق دارد. کدام درست است؟

هر دو، ولی دو چیز متفاوت را می‌شمارند. گزارش رویدادها جمع خام پارامتر value همه رویدادهاست؛ گزارش تجارت الکترونیک ارزش سفارش را دقیقا یک بار به ازای هر شناسه تراکنش می‌شمارد، حتی اگر آن سفارش ده قلم کالا داشته باشد. برای درآمد فروش، عدد این گزارش را مبنا بگیرید.

### فروش من هم ریالی است هم دلاری. عدد درآمد چه معنایی دارد؟

هیچ. ادپیکس ارز را تبدیل نمی‌کند و ارز هر سفارش را در همان واحد اصلی نگه می‌دارد، پس یک کارت واحد در چنین حالتی جمع واحدهای ناهمگن است. سرویس تفکیک درآمد به تفکیک ارز را برمی‌گرداند و ترکیب ارزها را علامت می‌زند؛ ساده‌ترین راه درست، یک دارایی جدا برای هر ارز است.

### قیف خرید همه‌اش صفر است در حالی که فروش دارم. چرا؟

چون درصدهای قیف نسبت به گام اول یعنی view_item حساب می‌شوند. اگر رویداد مشاهده محصول را نمی‌فرستید، مبنای درصد صفر است. گام‌های قیف را از صفحه محصول شروع کنید تا این گزارش معنا پیدا کند.

### سفارشی را دو بار فرستادم. دو بار شمرده می‌شود؟

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

## مطالب مرتبط

- [رویدادهای تجارت الکترونیک](https://docs.adpix.io/fa/analytics/collect/ecommerce-events/)
- [ردیابی سمت سرور](https://docs.adpix.io/fa/analytics/collect/server-side-tracking/)
- [قیف تبدیل](https://docs.adpix.io/fa/analytics/reports/funnel/)
- [گزارش رویدادها](https://docs.adpix.io/fa/analytics/reports/events/)

---

[مستندات](https://docs.adpix.io/fa/analytics/reports/ecommerce/) · AdPix