การจ่ายงาน - iOS SDK

เอกสารนี้จะอธิบายวิธีการจัดการข้อมูล การจ่ายไปยัง Google Analytics โดยใช้ Google Analytics SDK สำหรับ iOS v2

ภาพรวม

ใน Google Analytics SDK สำหรับ iOS ข้อมูลที่เก็บรวบรวม เช่น การดูหน้าจอหรือเหตุการณ์ จะจัดเก็บอยู่ในคิวก่อนส่งไปยังเซิร์ฟเวอร์ Google Analytics กระบวนการที่ส่งข้อมูลเหล่านี้ (เรียกว่า "Hit") จาก SDK ไปยัง Google Analytics เรียกว่าการส่ง

การมอบหมายงานเป็นเอกลักษณ์เฉพาะของไลบรารีคอลเล็กชันอุปกรณ์เคลื่อนที่ และออกแบบมาเพื่อลดปัญหาในการเข้าถึงเครือข่ายที่ไม่น่าเชื่อถือและอายุการใช้งานแบตเตอรี่ที่จำกัด

การจ่ายงานมี 2 ประเภท ได้แก่

  • การจ่ายงานเป็นระยะ – ส่ง Hit โดยอัตโนมัติในช่วงเวลาที่เกิดซ้ำตามที่คุณระบุ
  • การจัดส่งด้วยตนเอง - ส่ง Hit ด้วยตนเองเพื่อส่งข้อมูลเมื่อคุณสะดวก เช่น เมื่อมีการเชื่อมต่อ HTTP อยู่

ส่วนที่เหลือของเอกสารนี้จะให้ข้อมูลเชิงลึกเกี่ยวกับการจัดส่งแต่ละประเภทและวิธีติดตั้งใช้งานในแอป

การจ่ายงานตามระยะ

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

ระยะเวลาการจัดส่งเริ่มต้นคือ 2 นาที คุณระบุช่วงเวลาของตนเองเป็นวินาทีได้โดยเรียกใช้ setDispatchPeriod:(NSTimeInterval) ตามตัวอย่างนี้

[[GAI sharedInstance] setDispatchPeriod:60];

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

เมื่อส่ง Hit ทั้งหมดแล้ว การจ่ายงานเป็นระยะจะเข้าสู่โหมดประหยัดพลังงานและถูกปิดใช้จนกว่าจะมีการโทรส่งอีกครั้ง

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

จ่ายงานด้วยตนเอง

อาจมีบางครั้งที่คุณต้องการส่ง Hit ด้วยตนเอง นอกเหนือจากการพึ่งพาการจัดส่งเป็นระยะ เช่น จัดกลุ่มการจ่ายงานกับคำขอ HTTP อื่นๆ ที่แอปพลิเคชันสร้างขึ้นเพื่อลดค่าใช้จ่าย

คุณส่ง Hit ด้วยตนเองได้โดยเรียกใช้ dispatch ตามที่แสดงด้านล่าง

[[GAI sharedTracker] dispatch];