# اندازه‌گیری پیشرفته

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

## چه چیزی هست و کجا تنظیم می‌شود

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

1. «مدیریت» ← «جریان‌های داده».
2. جریان خود را باز کنید.
3. در کارت «رویدادها»، کنار «اندازه‌گیری پیشرفته» روی چرخ دنده بزنید.
4. کلیدها را تنظیم و «ذخیره» را بزنید.

## هر کلید چه چیزی می‌سازد

| کلید | چه وقت شلیک می‌شود | نام رویداد | خصیصه ها |
| --- | --- | --- | --- |
| بازدید صفحه‌ها | بارگذاری صفحه و هر تغییر واقعی آدرس در سایت‌های تک صفحه‌ای | `page_view` | — |
| اسکرول ها | اولین باری که بازدیدکننده به ۹۰٪ ارتفاع صفحه می‌رسد | `scroll` | `percent_scrolled` |
| کلیک های خروجی | کلیک روی لینکی به نام میزبانی غیر از میزبان صفحه فعلی | `click` | `link_url`، `link_domain`، `outbound` |
| دانلود فایل ها | کلیک روی لینکی که پسوندش در فهرست فایل هاست | `file_download` | `link_url`، `file_extension`، `link_text` |
| جستجوی سایت | بارگذاری صفحه‌ای که یکی از پارامترهای جستجو را در آدرس دارد | `view_search_results` | `search_term` |
| تعامل با فرم ها | اولین ورود مکان نما به هر فرم، و هر ارسال فرم | `form_start`، `form_submit` | `form_id`، `form_name` |
| تعامل با ویدیو | شروع و پایان پخش یک عنصر ویدیوی مرورگر | `video_start`، `video_complete` | `video_url` |

هر کدام از این‌ها یک رویداد کامل و واقعی است: در گزارش رویدادها دیده می‌شود، می‌توانید از آن رویداد کلیدی بسازید، و در حجم داده شما شمرده می‌شود.

## جزئیاتی که در جدول جا نمی‌شود

**بازدید صفحه‌ها** کلید خاموش ندارد و در پنل با برچسب «همیشه روشن» نمایش داده می‌شود. همین کلید است که قلاب History را برای مسیریابی سمت مرورگر نصب می‌کند. رفتار دقیقش — و اینکه چرا نباید `ap('page')` دستی اضافه کنید — در [بازدید صفحه در سایت‌های تک صفحه‌ای](analytics/collect/spa-and-page-view) آمده است.

**اسکرول ها** حداکثر یک بار در هر بارگذاری صفحه شلیک می‌کند و بعد از آن شنونده برداشته می‌شود. یعنی مقدار `percent_scrolled` همیشه ۹۰ است و هیچ وقت ۲۵ یا ۵۰ نمی‌بینید. در یک سایت تک صفحه‌ای هم با تغییر مسیر دوباره مسلح نمی‌شود؛ برای شلیک دوباره یک بارگذاری کامل لازم است.

**دانلود فایل ها بر کلیک خروجی مقدم است.** اگر لینکی هم به دامنه دیگری اشاره کند و هم پسوند فایل داشته باشد، فقط `file_download` ثبت می‌شود. فهرست پسوندها ثابت است: `pdf`, `doc`, `docx`, `xls`, `xlsx`, `ppt`, `pptx`, `zip`, `rar`, `7z`, `gz`, `tgz`, `dmg`, `pkg`, `exe`, `csv`, `txt`, `mp3`, `mp4`, `mov`, `avi`, `wav`. متن لینک تا ۸۰ کاراکتر ذخیره می‌شود.

**جستجوی سایت** فقط آدرس صفحه‌ای را که بارگذاری شده نگاه می‌کند و پارامترهای پیش‌فرضش `q`, `s`, `query`, `search` هستند. اگر جستجوی سایت شما نتیجه را بدون تغییر آدرس و با درخواست پس زمینه نشان می‌دهد، این کلید چیزی نمی‌بیند؛ در آن حالت باید خودتان رویداد را با `ap('track', …)` بفرستید.

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

**تعامل با فرم ها** هر عنصر فرم صفحه را شامل می‌شود، نه فقط فرم های مهم. جعبه جستجوی هدر، فرم عضویت در خبرنامه و فیلتر محصولات هم فرم‌اند و اولین کلیک داخلشان یک `form_start` می‌سازد. `form_start` برای هر فرم فقط یک بار در هر بارگذاری صفحه شلیک می‌شود، ولی `form_submit` هر بار ارسال را ثبت می‌کند.

