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

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

ภาพรวม

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

การติดตั้งมิติข้อมูลหรือเมตริกที่กำหนดเองมี 2 ขั้นตอนหลักๆ ดังนี้

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

ส่วนที่เหลือของบทความนี้จะอธิบายวิธีติดตั้งโค้ดเพื่อตั้งค่าและส่งค่ามิติข้อมูลหรือเมตริกที่กำหนดเองไปยัง Google Analytics

มิติข้อมูลที่กำหนดเอง

ค่ามิติข้อมูลที่กำหนดเองสามารถกำหนดให้กับ Hit ทุกประเภทของ Google Analytics ตั้งค่ามิติข้อมูลที่กำหนดเองก่อนการเรียกใช้ "ส่ง" ซึ่งคุณต้องการใช้ค่า

ขอบเขตของมิติข้อมูลที่กำหนดเองที่กำหนดไว้จะเป็นตัวกำหนดว่า Hit เพิ่มเติมใดอาจเชื่อมโยงกับค่านั้นขณะประมวลผล

ต้องระบุข้อมูลในช่องเหล่านี้เพื่อตั้งค่ามิติข้อมูลที่กำหนดเอง

  • NSNumber ดัชนี – ดัชนีของคำจำกัดความมิติข้อมูลที่กำหนดเอง ดัชนีนี้เป็นแบบ 1
  • NSString Value – ค่าของมิติข้อมูลที่กำหนดเอง

การตั้งค่ามิติข้อมูลที่กำหนดเอง

หากต้องการตั้งค่ามิติข้อมูลที่กำหนดเอง ให้เรียกใช้ 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];

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

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

ขอบเขตระดับเซสชันและระดับผู้ใช้จะแตกต่างกันไป

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

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

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

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

เมื่อกรองค่ามิติข้อมูลที่กำหนดเอง Hit จะถูกกรองตามขอบเขตของค่ามิติข้อมูลที่กำหนดเองนั้น

ดูข้อมูลเพิ่มเติมว่าตัวกรองและค่ามิติข้อมูลที่กำหนดเองทำงานร่วมกันอย่างไรเมื่อประมวลผลข้อมูล

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

หากต้องการใช้ค่ามิติข้อมูลที่กำหนดเองกับมุมมองหน้าจอที่ส่งผ่านการวัดหน้าจออัตโนมัติ ให้กำหนดค่าระหว่างเมธอด 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.

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

ข้อกำหนดในการให้บริการของ Google Analytics ไม่อนุญาตให้ส่งข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) ใดๆ ไปยังเซิร์ฟเวอร์ Google Analytics ดูข้อมูลเพิ่มเติมได้ในข้อกำหนดในการให้บริการ

เมตริกที่กำหนดเอง

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

ต้องกรอกข้อมูลในช่องเหล่านี้เพื่อตั้งค่าเมตริกที่กำหนดเอง

  • NSInteger ดัชนี – ดัชนีของคำจำกัดความเมตริกที่กำหนดเอง
  • NSNumber ค่า – ค่าของเมตริกที่กำหนดเอง ค่าอาจเป็นลบ

การตั้งค่าเมตริกที่กำหนดเอง

หากต้องการกำหนดค่าเมตริกที่กำหนดเอง ให้เรียก setCustom:metric: ก่อน การเรียกส่งรายการอื่น:

// 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 เพื่อเพิ่มยอดรวมของเมตริกในรายงาน

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

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