این راهنمای توسعهدهنده نحوه استفاده از Google Analytics SDK v4 برای Android برای پیادهسازی ابعاد و معیارهای سفارشی را توضیح میدهد.
بررسی اجمالی
تو می توانی:
- از رابط وب Google Analytics برای پیکربندی ابعاد یا متریک سفارشی استفاده کنید. با نحوه پیکربندی یک بعد یا متریک سفارشی (مرکز راهنمایی) آشنا شوید .
- ابعاد و مقادیر متریک سفارشی را از یک برنامه تنظیم و ارسال کنید.
ابعاد و معیارهای سفارشی از دو قسمت تشکیل شده است:
نام زمینه | تایپ کنید | شرح |
---|---|---|
فهرست مطالب | Integer | نمایه بعد یا متریک سفارشی. این شاخص مبتنی بر 1 است. |
ارزش | String | ارزش بعد یا متریک سفارشی. در این مورد از معیارها، اگر متریک برای یک نوع ارز پیکربندی شده باشد، به عنوان یک عدد صحیح یا یک مقدار اعشاری با نقطه ثابت تجزیه خواهد شد. |
تنظیم و ارسال مقادیر
برای تنظیم و ارسال یک مقدار ابعاد سفارشی:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomDimension(1, "premiumUser") .build() );
مقادیر ابعاد سفارشی را میتوان با هر نوع ضربه Google Analytics ارسال کرد، از جمله نماهای صفحه، رویدادها، تراکنشهای تجارت الکترونیک، زمانبندی کاربر و تعاملات اجتماعی. محدوده تعریفشده بعد سفارشی، در زمان پردازش، تعیین میکند که کدام بازدید با مقدار بعد مرتبط است.
برای تنظیم و ارسال یک مقدار متریک سفارشی:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomMetric(1, 5) .build() );
برای جزئیات بیشتر در مورد روش getTracker
به تنظیمات پیشرفته مراجعه کنید.
ملاحظات پیاده سازی
این بخش ملاحظات دیگری را که باید هنگام اجرای ابعاد یا معیارهای سفارشی در نظر داشته باشید، تشریح می کند.
ملاحظات برای ابعاد سفارشی
مقادیر با محدوده کاربر و سطح جلسه برای بازدیدهای گذشته اعمال می شود
- مقادیر ابعاد سفارشی با دامنه کاربر یا سطح جلسه برای همه بازدیدهای جلسه جاری، از جمله بازدیدهای گذشته، اعمال خواهد شد. اگر نمیخواهید یک مقدار ابعاد سفارشی با وسعت جلسه یا سطح کاربر برای بازدیدهای گذشته در جلسه فعلی اعمال شود، قبل از اعمال مقدار برای ضربه ، جلسه جدیدی را شروع کنید .
- برای مثال، اگر از نوع عضویت به عنوان یک بعد سفارشی در سطح کاربر استفاده میکنید، و کاربر عضویت خود را در میانه جلسه ارتقا میدهد، ممکن است بخواهید قبل از تنظیم مقدار ابعاد سفارشی جدید، جلسه جدیدی را شروع کنید. این تضمین می کند که بازدیدهای قبل از ارتقاء با مقدار عضویت قدیمی مرتبط می شوند، در حالی که بازدیدهای جدید با مقدار جدید مرتبط خواهند بود.
ابعاد سفارشی و فیلترهای نمایش (نمایه).
- مقادیر ابعاد سفارشی کاربر یا سطح جلسه همچنان برای همه بازدیدها در جلسات فعلی و/یا آینده اعمال میشود، حتی اگر بازدیدی که با آن ارسال میشود از یک نمای (نمایه) فیلتر شده باشد.
- هنگام فیلتر کردن یک مقدار ابعاد سفارشی، بازدیدها با توجه به محدوده آن مقدار ابعاد سفارشی فیلتر می شوند. درباره نحوه تعامل فیلترها و مقادیر ابعاد سفارشی هنگام پردازش دادههایتان بیشتر بدانید .
ملاحظات برای معیارهای سفارشی
مقادیر متریک سفارشی در گزارش ها جمع می شوند
- مقادیر متریک سفارشی مانند سایر معیارهای از پیش تعریف شده در Google Analytics در گزارش ها جمع می شوند. در نتیجه، برای افزایش مجموع متریک در گزارش های خود، یک مقدار متریک سفارشی
1
تعیین می کنید.
معیارهای سفارشی و فیلترهای نمایش (نمایه).
- اگرچه معمولاً مقادیر متریک سفارشی را میتوان هر زمان که مناسب باشد تنظیم کرد، از تنظیم مقادیر متریک سفارشی روی بازدیدهایی که احتمالاً از نماهای شما (نمایهها) فیلتر میشوند، خودداری کنید. اگر یک بازدید با فیلتر نما (نمایه) فیلتر شود، هر مقدار متریک سفارشی مرتبط نیز فیلتر خواهد شد. درباره ابعاد و معیارهای سفارشی و فیلترهای مشاهده (نمایه) بیشتر بیاموزید .
تنظیم مقادیر با اندازه گیری خودکار صفحه
- برای اعمال یک مقدار ابعاد سفارشی به نمای صفحه ارسال شده از طریق اندازهگیری خودکار صفحه، مقداری را قبل از
activityStart()
در طولonStart()
تنظیم کنید. توجه داشته باشید که در مواردی که مقدار در زمان اجرایonStart()
مشخص نیست، اندازه گیری دستی صفحه به جای آن توصیه می شود.
اطلاعات شناسایی شخصی (PII) را به عنوان مقادیر ارسال نکنید
- شرایط خدمات Google Analytics ارسال هرگونه اطلاعات شناسایی شخصی (PII) به سرورهای Google Analytics را ممنوع می کند. برای اطلاعات بیشتر، لطفاً به شرایط خدمات مراجعه کنید.