คู่มือนักพัฒนาซอฟต์แวร์นี้อธิบายวิธีนํามิติข้อมูลและเมตริกที่กําหนดเองไปใช้โดยใช้ Google Analytics SDK สําหรับ iOS v3
ภาพรวม
มิติข้อมูลที่กําหนดเองช่วยให้เชื่อมโยงข้อมูลเมตากับ Hit ผู้ใช้ และเซสชันใน Google Analytics ได้ ขณะที่เมตริกที่กําหนดเองช่วยให้คุณสร้างและเพิ่มเมตริกของคุณเองใน Google Analytics ได้
- กําหนดค่ามิติข้อมูลหรือเมตริกที่กําหนดเองโดยใช้อินเทอร์เฟซเว็บของ Google Analytics ดูวิธีกําหนดค่ามิติข้อมูลหรือเมตริกที่กําหนดเอง (ศูนย์ช่วยเหลือ)
- ตั้งค่าและส่งค่ามิติข้อมูลและเมตริกที่กําหนดเองจากแอป
มิติข้อมูลและเมตริกที่กําหนดเองประกอบด้วย 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
เพื่อเพิ่มผลรวมของเมตริกในรายงาน
ตัวกรองเมตริกที่กําหนดเองและตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
- โดยปกติคุณจะตั้งค่าเมตริกที่กําหนดเองได้เมื่อใดก็ตามที่สะดวก แต่ให้หลีกเลี่ยงการตั้งค่าเมตริกที่กําหนดเองใน Hit ที่มีแนวโน้มว่าจะถูกกรองออกจากข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) หาก Hit ได้รับการกรองโดยตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ระบบจะกรองค่าเมตริกที่กําหนดเองที่เชื่อมโยงด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับมิติข้อมูลและเมตริกที่กําหนดเอง รวมถึงตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
การตั้งค่าด้วยการวัดหน้าจออัตโนมัติ
- หากต้องการใช้ค่ามิติข้อมูลที่กําหนดเองกับการดูหน้าจอที่ส่งผ่านการวัดหน้าจออัตโนมัติ ให้ตั้งค่าระหว่างเมธอด
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) เป็นค่า
- ข้อกําหนดในการให้บริการของ Google Analytics ไม่อนุญาตให้ส่งข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) ไปยังเซิร์ฟเวอร์ของ Google Analytics ดูข้อมูลเพิ่มเติมได้ในข้อกําหนดในการให้บริการ