ابعاد و معیارهای سفارشی - Android SDK نسخه 2 (قدیمی)

این راهنمای توسعه‌دهنده نحوه پیاده‌سازی ابعاد و معیارهای سفارشی با استفاده از Google Analytics SDK برای Android نسخه ۲ را شرح می‌دهد.

بررسی اجمالی

وقتی یک بعد سفارشی یا مقدار متریک را با استفاده از Google Analytics SDK برای Android تنظیم می‌کنید، آن مقدار به عنوان پارامتر با ضربه بعدی ارسال می‌شود. این مقادیر را می توان برای هر نوع ضربه گوگل آنالیتیکس، از جمله نماهای صفحه، رویدادها، تراکنش های تجارت الکترونیک، زمان بندی کاربر و تعاملات اجتماعی اعمال کرد.

دو مرحله اصلی برای اجرای یک بعد یا متریک سفارشی وجود دارد:

  1. بعد یا متریک سفارشی را با استفاده از رابط وب Google Analytics تعریف کنید.
    فهرست، نام و دامنه ابعاد یا متریک سفارشی را در بخش تنظیمات ویژگی رابط وب تنظیم کنید.
    با نحوه تعریف یک بعد یا متریک سفارشی آشنا شوید .
  2. کد را برای تنظیم و جمع‌آوری ابعاد سفارشی و مقادیر متریک پیاده‌سازی کنید.
    کدی را به برنامه خود اضافه کنید تا ابعاد یا مقادیر متریک سفارشی را برای بازدیدهای Google Analytics خود در شاخص هایی که در مرحله قبل تعریف کرده اید تنظیم کنید.

در ادامه این مقاله نحوه پیاده‌سازی کد برای تنظیم و ارسال ابعاد سفارشی یا مقادیر متریک به Google Analytics توضیح داده می‌شود.

ابعاد سفارشی

مقادیر ابعاد سفارشی را می توان در همه انواع ضربه های Google Analytics تنظیم کرد. یک مقدار ابعاد سفارشی را درست قبل از تماس ارسالی که می‌خواهید مقدار روی آن اعمال شود، تنظیم کنید.

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

این فیلدها برای تنظیم مقدار ابعاد سفارشی مورد نیاز هستند:

  • Integer Index – نمایه تعریف بعد سفارشی. این شاخص مبتنی بر 1 است.
  • String Value – مقدار بعد سفارشی.

تنظیم مقدار ابعاد سفارشی

برای تنظیم یک مقدار ابعاد سفارشی، قبل از تماس ارسالی که می‌خواهید مقدار را با آن مرتبط کنید، setCustomDimension را فراخوانی کنید:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

ملاحظات پیاده سازی

این بخش ملاحظات دیگری را که باید هنگام اجرای یک بعد سفارشی در نظر داشته باشید، تشریح می کند.

محدوده کاربر و سطح جلسه حریص هستند

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

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

ابعاد سفارشی و فیلترهای نمایش (نمایه).

مقادیر ابعاد سفارشی کاربر یا سطح جلسه همچنان برای همه بازدیدها در جلسات فعلی و/یا آینده اعمال می‌شود، حتی اگر بازدیدی که با آن ارسال می‌شود از یک نمای (نمایه) فیلتر شده باشد.

هنگام فیلتر کردن یک مقدار ابعاد سفارشی، بازدیدها با توجه به محدوده آن مقدار ابعاد سفارشی فیلتر می شوند.

درباره نحوه تعامل فیلترها و مقادیر ابعاد سفارشی هنگام پردازش داده‌هایتان بیشتر بدانید .

تنظیم مقادیر با اندازه گیری خودکار صفحه

برای اعمال یک مقدار ابعاد سفارشی به نمای صفحه ارسال شده از طریق اندازه‌گیری خودکار صفحه EasyTracker، مقدار را قبل از activityStart() در حین onStart() تنظیم کنید.

توجه داشته باشید که در مواردی که در زمان اجرای onStart() مقدار مشخص نیست، توصیه می شود به جای آن از اندازه گیری دستی صفحه استفاده کنید.

اطلاعات شناسایی شخصی (PII) را به عنوان مقادیر ارسال نکنید

شرایط خدمات Google Analytics ارسال هرگونه اطلاعات شناسایی شخصی (PII) به سرورهای Google Analytics را ممنوع می کند. برای اطلاعات بیشتر، لطفاً به شرایط خدمات مراجعه کنید.

معیارهای سفارشی

در حالی که ابعاد سفارشی باید به دقت برای بازدیدهای خاص اعمال شوند و با دامنه مدیریت شوند، بازدیدی که یک سنجه سفارشی برای آن اعمال می‌شود، عموماً بر گزارش‌دهی تأثیر نمی‌گذارد، و بنابراین هر زمان که مقدار متریک مشخص شد، می‌توان آنها را تنظیم کرد.

این فیلدها برای تنظیم یک مقدار متریک سفارشی مورد نیاز هستند:

  • Integer Index – شاخص تعریف متریک سفارشی.
  • مقدار Integer - مقدار معیار سفارشی. ارزش ها ممکن است منفی باشند.

تنظیم یک مقدار متریک سفارشی

برای تنظیم یک مقدار متریک سفارشی، قبل از ارسال تماس دیگری با setCustomMetric تماس بگیرید:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

یا برای تنظیم یک متریک سفارشی ارز:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

ملاحظات پیاده سازی

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

مقادیر متریک سفارشی در گزارش ها جمع می شوند

مقادیر متریک سفارشی مانند سایر معیارهای از پیش تعریف شده در Google Analytics در گزارش ها جمع می شوند. در نتیجه، برای افزایش مجموع متریک در گزارش های خود، یک مقدار متریک سفارشی 1 تعیین می کنید.

معیارهای سفارشی و فیلترهای نمایش (نمایه).

اگرچه معمولاً مقادیر متریک سفارشی را می‌توان هر زمان که مناسب باشد تنظیم کرد، از تنظیم مقادیر متریک سفارشی روی بازدیدهایی که احتمالاً از نماهای شما (نمایه‌ها) فیلتر می‌شوند، خودداری کنید. اگر یک بازدید با فیلتر نما (نمایه) فیلتر شود، هر مقدار متریک سفارشی مرتبط نیز فیلتر خواهد شد. درباره ابعاد و معیارهای سفارشی و فیلترهای مشاهده (نمایه) بیشتر بیاموزید .