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

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

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 อาร์เรย์<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 ครั้ง