คู่มือนักพัฒนาซอฟต์แวร์นี้จะอธิบายวิธีใช้ Google Analytics SDK v4 สำหรับ Android เพื่อติดตั้งใช้งานมิติข้อมูลและเมตริกที่กำหนดเอง
ภาพรวม
โดยคุณจะทำสิ่งต่อไปนี้ได้
- ใช้เว็บอินเทอร์เฟซของ Google Analytics เพื่อกำหนดค่ามิติข้อมูลหรือเมตริกที่กำหนดเอง ดูวิธีกำหนดค่ามิติข้อมูลหรือเมตริกที่กำหนดเอง (ศูนย์ช่วยเหลือ)
- ตั้งค่าและส่งค่ามิติข้อมูลและเมตริกที่กําหนดเองจากแอป
มิติข้อมูลและเมตริกที่กำหนดเองประกอบด้วย 2 ช่อง ดังนี้
ชื่อช่อง | ประเภท | คำอธิบาย |
---|---|---|
ดัชนี | Integer |
ดัชนีของมิติข้อมูลหรือเมตริกที่กําหนดเอง ดัชนีนี้เป็นแบบ 1 |
ค่า | String |
ค่าของมิติข้อมูลหรือเมตริกที่กําหนดเอง ในกรณีนี้ ระบบจะแยกวิเคราะห์เมตริกเป็นจำนวนเต็มหรือค่าทศนิยมแบบมีจุดคงที่ หากมีการกำหนดค่าเมตริกเป็นประเภทสกุลเงิน |
การตั้งค่าและส่งค่า
วิธีตั้งค่าและส่งค่ามิติข้อมูลที่กําหนดเอง
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomDimension(1, "premiumUser") .build() );
คุณจะส่งค่ามิติข้อมูลที่กำหนดเองพร้อมกับ Hit ประเภทใดก็ได้ของ Google Analytics ซึ่งรวมถึงการดูหน้าจอ เหตุการณ์ ธุรกรรมอีคอมเมิร์ซ ระยะเวลาของผู้ใช้ และการโต้ตอบทางโซเชียล ขอบเขตของมิติข้อมูลที่กำหนดเองที่กําหนดไว้จะเป็นตัวกำหนด Hit ที่เชื่อมโยงกับค่ามิติข้อมูลขณะประมวลผล
วิธีตั้งค่าและส่งค่าเมตริกที่กําหนดเอง
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomMetric(1, 5) .build() );
ดูรายละเอียดเกี่ยวกับเมธอด getTracker
ได้ที่
การกำหนดค่าขั้นสูง
ข้อควรพิจารณาในการติดตั้งใช้งาน
ส่วนนี้จะอธิบายข้อควรพิจารณาเพิ่มเติมที่ควรคำนึงถึงเมื่อติดตั้งใช้งานมิติข้อมูลหรือเมตริกที่กำหนดเอง
ข้อควรพิจารณาสำหรับมิติข้อมูลที่กำหนดเอง
ค่าที่มีขอบเขตระดับผู้ใช้และระดับเซสชันจะใช้กับ Hit ที่ผ่านมา
- ค่ามิติข้อมูลที่กำหนดเองที่มีขอบเขตระดับผู้ใช้หรือเซสชันจะมีผลกับ Hit ทั้งหมดในเซสชันปัจจุบัน รวมถึง Hit ที่ผ่านมา หากไม่ต้องการให้ใช้ค่ามิติข้อมูลที่กำหนดเองที่มีขอบเขตระดับเซสชันหรือระดับผู้ใช้กับ Hit ที่ผ่านมาในเซสชันปัจจุบัน ให้เริ่มเซสชันใหม่ก่อนนำค่าไปใช้กับ Hit
- เช่น หากคุณใช้ประเภทการเป็นสมาชิกเป็นมิติข้อมูลที่กำหนดเองระดับผู้ใช้ และผู้ใช้อัปเกรดการเป็นสมาชิกในระหว่างเซสชัน คุณอาจต้องเริ่มเซสชันใหม่ก่อนที่จะตั้งค่ามิติข้อมูลที่กำหนดเองใหม่ เพื่อให้แน่ใจว่า Hit ก่อนการอัปเกรดจะเชื่อมโยงกับค่าการเป็นสมาชิกเดิม ขณะที่ Hit ใหม่จะเชื่อมโยงกับค่าใหม่
มิติข้อมูลและตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่กำหนดเอง
- ค่ามิติข้อมูลที่กำหนดเองระดับผู้ใช้หรือระดับเซสชันจะยังคงมีผลกับ Hit ทั้งหมดในเซสชันปัจจุบันและ/หรือในอนาคต แม้ว่า Hit ที่ส่งด้วยจะถูกกรองออกจากข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
- เมื่อกรองค่ามิติข้อมูลที่กำหนดเอง Hit จะได้รับการกรองตามขอบเขตของค่ามิติข้อมูลที่กำหนดเองนั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ตัวกรองและค่ามิติข้อมูลที่กำหนดเองทำงานร่วมกันเมื่อประมวลผลข้อมูล
ข้อควรพิจารณาสำหรับเมตริกที่กำหนดเอง
ค่าเมตริกที่กำหนดเองจะรวมอยู่ในรายงาน
- ระบบจะรวมค่าเมตริกที่กำหนดเองไว้ในรายงานเช่นเดียวกับเมตริกอื่นๆ ที่กำหนดไว้ล่วงหน้าใน Google Analytics ดังนั้นคุณจึงตั้งค่าเมตริกที่กำหนดเองเป็น
1
เพื่อเพิ่มยอดรวมของเมตริกในรายงาน
เมตริกที่กำหนดเองและตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
- แม้ว่าโดยทั่วไปคุณจะตั้งค่าเมตริกที่กำหนดเองได้ทุกเมื่อที่สะดวก แต่ให้หลีกเลี่ยงการกำหนดค่าเมตริกที่กำหนดเองสำหรับ Hit ที่มีแนวโน้มว่าจะถูกกรองออกจากข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) หาก Hit ถูกกรองโดยตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ระบบจะกรองค่าเมตริกที่กำหนดเองที่เกี่ยวข้องออกด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับมิติข้อมูลและเมตริกที่กำหนดเอง และตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
การตั้งค่าด้วยการวัดหน้าจออัตโนมัติ
- หากต้องการใช้ค่ามิติข้อมูลที่กำหนดเองกับการดูหน้าจอที่ส่งผ่านการวัดหน้าจออัตโนมัติ ให้กำหนดค่าก่อนที่จะเรียกใช้
activityStart()
ระหว่างonStart()
โปรดทราบว่าหากไม่ทราบค่านี้ในขณะที่เรียกใช้onStart()
เราขอแนะนำให้ใช้การวัดหน้าจอด้วยตนเองแทน
อย่าส่งข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) เป็นค่า
- ข้อกำหนดในการให้บริการของ Google Analytics ไม่อนุญาตให้ส่งข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) ใดๆ ไปยังเซิร์ฟเวอร์ Google Analytics ดูข้อมูลเพิ่มเติมได้ในข้อกำหนดในการให้บริการ