มิติข้อมูลและเมตริกที่กำหนดเอง

คู่มือนักพัฒนาซอฟต์แวร์นี้จะอธิบายวิธีใช้ Google Analytics SDK v4 สำหรับ Android เพื่อติดตั้งใช้งานมิติข้อมูลและเมตริกที่กำหนดเอง

ภาพรวม

โดยคุณจะทำสิ่งต่อไปนี้ได้

มิติข้อมูลและเมตริกที่กำหนดเองประกอบด้วย 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 เพื่อเพิ่มยอดรวมของเมตริกในรายงาน

เมตริกที่กำหนดเองและตัวกรองข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)

การตั้งค่าด้วยการวัดหน้าจออัตโนมัติ

  • หากต้องการใช้ค่ามิติข้อมูลที่กำหนดเองกับการดูหน้าจอที่ส่งผ่านการวัดหน้าจออัตโนมัติ ให้กำหนดค่าก่อนที่จะเรียกใช้ activityStart() ระหว่างonStart() โปรดทราบว่าหากไม่ทราบค่านี้ในขณะที่เรียกใช้ onStart() เราขอแนะนำให้ใช้การวัดหน้าจอด้วยตนเองแทน

อย่าส่งข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) เป็นค่า