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 3.

Tổng quan

Thứ nguyên tùy chỉnh cho phép liên kết siêu dữ liệu với lượt truy cập, người dùng và phiên trong Google Analytics, trong khi chỉ số tùy chỉnh cho phép bạn tạo và tăng các chỉ số của riêng bạn trong Google Analytics.

  1. Định cấu hì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ìm hiểu cách thiết lập một phương diện hoặc chỉ số tuỳ chỉnh (Trung tâm trợ giúp).
  2. Đặt và gửi giá trị thứ nguyên và chỉ số tùy chỉnh từ một ứng dụng.

Thứ nguyên và chỉ số tùy chỉnh bao gồm hai trường:

  • NSNumber Chỉ mục – chỉ mục của phương diện hoặc chỉ số tuỳ chỉnh. Chỉ mục này dựa trên 1.
  • NSString Giá trị – giá trị của phương diện hoặc chỉ số tuỳ chỉnh. Trong trường hợp này, chỉ số sẽ được phân tích cú pháp dưới dạng số nguyên hoặc giá trị thập phân dạng điểm cố định nếu chỉ số được định cấu hình thành một loại đơn vị tiền tệ.

Cài đặt và gửi giá trị

Cách đặt và gửi một giá trị phương diện tuỳ chỉnh:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] build]];

Bạn có thể gửi giá trị thứ nguyên tùy chỉnh cùng với bất kỳ loại lượt truy cập Google Analytics nào, bao gồm 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. Phạm vi đã xác định của thứ nguyên tùy chỉnh sẽ xác định lượt truy cập được liên kết với giá trị thứ nguyên tại thời điểm xử lý.

Cách đặt và gửi một giá trị chỉ số tuỳ chỉnh:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

Cân nhắc khi triển khai

Phần này trình bày các yếu tố khác cần cân nhắc khi triển khai phương diện hoặc chỉ số tuỳ chỉnh.

Những điểm cần lưu ý về phương diện tuỳ chỉnh

Giá trị có phạm vi cấp người dùng và cấp phiên hoạt động áp dụng cho lượt truy cập trước đây

  • 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 hoạt động 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 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, thì bạn nên bắt đầu một phiên hoạt động mới trước khi đặt giá trị phương diệ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 sẽ vẫn đượ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 mà chúng được gửi cùng bị lọc khỏi 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ị phương diện tuỳ chỉnh tương tác khi dữ liệu của bạn được xử lý.

Những điểm cần lưu ý về chỉ số tuỳ 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 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 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 bỏ 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ơ).

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

  • Để áp dụng giá trị phương diện tuỳ chỉnh cho một 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 trình đ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<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [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ị