سازمان، حساب و دارایی
هر چیزی که در ادپیکس میسازید زیر یکی از این سه سطح مینشیند. سازمان مرز بیرونی است، حساب گروه بندی داخل آن، و دارایی همان چیزی است که واقعا اندازه میگیرید و گزارشش را میخوانید.
سه سطح، از بالا به پایین#
سازمان ← حساب ← دارایی ← جریان داده.
این ترتیب هیچ وقت عوض نمیشود و هر چیزی دقیقا یک والد دارد.
- سازمان بیرونی ترین مرز است. کاربران و تنظیمات سراسری به آن میچسبند و داده هرگز از این مرز بیرون نمیرود.
- حساب یک گروه بندی داخل سازمان است — معمولا یک برند، یک واحد کسبوکار، یا اگر آژانس هستید یک مشتری.
- دارایی یک وب سایت یا اپلیکیشن است که اندازه میگیرید. هر گزارشی که باز میکنید دقیقا یک دارایی را میخواند.
- جریان داده مسیر ورود داده به آن دارایی است. شناسه اندازهگیری متعلق به جریان است، نه به دارایی و نه به حساب.
در کنسول همین درخت را در «مدیریت» ← «جزئیات و سلسله مراتب حساب» میبینید: سازمان های شما، حساب های هرکدام، و دارایی های زیر هر حساب با دامنه اصلی شان.
چه چیزی به کدام سطح میچسبد#
| سطح | زیرش چه چیزی هست | چه کسی میتواند بسازدش |
|---|---|---|
| سازمان | حساب ها، اعضای سازمان | ساخته نمیشود؛ با ثبت نام یا به دست مدیر پلتفرم به وجود میآید |
| حساب | دارایی ها، سطل زباله، دسترسی حساب | «مدیر سازمان» یا «مالک سازمان» |
| دارایی | جریانهای داده، رویدادها، رویدادهای کلیدی، تعریفهای سفارشی، دسترسی دارایی | «مدیر حساب» همان حساب، یا «مدیر سازمان» و «مالک سازمان» |
| جریان داده | شناسه اندازهگیری و قطعه کد تگ | «ویرایش گر» و بالاتر روی همان دارایی |
نقش ها در هر سطح تعریف میشوند و به پایین میریزند: کسی که در سازمان نقشی دارد، همان اختیار را روی همه حساب ها و دارایی های زیرش هم دارد. جزئیات این ریزش در نقش ها و محدودیت های داده آمده است.
پلن — رایگان یا پریمیوم — به دارایی بسته است، نه به سازمان و نه به کاربر. اگر چند دارایی دارید، ممکن است یک قابلیت روی یکی باز و روی دیگری قفل باشد. پلن را ادپیکس تعیین میکند، نه اعضای کسبوکار.
دارایی، واحد گزارش است#
این نکتهای است که بیشتر از همه در طراحی ساختار اثر میگذارد: هیچ گزارشی چند دارایی را با هم جمع نمیزند. انتخابگر بالای صفحه یک دارایی را فعال میکند و هر عددی که میبینید فقط برای همان است.
سه تنظیم مهم هم متعلق به دارایی است، نه به حساب:
| تنظیم | اثرش | پیشفرض | بعدا قابل تغییر؟ |
|---|---|---|---|
| منطقه زمانی | مرز روز و همه سطل های زمانی گزارشها | UTC |
بله |
| پنجره اتریبیوشن | چند روز عقب تر یک برخورد هنوز اعتبار تبدیل میگیرد | ۳۶۵ روز | بله |
| ارز | واحد درآمد و هزینه در گزارشها | USD |
خیر — فقط هنگام ساخت دارایی |
«مدیریت» ← «جزئیات دارایی» نام دارایی، پنجره اتریبیوشن، منطقه زمانی و CIDRهای حذف شده را ویرایش میکند. ارز در آن فرم نیست؛ هنگام ساخت دارایی انتخاب میشود.
کنسول امروز راهی برای جابهجا کردن یک دارایی بین دو حساب ندارد. اگر قرار است ساختارتان چند برند یا چند مشتری داشته باشد، پیش از نصب تگ سراغ ساختنش بروید؛ بعدا یعنی ساختن دارایی تازه و شروع دوباره جمع آوری داده.
ساختن حساب و دارایی#
دارایی تازه هنوز هیچ جریان داده ای ندارد و تا وقتی جریان نسازید شناسه اندازهگیری هم ندارد. ادامه کار در نصب تگ اندازهگیری است.
اگر هنوز دارایی ای ندارید#
اگر عضو یک سازمان هستید ولی هیچ دارایی ای برای دیدن ندارید، کنسول به جای گزارشها صفحه خوش آمد را نشان میدهد. آنجا دو حالت هست:
- اجازه ساخت دارید — دکمه «ساخت اولین دارایی» را میبینید و همان جا کار تمام میشود.
- اجازه ساخت ندارید — پیام میگوید از یک مدیر حساب بخواهید دارایی بسازد یا به شما دسترسی بدهد. بعد از اینکه این کار را کرد، صفحه را تازه کنید.
جابهجایی بین دارایی ها#
انتخابگر بالای صفحه («جستجوی حساب ها و دارایی ها») همه چیزهایی را که به آنها دسترسی دارید در یک فهرست میآورد، با زبانه های «موارد دلخواه»، «اخیر»، «حساب ها» و «دارایی ها». انتخاب شما در همان مرورگر نگه داشته میشود، پس دفعه بعد در همان دارایی باز میشوید.
حذف و بازیابی#
حذف دارایی یا حساب نرم است: ردیف ناپدید میشود ولی از بین نمیرود. هر دو در «مدیریت» ← «سطل زباله» فهرست میشوند و با «بازیابی» برمی گردند. حذف و بازیابی نقش «مدیر حساب» یا بالاتر میخواهد. تاریخچه تغییرها و جزئیات سطل زباله در تاریخچه تغییرات و سطل زباله است.
این شناسهها را کجا دوباره میبینید#
اگر با API یا خروجی های خام کار میکنید، همین ساختار با نام دیگری برمی گردد:
| در کنسول | در داده و API |
|---|---|
| سازمان | tenant_id |
| دارایی | site_id (پارامتر site در پرس وجوهای گزارش) |
هر پرس وجوی گزارش با همین دو مقدار محدود میشود؛ همین است که مرز داده بین سازمان ها را نگه میدارد.
پرسشهای پرتکرار#
تفاوت سازمان با حساب چیست؟
سازمان بیرونی ترین مرز است و داده هرگز از آن بیرون نمیرود؛ کاربران و عضویت ها به آن میچسبند. حساب فقط یک گروه بندی داخل همان سازمان است — معمولا یک برند، یک واحد کسبوکار یا یک مشتری. یک سازمان میتواند چند حساب داشته باشد، اما یک حساب همیشه دقیقا زیر یک سازمان است.
میتوانم گزارش چند دارایی را با هم ببینم؟
خیر. هر گزارش دقیقا یک دارایی را میخواند و همه پرس وجوها به همان سازمان و همان دارایی محدود میشوند. اگر میخواهید چند دامنه در یک گزارش دیده شوند، باید همه زیر یک دارایی و با جریانهای داده جداگانه اندازهگیری شوند، نه در دارایی های مختلف.
منطقه زمانی را کجا تعیین میکنم و روی چه چیزی اثر میگذارد؟
در «مدیریت» ← «جزئیات دارایی». منطقه زمانی متعلق به دارایی است و هر بازه تاریخ و هر سطل روزانه، ساعتی، هفتگی و ماهانه گزارشها با همان محاسبه میشود. عوض کردنش، مرز روزها را در همه گزارشها جابهجا میکند.
دارایی را اشتباهی حذف کردم. برمی گردد؟
بله. حذف دارایی نرم است: دارایی به «سطل زباله» در تنظیمات حساب میرود و از همان جا با «بازیابی» برمی گردد. برای حذف و بازیابی، نقش «مدیر حساب» یا بالاتر لازم است.
ممنون — بازخورد شما به بهتر شدن مستندات کمک میکند.