คู่มือนักพัฒนาซอฟต์แวร์นี้จะอธิบายวิธีติดตั้งใช้งานมิติข้อมูลและเมตริกที่กำหนดเองโดยใช้ 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 ดูข้อมูลเพิ่มเติมได้ในข้อกำหนดในการให้บริการ