การอ้างอิงคลาส GAI

ภาพรวม

Google Analytics iOS ระดับบนสุด

มีสิ่งอำนวยความสะดวกในการสร้างตัวติดตามและตั้งค่าสถานะเชิงพฤติกรรม

รับค่า NSObject

เมธอดของอินสแตนซ์

(รหัส< GAITracker >)- trackerWithName:รหัสติดตาม:
 สร้างหรือเรียกการติดตั้งใช้งาน GAITracker ที่มีชื่อและรหัสติดตามที่ระบุ เพิ่มเติม...
 
(รหัส< GAITracker >)- trackerWithTrackingId:
 สร้างหรือดึงการใช้งาน GAITracker ที่มีชื่อเท่ากับรหัสติดตามที่ระบุ เพิ่มเติม...
 
(void) - removeTrackerByName:
 นำอุปกรณ์ติดตามออกจากพจนานุกรมแท็กติดตาม เพิ่มเติม...
 
(void) - dispatch
 ส่งข้อมูลการติดตามที่รอดำเนินการ เพิ่มเติม...
 
(void) - dispatchWithCompletionHandler:
 ส่งบีคอนการติดตามถัดไปในคิว เรียก completeHandler เมื่อมีการส่งบีคอนการติดตาม (ส่งคืน kGAIDispatchGood) หรือเกิดข้อผิดพลาด (แสดง kGAIDispatchError) เพิ่มเติม...
 

วิธีการของชั้นเรียน

(GAI *)+ sharedInstance
 รับอินสแตนซ์ที่แชร์ของคลาส Google Analytics สำหรับ iOS เพิ่มเติม...
 

พร็อพเพอร์ตี้

รหัส< GAITracker >defaultTracker
 คลาสนี้จะแสดงอินสแตนซ์ตัวติดตามเริ่มต้นเพื่อความสะดวก เพิ่มเติม...
 
รหัส< GAILogger >logger
 GAILogger ที่จะใช้ เพิ่มเติม...
 
บูลีนoptOut
 เมื่อเป็นเช่นนี้ จะไม่มีการรวบรวมข้อมูลการติดตาม การติดตามการโทรจะกลายเป็นที่ไม่มีการดำเนินการ เพิ่มเติม...
 
NSTimeIntervaldispatchInterval
 หากค่านี้เป็นบวก ระบบจะส่งข้อมูลการติดตามโดยอัตโนมัติทุกวินาทีของ DispatchInterval เพิ่มเติม...
 
บูลีนtrackUncaughtExceptions
 เมื่อตั้งค่าเป็น "จริง" SDK จะบันทึกตัวแฮนเดิลข้อยกเว้นที่ตรวจไม่พบที่ลงทะเบียนไว้ในปัจจุบัน จากนั้นลงทะเบียนตัวแฮนเดิลข้อยกเว้นที่ตรวจไม่พบซึ่งติดตามข้อยกเว้นที่เกิดขึ้นโดยใช้ defaultTracker เพิ่มเติม...
 
บูลีนdryRun
 หากเป็น "ใช่" จะไม่มีการส่งข้อมูลการติดตาม เพิ่มเติม...
 

เอกสารประกอบของเมธอด

+ (GAI *) sharedInstance

รับอินสแตนซ์ที่แชร์ของคลาส Google Analytics สำหรับ iOS

- (id<GAITracker>) trackerWithName: (NSString *) name
รหัสติดตาม: (NSString *) trackingId

สร้างหรือเรียกการติดตั้งใช้งาน GAITracker ที่มีชื่อและรหัสติดตามที่ระบุ

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

พารามิเตอร์
ชื่อชื่อของตัวติดตามนี้ ต้องไม่เป็น nil หรือว่างเปล่า
trackingIDรหัสติดตามที่จะใช้กับอุปกรณ์ติดตามนี้ ซึ่งควรอยู่ในรูปแบบ UA-xxxxx-y
การคืนสินค้า
GAITracker ที่เชื่อมโยงกับชื่อที่ระบุ เครื่องมือติดตามสามารถใช้เพื่อส่งข้อมูลการติดตามไปยัง Google Analytics ครั้งแรกที่มีการเรียกเมธอดนี้โดยใช้ชื่อหนึ่งๆ ระบบจะแสดงผลเครื่องมือติดตามสําหรับชื่อนั้น และการเรียกครั้งต่อๆ มาที่มีชื่อเดียวกันจะแสดงอินสแตนซ์เดียวกัน คุณไม่จำเป็นต้องเก็บอุปกรณ์ติดตามไว้เนื่องจากไลบรารีจะเก็บรักษาอุปกรณ์ติดตามไว้ภายใน

หากเกิดข้อผิดพลาดหรือชื่อไม่ถูกต้อง เมธอดนี้จะแสดง nil

- (id<GAITracker>) trackerWithTrackingId: (NSString *) trackingId

