ภาพรวม
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 |
เมื่อเป็นเช่นนี้ จะไม่มีการรวบรวมข้อมูลการติดตาม การติดตามการโทรจะกลายเป็นที่ไม่มีการดำเนินการ เพิ่มเติม... | |
NSTimeInterval | dispatchInterval |
หากค่านี้เป็นบวก ระบบจะส่งข้อมูลการติดตามโดยอัตโนมัติทุกวินาทีของ 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 ที่จะส่ง
เอกสารประกอบเกี่ยวกับอสังหาริมทรัพย์
|
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด) |
คลาสนี้จะแสดงอินสแตนซ์ตัวติดตามเริ่มต้นเพื่อความสะดวก
โดยกำหนดค่าเริ่มต้นเป็น nil
และจะตั้งค่าเป็นเครื่องมือติดตามแรกที่อินสแตนซ์ใน trackerWithTrackingId: ซึ่งอาจมีการลบล้างตามต้องการ
โดยค่าเริ่มต้น คลาส GAITrackedViewController จะใช้อินสแตนซ์เครื่องมือติดตามนี้
|
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด) |
เมื่อเป็นเช่นนี้ จะไม่มีการรวบรวมข้อมูลการติดตาม การติดตามการโทรจะกลายเป็นที่ไม่มีการดำเนินการ
เมื่อตั้งค่าเป็น "จริง" ระบบจะลบข้อมูลทั้งหมดที่อยู่ระหว่างรอการอัปโหลด SDK จะยืนยันค่าของแฟล็กนี้โดยอัตโนมัติ นักพัฒนาซอฟต์แวร์สามารถใช้ Flag นี้เพื่อนำการตั้งค่าการเลือกไม่ใช้ในแอปไปใช้เพื่ออนุญาตให้ผู้ใช้เลือกไม่ใช้การติดตามของ Google Analytics ได้
ค่านี้จะเป็น NO
ครั้งแรกที่ใช้ Google Analytics SDK ในอุปกรณ์ และจะคงค่าไว้หลังจากนั้น
|
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด) |
หากค่านี้เป็นบวก ระบบจะส่งข้อมูลการติดตามโดยอัตโนมัติทุกวินาทีของ DispatchInterval
ไม่เช่นนั้น คุณต้องส่งข้อมูลการติดตามด้วยตนเองโดยการโทรหาสายงาน
โดยค่าเริ่มต้น ระบบจะตั้งค่าเป็น 120
ซึ่งบ่งชี้ว่าควรส่งข้อมูลการติดตามโดยอัตโนมัติทุก 120 วินาที
|
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด) |
เมื่อตั้งค่าเป็น "จริง" SDK จะบันทึกตัวแฮนเดิลข้อยกเว้นที่ตรวจไม่พบที่ลงทะเบียนไว้ในปัจจุบัน จากนั้นลงทะเบียนตัวแฮนเดิลข้อยกเว้นที่ตรวจไม่พบซึ่งติดตามข้อยกเว้นที่เกิดขึ้นโดยใช้ defaultTracker
หาก defaultTracker ไม่ใช่ nil
ฟังก์ชันนี้จะติดตามข้อยกเว้นในอุปกรณ์ติดตามและพยายามส่งข้อมูลการติดตามที่ค้างอยู่เป็นเวลา 5 วินาที จากนั้นจะเรียกใช้เครื่องจัดการข้อยกเว้นที่ลงทะเบียนก่อนหน้านี้ หากมี เมื่อกำหนดกลับไปเป็น "เท็จ" ระบบจะคืนค่าตัวแฮนเดิลข้อยกเว้นที่ไม่ถูกตรวจจับซึ่งลงทะเบียนไว้ก่อนหน้านี้
|
(อ่านและเขียน, ไม่ใช่อะตอม, กำหนด) |
หากเป็น "ใช่" จะไม่มีการส่งข้อมูลการติดตาม
ค่าเริ่มต้นคือ "NO"