การกำหนดค่าขั้นสูง - iOS SDK

เอกสารนี้จะอธิบายฟีเจอร์การกำหนดค่าขั้นสูงบางอย่างของ Google Analytics SDK สำหรับ iOS v2

ภาพรวม

Google Analytics SDK สำหรับ iOS ใช้ 2 คลาสในการจัดการสถานะส่วนกลางของการติดตั้งใช้งานและส่งข้อมูลไปยังเซิร์ฟเวอร์ Google Analytics

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

การใช้ตัวติดตามหลายอย่าง

ตั้งแต่ SDK เวอร์ชัน 2 คุณสามารถใช้เครื่องมือติดตามหลายตัวในการติดตั้งใช้งานเพียงครั้งเดียว โดยสามารถใช้ 1 ตัวต่อรหัสติดตามที่ไม่ซ้ำกัน อุปกรณ์ติดตามทั้งหมดอยู่ในรัฐเดียวกัน ที่ครอบครองโดยซิงเกิล GAI

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

#import "RootViewController.h"
#import "GAI.h"

@interface RootViewController ()

@end

@implementation RootViewController
{
- (void)viewDidLoad {
  [super viewDidLoad];

  // Send a screen view to the first property.
  id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];
  [tracker1 sendView:@"/HomeScreen"];

  // Send another screen view to the second property.
  id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"];
  [tracker2 sendView:@"Home"];
}

@end

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

การวัดหน้าจออัตโนมัติจะใช้อุปกรณ์ติดตามที่ระบุไว้ในพร็อพเพอร์ตี้ tracker ของ GAITrackedViewController ที่กำหนดเพื่อใช้อ้างอิง การวัดข้อยกเว้นที่ตรวจไม่พบจะใช้เครื่องมือติดตามเริ่มต้นที่ระบุไว้ในอินสแตนซ์ GAI

เครื่องมือติดตามเริ่มต้น

แม้ว่าการติดตั้งใช้งานอาจใช้อุปกรณ์ติดตามหลายอย่าง แต่ทั่วโลกจะมีอุปกรณ์ติดตามเริ่มต้นเพียงรายการเดียว Tracker แรกที่ดึงมาจะกลายเป็นเครื่องมือติดตามเริ่มต้น

หากต้องการใช้ตัวติดตามเริ่มต้น ให้ใช้

// Get default tracker.
id myDefault = [GAI sharedInstance].defaultTracker;

หากต้องการตั้งค่าตัวติดตามเริ่มต้น ให้ใช้

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

ทดสอบผลิตภัณฑ์

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

ตัวอย่างเช่น หากต้องการใช้การสุ่มตัวอย่างฝั่งไคลเอ็นต์ในอัตรา 50% ให้ใช้โค้ดต่อไปนี้

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

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

การเลือกไม่ใช้ระดับแอป

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

หากต้องการรับการตั้งค่าการเลือกไม่ใช้ระดับแอป ให้ใช้

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

หากต้องการตั้งค่าสถานะการเลือกไม่ใช้ระดับแอป ให้ใช้


// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

การทดสอบและการแก้ไขข้อบกพร่อง

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

// Enable debug mode.
[GAI sharedInstance].debug = YES;