ตรวจสอบเหตุการณ์

เลือกแพลตฟอร์มของคุณ

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

คุณจะเรียกเซิร์ฟเวอร์การตรวจสอบโดยตรง หรือใช้เครื่องมือสร้างเหตุการณ์ Google Analytics ก็ได้ เครื่องมือสร้างเหตุการณ์ของ Google Analytics ช่วยให้คุณสร้างเหตุการณ์แบบอินเทอร์แอกทีฟ และใช้เซิร์ฟเวอร์การตรวจสอบ Measurement Protocol เพื่อ ตรวจสอบเหตุการณ์เหล่านั้นได้

คู่มือนี้อธิบายวิธีส่งเหตุการณ์ไปยัง Measurement Protocol สำหรับเซิร์ฟเวอร์การตรวจสอบ Google Analytics 4 และตีความการตอบกลับ

ส่งเหตุการณ์เพื่อตรวจสอบ

ความแตกต่างเพียงอย่างเดียวในคำขอสำหรับเหตุการณ์ที่ส่งไปยัง Measurement Protocol และเซิร์ฟเวอร์การตรวจสอบ Measurement Protocol คือ URL

เซิร์ฟเวอร์ URL
Measurement Protocol /mp/collect
เซิร์ฟเวอร์การตรวจสอบ Measurement Protocol /debug/mp/collect

ฟิลด์คำขออื่นๆ ทั้งหมดจะเหมือนกัน ดูรายละเอียดทั้งหมดเกี่ยวกับการสร้างคำขอที่ถูกต้องได้ที่ข้อมูลอ้างอิงโปรโตคอล

โค้ดต่อไปนี้แสดงเหตุการณ์ที่ไม่ถูกต้องซึ่งส่งไปยังเซิร์ฟเวอร์การตรวจสอบ Measurement Protocol

การตอบกลับการตรวจสอบ

นี่คือการตอบกลับของเซิร์ฟเวอร์การตรวจสอบต่อเหตุการณ์ก่อนหน้า

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

นี่คือการตอบกลับของเซิร์ฟเวอร์ตรวจสอบต่อคำขอที่ไม่มีปัญหาการตรวจสอบ

{
  "validationMessages": []
}

การตอบกลับ

คีย์ ประเภท คำอธิบาย
validationMessages Array<ValidationMessage> อาร์เรย์ของข้อความการตรวจสอบ

ValidationMessage

คีย์ ประเภท คำอธิบาย
fieldPath สตริง เส้นทางไปยังฟิลด์ที่ไม่ถูกต้อง
description สตริง คำอธิบายของข้อผิดพลาด
validationCode ValidationCode รหัสการตรวจสอบที่สอดคล้องกับข้อผิดพลาด

ValidationCode

ค่า คำอธิบาย
VALUE_INVALID ค่าที่ระบุสำหรับ fieldPath ไม่ถูกต้อง ดูข้อจำกัด
VALUE_REQUIRED ไม่ได้ระบุค่าที่ต้องระบุสำหรับ fieldPath
NAME_INVALID ชื่อที่ระบุไม่ถูกต้อง ดูข้อจำกัด
NAME_RESERVED ชื่อที่ระบุเป็นชื่อที่สงวนไว้ ดูชื่อที่สงวนไว้
VALUE_OUT_OF_BOUNDS ค่าที่ระบุมีขนาดใหญ่เกินไป ดูข้อจำกัด
EXCEEDED_MAX_ENTITIES คำขอมีพารามิเตอร์มากเกินไป ดูข้อจำกัด
NAME_DUPLICATED มีการระบุชื่อเดียวกันมากกว่า 1 ครั้งในคำขอ