راهنمای نصب
نصب کد رهگیری ایران آنالیتیکس
این راهنما مسیر استاندارد نصب اسکریپت رهگیری را از ساخت Property تا تأیید اولین بازدید توضیح میدهد. هدف این است که بدون حدس و خطا، آمار بازدید، رویداد و قیف را همان روز اول در داشبورد فارسی ببینید—بدون وابستگی به Google Analytics و بدون خروج داده به سرویسهای تحلیلی خارجی.
قبل از شروع چه چیزی لازم است؟
دسترسی ادمین به حساب ایران آنالیتیکس، دسترسی ویرایش قالب یا لایهٔ HTML سایت (یا پیشخوان وردپرس)، و یک دامنهٔ فعال کافی است. اگر سایت وردپرسی دارید، نیازی به دستکاری دستی قالب نیست؛ میتوانید مستقیماً به صفحهٔ افزونهٔ وردپرس بروید. برای مقایسهٔ ابزارها نیز صفحهٔ مقایسه با Google Analytics مفید است.
مراحل نصب (HowTo)
گام 1
ثبتنام و ساخت Property
در پنل ایران آنالیتیکس حساب بسازید، کسبوکار و سپس Property مربوط به دامنهٔ سایت را ایجاد کنید. هر Property یک شناسهٔ رهگیری یکتا دارد که مبنای جمعآوری داده است.
گام 2
کپی کردن اسکریپت رهگیری
از بخش «کد رهگیری» در داشبورد، snippet اختصاصی Property را کپی کنید. این کد شامل مقداردهی اولیهٔ IRA و بارگذاری اسکریپت سبک از CDN ایران آنالیتیکس است.
گام 3
قرار دادن در head سایت
اسکریپت را قبل از بسته شدن تگ head در قالب، لایهٔ layout یا تگمنیجر داخلی خود قرار دهید. برای وردپرس مسیر سادهتر از طریق افزونهٔ رسمی است.
گام 4
تأیید دریافت داده
سایت را در یک پنجرهٔ جدید باز کنید و گزارش لحظهای داشبورد را ببینید. اگر بازدید فعال ظاهر شد، نصب موفق است و میتوانید رویدادها و قیف را تنظیم کنید.
نمونهٔ ساختار اسکریپت
ساختار کلی کد شبیه نمونهٔ زیر است. مقدار YOUR_TRACKING_ID را با شناسهٔ واقعی Property از داشبورد جایگزین کنید—هرگز شناسهٔ نمونه را در production رها نکنید.
<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>اسکریپت بهصورت async بارگذاری میشود تا تأثیر منفی بر Core Web Vitals به حداقل برسد. جزئیات رویدادهای سفارشی و API در مستندات آمده است.
تأیید نصب
گزارش لحظهای را باز کنید، یک صفحه را خودتان بازدید کنید و صبر کنید تا سشن فعال دیده شود. سپس یک رویداد تست (مثلاً کلیک یا خرید آزمایشی در استیجینگ) ارسال کنید.
خطاهای رایج
شناسهٔ اشتباه، قرار دادن اسکریپت فقط در یک صفحه، کش تهاجمی که JS را حذف میکند، و نصب روی دامنهٔ متفاوت با Property از رایجترین دلایل «داده نمیآید» هستند.
گام بعدی بعد از نصب
پس از تأیید داده، رویدادهای کلیدی کسبوکار (ثبتنام، افزودن به سبد، خرید، ارسال فرم) را تعریف کنید و در صورت نیاز قیف بسازید. اگر از GA مهاجرت میکنید، چکلیست مهاجرت را دنبال کنید. واژههای پایه را در واژهنامه مرور کنید و برای انتخاب پلن به قیمتگذاری سر بزنید.