การตรวจสอบ Hit - Measurement Protocol

เอกสารนี้จะอธิบายวิธีตรวจสอบ Hit โปรโตคอล การวัดผลของ Google Analytics

ภาพรวม

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

คู่มือนี้จะอธิบายกระบวนการส่ง Hit ไปยังเซิร์ฟเวอร์การตรวจสอบโปรโตคอลการวัด และอธิบายวิธีตีความการตอบกลับ

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

การส่ง Hit เพื่อตรวจสอบ

คุณสามารถส่ง Hit ไปยังเซิร์ฟเวอร์การตรวจสอบ Measurement Protocol ผ่านวิธีการที่ Measurement Protocol รองรับในปัจจุบันได้ ความแตกต่างเพียงอย่างเดียวคือ URL หากต้องการส่ง Hit ไปยังเซิร์ฟเวอร์การตรวจสอบ Measurement Protocol ให้ใช้ปลายทาง /debug/collect แทน /collect ตัวอย่างต่อไปนี้แสดง Hit ที่ไม่ถูกต้องที่ส่งไปยังเซิร์ฟเวอร์ตรวจสอบความถูกต้องของ Measurement Protocol

https://www.google-analytics.com/debug/collect?tid=fake&v=1

ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีสร้าง Hit ของ Measurement Protocol ได้ในข้อมูลอ้างอิงโปรโตคอล

สำคัญ: Hit ที่ส่งไปยังเซิร์ฟเวอร์การตรวจสอบ Measurement Protocol จะไม่แสดงในรายงาน ซึ่งใช้สำหรับการแก้ไขข้อบกพร่องเท่านั้น

การตีความคำตอบ

คำตอบจากเซิร์ฟเวอร์ตรวจสอบ Measurement Protocol จะอยู่ในรูปแบบ JSON ตัวอย่างต่อไปนี้แสดงการตอบกลับสำหรับ Hit ที่แสดงด้านบน

{
  "hitParsingResult": [
    {
      "valid": false,
      "hit": "GET /debug/collect?tid=fake\u0026v=1 HTTP/1.1",
      "parserMessage": [
        {
          "messageType": "ERROR",
          "description": "The value provided for parameter 'tid' is invalid. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        },
        {
          "messageType": "ERROR",
          "description": "Tracking Id is a required field for this hit. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        }
      ]
    }
  ]
}

รูทการตอบกลับ hitParsingResult คืออาร์เรย์ที่มีความยาวจะสอดคล้องกับจำนวน Hit ที่ส่งในคำขอเดิม แต่ละออบเจ็กต์ในอาร์เรย์จะมีคีย์ valid, hit และ parserMessage หาก Hit ไม่ถูกต้อง parserMessage จะมีอาร์เรย์ของออบเจ็กต์ที่อธิบายปัญหาการตรวจสอบ หาก Hit ถูกต้อง parserMessage จะเป็นอาร์เรย์เปล่า

ตารางต่อไปนี้อธิบายพร็อพเพอร์ตี้ของแต่ละรายการในอาร์เรย์ hitParsingResult

คีย์	ประเภท	คำอธิบาย
valid	Boolean	true สำหรับ Hit ที่ถูกต้อง false สำหรับ Hit ที่ไม่ถูกต้อง
hit	string	สตริงที่มีเส้นทางของคำขอ รวมถึงวิธีและโปรโตคอลของคำขอดังกล่าว
parserMessage	Array	รายการข้อความโปรแกรมแยกวิเคราะห์ หาก Hit ถูกต้อง อาร์เรย์นี้จะว่างเปล่า
parserMessage.messageType	string	ค่าที่เป็นไปได้คือ "INFO", "WARN" และ "ERROR"
parserMessage.description	string	รายละเอียดหรือขั้นตอนเพิ่มเติมในการแก้ไขปัญหาการตรวจสอบความถูกต้อง
parserMessage.parameter	string|undefined	พารามิเตอร์ (หากมี) ที่ทำให้เกิดปัญหาในการตรวจสอบความถูกต้อง