نمای کلی
از v1.0.0، افزونه رایگان وردپرس Statnive یک گزارش درآمد اختصاصی ارائه میدهد که دادههای سفارش WooCommerce شما را به یک داشبورد متمرکز بر CRO درون /wp-admin تبدیل میکند. بدون تنظیمات، بدون سطح پولی، بدون انتقال به شخص ثالث — تمام دادهها در پایگاهداده وردپرس شما باقی میماند.
این یکپارچهسازی روی انتساب سفارش WooCommerce 8.5+ ساخته شده، سازگار با HPOS + Block Checkout است و در برابر WooCommerce فقط-خواندنی است — Statnive فقط از گترهای $order->get_*() استفاده میکند و هرگز در جدول WooCommerce یا متادیتای پست نمینویسد.
پیشنیازها
- WordPress 6.2+ (آزمایششده تا 7.0)
- PHP 8.1+ (در نسخه 0.4.13 از 8.0 ارتقا یافت)
- WooCommerce 8.5+ (انتساب سفارش برای انتساب کانال لازم است)
- Action Scheduler (از نسخه 5.4 با WooCommerce همراه است)
پنج شاخص کلیدی در گزارش درآمد
| شاخص | منبع | یادداشت |
|---|---|---|
| سفارشها | COUNT(orders) در processing + completed | سفارشهای بازپرداختشده جداگانه ذیل مجموع بازپرداخت اندازهگیری میشوند |
| درآمد (خالص) | net_total − refund_total | مالیات و حملونقل را شامل نمیشود؛ یک کمکی Gross: $X در زیر ظاهر میشود |
| میانگین ارزش سفارش | net_revenue / orders | نمایش اعشاری دقیق طبق تنظیمات ارز فروشگاه WooCommerce |
| مجموع بازپرداخت + نرخ | refund_total, refund_rate = refunds / gross | بهصورت ترکیبی «Refund total · Rate: X%» نمایش داده میشود |
| مالیات + حملونقل | tax_total + shipping_total | مقدار ترکیبی، با برچسب صریح «از درآمد مستثنی شده است» |
هفت تفکیک
گزارش درآمد هفت بُعد را در صفحه نمایش میدهد؛ همه یازده endpoint (wc-status, backfill, summary, timeseries, by-channel, by-utm, by-landing, products, funnel, refunds, coupons) از طریق REST API نیز در دسترس هستند.
درآمد بر اساس کانال
جدول قابل مرتبسازی با کانال · سفارشها · درآمد · AOV در 8 کانالی که Statnive ترافیک را در آنها گروهبندی میکند:
- مستقیم
- دستیارهای هوش مصنوعی — 14 میزبان: ChatGPT (
chatgpt.com,chat.openai.com)، Claude (claude.ai)، Gemini (gemini.google.com,bard.google.com,notebooklm.google.com)، Copilot (copilot.microsoft.com)، Perplexity (perplexity.ai)، Meta AI (meta.ai)، Le Chat / Mistral (chat.mistral.ai)، DeepSeek (deepseek.com,chat.deepseek.com)، You (you.com)، iAsk (iask.ai)، Jasper (jasper.ai)، Writesonic (writesonic.com). تشخیص هوش مصنوعی پیش از دستهبندیکننده موتور جستجو اجرا میشود تا ارجاعهای هوش مصنوعی هرگز به اشتباه به جستجوی ارگانیک منتسب نشوند. - جستجوی ارگانیک
- شبکههای اجتماعی
- ایمیل
- ارجاع
- جستجوی پولی (از UTM
medium=cpc,ppc,paidsearch,paid_search) - شبکههای اجتماعی پولی (از UTM
medium=cpm,paid_social)
محصولات برتر
10 محصول برتر بهطور پیشفرض (قابل مرتبسازی بر اساس تعداد یا درآمد، حداکثر 100). تنوعها زیر محصول مادر خود گروهبندی میشوند. بازپرداختها به آیتم سطری اعمال میشوند.
قیف سبد تا خرید
چهار مرحله، سمت سرور از WooCommerce — بدون JS اضافی برای نصب:
- مشاهده محصول — رویداد:
wc_product_view - افزودهشده به سبد — رویداد:
wc_add_to_cart - شروع تسویهحساب — رویداد:
wc_checkout_start - خرید کامل — رویداد:
wc_purchase
نرخ تبدیل هر مرحله (فعلی/قبلی) و نرخ تبدیل کلی (خریدها/گستردهترین دهانه) در کنار تعداد نشستها نمایش داده میشود.
بهروزرسانی نسخه 1.1.0. مخرج «درصد کل» از مرحله اول به گستردهترین مرحله تغییر کرد، و رابط هر مرحله درصد تبدیل را نشان میدهد، نه درصد ریزش. این با قراردادی که WooCommerce Analytics در WC 9.x پذیرفته است، مطابقت دارد.
درآمد بر اساس منبع / واسطه / کمپین UTM
جدول صفحهبندیشده از مقدارهای utm_source، utm_medium و utm_campaign دیدهشده در سفارشهای منتسب، با سفارشها، درآمد و AOV برای هر سطر.
درآمد بر اساس صفحه فرود
جدول صفحهبندیشده از صفحههای فرود ورودی با سفارشها و درآمد به ازای هر صفحه — پاسخ میدهد به «کدام سطح ورودی واقعاً خریدار میفرستد؟»
بازپرداختها
روند نرخ بازپرداخت در طول دوره بهعلاوه فهرستی از محصولات با بیشترین بازپرداخت، بازپرداختها در سطح آیتم سطری اعمال میشوند.
کوپنها
جدول صفحهبندیشده از استفاده از کوپنها: کد، تعداد، مبلغ کل تخفیف و درآمد خالص پس از تخفیف.
سطلبندی تاریخ نسخه 1.1.0
سفارشها بر اساس
COALESCE(date_paid_gmt, date_created_gmt)سطلبندی میشوند تا تمدید اشتراکها و سفارشهای با پرداخت تأخیری (BACS، چک، پرداخت در محل، webhookهای با تکمیل دیر) در روزی که پرداخت تسویه شده است قرار بگیرند، نه روزی که سفارش ثبت شده است. پیشتر، نسخه 1.0.0 فقط ازdate_created_gmtاستفاده میکرد که پرداختهای تمدید را اشتباه در گذشته قرار میداد.
درونریزی بدون دخالت
اولین بار که گزارش درآمد را پس از فعالسازی v1.0.0 روی یک سایت WooCommerce باز میکنید، Statnive کارهای پسزمینه را از طریق Action Scheduler برای درونریزی سفارشهای تاریخی به صف میگذارد. وضعیت در بالای گزارش درآمد در حین اجرا ظاهر میشود.
- اندازه قطعه: 500 سفارش به ازای هر قلاب Action Scheduler (
statnive/wc/backfill/chunk) - وضعیتهای شمارششده:
processingوcompleted. آیتمهای سطری بازپرداختشده بهجای آنکه بهعنوان وضعیت جداگانه شمرده شوند، درآمد سطح آیتم سطری روی سفارش والد را کاهش میدهند. - مشاهدهپذیری: WooCommerce → وضعیت → اقدامات زمانبندیشده (Status → Scheduled Actions)، فیلتر بر اساس
statnive/wc/backfill/chunk
جایگزین CLI
برای سایتهایی که ترجیح میدهید درونریزی را از خط فرمان آغاز یا پایش کنید:
wp statnive woocommerce-backfillاین دستور خنثیپذیر است — اجرای دوباره در حالی که درونریزی در حال انجام است، 409 برمیگرداند.
جدولهای پایگاهداده
v1.0.0 پنج جدول جدید را از طریق dbDelta اضافه میکند. جدولها و دادههای موجود Statnive شما در ارتقا از 0.4.x حفظ میشوند.
| جدول | هدف |
|---|---|
wp_statnive_orders | متادیتای سفارش، عکس فوری انتساب، کانال |
wp_statnive_order_attribution | کانال، پارامترهای UTM، میزبان ارجاعدهنده، مراحل قیف |
wp_statnive_order_items | اقلام سطری، محصولات، SKU، اندازهگیری بازپرداخت |
wp_statnive_order_refunds | رویدادهای بازپرداخت با مقدار و دلیل |
wp_statnive_order_coupons | استفاده از کوپن به ازای سفارش، مبالغ تخفیف |
پیشوند جدول از $wpdb->prefix وردپرس شما پیروی میکند.
وضعیت حریم خصوصی + ایمنی
- فقط-خواندنی در برابر WooCommerce. فقط گترهای
$order->get_*()؛ Statnive هرگز در جدول WooCommerce یا متادیتای پست نمینویسد. بهصورت تجربی باCHECKSUM TABLEقبل/بعد روی سایتی با 1933 سفارش تأیید شده است. - بدون کوکی. هیچ نوع ذخیرهسازی مرورگری برای شناسایی بازدیدکننده وجود ندارد.
- نمکهای روزانه چرخشی (تولیدشده با CSPRNG، پنجره همپوشانی 48 ساعته) — همان بازدیدکننده هر روز هش متفاوتی تولید میکند و این کار شناسایی مجدد در روزهای مختلف را ناممکن میسازد.
- بدون ذخیرهسازی IP خام. IP هش میشود، برای جستجوی GeoIP استفاده میشود و بلافاصله دور انداخته میشود. IPv4: اکتت آخر صفر میشود. IPv6: 80 بیت آخر صفر میشود.
- GPC + DNT در سمت سرور رعایت میشوند.
- خروجیگیرنده و پاککننده WordPress Privacy API در فعالسازی ثبت میشوند.
- حذف نصب اختیاری (پیشفرض خاموش). نصب دوباره، تاریخچه آمار و درآمد را حفظ میکند.
صفحههای مدیریت سطح بالا
پس از فعالسازی v1.1.0، ناوبری مدیریت Statnive این صفحههای دارای دامنه را دارد:
- نمای کلی (
/wp-admin/admin.php?page=statnive) — بازدیدکنندهها، نشستها، بازدید صفحه، میانگین مدت زمان، بهعلاوه منابع برتر و صفحات برتر - گزارش درآمد (
/wp-admin/admin.php?page=statnive-revenue) — پنج شاخص کلیدی + هفت تفکیک توضیحدادهشده در بالا - Ask me! (
/wp-admin/admin.php?page=statnive-ask) — 116 پرسش به زبان صاحب کسبوکار در 10 دسته، 63 پرسش امروز پاسخ میدهد (نسخه 1.1.0+) - تنظیمات (
/wp-admin/admin.php?page=statnive-settings) — حریم خصوصی، نگهداری، استثناها، GeoIP
هیچ پیکربندی مختص WooCommerce لازم نیست. این یکپارچهسازی پس از نصب WooCommerce همیشه فعال است.
ارتقا از 0.4.x
ارتقای جایگزینی. پنج جدول جدید از طریق dbDelta اضافه میشوند؛ 21 جدول موجود و دادههای آنها دستنخورده باقی میمانند. در یک سایت WooCommerce، گزارش درآمد ظرف چند دقیقه پس از فعالسازی از طریق درونریزی بدون دخالت پر میشود. هیچ تغییر کدی لازم نیست.
برای یادداشتهای کامل انتشار، تغییرات v1.0.0 را ببینید.