พร็อพเพอร์ตี้ผู้ใช้อธิบายกลุ่มต่างๆ ในฐานผู้ใช้ของคุณ เช่น ค่ากำหนดภาษาหรือสถานที่ตั้งทางภูมิศาสตร์ Analytics จะบันทึกพร็อพเพอร์ตี้ผู้ใช้บางรายการโดยอัตโนมัติ หากต้องการรวบรวมพร็อพเพอร์ตี้เพิ่มเติม คุณสามารถตั้งค่าพร็อพเพอร์ตี้ผู้ใช้เพิ่มได้ถึง 25 รายการต่อโปรเจ็กต์ ดูวิธีตั้งค่าและลงทะเบียนพร็อพเพอร์ตี้ผู้ใช้ได้ที่พร็อพเพอร์ตี้ผู้ใช้ที่กำหนดเอง
พร็อพเพอร์ตี้ผู้ใช้ช่วยปรับปรุงการแบ่งกลุ่มผู้ใช้ แต่ข้อมูลพร็อพเพอร์ตี้ผู้ใช้มักจะพร้อมใช้งานฝั่งเซิร์ฟเวอร์เท่านั้น Measurement Protocol ช่วยให้คุณเพิ่มการวัดฝั่งไคลเอ็นต์ด้วยข้อมูลฝั่งเซิร์ฟเวอร์ ซึ่งโดยปกติแล้วจะทำไม่ได้หากใช้โซลูชันฝั่งไคลเอ็นต์เพียงอย่างเดียว
ชื่อที่สงวนไว้
ชื่อพร็อพเพอร์ตี้ผู้ใช้บางชื่อเป็นชื่อที่สงวนไว้และไม่สามารถใช้ในการวัดได้
first_open_timefirst_visit_timelast_deep_link_referreruser_idfirst_open_after_install
นอกจากนี้ ชื่อพร็อพเพอร์ตี้ผู้ใช้ต้องไม่ขึ้นต้นด้วย
google_ga_firebase_
ตัวอย่างการใช้
ในตัวอย่างต่อไปนี้ CRM มีพร็อพเพอร์ตี้ผู้ใช้ (customer_tier) ที่คุณต้องการเพิ่มลงในการวัด customer_tier สามารถตั้งค่าเป็น premium หรือ standard ได้ หากต้องการรับพร็อพเพอร์ตี้ผู้ใช้นี้ในรายงาน ให้ทําดังนี้
ก่อนอื่น ให้ไคลเอ็นต์ส่งเหตุการณ์ add_payment_info พร้อมกับการเรียก API ของเซิร์ฟเวอร์ที่มีสิทธิ์เข้าถึงระบบ CRM ของคุณ
รหัสไคลเอ็นต์
FirebaseAnalytics.logEvent("add_payment_info")
ServerAPI.addCustomerTier(
FirebaseAnalytics.getAppInstanceId(),
"[{name: \"add_payment_info\"}"]
);
จากนั้นเซิร์ฟเวอร์จะเพิ่มการวัดผลด้วยพร็อพเพอร์ตี้ผู้ใช้ customer_tier โดยใช้ Measurement Protocol ดังนี้
โค้ดเซิร์ฟเวอร์
const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";
function addCustomerTier(appInstanceId, events) {
// Request the customer tier from the CRM.
const customerTier = getCustomerTier(appInstanceId);
const queryParams = `?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`;
fetch(`https://www.google-analytics.com/mp/collect${queryParams}`, {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"app_instance_id": "APP_INSTANCE_ID",
"user_properties": {
"customer_tier": {
"value": "CUSTOMER_TIER"
}
},
"events": JSON.parse(events)
})
});
}
พร็อพเพอร์ตี้ผู้ใช้นี้จะรายงานกลุ่ม 2 กลุ่ม ได้แก่ premium และ standard
ดูรายละเอียดทั้งหมดเกี่ยวกับวิธีส่งเหตุการณ์โดยใช้ Measurement Protocol ได้ที่การส่งเหตุการณ์
ลบล้างการประทับเวลา
Measurement Protocol จะใช้การประทับเวลาแรกที่พบในรายการต่อไปนี้สําหรับพร็อพเพอร์ตี้ผู้ใช้แต่ละรายการในคําขอ
timestamp_microsของรายการในuser_propertiestimestamp_microsของคำขอ- เวลาที่ Measurement Protocol ได้รับคําขอ
ตัวอย่างต่อไปนี้จะส่งการประทับเวลาระดับคำขอซึ่งมีผลกับพร็อพเพอร์ตี้ผู้ใช้ทั้งหมดในคำขอ ด้วยเหตุนี้ Measurement Protocol จึงกำหนดการประทับเวลา requestUnixEpochTimeInMicros ให้กับทั้งพร็อพเพอร์ตี้ผู้ใช้ customer_tier และ customer_group
{
"timestamp_micros": requestUnixEpochTimeInMicros,
"user_properties": {
"customer_tier": {
"value": customerTierValue
},
"customer_group": {
"value": customerGroupValue
}
}
}
ตัวอย่างต่อไปนี้จะส่งทั้งการประทับเวลาระดับคำขอและการประทับเวลาสำหรับพร็อพเพอร์ตี้ผู้ใช้ customer_tier ด้วยเหตุนี้ Measurement Protocol จึงกำหนดให้ customer_tier มีการประทับเวลาเป็น customerTierUnixEpochTimeInMicros และ customer_group มีการประทับเวลาเป็น requestUnixEpochTimeInMicros
"timestamp_micros": requestUnixEpochTimeInMicros,
"user_properties": {
"customer_tier": {
"value": customerTierValue,
"timestamp_micros": customerTierUnixEpochTimeInMicros
},
"customer_group": {
"value": customerGroupValue
}
}