Phương diện và chỉ số tùy chỉnh – SDK iOS

Hướng dẫn cho nhà phát triển này mô tả cách triển khai thứ nguyên và chỉ số tùy chỉnh bằng cách sử dụng SDK Google Analytics dành cho iOS phiên bản 2.

Tổng quan

Khi bạn đặt giá trị thứ nguyên hoặc chỉ số tùy chỉnh bằng cách sử dụng SDK Google Analytics cho iOS, giá trị đó được gửi dưới dạng thông số cùng với lượt truy cập tiếp theo được gửi đi. Các giá trị đó có thể được áp dụng cho bất kỳ loại lượt truy cập Google Analytics nào, bao gồm cả lượt xem màn hình, sự kiện, giao dịch thương mại điện tử, thời gian người dùng và tương tác trên mạng xã hội.

Có hai bước chính để triển khai một chỉ số hoặc phương diện tuỳ chỉnh:

  1. Xác định phương diện hoặc chỉ số tuỳ chỉnh bằng cách sử dụng giao diện web của Google Analytics.
    Đặt chỉ mục, tên và phạm vi của thứ nguyên hoặc chỉ số tùy chỉnh trong phần cài đặt thuộc tính của giao diện web.
    Tìm hiểu cách xác định phương diện hoặc chỉ số tuỳ chỉnh.
  2. Triển khai mã để đặt và thu thập các giá trị phương diện và chỉ số tuỳ chỉnh.
    Thêm mã vào ứng dụng của bạn để đặt giá trị thứ nguyên hoặc chỉ số tùy chỉnh cho lượt truy cập Google Analytics tại các chỉ mục mà bạn đã xác định trong bước trước.

Phần còn lại của bài viết này sẽ mô tả cách triển khai mã để đặt và gửi giá trị thứ nguyên hoặc chỉ số tùy chỉnh đến Google Analytics.

Phương diện tuỳ chỉnh

Bạn có thể đặt giá trị thứ nguyên tùy chỉnh trên tất cả các loại lượt truy cập Google Analytics. Hãy đặt một giá trị thứ nguyên tùy chỉnh ngay trước lệnh gọi gửi mà bạn muốn áp dụng giá trị đó.

Phạm vi đã xác định của thứ nguyên tùy chỉnh sẽ xác định thời điểm xử lý những lượt truy cập bổ sung có thể được liên kết với giá trị đó.

Bạn bắt buộc phải sử dụng các trường sau để đặt giá trị phương diện tuỳ chỉnh:

  • NSNumber Chỉ mục – chỉ mục của định nghĩa phương diện tuỳ chỉnh. Chỉ mục này dựa trên 1.
  • NSString Giá trị – giá trị của phương diện tuỳ chỉnh.

Đặt giá trị phương diện tùy chỉnh

Để đặt giá trị thứ nguyên tùy chỉnh, hãy gọi setCustom:dimension: trước lệnh gọi gửi mà bạn muốn liên kết giá trị:

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

Cân nhắc khi triển khai

Phần này trình bày các điểm cần cân nhắc khác cần lưu ý khi triển khai phương diện tuỳ chỉnh.

Phạm vi cấp người dùng và phiên đang tham gia

Giá trị thứ nguyên tùy chỉnh có phạm vi cấp người dùng hoặc cấp phiên hoạt động sẽ áp dụng cho tất cả các lượt truy cập trong phiên hiện tại, bao gồm cả lượt truy cập trước đây. Nếu bạn không muốn áp dụng giá trị thứ nguyên tùy chỉnh có phạm vi cấp phiên hoạt động hoặc cấp người dùng cho các lượt truy cập trước đây trong phiên hiện tại, hãy bắt đầu một phiên mới trước khi áp dụng giá trị cho một lượt truy cập.

Ví dụ: nếu bạn đang sử dụng loại thành viên làm phương diện tuỳ chỉnh cấp người dùng và một người dùng nâng cấp tư cách thành viên của họ vào giữa phiên hoạt động, thì bạn nên bắt đầu một phiên hoạt động mới trước khi đặt giá trị thứ nguyên tuỳ chỉnh mới. Điều này đảm bảo rằng các lượt truy cập trước khi nâng cấp sẽ được liên kết với giá trị thành viên cũ, trong khi các lượt truy cập mới sẽ được liên kết với giá trị mới.

