اگر می‌خواهید مشکلات مربوط به ردیابی Google Analytics را عیب‌یابی کنید، ابتدا مطمئن شوید که تنظیمات اولیه شما همانطور که در مرکز راهنمایی در قسمت تأیید تنظیمات شما توضیح داده شده است درست است.
عیب یابی ردیابی آنالیتیکس حول دو موضوع کلیدی متمرکز می شود:
- خطاها/اشتباهات تایپی در نحو کد رهگیری شما (به عنوان مثال، فضای خالی، سفارشی سازی های املای نادرست، نام پارامترهای نادرست)
- داده‌ها در گزارش‌های شما وجود ندارد
بقیه این سند نحوه استفاده از ابزارهای عیب یابی را برای کمک به شناسایی و اصلاح این دو مشکل اساسی پوشش می دهد.
خطاهای رایج کد رهگیری
چه از نحو ناهمزمان یا سنتی استفاده می‌کنید، برای جلوگیری از رایج‌ترین خطاها هنگام سفارشی‌سازی یا تنظیم کد رهگیری، موارد زیر را در نظر داشته باشید. برای یادگیری نحوه بررسی آسان این خطاها، به اشکال زدایی با ga_debug.js مراجعه کنید.
- نام روش ها از حروف نادرست استفاده می کنند.
به یاد داشته باشید که روش ها به حروف کوچک و بزرگ حساس هستند. اگر از نام روشی بدون پوشش مناسب استفاده کنید، فراخوانی روش شما کار نخواهد کرد. مثال‌ها:_gaq.push(['_trackpageview']); // wrong _gaq.push(['_trackPageView']); // wrong _gaq.push(['_trackPageview']); // correct
- نام روش نادرست
اگر ردیابی شما به درستی کار نمی کند، بررسی کنید که از نام صحیح روش استفاده می کنید. مثال‌ها:_gaq.push(['_setDomain', 'example.com']); // wrong _gaq.push(['_setDomainName', 'example.com']); // correct
- ارسال یک مقدار غیر رشته ای با استفاده از نقل قول .
فقط رشته ها باید با نقل قول ارسال شوند. همه انواع دیگر باید بدون نقل قول رها شوند.
هر مقداری که رشته نیست، مانند یک بولی، حروف الفبای شی، توابع یا آرایه، باید بدون علامت نقل قول ارسال شود. زمانی که در حال عبور از چیزی هستید که قرار است به عنوان رشته تفسیر شود، فقط از علامت نقل قول استفاده کنید. اگر از نحو سنتی مهاجرت می کنید، هر پارامتر تابعی که بدون علامت نقل قول ارسال شده است باید در نحو ناهمزمان بدون نقل قول باقی بماند. مثال‌ها:_gaq.push(['_setAllowLinker', 'false']); // wrong _gaq.push(['_setAllowLinker', false]); // correct
- رشته ها حاوی فضای خالی اصلی یا انتهایی هستند.
مثال:_gaq.push(['_setAccount', ' UA-65432-1']); // wrong _gaq.push(['_setAccount', 'UA-65432-1']); // correct
گزارش مشترک مشکلات داده ها
اگر داده‌هایی در گزارش‌هایتان وجود ندارد، این بخش را بخوانید تا به شناسایی رایج‌ترین خطاها و اقدامات توصیه‌شده کمک کنید.
تغییر یا تنظیم کد ردیابی شناسایی نشد
هنگام نصب کد رهگیری برای اولین بار در یک صفحه، یا افزودن عملکرد کد رهگیری اضافی (مانند تجارت الکترونیک)، می توانید به راحتی با بررسی عناصر زیر تأیید کنید که درخواست صفحه به درستی تنظیم شده است:
- صفحه جاوا اسکریپت
ga.jsدرخواست می کند - صفحه درخواست
__utm.gifدارد - متغیرهای
utmacوutmccدر درخواست__utm.gifارسال می شوند - تمام پارامترهای ردیابی مربوطه برای داده های اضافی که انتظار دارید ارسال شوند در دسترس هستند ( لیست پارامتر درخواست GIF را در زیر ببینید).
اگر همه این عناصر به درستی ارسال شوند، داده ها باید حداکثر ظرف 24 ساعت در گزارش های شما ظاهر شوند. با این حال، می‌توانید با تغییر محدوده تاریخ در گزارش‌های خود به «امروز» بررسی کنید که آیا داده‌ها زودتر ظاهر می‌شوند یا خیر.
صفحه یا رویداد در گزارش ها ظاهر نمی شود
اگر صفحه‌ای که حاوی کد رهگیری است در گزارش‌های محتوا ظاهر نمی‌شود، موارد زیر را بررسی کنید:
- آیا به دنبال صفحه صحیح هستید؟
- Google Analytics از مقدار پارامتر
utmpبه عنوان صفحه درخواستی استفاده می کند، بنابراین اگر URL صفحه شما/test/myPage.htmlاست، مطمئن شوید که به دنبال myPage.html در گزارش های محتوا هستید. مقدار پارامترutmpرا بررسی کنید تا ببینید چه درخواست صفحه ای ارسال می شود. - آیا به دنبال رویداد صحیح هستید؟
- Google Analytics از مقدار پارامتر
utmeبرای ردیابی رویدادها به شکل5(object*action*label)(value)استفاده می‌کند:- 5 یک ثابت است
- شیء و عمل مورد نیاز است
- برچسب و مقدار گزینه هستند
- آیا روزانه بیش از 50000 URL منحصر به فرد یا صفحه مجازی را ردیابی می کنید؟
- گوگل آنالیتیکس تمام ارسال‌های یک وب‌سایت را جمع‌آوری می‌کند و روزانه 50000 صفحه برتر (مرتب‌سازی شده بر اساس بازدید از صفحه) را گزارش می‌دهد. تمام صفحات باقیمانده در یک بخش جداگانه جمع می شوند که در گزارش های محتوا برچسب (سایر) دارد. برای مشاهده اطلاعات گزارش دقیق برای بازدیدهای صفحه با ترافیک کمتر، می توانید یک نمای جدید (نمایه) با فیلتری برای حذف تمام بازدیدهای صفحه با ترافیک بالاتر تنظیم کنید، که عملاً به صفحات باقی مانده اجازه می دهد تا در 50000 URL برتر قرار گیرند.
- مطمئن شوید که به حساب و نمای (نمایه) صحیح در رابط کاربری گزارش دسترسی دارید.
- Google Analytics حساب‌های مختلف را با شناسه‌های دامنه، که به شکل
UA-123456-1هستند، متمایز می‌کند. این شناسه دامنه در کد رهگیری درج می شود، به این ترتیب داده های یک صفحه با یک حساب مشخص مرتبط می شوند. مطمئن شوید که حساب و نمای (نمایه) مورد نظر ( تنظیمات تجزیه و تحلیل -> ویرایش -> بررسی وضعیت ) دارای همان شناسه دامنه ای است که در پارامترutmacبرای درخواست GIF ارسال می شود.
مشکلات ردیابی کمپین
برای اینکه یک کمپین تبلیغاتی در گوگل آنالیتیکس ردیابی شود، لینک های تبلیغاتی به وب سایت شما باید دارای پارامترهای ردیابی باشند. سپس کد GATC از ترکیبی از URL صفحه و پارامترهای ارجاع برای شناسایی کمپین ارسال شده استفاده می کند. سپس این اطلاعات در کوکی سایت شما ذخیره می شود و در پارامتر utmcc درخواست GIF ارسال می شود. در بسیاری از موارد، تغییر مسیرهای URL وب سایت، پارامترهای ردیابی یا داده های ارجاع را از این پیوندها حذف می کند، و این منجر به گزارش های نادرست کمپین می شود.
برای آزمایش اینکه آیا تغییر مسیرها باعث ایجاد مشکلات ردیابی کمپین می شوند، روی پیوند ارجاعی یا برچسب گذاری شده که به وب سایت شما اشاره دارد کلیک کنید و داده های کمپین مناسب را در پارامتر utmcc جستجو کنید. برای اطلاعات بیشتر در مورد نحوه یافتن و خواندن پارامتر utmcc ، به پارامترهای درخواست GIF و اشکال زدایی با ga_debug.js مراجعه کنید.
هدف (تبدیل) انتساب صحیح نیست
تبدیل هدفی است که با یک کمپین خاص مرتبط است. برای اطمینان از اینکه هدفی را به درستی به یک کمپین یا ارجاع مرتبط کرده اید، موارد زیر را انجام دهید:
- روی ارجاع به سایت خود کلیک کنید—این کار کوکی های کمپین را تنظیم می کند.
- از طریق سایت خود به صفحه تبدیل یا هدف کلیک کنید.
- برای اطمینان از حفظ کوکی کمپین، داده های ارسال شده در پارامتر
utmccرا بررسی کنید.
پس از اینکه کد رهگیری همه اطلاعات کمپین را ضبط کرد، در یک کوکی ذخیره می شود که در چندین جلسه با کاربر باقی می ماند. برای هر صفحه ای که توابع ردیابی را اجرا می کند، اطلاعات کمپین در درخواست GIF ارسال می شود. بنابراین، هر نمای صفحه دارای داده های کمپین/ارجاع مرتبط با آن است. اگر یکی از این نماهای صفحه به عنوان هدف پیکربندی شود، کمپین مشاهده صفحه مرتبط با هدف مرتبط می شود. برای اطلاعات بیشتر در مورد نحوه یافتن و خواندن پارامتر utmcc ، به پارامترهای درخواست GIF و اشکال زدایی با ga_debug.js مراجعه کنید.
مراحل اولیه اشکال زدایی
هر بار که کد ردیابی Google Analytics اجرا می شود، یک تصویر GIF تک پیکسلی از سرورهای مجموعه Google Analytics به نام __utm.gif درخواست می کند. تمام پارامترهایی که گوگل در مورد یک درخواست صفحه خاص ثبت می کند، به رشته درخواست تصویر اضافه شده است، از جمله:
- اطلاعات مشاهده صفحه URL
- اطلاعات کمپین
- داده های تجارت الکترونیک
- ویژگی های مرورگر
- شناسه های مشتری
داده‌های موجود در درخواست GIF دقیقاً با داده‌های ارسال شده به سرورهای Google Analytics مطابقت دارد ، که سپس پردازش می‌شود و در گزارش‌های شما قرار می‌گیرد. بنابراین با مشاهده داده های ارسال شده در درخواست __utm.gif ، می توانید تعیین کنید که آیا کد رهگیری کار می کند و مهمتر از آن، اینکه آیا داده های نادرستی را به گزارش های شما ارسال می کند یا خیر.
برای اشکال زدایی کد رهگیری، مراحل زیر را دنبال کنید:
- از یک ابزار اشکال زدایی شخص ثالث برای بررسی درخواست GIF به Google Analytics با کلیک بر روی پیوند مربوطه در وب سایت خود استفاده کنید.
- بررسی کنید کد رهگیری حاوی هیچ یک از خطاهای رایج کد رهگیری نباشد.
- اطمینان حاصل کنید که پارامتر
utmpوجود دارد. - اطمینان حاصل کنید که پارامتر
utmccوجود دارد و خالی نیست.
در مورد پارامتر خالیutmcc، هیچ داده کوکی ارسال نمی شود و درخواست نادیده گرفته می شود. - آزمایش را چندین بار تکرار کنید تا مطمئن شوید که درخواست GIF هر بار ارسال می شود.
ابزارهای اشکال زدایی
درخواست GIF دارای تعدادی پارامتر نام/مقدار متصل به URL آن است. به جای اینکه سعی کنید این رشته را به طور کامل نگاه کنید، می توانید از یک ابزار رایگان برای نمایش درخواست GIF به شکلی خواناتر استفاده کنید. جدول زیر تعدادی از ابزارها را برای استفاده با رایج ترین مرورگرها فهرست می کند.
برای راحتی کار، ما اشکال‌زدای کد ردیابی Google Analytics را توسعه داده‌ایم، که به شما کمک می‌کند تا مشکلات کد ردیابی را بدون نیاز به تغییر کدگذاری از طرف خود عیب‌یابی کنید. به سادگی این افزونه را فعال کنید و می توانید صفحات تولید خود را برای خطا بررسی کنید. درباره ga_debug.js بیشتر بخوانید.
| مرورگر | ابزار |
|---|---|
| همه | Firebug Lite |
| کروم | دیباگر کد ردیابی گوگل آنالیتیکس جدید! |
| کروم | ابزارهای توسعه‌دهنده داخلی (مثلاً منابع ) |
| فایرفاکس | هدرهای HTTP زنده |
| فایرفاکس | آتش سوزی |
| فایرفاکس | چارلز |
| اینترنت اکسپلورر | کمانچه نواز |
| اینترنت اکسپلورر | چارلز |
| سافاری | پنجره فعالیت داخلی |
| سافاری | چارلز |
هنگامی که ابزار را نصب کردید و آن را راه اندازی کردید، می توانید صفحه وب مورد نظر برای عیب یابی را باز کنید و تجزیه و تحلیل GIF را در ابزار ببینید. ابتدا می خواهید مطمئن شوید که صفحه مورد نظر واقعاً درخواست __utm.gif را ارسال می کند. تا زمانی که درخواست را مشاهده می کنید، می توانید مطمئن باشید که سرورهای Google Analytics در حال جمع آوری داده ها از آن صفحه هستند. بقیه این بخش دستورالعمل‌های اساسی برای استفاده از Live HTTP Header و Firebug را ارائه می‌دهد تا به شما این حس را بدهد که استفاده از ابزارها یا افزونه‌های داخلی با مرورگر وب چقدر آسان است.
استفاده از هدرهای HTTP زنده
- دانلود و نصب LiveHTTPHeaders برای فایرفاکس . مرورگر خود را مجددا راه اندازی کنید.
- سرصفحه‌های زنده HTTP ( ابزارها > LiveHTTPHheaders ) را باز کنید.
- روی تب Generator کلیک کنید.
- به سایت خود (یا هر صفحه ای که کد رهگیری گوگل آنالیتیکس نصب شده است) بروید.
- بررسی کنید که درخواستی برای
urchin.jsیاga.jsارسال شده باشد - بررسی کنید که درخواستی برای
__utm.gifارسال شده باشد.
استفاده از Firebug
افزونه Firebug نمای ساختاری تری از درخواست کد رهگیری ( urchin.js یا ga.js ) و همچنین درخواست GIF ( __utm.gif ) ارائه می دهد. این مراحل نحوه استفاده از Firebug را برای مشاهده جزئیات درخواست GIF نشان می دهد.
- Firebug را برای فایرفاکس دانلود و نصب کنید. مرورگر خود را مجددا راه اندازی کنید.
- به سایت خود بروید.
- در فایرفاکس، Tools > Firebug > Open Firebug > "Enable Firebug for this web site" را انتخاب کنید.
- روی Net و سپس Images کلیک کنید.
- صفحه را دوباره بارگیری کنید و بررسی کنید که درخواست جدیدی برای __utm.gif در لیست ظاهر شود.
- اجزای درخواست را در تب Params تأیید کنید.
اشکال زدایی با ga_debug.js
علاوه بر استاندارد ga.js ، تیم Analytics یک نسخه جایگزین از جاوا اسکریپت Google Analytics به نام ga_debug.js را به کار گرفته است. هدف این اسکریپت کمک به کاربران Analytics در عیب یابی نصب است. مخصوصاً اگر تازه وارد Analytics هستید یا اگر سایت خود را به نحو ناهمزمان جدید منتقل می کنید مفید است.
این اسکریپت جزئیات مربوط به هر درخواست GIF را ارائه می دهد و در صورت شناسایی مشکلات در کد رهگیری، پیام های هشدار و خطا را ثبت می کند. این کار را با چاپ پیام ها در شیء window.console انجام می دهد. سپس می توانید از یکی از ابزارهای زیر برای مشاهده این خطاها استفاده کنید:
- فایرباگ (برای فایرفاکس)
- ابزارهای داخلی برای کروم و/یا سافاری
- Firebug Lite (برای سایر مرورگرها)
برای استفاده از اسکریپت ga_debug.js، می‌توانید مرجع کد رهگیری صفحه وبی را که به آن دسترسی دارید و می‌توانید ویرایش کنید، تغییر دهید. برای انجام این کار، تمام ارجاعات به /ga.js را با /u/ga_debug.js در کد رهگیری آن صفحه جایگزین کنید. توصیه می کنیم اگر از اسکریپت اشکال زدایی برای یک وب سایت در مقیاس بزرگ استفاده می کنید، از آن فقط در محیط تست خود استفاده کنید. از طرف دیگر، اگر سایت کوچکتری را اشکال زدایی می کنید، توصیه می کنیم فقط صفحات انتخابی را به جای کل سایت به این روش آزمایش کنید.
مهم : شما نباید سایت تولید خود را برای استفاده از این نسخه از جاوا اسکریپت تغییر دهید. اسکریپت ga_debug.js بزرگتر از کد رهگیری ga.js است و معمولاً کش نیست. بنابراین، استفاده از آن در سراسر سایت تولیدی، سرعت سایت شما را برای همه کاربران کند می کند. باز هم، این فقط برای اهداف آزمایشی خودتان است.
اگر از Universal Analytics ( analytics.js ) برای ردیابی سایت‌های خود استفاده می‌کنید، می‌توانید analytics_debug.js ، نسخه رفع اشکال analytics.js را برای عیب‌یابی کد رهگیری فعال کنید. برای اطلاعات بیشتر در مورد analytics_debug.js ، به اشکال زدایی مراجعه کنید.
با استفاده از دیباگر کد ردیابی گوگل آنالیتیکس
Google Analytics Tracking Code Debugger یک افزونه مرورگر کروم است که ga_debug.js بدون نیاز به تغییرات کدنویسی برای شما فعال می کند. احتمالاً ساده ترین راه برای استفاده از ga_debug.js عیب یابی و تجزیه و تحلیل رفتار ردیابی برای وب سایت شما است. به سادگی این برنامه افزودنی را روشن کنید و می توانید صفحات تولید خود را برای خطاها بررسی کنید بدون اینکه نیازی به تغییر مراجع ردیابی در خود کد باشد.
برای استفاده از این افزونه، با کلیک کردن روی نماد آن در سمت راست نوار آدرس، آن را روشن کنید. سپس کنسول Chrome JavaScript را باز کنید تا پیام‌های موجود در کنسول را ببینید.
- در ویندوز و لینوکس، روی [Page Icon] -> Developer -> Javascript console کلیک کنید یا Control-Shift-J را فشار دهید.
- در مک، روی View -> Developer -> Javascript console کلیک کنید یا Command-Option-J را فشار دهید.
پارامترهای درخواست GIF
درخواست GIF بسیار طولانی است. در اینجا نمونه ای از تنها بخشی از درخواست GIF آورده شده است:
http://www.google-analytics.com/__utm.gif?utmwv=4&utmn=769876874&utmhn=example.com&utmcs=ISO-8859-1&utmsr=1280x1024&utmsc=32-bit&utmul=en-us&utmje=1&utmfl=9.0%20%20r115&utmcn=1&utmdt=GATC012%20setting%20variables&utmhid=2059107202&utmr=0&utmp=/auto/GATC012.html?utm_source=www.gatc012.org&utm_campaign=campaign+gatc012&utm_term=keywords+gatc012&utm_content=content+gatc012&utm_medium=medium+gatc012&utmac=UA-30138-1&utmcc=__utma%3D97315849.1774621898.1207701397.1207701397.1207701397.1%3B...
این جدول شامل فهرستی از بسیاری از پارامترهای ارسال شده از طریق درخواست GIF است. همه پارامترها با هر اجرای کد رهگیری منتقل نمی شوند، زیرا برخی فقط برای شرایط خاصی مانند ارجاع کمپین یا سبد خرید اعمال می شوند. هنگام استفاده از این مرجع، به خاطر داشته باشید که به دنبال متغیرهایی هستید که معمولاً برای صفحه/درخواستی که در حال بررسی آن هستید اعمال می شود.
| متغیر | شرح | مقدار نمونه |
|---|---|---|
| utmac | رشته حساب در تمام درخواست ها ظاهر می شود. | utmac=UA-2202604-2 |
| utmcc | مقادیر کوکی این پارامتر درخواست تمام کوکی های درخواست شده از صفحه را ارسال می کند. | utmcc=__utma%3D117243.1695285.22%3B%2B __utmz%3D117945243.1202416366.21.10. utmcsr%3Db%7C utmccn%3D(ارجاع)% 7C utmcmd%3Dreferral%7C utmcct%3D%252Fissue%3B%2B |
| utmcn | یک جلسه کمپین جدید را شروع می کند. utmcn یا utmcr در هر درخواستی وجود دارد. داده های ردیابی کمپین را تغییر می دهد. اما جلسه جدیدی را شروع نمی کند | utmcn=1 |
| utmcr | نشان دهنده بازدید مجدد از کمپین است. زمانی تنظیم می‌شود که کلیک‌های بعدی روی همان پیوند اتفاق بیفتد. utmcn یا utmcr در هر درخواستی وجود دارد. | utmcr=1 |
| utmcs | کدگذاری زبان برای مرورگر برخی از مرورگرها این را تنظیم نمی کنند، در این صورت روی "-" تنظیم می شود. | utmcs=ISO-8859-1 |
| utmdt | عنوان صفحه، که یک رشته رمزگذاری شده با URL است. | utmdt=analytics%20page%20test |
| utme | پارامتر قابل توسعه | مقدار کدگذاری شده است. برای رویدادها و متغیرهای سفارشی استفاده می شود. |
| utmfl | نسخه فلش | utmfl=9.0%20r48& |
| utmhn | نام میزبان، که یک رشته رمزگذاری شده با URL است. | utmhn=x343.gmodules.com |
| utmhid | یک عدد تصادفی که برای پیوند درخواست‌های Analytics GIF با Google AdSense استفاده می‌شود. | utmhid=2059107202 |
| utmipc | کد محصول. این کد sku برای یک محصول معین است. | utmipc=989898ajssi |
| utmipn | نام محصول، که یک رشته رمزگذاری شده با URL است. | utmipn=پیراهن%20 |
| utmipr | قیمت واحد. در سطح آیتم تنظیم کنید. مقدار فقط در قالب ارز ایالات متحده روی اعداد تنظیم شده است. | utmipr=17100.32 |
| utmiqt | تعداد. | utmiqt=4 |
| utmiva | تغییرات روی یک آیتم به عنوان مثال: بزرگ، متوسط، کوچک، صورتی، سفید، سیاه، سبز. رشته دارای URL کدگذاری شده است. | utmiva=red; |
| utmje | نشان می دهد که آیا مرورگر جاوا فعال است یا خیر. 1 درست است. | utmje=1 |
| utmn | شناسه منحصربه‌فرد برای هر درخواست GIF ایجاد می‌شود تا از ذخیره‌سازی تصویر GIF جلوگیری شود. | utmn=1142651215 |
| utmp | درخواست صفحه از صفحه فعلی. | utmp=/testDirectory/myPage.html |
| utmr | ارجاع، URL کامل. | utmr=http://www.example.com/aboutUs/index.php?var=selected |
| utmsc | عمق رنگ صفحه نمایش | utmsc=24 بیت |
| utmsr | وضوح صفحه | utmsr=2400x1920 |
| utmt | نوع درخواست را نشان می دهد که یکی از موارد زیر است: رویداد ، تراکنش ، آیتم یا متغیر سفارشی . اگر این مقدار در درخواست GIF وجود نداشته باشد، درخواست به عنوان صفحه تایپ می شود. | utmt=رویداد |
| utmtci | شهر صورتحساب | utmtci=San%20Diego |
| utmtco | کشور صدور صورت حساب | utmtco=بریتانیا%20 |
| utmtid | شناسه سفارش، رشته رمزگذاری شده با URL. | utmtid=a2343898 |
| utmtrg | منطقه صورتحساب، رشته رمزگذاری شده با URL. | utmtrg=New%20Brunswick |
| utmtsp | هزینه حمل و نقل. مقادیر برای واحد و قیمت. | utmtsp=23.95 |
| utmtst | وابستگی. معمولاً برای کاربردهای آجر و ملات در تجارت الکترونیک استفاده می شود. | utmtst=google%20mtv%20store |
| utmtto | جمع. مقادیر برای واحد و قیمت. | utmtto=334.56 |
| utmttx | مالیات. مقادیر برای واحد و قیمت. | utmttx=29.16 |
| utmul | زبان مرورگر | utmul=pt-br |
| utmwv | نسخه کد رهگیری | utmwv=1 |