جریانهای داده
هر جریان داده یک تگ است با شناسه اندازهگیری مخصوص خودش. جریان تعیین میکند تگ روی کدام دامنه بنشیند، چه چیزهایی خودکار اندازهگیری شود و کدام کلیدهای سرور برای آن کار کنند.
یک جریان دقیقا چیست#
جریان داده کوچک ترین واحد جمع آوری در ادپیکس است: یک تگ، یک شناسه اندازهگیری، یک دامنه. جریان زیر «دارایی» مینشیند، دارایی زیر حساب، و حساب زیر سازمان.
هر چیزی که به «نحوه جمع آوری» مربوط است روی خود جریان نگه داری میشود، نه روی دارایی:
| روی جریان | چه چیزی را تعیین میکند |
|---|---|
| شناسه اندازهگیری | هویت تگ. در قطعه کد میآید و گیرنده از روی آن سازمان و دارایی را پیدا میکند. |
| دامنه | نام میزبانی که تگ آنجا اجرا میشود. مبنای بررسی نصب و نشانگر دریافت ترافیک است. |
| حالت جمع آوری | «تگ مستقیم» یا «دروازه تگ». تعیین میکند تگ از کجا سرو شود و بیکن به کجا برود. |
| اندازهگیری پیشرفته | کدام رویدادهای خودکار (اسکرول، کلیک خروجی، دانلود، فرم، ویدیو، جستجوی سایت) روشن باشند. |
| پیکربندی دامنهها | شرط های میان دامنهای که لینکگر و استثنای خودارجاعی از آنها تغذیه میشوند. |
| نقشههای حرارتی | روشن/خاموش، نرخ نمونه گیری، حالتها، مسیرهای مستثنی و تاریخ توقف. |
| کلیدهای سرور | اعتبارنامه های ارسال سرور به سرور، که به همان جریان بستهاند. |
به همین دلیل است که دو سایت با تنظیمات متفاوت نمیتوانند یک تگ مشترک داشته باشند: تنظیمات به جریان چسبیده است.
چرا شناسه به جریان تعلق دارد، نه به حساب#
هر بیکنی که از مرورگر بیرون میرود فقط یک شناسه با خودش دارد. گیرنده با همان یک رشته سازمان، دارایی و جریان را از پایگاه داده بیرون میکشد و رویداد را در جای درست مینویسد. شناسه ای در سطح حساب هیچ راهی برای تشخیص اینکه این بازدید از کدام سایت آمده باقی نمیگذاشت.
شکل شناسه ثابت است: AP- به اضافه ۱۰ کاراکتر هگز بزرگ، مثل AP-A1B2C3D4E5. یکتا بودنش را یک ایندکس یکتا روی همان ستون تضمین میکند، پس هیچ دو جریانی — حتی در دو سازمان مختلف — نمیتوانند یک شناسه داشته باشند.
شناسه اندازهگیری در سورس هر صفحه پیداست و اشکالی هم ندارد؛ اعتبارنامه نیست. اعتبارنامه واقعی جریان، «کلید سرور» است که هنگام ساخت جریان یک بار نشان داده میشود و در «رمزهای API پروتکل اندازهگیری» مدیریت میشود. آن یکی را هرگز در صفحه نگذارید.
فهرست جریان ها را کجا ببینید#
بالای فهرست، زبانه های «همه»، iOS، Android و «وب» هستند. امروز فقط جریان وب ساخته میشود؛ دو زبانه اپلیکیشن با نشان «به زودی» غیرفعالاند. تا آن زمان بکاند اپلیکیشن میتواند رویدادها را از راه API سرور به سرور بفرستد.
ساختن یک جریان وب#
بلافاصله بعد از ساخت، صفحه دستورالعمل نصب باز میشود و دو چیز را نشان میدهد که فقط همان جا در دسترساند: قطعه کد تگ با شناسه همین جریان، و کلید سرور که فقط یک بار نمایش داده میشود. کلید را همان لحظه جایی ذخیره کنید.
نام و دامنه بعدا قابل ویرایشاند؛ شناسه اندازهگیری نه.
داخل یک جریان چه چیزهایی هست#
روی هر ردیف فهرست بزنید تا «جزئیات جریان وب» باز شود.
بالای این پنجره یک نوار وضعیت است: یا «جمع آوری داده در ۴۸ ساعت گذشته فعال است»، یا هشدار «جمع آوری داده برای وب سایت شما فعال نیست» همراه با دکمه «مشاهده دستورالعمل نصب تگ». پایین تر کارت «جزئیات جریان» چهار مقدار را نشان میدهد — نام، آدرس، شناسه جریان و شناسه اندازهگیری — و بعد از آن ردیفهای زیر:
| ردیف | چه کاری میکند |
|---|---|
| اندازهگیری پیشرفته | رویدادهای خودکار این جریان را روشن و خاموش میکند. |
| اصلاح رویدادها / ساخت رویدادهای سفارشی | شما را به تنظیمات رویدادهای دارایی میبرد؛ اینها در سطح داراییاند نه جریان. |
| نقشههای حرارتی | ضبط اختیاری کلیک، حرکت و اسکرول با نمونه گیری و تاریخ توقف. |
| رمزهای API پروتکل اندازهگیری | ساخت و ابطال کلیدهای سرور همین جریان. |
| پیکربندی دامنهها | شرط های اندازهگیری میان دامنه. خلاصه اش روی همان ردیف نوشته میشود. |
| دروازه تگ (فرستپارتی) | ساخت بسته پروکسی و اجرای عیب یابی برای حالت فرستپارتی. |
| مشاهده دستورالعمل نصب تگ | قطعه کد و دکمه «آزمایش نصب». |
دو حالت جمع آوری#
| حالت | تگ از کجا سرو میشود | رویدادها به کجا میروند |
|---|---|---|
| تگ مستقیم | دامنه CDN ادپیکس | گیرنده ادپیکس، به صورت میان مبدا و بدون کوکی |
| دروازه تگ | زیردامنه خود شما، پیشفرض metrics.<دامنه شما> |
همان زیردامنه خودتان، که به گیرنده پروکسی میشود |
تگ مستقیم چیزی برای راه اندازی ندارد و توصیه شده شروع است. دروازه تگ یک رکورد CNAME و یک پیکربندی پروکسی روی سرور خودتان میخواهد و در عوض تگ و بیکن هر دو فرستپارتی میشوند. اگر بسته دروازه را بسازید، تگ مستقیم از کار نمیافتد؛ صفحه دستورالعمل هر دو قطعه کد را کنار هم نشان میدهد و شما یکی را انتخاب میکنید.
کی به جریان دوم نیاز دارید#
این تنها بخشی از این صفحه است که بعدا پشیمانی میآورد، پس مرزش را دقیق بگویید:
- دامنه کاملا متفاوت، یا تنظیمات جمع آوری متفاوت — جریان دوم بسازید. مثلا وقتی سایت اصلی و وبلاگ روی دو دامنهاند و میخواهید نقشه حرارتی فقط روی یکی روشن باشد.
- زیردامنههای همان دامنه — جریان دوم لازم نیست. یک جریان روی
example.comزیردامنههایش را هم پوشش میدهد. - گزارشهای جدا برای دو سایت — جریان دوم جواب نمیدهد. دارایی جداگانه بسازید.
رویدادها شناسه جریان را با خود حمل نمیکنند. هر چیزی که با شناسههای جریانهای یک دارایی فرستاده شود، در همان یک مجموعه گزارش دیده میشود و فقط از روی نام میزبان صفحه قابل تفکیک است. اگر میخواهید دو سایت اعداد جدا داشته باشند، جدایی باید در سطح دارایی اتفاق بیفتد، نه جریان.
نکته کوچک ولی مهم: دامنه اصلی دارایی از اولین جریان وبی که دامنه دارد گرفته میشود و به صورت خودکار نگه داری میشود. ترتیب ساخت جریان ها اینجا اثر دارد.
نشانگر دریافت و آزمایش نصب#
کنار هر جریان یکی از دو جمله «دریافت ترافیک در ۴۸ ساعت گذشته» یا «داده ای در ۴۸ ساعت گذشته دریافت نشد» نوشته میشود. این نشانگر از روی دامنه جریان کار میکند: رویدادهایی که نام میزبان صفحه شان با دامنه جریان یکی است یا زیردامنه آن است، به حساب همان جریان گذاشته میشوند. جریانی که هنوز دامنهای برایش ثبت نشده، هر ترافیکی از آن دارایی را «در حال دریافت» میبیند.
دکمه «آزمایش نصب» در دستورالعمل تگ، بررسی دقیق تری است و وضعیت جریان را هم ذخیره میکند؛ معنی هر وضعیت در تایید رسیدن داده آمده است.
حذف جریان#
حذف جریان تگ را از کار میاندازد و همه کلیدهای سرورش را باطل میکند. برای تایید باید نام جریان را تایپ کنید. رویدادهایی که قبلا جمع شدهاند در گزارشها میمانند، ولی شناسه اندازهگیری برنمی گردد — یعنی هر صفحهای که هنوز آن قطعه کد را دارد، از آن لحظه به بعد داده اش به هیچ جا نمیرسد. اول قطعه کد را از سایت بردارید، بعد جریان را حذف کنید.
پرسشهای پرتکرار#
شناسه اندازهگیری محرمانه است؟
خیر. شناسه در سورس هر صفحه سایت شما دیده میشود و قرار هم هست دیده شود؛ کارش فقط این است که به گیرنده بگوید رویداد مال کدام دارایی است. چیزی که محرمانه است کلید سرور جریان است — آن یک اعتبارنامه برای ارسال سرور به سرور است و فقط یک بار نمایش داده میشود.
برای هر زیردامنه باید یک جریان جدا بسازم؟
نه. ضربان داده و نشانگر «دریافت ترافیک» زیردامنههای دامنه ثبت شده جریان را هم به حساب همان جریان میگذارند، پس یک جریان روی example.com هم shop.example.com را پوشش میدهد. جریان دوم وقتی لازم است که دامنهای کاملا متفاوت داشته باشید یا بخواهید تنظیمات اندازهگیری اش فرق کند.
اگر دو جریان زیر یک دارایی بسازم، گزارشها از هم جدا میشوند؟
خیر. رویدادها شناسه جریان را با خود حمل نمیکنند و همه جریانهای یک دارایی در همان یک استخر گزارش میریزند. اگر گزارش جداگانه میخواهید، دارایی جداگانه بسازید و در هر کدام یک جریان.
جریان را حذف کنم، دادههای جمع آوری شده هم میروند؟
خیر. حذف جریان، تگ را از کار میاندازد و کلیدهای سرورش را باطل میکند، ولی رویدادهایی که قبلا جمع شدهاند در گزارشها میمانند. این کار برگشت پذیر نیست و شناسه اندازهگیری همان جریان دیگر بازنمی گردد.
ممنون — بازخورد شما به بهتر شدن مستندات کمک میکند.