มิติข้อมูลและเมตริกที่กำหนดเอง - 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) เป็นค่า