自定义维度和指标 - iOS SDK

本开发者指南将介绍如何使用 iOS 版 Google Analytics（分析）SDK v2 来实现自定义维度和指标。

概览

如果您使用 iOS 版 Google Analytics（分析）SDK 设置自定义维度或指标值，该值将作为参数随分派的下一个命中一起发送。这些值可应用于任何 Google Analytics（分析）命中类型，包括屏幕浏览、事件、电子商务交易、用户计时和社交互动。

实现自定义维度或指标有两个主要步骤：

使用 Google Analytics（分析）网页界面定义自定义维度或指标。
在网页界面的“媒体资源设置”部分中设置自定义维度或指标的索引、名称和范围。
了解如何定义自定义维度或指标。
实现代码以设置和收集自定义维度和指标值。
将代码添加到您的应用中，以按照您在上一步中定义的索引为您的 Google Analytics（分析）命中设置自定义维度或指标值。

本文的其余部分将介绍如何实现代码，以设置自定义维度或指标值并将其发送到 Google Analytics（分析）。

自定义维度

您可以针对所有 Google Analytics（分析）命中类型设置自定义维度值。在要应用该值的 send 调用之前，设置一个自定义维度值。

自定义维度的范围定义将在处理时决定还有哪些额外的命中可能与该值相关联。

要设置自定义维度值，必须填写以下字段：

NSNumber Index - 自定义维度定义的索引。此索引值以 1 起始。
NSString Value – 自定义维度的值。

设置自定义维度值

要设置自定义维度值，请在要与该值关联的 send 调用之前调用 setCustom:dimension:：

// 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];

实现方面的注意事项

本部分介绍了在实现自定义维度时需要注意的其他事项。

用户级和会话级范围是贪心的

范围为用户级或会话级的自定义维度值将会应用于当前会话的所有命中，包括之前的命中。如果您不希望范围为用户级或会话级的自定义维度值应用到当前会话中之前的命中，请在向命中应用该值之前开始一个新会话。

例如，如果您使用“成员资格类型”作为用户级自定义维度，而用户在会话过程中升级了其成员资格，您可能需要在设置新的自定义维度值之前启动一个新会话。这可确保升级之前的命中与旧的成员资格值相关联，而新的命中将与新值相关联。

自定义维度和数据视图（配置文件）过滤器

即使一起发送的命中从数据视图（配置文件）中滤除，用户级或会话级自定义维度值仍将应用于当前和/或未来会话中的所有命中。

如果根据自定义维度值进行过滤，则系统会根据该自定义维度值的范围来过滤命中。

详细了解过滤条件和自定义维度值如何在处理您的数据时相互影响。

在使用自动屏幕衡量的情况下设置值

若要将自定义维度值应用于通过自动屏幕衡量发送的屏幕浏览，请在视图控制器的 viewDidAppear: 方法执行期间设置该值。例如，您的视图控制器的 .m 文件可能如下所示：

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

请勿在值中发送任何个人身份信息

Google Analytics（分析）服务条款禁止向 Google Analytics（分析）服务器发送任何个人身份信息 (PII)。如需了解详情，请参阅服务条款。

自定义指标

虽然自定义维度需要谨慎地应用于特定命中并在范围内进行管理，但应用自定义指标的命中通常不会影响报告，因此，只要指标值已知，您就可以设置自定义维度。

要设置自定义指标值，必须填写以下字段：

NSIntegerIndex - 自定义指标定义的索引。
NSNumber 值 - 自定义指标的值。值可以为负数。

设置自定义指标值

如需设置自定义指标值，请先调用 setCustom:metric:，然后再进行另一个 send 调用：

// 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];

或者，要设置货币自定义指标，请执行以下操作：

// 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];

实现方面的注意事项

以下部分概述了在规划自定义维度或指标实现时需要注意的其他事项。

自定义指标值会在报告中汇总

与 Google Analytics（分析）中的其他预定义指标一样，自定义指标值会在报告中汇总。因此，您需要设置一个自定义指标值 1，以增加报告中的指标汇总值。

自定义指标和数据视图（配置文件）过滤器

尽管自定义指标值一般可以视情况随时设置，但还是请避免为可能从数据视图（配置文件）中滤除的命中设置自定义指标值。如果某次命中被数据视图（配置文件）过滤器所滤除，所有关联的自定义指标值也将被滤除。详细了解自定义维度和指标以及数据视图（配置文件）过滤器。