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

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

ภาพรวม

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

  1. กำหนดค่ามิติข้อมูลหรือเมตริกที่กำหนดเองโดยใช้เว็บอินเทอร์เฟซของ Google Analytics ดูวิธีกำหนดค่ามิติข้อมูลหรือเมตริกที่กำหนดเอง (ศูนย์ช่วยเหลือ)
  2. ตั้งค่าและส่งค่ามิติข้อมูลและเมตริกที่กําหนดเองจากแอป

มิติข้อมูลและเมตริกที่กำหนดเองประกอบด้วย 2 ช่อง ดังนี้

  • Integer ดัชนี – ดัชนีของมิติข้อมูลหรือเมตริกที่กำหนดเอง ดัชนีนี้เป็นแบบ 1
  • String ค่า – ค่าของมิติข้อมูลหรือเมตริกที่กำหนดเอง ในกรณีนี้ ระบบจะแยกวิเคราะห์เมตริกเป็นจำนวนเต็มหรือค่าทศนิยมแบบมีจุดคงที่ หากมีการกำหนดค่าเมตริกเป็นประเภทสกุลเงิน

การตั้งค่าและส่งค่า

วิธีตั้งค่าและส่งค่ามิติข้อมูลที่กําหนดเอง

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .set(Fields.customDimension(1), "premiumUser");
    .build()
);

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

วิธีตั้งค่าและส่งค่าเมตริกที่กําหนดเอง

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();


// Set the custom metric to be incremented by 5 using its index.
easyTracker.set(Fields.customMetric(1), 5);


// Custom metric value sent is with this screen view.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .build()
);

ข้อควรพิจารณาในการติดตั้งใช้งาน

ส่วนนี้จะอธิบายข้อควรพิจารณาเพิ่มเติมที่ควรคำนึงถึงเมื่อติดตั้งใช้งานมิติข้อมูลหรือเมตริกที่กำหนดเอง

ข้อควรพิจารณาสำหรับมิติข้อมูลที่กำหนดเอง

ค่าที่มีขอบเขตระดับผู้ใช้และระดับเซสชันจะใช้กับ Hit ที่ผ่านมา

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

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

  • ค่ามิติข้อมูลที่กำหนดเองระดับผู้ใช้หรือระดับเซสชันจะยังคงมีผลกับ Hit ทั้งหมดในเซสชันปัจจุบันและ/หรือในอนาคต แม้ว่า Hit ที่ส่งด้วยจะถูกกรองออกจากข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
  • เมื่อกรองค่ามิติข้อมูลที่กำหนดเอง Hit จะได้รับการกรองตามขอบเขตของค่ามิติข้อมูลที่กำหนดเองนั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ตัวกรองและค่ามิติข้อมูลที่กำหนดเองทำงานร่วมกันเมื่อประมวลผลข้อมูล

ข้อควรพิจารณาสำหรับเมตริกที่กำหนดเอง

ค่าเมตริกที่กำหนดเองจะรวมอยู่ในรายงาน

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

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

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

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

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