از ساخت ملک رهگیری تا تأیید اولین بازدید — همه روش‌های نصب (اسکریپت، وردپرس، رابط برنامه‌نویسی) و مرجع کامل رویدادهای وب و فروشگاهی در یک صفحه.
نصب در چند دقیقه
اسکریپت سبک در بخش سرصفحه — بدون وابستگی به گوگل آنالیتیکس.
وردپرس بدون کد
افزونه رسمی با رویدادهای ووکامرس خودکار.
رابط برنامه‌نویسی و رویداد سفارشی
اتصال به سیستم‌های داخلی و ارسال رویداد از سرور یا مرورگر.
افزونه ایران آنالیتیکس آمار بازدید صفحات، رفتار کاربران، مسیرهای تبدیل و عملکرد محتوا را مستقیماً داخل پیشخوان وردپرس می‌آورد — بدون ابزار خارجی، بدون کدنویسی و با داده‌ای که در ایران می‌ماند.
روش‌های نصب
بسته به پلتفرم سایت، یکی از روش‌های زیر را انتخاب کنید — همه به یک ملک و داشبورد واحد متصل می‌شوند.
روش استاندارد برای هر سایت — کپی قطعه کد از داشبورد و قرار دادن قبل از پایان بخش سرصفحه.
مراحل نصب دستینصب از پیشخوان، بدون ویرایش قالب — رویدادهای ووکامرس خودکار.
بخش وردپرسدریافت آمار با وب‌سرویس و ارسال رویدادهای قطعی از بک‌اند فروشگاه.
بخش رابط برنامهنویسینصب دستی
مسیر استاندارد برای هر فریم‌ورک یا سامانه مدیریت محتوا — از ری‌اکت و نکست تا لاراول و اچ‌تی‌ام‌ال ساده.
برای نصب موفق این موارد کافی است — نیازی به دانش پیشرفته نیست.
اگر سایت وردپرسی دارید، بخش افزونه را ببینید. برای مقایسه با GA: مقایسه با گوگل آنالیتیکس.
مراحل نصب — راهنمای گام‌به‌گام
از ساخت ملک تا تأیید اولین بازدید — هر گام را به‌ترتیب انجام دهید؛ گام اول با رنگ آبی برجسته شده است.
گام ۱
در پنل ایران آنالیتیکس حساب بسازید، کسب‌وکار و سپس ملک مربوط به دامنهٔ سایت را ایجاد کنید. هر ملک یک شناسهٔ رهگیری یکتا (IRA-…) دارد.
گام ۲
از بخش «کد رهگیری» در داشبورد، قطعه کد اختصاصی ملک را کپی کنید. این کد شامل مقداردهی اولیهٔ تابع رهگیری و بارگذاری ناهمزمان اسکریپت از شبکهٔ تحویل محتوا است.
گام ۳
اسکریپت را قبل از بسته شدن بخش سرصفحه در قالب، چیدمان یا مدیر تگ قرار دهید. برای وردپرس مسیر ساده‌تر از طریق افزونهٔ رسمی است.
گام ۴
سایت را باز کنید و گزارش لحظهای داشبورد را ببینید. اگر نشست فعال ظاهر شد، نصب موفق است و میتوانید رویدادها و قیف را تنظیم کنید.
مقدار جای‌نگهدار شناسهٔ رهگیری در نمونه را با شناسهٔ واقعی ملک از داشبورد جایگزین کنید. اسکریپت به‌صورت ناهمزمان بارگذاری میشود تا شاخص‌های حیاتی وب تحت تأثیر قرار نگیرند.
<script>
window.dataLayer=window.dataLayer||[];
function IRA(){dataLayer.push(arguments);}
IRA('js',new Date());
IRA('config','YOUR_TRACKING_ID');
</script>
<script async src="https://t.iran-analytics.ir/iratag/js?id=YOUR_TRACKING_ID"></script>رابط یکپارچه ایران آنالیتیکس رویدادها، آمار بازدید و داده‌های تحلیلی هر پلتفرم را به‌صورت ساختارمند در اختیارتان می‌گذارد تا در سامانه‌های داخلی، داشبورد اختصاصی یا جریان‌های پردازش خود ادغام کنید.
curl https://iran-analytics.ir/api/v1/stats \
-H "Authorization: Bearer <API_KEY>"
{
"pageviews": 48210,
"visitors": 12904,
"top_pages": [
{ "path": "/blog/seo-guide", "views": 3120 },
{ "path": "/product/plans", "views": 2410 }
],
"sources": { "google": 61, "direct": 24, "social": 15 }
}رویدادهای وب
این رویدادها پایهٔ آمار بازدید، رفتار و تعامل سایت هستند. بیشتر آن‌ها خودکار ثبت می‌شوند؛ برخی (مثل جستجو یا خرید سفارشی) نیاز به اتصال دارند.
| رویداد | نوع ثبت | خلاصه |
|---|---|---|
بازدید صفحات | خودکار | هر ورود کاربر به یک صفحه در گزارش‌ها دیده میشود — از اولین بازدید تا جابه‌جایی بین صفحات. |
کلیک | خودکار | می‌بینید کاربران روی چه دکمه‌ها و لینک‌هایی کلیک کرده‌اند. |
اسکرول | خودکار | عمق اسکرول کاربر را می‌بینید — تا کجا پایین آمده و کجا صفحه را ترک کرده. |
جستجوی سایت | نیاز به تنظیم | عباراتی که کاربران در سایت جستجو می‌کنند در گزارش جستجو دیده میشود. |
تعامل با فرم | خودکار | هر بار کاربر فرمی را با موفقیت ارسال کند، در گزارش ثبت میشود. |
دانلود فایل | خودکار | می‌بینید کاربران چه فایل‌هایی را دانلود کرده‌اند — PDF، ویدیو، کاتالوگ و … |
باز شدن پنجره | خودکار | باز شدن پنجره‌های بازشو، ورود و کشوی کناری در گزارش دیده میشود. |
خطاها | خودکار | خطاهای صفحه در داشبورد جمع میشود تا سریع‌تر متوجه مشکل شوید. |
سوابق فروش و ثبت سفارش | نیاز به تنظیم | فروش موفق و جزئیات سفارش در گزارش درآمد نمایش داده میشود. |
رویداد سفارشی | نیاز به تنظیم | هر تعامل خاصی که در رویدادهای آماده نیست — ثبتنام، تکمیل مرحله، کلیک دکمه اقدام و … — با کلید فنی دلخواه در گزارش ذخیره میشود. |
پایه‌ی آمار بازدید سایت شماست. وقتی کاربری صفحه‌ای را باز می‌کند یا در سایت تک‌صفحه‌ای مسیر عوض میشود، رویداد «بازدید صفحه» ثبت میشود؛ همراه آن «تعامل صفحه» رفتار ماندن در صفحه و سیگنال‌های ترک را برای گزارش تعامل ذخیره می‌کند (بدون اینکه واحد مصرف جدا باشد).
رویدادهای فروشگاهی
مستندات یکپارچه از صفحات فروشگاه آنلاین و افزونه وردپرس: مشاهده محصول، سبد، تسویه، خرید و پروموشن.
۱۴ رویداد استاندارد فروشگاه — نمونه کد با فراخوانی رهگیری، رابط فروشگاه مرورگر و لایهٔ داده برای توسعه‌دهندگان.
صفحه جزئیات یک محصول — معمولاً بعد از بارگذاری صفحه محصول.
کاربرد در داشبورد
نمونه کد
IRA('view_item', {
currency: 'IRR',
value: 45000000,
items: [{
item_id: 'SKU-001',
item_name: 'لپ‌تاپ گیمینگ',
item_category: 'الکترونیک',
item_brand: 'برند نمونه',
price: 45000000,
quantity: 1
}]
});نکات مهم
حداقل یک آیتم با شناسه محصول در آرایهٔ آیتم‌ها توصیه میشود.
رویدادهای سرور
رویدادهایی که باید از بک‌اند ارسال شوند تا درآمد و سفارش قطعی در داشبورد ثبت شود — نه فقط از مرورگر.
ارسال رویدادهای قطعی (تکمیل سفارش، پرداخت، مرجوعی) از سرور فروشگاه با کلید iis_ و امضای امن.
آدرس ارسال
ارسال https://collector.iran-analytics.ir/eپاسخ موفق: 204
کلیدهای دسترسی
IRA-… — شناسه رهگیری (سرآیند)iis_… — کلید ارسال سرور (فقط بک‌اند، هرگز در جاوااسکریپت)iak_… — فقط خواندن گزارش؛ برای امضا استفاده نشودسرآیندهای الزامی
Content-Typeapplication/json
X-Ingestion-Tokenشناسه رهگیری IRA-…
X-IRA-Ingest-Modeserver
X-IRA-Signature-Timestampزمان ارسال (میلی‌ثانیه)
X-IRA-Signatureامضای امن با کلید iis_
X-Event-Nameنام رویداد (مثلاً تکمیل سفارش)
روش امضای امن
// امضای امن (مثل کلاس دریافت سرور در افزونه)
$key = hex2bin(hash('sha256', $iis_secret));
$body_hash = hash('sha256', $raw_json_body);
$canonical = $timestamp_ms . "\n" . $body_hash;
$signature = hash_hmac('sha256', $canonical, $key);رویداد قطعی برای درآمد داشبورد. فقط «تکمیل سفارش» از سرور مبنای درآمد خالص است — نه خرید مرورگر.
زمان ارسال
بلافاصله پس از تأیید موفق پرداخت در بک‌اند فروشگاه.
کاربرد در داشبورد
درآمد خالص، میانگین سفارش و گزارش فروش تکمیل‌شده.
{
"eventName": "order_completed",
"eventData": {
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"commerce_event_type": "order_completed",
"transaction_id": "WC-12345",
"order_id": "12345",
"currency": "IRR",
"net_value": 500000,
"ingest_source": "server",
"is_authoritative": true,
"items": [{ "item_id": "SKU-1", "item_name": "محصول", "price": 450000, "quantity": 1 }]
}
}POST https://collector.iran-analytics.ir/e
Content-Type: application/json
X-Ingestion-Token: IRA-XXXXXXXX
X-IRA-Ingest-Mode: server
X-IRA-Signature-Timestamp: 1710000000000
X-IRA-Signature: <hmac_hex>
X-Event-Name: order_completed
{
"eventName": "order_completed",
"eventData": {
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"commerce_event_type": "order_completed",
"transaction_id": "WC-12345",
"order_id": "12345",
"currency": "IRR",
"net_value": 500000,
"ingest_source": "server",
"is_authoritative": true,
"items": [{ "item_id": "SKU-1", "item_name": "محصول", "price": 450000, "quantity": 1 }]
}
}هر رویداد باید شناسهٔ یکتای رویداد داشته باشد. اطلاعات کارت، کد امنیتی و توکن پرداخت ارسال نشود. برای تعویض کلید، مهلت ۲۴ ساعته در درگاه دریافت پشتیبانی میشود.
تأیید و عیب‌یابی
تأیید و عیب‌یابی سریع — قبل از رفتن به رویدادهای پیشرفته.
گزارش لحظهای را باز کنید، یک صفحه را خودتان بازدید کنید و صبر کنید تا نشست فعال دیده شود. سپس یک رویداد آزمایشی (کلیک یا خرید تست در محیط آزمایشی) ارسال کنید.
شناسهٔ اشتباه، قرار دادن اسکریپت فقط در یک صفحه، کش تهاجمی که جاوااسکریپت را حذف می‌کند، و نصب روی دامنهٔ متفاوت با ملک از رایج‌ترین دلایل «داده نمی‌آید» هستند.
پس از تأیید داده، رویدادهای کلیدی کسب‌وکار (ثبتنام، افزودن به سبد، خرید، ارسال فرم) را تعریف کنید. برای فروشگاه، جدول رویدادهای فروشگاهی پایین همین صفحه را ببینید.
برای مهاجرت از گوگل آنالیتیکس: چک‌لیست مهاجرت. واژه‌ها: واژه‌نامه. پلن: قیمت‌گذاری.
حساب بسازید، ملک ایجاد کنید و کد رهگیری را در کمتر از چند دقیقه فعال کنید.
پرسش‌های رایج
پاسخ کوتاه به پرسش‌هایی که قبل از شروع معمولاً مطرح میشود.