สร้างหรือดึงการใช้งาน GAITracker ที่มีชื่อเท่ากับรหัสติดตามที่ระบุ

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

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

หากเกิดข้อผิดพลาดหรือรหัสติดตามไม่ถูกต้อง เมธอดนี้จะแสดง nil

- (เป็นโมฆะ) removeTrackerByName: (NSString *) name

นำอุปกรณ์ติดตามออกจากพจนานุกรมแท็กติดตาม

หากเป็นอุปกรณ์ติดตามเริ่มต้น ให้ล้างอุปกรณ์ติดตามเริ่มต้นด้วย

พารามิเตอร์
ชื่อชื่ออุปกรณ์ติดตาม
- การจ่ายงาน (เป็นโมฆะ)

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

โปรดทราบว่าการดำเนินการนี้จะไม่มีผลกับ DispatchInterval และใช้ร่วมกับการจ่ายงานเป็นครั้งคราวได้

- (เป็นโมฆะ) dispatchWithCompletionHandler: (void(^)(ผลลัพธ์ GAIDispatch Results)) completionHandler

ส่งบีคอนการติดตามถัดไปในคิว เรียก completeHandler เมื่อมีการส่งบีคอนการติดตาม (ส่งคืน kGAIDispatchGood) หรือเกิดข้อผิดพลาด (แสดง kGAIDispatchError)

หากไม่มีการเชื่อมต่อเครือข่ายหรือไม่มีข้อมูลที่จะส่ง ระบบจะแสดงผล kGAIDispatchNoData

โปรดทราบว่าการเรียกใช้เมธอดนี้ด้วย non-nil completeHandler จะปิดใช้การจ่ายงานเป็นระยะ คุณเปิดใช้การส่งงานเป็นระยะได้อีกครั้งโดยการตั้งค่า DispatchInterval เป็นตัวเลขจำนวนบวกเมื่อแอปกลับมาทำงานอีกครั้งจากเบื้องหลัง

การเรียกใช้เมธอดนี้ด้วย nil completedHandler จะเหมือนกับการเรียกใช้ Dispatch ด้านบน

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

พารามิเตอร์
completionHandlerการบล็อกที่จะทำงานหลังจากคำขอส่งสินค้ารายการเดียว พารามิเตอร์ GAIDispatch Results ระบุว่าการส่งงานสำเร็จ มีข้อผิดพลาด หรือไม่มี Hit ที่จะส่ง

เอกสารประกอบเกี่ยวกับอสังหาริมทรัพย์

- (id<GAITracker>) defaultTracker
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด)

คลาสนี้จะแสดงอินสแตนซ์ตัวติดตามเริ่มต้นเพื่อความสะดวก

โดยกำหนดค่าเริ่มต้นเป็น nil และจะตั้งค่าเป็นเครื่องมือติดตามแรกที่อินสแตนซ์ใน trackerWithTrackingId: ซึ่งอาจมีการลบล้างตามต้องการ

โดยค่าเริ่มต้น คลาส GAITrackedViewController จะใช้อินสแตนซ์เครื่องมือติดตามนี้

- ตัวบันทึก (id<GAILogger>)
(อ่านและเขียน ไม่ใช้อะตอม เก็บรักษา)

GAILogger ที่จะใช้

- เลือกไม่ใช้ (BOOL)
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด)

เมื่อเป็นเช่นนี้ จะไม่มีการรวบรวมข้อมูลการติดตาม การติดตามการโทรจะกลายเป็นที่ไม่มีการดำเนินการ

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

ค่านี้จะเป็น NO ครั้งแรกที่ใช้ Google Analytics SDK ในอุปกรณ์ และจะคงค่าไว้หลังจากนั้น

- (NSTimeInterval) ช่วงการจ่ายงาน
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด)

หากค่านี้เป็นบวก ระบบจะส่งข้อมูลการติดตามโดยอัตโนมัติทุกวินาทีของ DispatchInterval

ไม่เช่นนั้น คุณต้องส่งข้อมูลการติดตามด้วยตนเองโดยการโทรหาสายงาน

โดยค่าเริ่มต้น ระบบจะตั้งค่าเป็น 120 ซึ่งบ่งชี้ว่าควรส่งข้อมูลการติดตามโดยอัตโนมัติทุก 120 วินาที

- (BOOL) trackUncaughtException
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด)

เมื่อตั้งค่าเป็น "จริง" SDK จะบันทึกตัวแฮนเดิลข้อยกเว้นที่ตรวจไม่พบที่ลงทะเบียนไว้ในปัจจุบัน จากนั้นลงทะเบียนตัวแฮนเดิลข้อยกเว้นที่ตรวจไม่พบซึ่งติดตามข้อยกเว้นที่เกิดขึ้นโดยใช้ defaultTracker

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

- (BOOL) ทดลองเรียกใช้
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด)

หากเป็น "ใช่" จะไม่มีการส่งข้อมูลการติดตาม

ค่าเริ่มต้นคือ "NO"