**تعامل با ویدیو** فقط شروع و پایان را دارد؛ نقاط میانی مثل ۲۵ یا ۷۵ درصد ثبت نمی‌شوند. و فقط عنصر ویدیوی خود مرورگر شنیده می‌شود — پخش کننده های داخل iframe اصلا دیده نمی‌شوند.

## هزینه اش چیست

سه هزینه واقعی دارد و بهتر است آگاهانه قبولشان کنید:

- **حجم رویداد.** در یک فروشگاه پرلینک، کلیک های خروجی و دانلودها می‌توانند از خود بازدید صفحه بیشتر شوند. اگر گزارش رویدادها ناگهان پر از `click` شده، ریشه اش همین است.
- **نویز در گزارش‌ها.** `form_start` روی فرم های بی اهمیت، و `click` روی هر لینک شبکه اجتماعی در پاورقی، فهرست رویدادها را شلوغ می‌کنند بدون اینکه چیزی به تصمیم های شما اضافه کنند.
- **داده ناخواسته.** عبارت جستجو و نام فرم را خودتان تعیین نمی‌کنید؛ از صفحه خوانده می‌شوند.

قاعده ساده: کلیدی را روشن نگه دارید که برایش گزارشی می‌خوانید یا رویداد کلیدی ساخته‌اید. بقیه را خاموش کنید.

## دو رفتار که غافلگیرتان می‌کند

**پیش‌فرض، روشن است.** یک کلید تا وقتی صریحا روی خاموش ذخیره نشود، روشن حساب می‌شود. پنل «اندازه‌گیری پیشرفته» وضعیت همه کلیدها را با هم ذخیره می‌کند، پس تنها راه مطمئن خاموش کردن، همان پنل است. کلید کلی ای که هنگام **ساختن** جریان می‌بینید جای این پنل را نمی‌گیرد؛ بعد از ساخت جریان، یک بار پنل را باز کنید و کلیدهای ناخواسته را خاموش و ذخیره کنید.

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

> **همه چیز پشت رضایت «آماری» است**
>
> هر رویداد اندازه‌گیری پیشرفته از همان دروازه ای رد می‌شود که بازدید صفحه: بدون رضایت دسته آماری هیچ کدام ارسال نمی‌شوند و در حالت انتخاب صریح، رفتار پیش‌فرض بسته است. اگر بنر رضایت را روشن کرده‌اید، بخشی از این رویدادها را طبیعتا نخواهید دید.

## چیزی که اینجا نیست

شنونده های اندازه‌گیری پیشرفته پس از رسیدن پیکربندی نصب می‌شوند، بنابراین یک اسکرول یا کلیک در همان کسری از ثانیه نخست ممکن است از دست برود. برای رویدادهای تجاری — ثبت نام، افزودن به سبد، خرید — به این شنونده ها تکیه نکنید؛ آن‌ها را با `ap('track', …)` یا از سمت سرور بفرستید تا شمارششان قطعی باشد.

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

### کلیدها را کجا خاموش می‌کنم؟

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

### چرا «بازدید صفحه‌ها» کلید خاموش ندارد؟

چون شمارش بازدید صفحه پایه همه چیز است و همان قلاب History را نصب می‌کند که سایت‌های تک صفحه‌ای به آن نیاز دارند. در پنل با برچسب «همیشه روشن» و غیرفعال نشان داده می‌شود.

### ویدیوهای یوتیوب و آپارات هم شمرده می‌شوند؟

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

### بعد از تغییر تنظیمات چقدر طول می‌کشد تا اعمال شود؟

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

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

- [جریان‌های داده](https://docs.adpix.io/fa/analytics/collect/data-streams/)
- [بازدید صفحه و سایت‌های تک صفحه‌ای](https://docs.adpix.io/fa/analytics/collect/spa-and-page-view/)
- [گزارش رویدادها](https://docs.adpix.io/fa/analytics/reports/events/)
- [رویدادهای کلیدی](https://docs.adpix.io/fa/analytics/collect/key-events/)

---

[مستندات](https://docs.adpix.io/fa/analytics/collect/enhanced-measurement/) · AdPix