มิติข้อมูลและเมตริกที่กําหนดเอง - iOS SDK

คู่มือนักพัฒนาซอฟต์แวร์นี้อธิบายวิธีนํามิติข้อมูลและเมตริกที่กําหนดเองไปใช้โดยใช้ Google Analytics SDK สําหรับ iOS v3

ภาพรวม

มิติข้อมูลที่กําหนดเองช่วยให้เชื่อมโยงข้อมูลเมตากับ Hit ผู้ใช้ และเซสชันใน Google Analytics ได้ ขณะที่เมตริกที่กําหนดเองช่วยให้คุณสร้างและเพิ่มเมตริกของคุณเองใน Google Analytics ได้

  1. กําหนดค่ามิติข้อมูลหรือเมตริกที่กําหนดเองโดยใช้อินเทอร์เฟซเว็บของ Google Analytics ดูวิธีกําหนดค่ามิติข้อมูลหรือเมตริกที่กําหนดเอง (ศูนย์ช่วยเหลือ)
  2. ตั้งค่าและส่งค่ามิติข้อมูลและเมตริกที่กําหนดเองจากแอป

มิติข้อมูลและเมตริกที่กําหนดเองประกอบด้วย 2 ช่อง ดังนี้

  • NSNumber ดัชนี – ดัชนีของมิติข้อมูลหรือเมตริกที่กําหนดเอง ดัชนีนี้เป็นแบบ 1
  • NSString ค่า – ค่าของมิติข้อมูลหรือเมตริกที่กําหนดเอง หากเป็นเมตริก ระบบจะแยกวิเคราะห์เป็นจํานวนเต็มหรือค่าทศนิยมของจุดคงที่ หากมีการกําหนดค่าเมตริกเป็นประเภทสกุลเงิน

การตั้งค่าและส่งค่า

หากต้องการตั้งค่าและส่งค่ามิติข้อมูลที่กําหนดเอง ให้ทําดังนี้

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

คุณสามารถส่งค่ามิติข้อมูลที่กําหนดเองกับประเภท Hit ของ Google Analytics ได้ ซึ่งรวมถึงการดูหน้าจอ เหตุการณ์ ธุรกรรมอีคอมเมิร์ซ ระยะเวลาของผู้ใช้ และการโต้ตอบในโซเชียล ขอบเขตที่กําหนดของมิติข้อมูลที่กําหนดเองจะเป็นตัวกําหนดเวลาประมวลผลซึ่ง Hit ทั้งหมดเชื่อมโยงกับค่ามิติข้อมูล

หากต้องการตั้งค่าและส่งค่าเมตริกที่กําหนดเอง ให้ทําดังนี้

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

ข้อควรพิจารณาในการติดตั้งใช้งาน

ส่วนนี้จะอธิบายข้อควรพิจารณาเพิ่มเติมเมื่อใช้ มิติข้อมูลหรือเมตริกที่กําหนดเอง

ข้อควรพิจารณาสําหรับมิติข้อมูลที่กําหนดเอง

ค่าที่มีขอบเขตระดับผู้ใช้และเซสชันจะมีผลกับ Hit ที่ผ่านมา

  • ค่ามิติข้อมูลที่กําหนดเองที่มีขอบเขตระดับผู้ใช้หรือเซสชันจะมีผลกับ Hit ทั้งหมดในเซสชันปัจจุบัน รวมถึง Hit ที่ผ่านมา หากคุณไม่ต้องการให้ใช้ค่ามิติข้อมูลที่กําหนดเองที่มีขอบเขตระดับเซสชันหรือระดับผู้ใช้ ที่ใช้กับ Hit ที่ผ่านมาในเซสชันปัจจุบัน ให้เริ่มต้นเซสชันใหม่ ก่อนที่จะใช้ค่ากับ Hit
  • ตัวอย่างเช่น หากคุณใช้ประเภทการเป็นสมาชิกเป็นมิติข้อมูลที่กําหนดเองระดับผู้ใช้ และผู้ใช้อัปเกรดการเป็นสมาชิกในกลางเซสชัน คุณอาจต้องการเริ่มต้นเซสชันใหม่ก่อนที่จะตั้งค่ามิติข้อมูลที่กําหนดเองใหม่ การดําเนินการนี้จะทําให้ Hit ก่อนการอัปเกรดจะเชื่อมโยงกับค่าสมาชิกเดิม ขณะที่ Hit ใหม่จะเชื่อมโยงกับค่าใหม่

ตัวกรองมิติข้อมูลและมุมมอง (โปรไฟล์) ที่กําหนดเอง

  • ค่ามิติข้อมูลที่กําหนดเองระดับผู้ใช้หรือระดับเซสชันจะยังคงมีผลกับ Hit ทั้งหมดในเซสชันปัจจุบันและ/หรืออนาคต แม้ว่า Hit ที่ส่งด้วยจะถูกกรองออกจากข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ก็ตาม
  • เมื่อกรองค่ามิติข้อมูลที่กําหนดเอง ระบบจะกรอง Hit ตามขอบเขตของค่ามิติข้อมูลที่กําหนดเองนั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ตัวกรองและค่ามิติข้อมูลที่กําหนดเองโต้ตอบเมื่อประมวลผลข้อมูล

ข้อควรพิจารณาสําหรับเมตริกที่กําหนดเอง

ค่าเมตริกที่กําหนดเองจะรวมอยู่ในรายงาน

  • ค่าเมตริกที่กําหนดเองจะรวมอยู่ในรายงานเช่นเดียวกับเมตริกอื่นๆ ที่กําหนดไว้ล่วงหน้าใน Google Analytics ด้วยเหตุนี้ คุณควรกําหนดค่าเมตริกที่กําหนดเองเป็น 1 เพื่อเพิ่มผลรวมของเมตริกในรายงาน

ตัวกรองเมตริกที่กําหนดเองและตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)

การตั้งค่าด้วยการวัดหน้าจออัตโนมัติ

  • หากต้องการใช้ค่ามิติข้อมูลที่กําหนดเองกับการดูหน้าจอที่ส่งผ่านการวัดหน้าจออัตโนมัติ ให้ตั้งค่าระหว่างเมธอด viewDidAppear: ของตัวควบคุมมุมมอง ตัวอย่างเช่น ไฟล์ .m ของตัวควบคุมการดูอาจมีลักษณะดังนี้
#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.

ไม่ส่งข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) เป็นค่า