# تایید رسیدن داده

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

## اول «وضعیت زنده» را باز کنید

سریع ترین راه، خود گزارش زنده است. سایت خود را با کش خالی باز کنید — `Ctrl` + `Shift` + `R` روی ویندوز و لینوکس، `Cmd` + `Shift` + `R` روی مک — و بعد در کنسول سراغ «وضعیت زنده» بروید.

> اولین بازدیدها ظرف چند ثانیه در «وضعیت زنده» دیده می‌شوند. — [analytics.adpix.io/fa/realtime](https://analytics.adpix.io/fa/realtime)

سه نکته درباره این صفحه که وقت شما را نجات می‌دهد:

- بازه اش را دکمه های ۵، ۳۰ و ۶۰ دقیقه بالای صفحه تعیین می‌کنند، نه انتخابگر تاریخ. **انتخابگر تاریخ روی صفحات زنده اثری ندارد** و اصلا نمایش داده نمی‌شود.
- صفحه هر چند ثانیه خودش را تازه می‌کند؛ لازم نیست دستی نوسازی کنید.
- شمارش، کاربر یکتاست نه رویداد. اگر خودتان ده صفحه باز کنید، همچنان یک کاربر فعال می‌بینید.

اگر بازدید خودتان اینجا دیده شد، نصب سالم است و کار تمام است. اگر نه، به گام بعد بروید.

## بعد «آزمایش نصب» را اجرا کنید

این بررسی، جواب قطعی را می‌دهد، چون به جای حدس زدن، سه نشانه را جدا از هم می‌سنجد.

1. در کنسول «مدیریت» را باز کنید.
2. در ستون «دارایی»، «جریان‌های داده» را انتخاب کنید.
3. جریان خود را باز کنید و «مشاهده دستورالعمل نصب تگ» را بزنید.
4. روی «آزمایش نصب» بزنید و نتیجه را بخوانید.

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

### سه نشانه ای که سنجیده می‌شود

| نشانه | چه چیزی را می‌سنجد | چقدر قطعی است |
| --- | --- | --- |
| ضربان داده | آیا در ۳۰ دقیقه گذشته رویدادی از دامنه این جریان رسیده است؟ | قطعی. تنها ملاک واقعی. |
| قطعه کد در صفحه | ادپیکس صفحه اصلی دامنه شما را می‌گیرد و در سورس آن دنبال تگ می‌گردد. | کمکی. توضیح می‌دهد چرا داده نمی‌آید. |
| سلامت پروکسی | فقط در حالت دروازه تگ: آیا زیردامنه اندازه‌گیری شما پاسخ سالم می‌دهد؟ | کمکی، ولی اگر قرمز باشد ریشه مشکل همان است. |

### وضعیت ها و معنی شان

| وضعیت | یعنی چه | کار بعدی |
| --- | --- | --- |
| هنوز آزمایش نشده | هنوز بررسی را اجرا نکرده‌اید. | «آزمایش نصب» را بزنید. |
| در حال دریافت داده | رویداد واقعی رسیده است. جریان «تاییدشده» ذخیره می‌شود و زمان آخرین رویداد و نمونه‌ای از آدرس صفحه نشان داده می‌شود. | کاری لازم نیست. |
| پروکسی فعال — در انتظار یک بازدید | دروازه تگ سالم است ولی هنوز رویدادی نرسیده. | یک صفحه از سایت را باز کنید و دوباره آزمایش بگیرید. |
| تگ پیدا شد — در انتظار یک بازدید | تگ در سورس صفحه هست ولی رویدادی نرسیده. | سراغ رضایت کاربر و مسدودکننده بروید. |
| نیازمند توجه | زیردامنه اندازه‌گیری پاسخ نمی‌دهد (فقط در حالت دروازه تگ). | رکورد CNAME و پیکربندی پروکسی را بررسی کنید. |
| در انتظار داده | نه تگی پیدا شد، نه رویدادی رسید. | قطعه کد را روی سایت منتشرشده بررسی کنید. |

> **ضربان داده به دامنه همان جریان محدود است**
>
> یک دارایی می‌تواند چند جریان داشته باشد، و رویدادها شناسه جریان را حمل نمی‌کنند — ترافیک هر جریان از روی **دامنه اش** شناخته می‌شود. اگر تگ را روی دامنه‌ای نصب کنید که با دامنه ثبت شده جریان یکی نیست (و زیردامنه آن هم نیست)، ممکن است در وضعیت زنده بازدید ببینید ولی آزمایش نصب همچنان «در انتظار داده» بماند. در این حالت دامنه جریان را اصلاح کنید، یا دامنه دوم را در تنظیمات میان دامنه‌ای اضافه کنید.

در فهرست «جریان‌های داده» هم کنار هر جریان یکی از دو جمله «دریافت ترافیک در ۴۸ ساعت گذشته» یا «داده ای در ۴۸ ساعت گذشته دریافت نشد» نوشته می‌شود. این نشانگر هم با همان منطق دامنه کار می‌کند.

## اگر هنوز داده ای نیست، به این ترتیب بررسی کنید

از بالا به پایین. هر مورد از مورد بعدی محتمل تر است.

1. **قطعه کد واقعا منتشر شده است؟** سورس صفحه زنده را ببینید، نه محیط توسعه را. یک قالب جامانده — مثلا صفحه پرداخت — یعنی یک بخش کاملا نامرئی.
2. **شناسه اندازه‌گیری همان چیزی است که کنسول می‌گوید؟** اگر شناسه اشتباه باشد رویداد ارسال می‌شود ولی به دارایی شما نمی‌رسد و هیچ خطایی هم نمی‌بینید. شناسه با `AP-` شروع می‌شود.
3. **بنر رضایت، دسته «آماری» را رد کرده است؟** در حالت انتخاب صریح، تا کاربر رضایت ندهد نه کوکی ساخته می‌شود نه رویدادی می‌رود. رفتار پیش‌فرض بسته است، نه باز.
4. **IP خودتان حذف شده است؟** «مدیریت» ← «جزئیات دارایی» ← فیلتر ترافیک. درخواست‌های منطبق با CIDRهای حذف شده پیش از هر گزارشی کنار گذاشته می‌شوند.
5. **مسدودکننده تبلیغات؟** در حالت مستقیم بخشی از بازدیدکنندگان از دست می‌روند. یک بار با مرورگری بدون افزونه امتحان کنید؛ اگر آنجا دیده شد، ریشه همین است و راه حلش دروازه تگ است.
6. **دامنه جریان با جایی که تگ اجرا می‌شود یکی است؟** همان تله بالا.
7. **تگ دو بار نصب نشده باشد؟** این داده را متوقف نمی‌کند ولی عددها را باد می‌کند؛ اگر شمارش ها غیرعادی بزرگ‌اند، این را هم بررسی کنید.

مسیر کامل عیب یابی، با علامت های هر حالت، در [هیچ داده ای نمی‌رسد](analytics/troubleshooting/no-data-arriving) آمده است.

## وضعیت زنده داده دارد ولی گزارش‌ها خالی‌اند

این یک مشکل دیگر است و ربطی به نصب ندارد. سه علت رایج:

- **بازه زمانی.** گزارش‌ها بازه انتخاب شده را نشان می‌دهند و پیش‌فرض، ۳۰ روز گذشته است. اگر تگ را همین امروز نصب کرده‌اید، بازه را روی «امروز» بگذارید.
- **منطقه زمانی دارایی.** مرز روزها با منطقه زمانی دارایی حساب می‌شود، نه با ساعت مرورگر شما. نزدیک نیمه شب، این تفاوت خودش را نشان می‌دهد.
- **بازه‌های IP کنارگذاشته‌شده.** اگر شبکهٔ دفتر شما در فهرست بازه‌های کنارگذاشتهٔ دارایی باشد، بازدیدهای خودتان اصلاً نمی‌رسند. معمول‌ترین دلیل اینکه یک توسعه‌دهنده چیزی نمی‌بیند ولی ترافیک واقعی سالم است، همین است.

وقتی داده رسید، سراغ [خواندن اولین گزارش](analytics/start/read-your-first-report) بروید تا معنی هر عدد را بدانید.

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

### «قطعه کد در صفحه» سبز است ولی «ضربان داده» نه. یعنی چه؟

یعنی تگ در سورس صفحه شما پیدا شده اما هیچ رویدادی نرسیده است. سه دلیل رایج دارد؛ رضایت کاربر (در حالت انتخاب صریح تا رضایت داده نشود چیزی ثبت نمی‌شود)، مسدودکننده تبلیغات در حالت مستقیم، یا اینکه از زمان انتشار تگ هنوز هیچ کس صفحه‌ای را باز نکرده است. یک بار خودتان صفحه را با کش خالی باز کنید و دوباره آزمایش بگیرید.

### سایت من پشت ورود یا فایروال است؛ بررسی قطعه کد کار نمی‌کند.

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

### خودم چند بار سایت را باز کردم ولی هیچ چیزی در وضعیت زنده نیست.

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

### وضعیت جریان کی به «تاییدشده» می‌رسد؟

همان لحظه‌ای که آزمایش نصب، ضربان داده را پیدا کند — یعنی در ۳۰ دقیقه گذشته رویدادی از دامنه همان جریان رسیده باشد. این وضعیت ذخیره می‌شود و لازم نیست دوباره آزمایش بگیرید.

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

- [نصب تگ اندازه‌گیری](https://docs.adpix.io/fa/analytics/start/install-the-tag/)
- [هیچ داده‌ای نمی‌رسد](https://docs.adpix.io/fa/analytics/troubleshooting/no-data-arriving/)
- [نمای کلی لحظه‌ای](https://docs.adpix.io/fa/analytics/reports/realtime-overview/)

---

[مستندات](https://docs.adpix.io/fa/analytics/start/verify-data-is-arriving/) · AdPix
