ส่งเหตุการณ์ Measurement Protocol ไปยัง Google Analytics

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

เลือกแพลตฟอร์มที่ต้องการดูในคู่มือนี้

จัดรูปแบบคำขอ

Measurement Protocol สําหรับ Google Analytics 4 รองรับเฉพาะคําขอ HTTP POST

หากต้องการส่งกิจกรรม ให้ใช้รูปแบบต่อไปนี้

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

คุณต้องระบุข้อมูลต่อไปนี้ใน URL ของคำขอ

  • api_secret: ข้อมูลลับ API ที่สร้างขึ้นใน UI ของ Google Analytics

    หากต้องการสร้างข้อมูลลับใหม่ ให้ไปที่ผู้ดูแลระบบ > สตรีมข้อมูล > เลือกสตรีม > Measurement Protocol > สร้าง

  • firebase_app_id: รหัสแอป Firebase ที่อยู่ในคอนโซล Firebase ในส่วน การตั้งค่าโปรเจ็กต์ > ทั่วไป > แอปของคุณ > รหัสแอป

    firebase_app_id ไม่เหมือนกับ app_instance_id firebase_app_id จะระบุแอปของคุณ ในขณะที่ app_instance_id ระบุการติดตั้งแอปครั้งเดียว

ดูพารามิเตอร์การค้นหาสำหรับข้อมูลอ้างอิงแบบเต็ม

คุณต้องระบุข้อมูลต่อไปนี้ในเนื้อหาคำขอ

  • user_id: ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ มีได้เฉพาะ utf-8 อักขระ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุนี้ได้ที่ User-ID สำหรับการวิเคราะห์ข้ามแพลตฟอร์ม

  • consent: ไม่บังคับ ดูวิธีตั้งค่าการตั้งค่าความยินยอม

  • events: อาร์เรย์ของรายการเหตุการณ์ คุณสามารถรวมหลายเหตุการณ์ไว้ในคำขอเดียว

    หากต้องการให้กิจกรรมของผู้ใช้ปรากฏในรายงาน เช่น เรียลไทม์ คุณต้องระบุ engagement_time_msec และ session_id เป็นส่วนหนึ่งของ params สำหรับ event พารามิเตอร์ engagement_time_msec ควรแสดงเวลาในการมีส่วนร่วมของเหตุการณ์เป็นมิลลิวินาที

    ตัวอย่าง

  {
   "app_instance_id": "12345678901234567890123456789012",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

แม้ว่า session_start จะเป็นชื่อเหตุการณ์ที่สงวนไว้ แต่การสร้าง session_id ใหม่จะสร้างเซสชันใหม่โดยไม่ต้องส่ง session_start ทำความเข้าใจวิธีนับเซสชัน

ลองเลย

ตัวอย่างที่คุณใช้ส่งเหตุการณ์ tutorial_begin ไปยังเซิร์ฟเวอร์ Google Analytics ได้มีดังนี้

const firebase_app_id = `1:1234567890:android:321abc456def7890`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

รูปแบบของ firebase_app_id คือเฉพาะแพลตฟอร์ม ดูรหัสแอปพลิเคชันในส่วนไฟล์และออบเจ็กต์การกำหนดค่า Firebase

ข้อจำกัด

ข้อจำกัดต่อไปนี้มีผลกับการส่งเหตุการณ์ Measurement Protocol ไปยัง Google Analytics

  • คำขอมีเหตุการณ์ได้สูงสุด 25 รายการ
  • เหตุการณ์มีพารามิเตอร์ได้สูงสุด 25 รายการ
  • เหตุการณ์มีพร็อพเพอร์ตี้ผู้ใช้ได้สูงสุด 25 รายการ
  • ชื่อพร็อพเพอร์ตี้ผู้ใช้ต้องมีความยาวไม่เกิน 24 อักขระ
  • ค่าพร็อพเพอร์ตี้ผู้ใช้ต้องมีความยาวไม่เกิน 36 อักขระ
  • ชื่อเหตุการณ์ต้องขึ้นต้นด้วยตัวอักษรและมีความยาวไม่เกิน 40 อักขระ ซึ่งจะใช้ได้เพียงตัวอักษร ตัวเลข และขีดล่างเท่านั้น
  • ชื่อพารามิเตอร์รวมถึงพารามิเตอร์ของรายการต้องมีอักขระไม่เกิน 40 ตัว ประกอบด้วยอักขระที่เป็นตัวอักษร ตัวเลข และเครื่องหมายขีดล่างเท่านั้น และต้องขึ้นต้นด้วยอักขระที่เป็นพยัญชนะ
  • ค่าพารามิเตอร์รวมถึงค่าพารามิเตอร์ของรายการต้องมีอักขระ 100 ตัวหรือน้อยกว่าสำหรับพร็อพเพอร์ตี้ Google Analytics 4 มาตรฐาน และไม่เกิน 500 ตัวสำหรับพร็อพเพอร์ตี้ Google Analytics 360
  • พารามิเตอร์รายการมีพารามิเตอร์ที่กําหนดเองได้สูงสุด 10 รายการ
  • เนื้อหาของโพสต์ต้องเล็กกว่า 130 kB
  • ระบบจะรองรับการระบุแหล่งที่มาระดับเหตุการณ์จากเหตุการณ์ Measurement Protocol สูงสุด 63 วันหลังจากการติดแท็กเหตุการณ์ออนไลน์ล่าสุดเพื่อส่งออก Conversion ไปยัง Google Ads และการผสานรวมสื่ออื่นๆ แม้ว่ากรอบเวลา Conversion ของเหตุการณ์ Conversion จะนานกว่า 63 วันก็ตาม ในทางตรงกันข้าม การระบุแหล่งที่มาระดับเหตุการณ์สำหรับการติดแท็กเหตุการณ์ออนไลน์จะใช้ได้ในกรอบเวลา Conversion ทั้งหมด
  • เพื่อจุดประสงค์ด้านรีมาร์เก็ตติ้ง คุณสามารถเข้าร่วมกิจกรรม Measurement Protocol ได้จนถึงจำนวนวันต่อไปนี้หลังจากวันที่กิจกรรมออนไลน์ครั้งล่าสุดซึ่งมีคุกกี้หรือรหัสอุปกรณ์ที่เชื่อมโยง:
    • สตรีมเว็บ: 30 วัน
    • สตรีมแอป: 42 วัน
  • เหตุการณ์ Measurement Protocol ของแอปที่ส่งไปยัง Google Analytics 4 จะไม่ป้อนข้อมูลกลุ่มเป้าหมายใน Google Ads สําหรับผู้ใช้แอป