เอกสารนี้จะอธิบายวิธีการจัดการข้อมูล การส่งไปยัง Google Analytics โดยใช้ Google Analytics SDK สำหรับ Android เวอร์ชัน 2
ภาพรวม
ใน Google Analytics SDK สำหรับ Android ข้อมูลที่เก็บรวบรวม เช่น การดูหน้าจอหรือเหตุการณ์ จะได้รับการจัดเก็บไว้ในคิวก่อนส่งไปยังเซิร์ฟเวอร์ Google Analytics กระบวนการที่ส่งข้อมูลเหล่านี้ (เรียกว่า "Hit") จาก SDK ไปยัง Google Analytics เรียกว่าการส่ง
การมอบหมายงานเป็นเอกลักษณ์เฉพาะของไลบรารีคอลเล็กชันอุปกรณ์เคลื่อนที่ และออกแบบมาเพื่อลดปัญหาในการเข้าถึงเครือข่ายที่ไม่น่าเชื่อถือและอายุการใช้งานแบตเตอรี่ที่จำกัด
การจ่ายงานมี 2 ประเภท ได้แก่
- การส่งเป็นระยะ – ส่ง Hit โดยอัตโนมัติในช่วงเวลาที่เกิดซ้ำตามที่คุณระบุ ไม่ว่าจะเป็นแบบเป็นโปรแกรมหรือในไฟล์
analytics.xml - การจัดส่งด้วยตนเอง - ส่ง Hit ด้วยตนเองเพื่อส่งข้อมูลเมื่อคุณสะดวก เช่น เมื่อมีการเชื่อมต่อ HTTP อยู่
การส่งทั้ง 2 ประเภทเกิดขึ้นนอกเทรด UI หลักใน SDK เวอร์ชัน 2
ส่วนที่เหลือของเอกสารนี้จะให้ข้อมูลเชิงลึกเกี่ยวกับการจัดส่งแต่ละประเภทและวิธีติดตั้งใช้งานในแอป
การจ่ายงานตามระยะ
เมื่อแอปรวบรวมข้อมูล GA ระบบจะเพิ่มข้อมูลดังกล่าวลงในคิวและส่งไปยัง Google Analytics เป็นระยะ การส่งเป็นครั้งคราวอาจเกิดขึ้นเมื่อแอปทำงานอยู่ในเบื้องหน้าหรือเบื้องหลัง
ระยะเวลาการจัดส่งเริ่มต้นคือ 30 นาที
คุณสามารถระบุช่วงเวลาของคุณเองเป็นวินาทีได้โดยใช้พารามิเตอร์ ga_dispatchPeriod ในไฟล์ analytics.xml หรือโดยเรียกใช้ setDispatchPeriod(int dispatchPeriodInSeconds) ตามตัวอย่างนี้
ในไฟล์ analytics.xml
<integer name="ga_dispatchPeriod">60</integer>
เขียนโปรแกรม:
GAServiceManager.getInstance().setDispatchPeriod(60);
การตั้งค่าติดลบจะปิดใช้การจัดส่งตามระยะเวลา ซึ่งกำหนดให้คุณต้องใช้การจัดส่งด้วยตนเองหากต้องการส่งข้อมูลไปยัง Google Analytics ในทางกลับกัน การตั้งค่า 0 จะจ่ายแต่ละ Hit ทันทีหากมีการเชื่อมต่อเครือข่าย
เมื่อส่ง Hit ทั้งหมดแล้ว การจ่ายงานเป็นระยะจะเข้าสู่โหมดประหยัดพลังงานและถูกปิดใช้จนกว่าจะมีการโทรส่งอีกครั้ง
หากผู้ใช้สูญเสียสิทธิ์เข้าถึงเครือข่ายหรือออกจากแอปในขณะที่ยังมี Hit ที่รอการส่งอยู่ Hit เหล่านั้นจะยังคงอยู่ในพื้นที่เก็บข้อมูลในเครื่อง เราจะจัดส่งอุปกรณ์ให้คุณในครั้งต่อไปที่แอปทำงานและมีการเรียกการจัดส่ง
จ่ายงานด้วยตนเอง
อาจมีบางครั้งที่คุณต้องการส่ง Hit ด้วยตนเอง นอกเหนือจากการพึ่งพาการจัดส่งเป็นระยะ เช่น จัดกลุ่มการจ่ายงานกับคำขอ HTTP อื่นๆ ที่แอปพลิเคชันสร้างขึ้นเพื่อลดค่าใช้จ่าย
คุณจะส่ง Hit ด้วยตนเองได้โดยใช้อินสแตนซ์ GAServiceManager ดังนี้
GAServiceManager.getInstance().dispatch();