ส่งเหตุการณ์ในเว็บไปยัง GA4 โดยใช้ Measurement Protocol

1. บทนำ

อัปเดตล่าสุด: 2019-04-30

สิ่งที่คุณจะสร้าง

  • ในโค้ดแล็บนี้ คุณจะได้เรียนรู้วิธีส่งเหตุการณ์ภายนอกไปยัง GA4 โดยใช้ Measurement Protocol
  • Codelab นี้ถือว่าคุณมีหน้าเว็บ/เว็บไซต์ที่ติดตั้งใช้งาน Google Analytics 4 อยู่แล้ว

สิ่งที่คุณจะได้เรียนรู้

  • ขั้นตอนในการเรียก MP ครั้งแรก
  • เข้าใจพารามิเตอร์ที่ต้องใช้ในการเรียก
  • ส่งและตรวจสอบการเรียกทดสอบ
  • สร้างสคริปต์ตัวอย่างใน Python เพื่อทำการเรียก

สิ่งที่คุณต้องมี

  • เว็บไซต์/หน้าเว็บ
  • IDE ใดก็ได้เพื่อทำการเปลี่ยนแปลง
  • บัญชี GA4
  • ไม่บังคับ - สภาพแวดล้อมการพัฒนา Python (หรือ Colab)

2. รวบรวมช่องที่ต้องกรอก

สร้างข้อมูลลับ API ใน GA4

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

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

คุณระบุชื่อเล่นใดก็ได้ และระบบจะแสดงค่าลับซึ่งคุณใช้ในการเรียกได้

รวบรวม client_id

คุณใช้วิธีใดก็ได้ต่อไปนี้เพื่อรวบรวม client_id

  1. การรวบรวมผ่าน gTag

เราจะอธิบายรายละเอียดของทั้ง 2 อย่างนี้ด้านล่าง

การรวบรวมผ่าน gTag

คุณดึงข้อมูล client_id ผ่านเว็บไซต์ได้โดยใช้

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

ด้านล่างนี้คือลิงก์เพิ่มเติมซึ่งขึ้นอยู่กับโครงสร้างพื้นฐานของคุณ

3. สร้างการเรียก

คุณสามารถสร้างการเรียกทดลองได้โดยใช้เครื่องมือสร้างเหตุการณ์ใน GA4 (ซึ่งทำให้คุณต้องเข้าสู่ระบบและเปิดใช้คุกกี้) สลับปุ่มเปิด/ปิดเป็น "gtag.js"

b904d2a053eb7817.png

คุณจะต้องกรอกข้อมูลในช่องต่อไปนี้

  • api_secret - สร้างไว้แล้วก่อนหน้านี้ใน GA4
  • measurement_id - หากต้องการรับรหัสนี้ ให้ไปที่ผู้ดูแลระบบ > สตรีมข้อมูล > เลือกสตรีม โดยควรแสดงดังนี้

d362992ff592c675.png

  • client_id - คุณดึงค่านี้มาแล้ว
  • user_id ไม่บังคับ คุณเว้นว่างไว้ก่อนได้
  • หมวดหมู่ - เปลี่ยนเป็น "กําหนดเอง" จากเมนูแบบเลื่อนลง และใส่ชื่อเหตุการณ์ที่คุณเลือก (อย่าใช้เหตุการณ์ที่รวบรวมโดยอัตโนมัติ) ในที่นี้เราใช้ "test_from_codelab"

cf580a708bb0a8a2.png

คุณยังเลือกที่จะระบุพารามิเตอร์เหตุการณ์และ/หรือพร็อพเพอร์ตี้ผู้ใช้ได้ด้วย โดยคลิกปุ่มด้านล่าง

da59bb982f6f906a.png

เมื่อกรอกข้อมูลทุกอย่างแล้ว คุณควรเห็นข้อความคล้ายกับตัวอย่างนี้พร้อมปุ่ม "ตรวจสอบความถูกต้องของเหตุการณ์"

31f720d550906298.png

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

1d63d1e067c46294.png

ตอนนี้คุณคลิกปุ่มได้แล้ว และระบบควรส่งเหตุการณ์ทดสอบไปยัง GA4

4. การตรวจสอบเหตุการณ์ใน GA4

เมื่อส่งเหตุการณ์แล้ว คุณจะไปที่บัญชี GA4 และตรวจสอบเรียลไทม์ได้ คุณควรเห็นกิจกรรมที่ส่งเข้ามา

7b9e9a0f74b64757.png

ระบบอาจใช้เวลาประมาณ 24 ชั่วโมงในการเผยแพร่เหตุการณ์จากมุมมองแบบเรียลไทม์ไปยังแท็บการรายงานเหตุการณ์จริง ดังนั้นไม่ต้องกังวลหากคุณไม่เห็นเหตุการณ์นี้ในการรายงานเหตุการณ์ปกติทันที

5. การสร้างสคริปต์ Python

ตอนนี้คุณได้ทดสอบแล้ว คุณสามารถตรวจสอบการเรียก API และเพย์โหลดของเหตุการณ์เพื่อสร้างสถาปัตยกรรมที่คล้ายกันใน Python (หรือภาษาใดก็ได้ที่คุณเลือก) ซึ่งสามารถทำการเรียกนี้ได้ จากนั้นคุณสามารถกำหนดเวลาการดำเนินการนี้ตามความถี่ที่ต้องการและนำไปใช้ได้ สำหรับส่วนนี้ คุณสามารถใช้ IDE ที่เลือกซึ่งรองรับ Python หรือใช้เพียงสมุดบันทึก Google Colab ซึ่งไม่จำเป็นต้องติดตั้งในอุปกรณ์

เมื่อกลับไปที่เครื่องมือสร้างเหตุการณ์ GA4 คุณจะเห็นว่าปลายทางเป็นดังนี้

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

เพย์โหลดของเหตุการณ์มีลักษณะดังนี้

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

คุณแปลโค้ดนี้เป็น Python ได้โดยใช้โค้ดที่คล้ายกับโค้ดนี้

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

เมื่อดำเนินการนี้ด้วยค่าที่ถูกต้องแล้ว คุณควรเห็นเหตุการณ์ดังกล่าวแสดงใน GA4 แบบเรียลไทม์เช่นกัน

6. ขอแสดงความยินดี

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

คุณได้เรียนรู้

  • วิธีรวบรวมตัวแปรที่เหมาะสมเพื่อทำการเรียกใช้ MP
  • วิธีส่งและตรวจสอบเหตุการณ์ทดสอบ
  • วิธีสร้างสคริปต์เพื่อส่งการเรียกใช้ MP

เอกสารอ้างอิง