Phương diện tùy chỉnh và bộ lọc chế độ xem (Hồ sơ)

Giá trị thứ nguyên tùy chỉnh cấp người dùng hoặc cấp phiên hoạt động vẫn sẽ được áp dụng cho tất cả các lượt truy cập trong phiên hiện tại và/hoặc trong tương lai ngay cả khi lượt truy cập được gửi cùng bị lọc khỏi một chế độ xem (hồ sơ).

Khi lọc một giá trị thứ nguyên tùy chỉnh, lượt truy cập được lọc theo phạm vi của giá trị thứ nguyên tùy chỉnh đó.

Tìm hiểu thêm về cách các bộ lọc và giá trị thứ nguyên tùy chỉnh tương tác khi dữ liệu của bạn được xử lý.

Đặt giá trị bằng tính năng tự động đo lường màn hình

Để áp dụng giá trị kích thước tuỳ chỉnh cho lượt xem màn hình được gửi thông qua tính năng tự động đo lường màn hình, hãy đặt giá trị này trong phương thức viewDidAppear: của bộ điều khiển khung hiển thị. Ví dụ: tệp .m của bộ điều khiển chế độ xem có thể có dạng như sau:

#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [super viewDidAppear:animated]   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

Không gửi thông tin nhận dạng cá nhân (PII) làm giá trị

Điều khoản dịch vụ của Google Analytics nghiêm cấm gửi bất kỳ thông tin nhận dạng cá nhân (PII) nào đến các máy chủ của Google Analytics. Để biết thêm thông tin, vui lòng tham khảo Điều khoản dịch vụ.

Chỉ số tuỳ chỉnh

Mặc dù bạn cần áp dụng cẩn thận thứ nguyên tùy chỉnh cho các lượt truy cập cụ thể và quản lý theo phạm vi, nhưng lượt truy cập được áp dụng chỉ số tùy chỉnh thường sẽ không ảnh hưởng đến báo cáo. Do đó, bạn có thể đặt thứ nguyên này bất cứ khi nào giá trị chỉ số được biết.

Bạn bắt buộc phải sử dụng các trường sau đây để đặt giá trị chỉ số tuỳ chỉnh:

  • NSInteger Chỉ mục – chỉ mục của định nghĩa chỉ số tùy chỉnh.
  • NSNumber Giá trị – giá trị của chỉ số tuỳ chỉnh. Các giá trị có thể là số âm.

Đặt giá trị chỉ số tùy chỉnh

Để đặt giá trị chỉ số tuỳ chỉnh, hãy gọi setCustom:metric: trước một lệnh gọi gửi khác:

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

Hoặc cách đặt chỉ số tùy chỉnh đơn vị tiền tệ:

// Get the tracker.
id tracker = [GAI sharedInstance].defaultTracker;

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params:params];

Cân nhắc khi triển khai

Phần sau đây trình bày các điểm cần cân nhắc khác cần lưu ý khi lập kế hoạch triển khai thứ nguyên hoặc chỉ số tùy chỉnh.

Các giá trị chỉ số tùy chỉnh được tổng hợp trong báo cáo

Giá trị chỉ số tùy chỉnh được tổng hợp trong các báo cáo giống như các chỉ số được xác định trước khác trong Google Analytics. Do đó, bạn sẽ đặt giá trị chỉ số tuỳ chỉnh là 1 để làm tăng tổng giá trị tổng hợp của chỉ số đó trong các báo cáo.

Chỉ số tùy chỉnh và bộ lọc chế độ xem (Hồ sơ)

Mặc dù các giá trị chỉ số tùy chỉnh thường có thể được đặt bất cứ khi nào thuận tiện, nhưng bạn nên tránh đặt giá trị chỉ số tùy chỉnh trên những lượt truy cập có thể bị lọc khỏi chế độ xem (hồ sơ) của bạn. Nếu một lượt truy cập được lọc bằng bộ lọc chế độ xem (hồ sơ), thì mọi giá trị chỉ số tùy chỉnh được liên kết cũng sẽ được lọc. Tìm hiểu thêm về phương diện và chỉ số tuỳ chỉnh cũng như bộ lọc chế độ xem (hồ sơ).