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

1. บทนำ

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

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

  • ใน Codelab นี้ คุณจะได้เรียนรู้วิธีส่งเหตุการณ์ภายนอกไปยัง 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

ซึ่งได้อธิบายไว้โดยละเอียดด้านล่าง

การรวบรวมผ่าน 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

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