جریان داده ها
هر جریان داده یک تگ است با شناسه تگ مخصوص خودش. جریان داده تعیین میکند تگ روی کدام دامنه بنشیند، چه چیزهایی خودکار اندازهگیری شود و کدام کلیدهای سرور برای آن کار کنند.
یک جریان داده دقیقا چیست#
جریان داده کوچک ترین واحد جمع آوری در ادپیکس است: یک تگ، یک شناسه تگ، یک دامنه. جریان داده زیر «وبسایت» مینشیند، وبسایت زیر حساب، و حساب زیر سازمان.
هر چیزی که به «نحوه جمع آوری» مربوط است روی خود جریان داده نگه داری میشود، نه روی وبسایت:
| روی جریان داده | چه چیزی را تعیین میکند |
|---|---|
| شناسه تگ | هویت تگ. در قطعه کد میآید و گیرنده از روی آن سازمان و وبسایت را پیدا میکند. |
| دامنه | نام میزبانی که تگ آنجا اجرا میشود. مبنای بررسی نصب و نشانگر دریافت ترافیک است. |
| حالت جمع آوری | «تگ مستقیم» یا «دروازه تگ». تعیین میکند تگ از کجا سرو شود و بیکن به کجا برود. |
| اندازهگیری پیشرفته | کدام رویدادهای خودکار (اسکرول، کلیک خروجی، دانلود، فرم، ویدیو، جستجوی سایت) روشن باشند. |
| پیکربندی دامنهها | شرط های میان دامنهای که لینکگر و استثنای خودارجاعی از آنها تغذیه میشوند. |
| نقشههای حرارتی | روشن/خاموش، نرخ نمونه گیری، حالتها، مسیرهای مستثنی و تاریخ توقف. |
| بازپخش نشست | روشن/خاموش، نرخ نمونه گیری، پنهانسازی، طول ضبط، مسیرهای مستثنی و تاریخ توقف. |
| کلیدهای سرور | اعتبارنامه های ارسال سرور به سرور، که به همان جریان داده بستهاند و در «یکپارچهسازیها» ساخته و باطل میشوند. |
به همین دلیل است که دو سایت با تنظیمات متفاوت نمیتوانند یک تگ مشترک داشته باشند: تنظیمات به جریان داده چسبیده است.
چرا شناسه به جریان داده تعلق دارد، نه به حساب#
هر بیکنی که از مرورگر بیرون میرود فقط یک شناسه با خودش دارد. گیرنده با همان یک رشته سازمان، وبسایت و جریان داده را از پایگاه داده بیرون میکشد و رویداد را در جای درست مینویسد. شناسه ای در سطح حساب هیچ راهی برای تشخیص اینکه این بازدید از کدام سایت آمده باقی نمیگذاشت.
شکل شناسه ثابت است: AP- به اضافه ۱۰ کاراکتر هگز بزرگ، مثل AP-A1B2C3D4E5. یکتا بودنش را یک ایندکس یکتا روی همان ستون تضمین میکند، پس هیچ دو جریان دادهای — حتی در دو سازمان مختلف — نمیتوانند یک شناسه داشته باشند.
شناسه تگ در سورس هر صفحه پیداست و اشکالی هم ندارد؛ اعتبارنامه نیست. اعتبارنامه واقعی وبسایت، «کلید سرور» است که آگاهانه در «مدیریت» ← «یکپارچهسازیها» ساخته میشود و فقط یک بار نشان داده میشود. آن یکی را هرگز در صفحه نگذارید.
فهرست جریان داده ها را کجا ببینید#

فهرست همه جریان داده ها وبسایت را نشان میدهد. همه آنها جریان داده وب هستند، پس فهرست به زبانه تقسیم نمیشود؛ بکاند اپلیکیشن رویدادهایش را از راه API سرور به سرور میفرستد. زیر فهرست کارت «کلیدهای سرور» قرار دارد که در ردیابی سمت سرور توضیح داده شده است.
ساختن یک جریان داده#
بلافاصله بعد از ساخت، صفحه دستورالعمل نصب با قطعه کد تگ همین جریان داده باز میشود. با ساختن جریان داده هیچ کلیدی ساخته نمیشود؛ ماژولی که کلید سرور لازم دارد، آن را از یکپارچهسازیها میگیرد.
زیر قطعه کد، «شناسه وبسایت»، «آدرس دریافت داده» (جایی که تگ رویدادها را میفرستد) و «شناسه تگ» هر کدام دکمه «کپی» خودشان را دارند؛ همان سه مقداری که افزونه CMS، ابزار مدیریت تگ یا برنامهنویس از شما میخواهد.
نام و دامنه بعدا قابل ویرایشاند؛ شناسه تگ نه.
داخل یک جریان داده چه چیزهایی هست#
روی هر ردیف فهرست بزنید تا «جزئیات جریان داده» باز شود.

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