บทความนี้อธิบายวิธีต่างๆ ในการส่งเหตุการณ์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ หากต้องการข้อมูลพื้นฐานเพิ่มเติม โปรดดูวิธีการทำงานของการติดแท็กฝั่งเซิร์ฟเวอร์
บทความนี้จะอธิบายวิธีทำสิ่งต่อไปนี้
- ส่งข้อมูลจากเว็บไซต์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
- ส่งข้อมูลเพิ่มเติมไปยังคอนเทนเนอร์เซิร์ฟเวอร์
- รับข้อมูลในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
- ส่งข้อมูลจากแหล่งที่มาอื่นที่ไม่ใช่เว็บไซต์
ก่อนเริ่มต้น
คู่มือนี้จะถือว่าคุณมีสิ่งต่อไปนี้อยู่แล้ว
1. ส่งข้อมูลจากเว็บไซต์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
คุณกำหนดเส้นทางข้อมูลผ่านการติดตั้งใช้งานฝั่งเซิร์ฟเวอร์ได้โดยใช้ Tag Manager หรือ gtag.js เลือกตัวเลือกการติดตั้งใช้งาน
ไม่บังคับ: ส่งพารามิเตอร์เพิ่มเติมพร้อมกับแต่ละเหตุการณ์
คุณสามารถส่งพารามิเตอร์เพิ่มเติมอีก 2 ประเภท ได้แก่ พารามิเตอร์ระดับการกําหนดค่าและพารามิเตอร์ระดับเหตุการณ์ พารามิเตอร์การกําหนดค่าส่งผลต่อลักษณะการทํางานของแท็ก Google และตั้งค่าได้ที่ระดับแท็ก Google เท่านั้น
พารามิเตอร์เหตุการณ์จะระบุข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์ และตั้งค่าได้
สําหรับเหตุการณ์ทั้งหมด เหตุการณ์ที่เลือก หรือpage_viewเหตุการณ์
คำแนะนำในการตั้งค่า
เราขอแนะนําให้ใช้แท็ก GA4 ในหน้าเว็บเพื่อส่งข้อมูลไปยังคอนเทนเนอร์ของเซิร์ฟเวอร์ แท็กนี้สามารถใช้วิธีการส่งที่แตกต่างกันเพื่อให้มั่นใจว่าอัตราการนำส่งเหตุการณ์จะดีที่สุด ซึ่งรวมถึงแต่ไม่จำกัดเพียงวิธีการต่อไปนี้
- พิกเซลภาพ
- Fetch API
- XHR
- Service Worker ที่ทำงานใน iframe ที่โหลดจากคอนเทนเนอร์ของเซิร์ฟเวอร์ โดเมน
หากต้องการตรวจสอบว่าระบบรองรับวิธีการทั้งหมด ให้ตรวจสอบสิ่งต่อไปนี้
นโยบายรักษาความปลอดภัยเนื้อหา (CSP)
| คำสั่ง | เนื้อหา | Purpose |
| img-src | [SERVER_CONTAINER_URL] | คำขอการวัดผล |
| connect-src | [SERVER_CONTAINER_URL] | คำขอการวัดผล |
| frame-src | [SERVER_CONTAINER_URL] | การใช้งาน Service Worker |
นอกจากนี้ X-Frame-Options ต้องไม่จำกัดไม่ให้โหลด iframe จาก URL คอนเทนเนอร์ของเซิร์ฟเวอร์
โปรดดูนโยบายที่เฉพาะเจาะจงต่อผลิตภัณฑ์ที่ https://developers.google.com/tag-platform/security/guides/csp
2. รับข้อมูลในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
เมื่อส่งคำขอ HTTP ไปยังคอนเทนเนอร์เซิร์ฟเวอร์ ไคลเอ็นต์ต้องอ้างสิทธิ์คำขอ
วิธีดูรายชื่อไคลเอ็นต์ที่ใช้ได้
เปิดคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
คลิกไคลเอ็นต์ในแถบนำทางทางด้านซ้าย ไคลเอ็นต์ GA4 จะ ติดตั้งไว้ล่วงหน้าในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์โดยค่าเริ่มต้น
คลิกชื่อลูกค้าเพื่อดูหรือแก้ไขรายละเอียด
การตั้งค่าไคลเอ็นต์ที่ไม่บังคับ
ในกรณีส่วนใหญ่ ไคลเอ็นต์ไม่จำเป็นต้องมีการแก้ไข อย่างไรก็ตาม กรณีการใช้งานของคุณ อาจแตกต่างออกไป และคุณอาจต้องการแก้ไขการตั้งค่าอย่างใดอย่างหนึ่งต่อไปนี้
ลำดับความสำคัญ: กำหนดลำดับการเรียกใช้ไคลเอ็นต์ ระบบจะเรียกใช้โดยเริ่มจากตัวเลขที่มีค่ามาก และไคลเอ็นต์แรกที่ตรงกันกับคำขอที่เข้ามาใหม่จะเป็นไคลเอ็นต์ที่ใช้งานกับคำขอนั้น
เกณฑ์การเปิดใช้งาน: เกณฑ์การเปิดใช้งานจะกำหนดเวลาที่ไคลเอ็นต์จะ ตอบสนองต่อคำขอ
- เส้นทางตามค่าเริ่มต้นของ gtag.js สำหรับรหัสแบบเจาะจง: ใช้การตั้งค่านี้เพื่อเปิดใช้
gtag.js JavaScript ที่แสดงผ่าน URL ของคอนเทนเนอร์เซิร์ฟเวอร์ เมื่อเปิดใช้ ไคลเอ็นต์นี้จะทำงานตามคำขอไปที่เส้นทางตามค่าเริ่มต้นของคำขอ gtag.js เช่น
/gtag/js?id=TAG_IDคลิกเพิ่ม รหัสการวัดเพื่อเพิ่ม รหัสปลายทางอย่างน้อย 1 รายการ
- เส้นทางตามค่าเริ่มต้นของ gtag.js สำหรับรหัสแบบเจาะจง: ใช้การตั้งค่านี้เพื่อเปิดใช้
gtag.js JavaScript ที่แสดงผ่าน URL ของคอนเทนเนอร์เซิร์ฟเวอร์ เมื่อเปิดใช้ ไคลเอ็นต์นี้จะทำงานตามคำขอไปที่เส้นทางตามค่าเริ่มต้นของคำขอ gtag.js เช่น
ไม่บังคับ: รับข้อมูลเพิ่มเติมใน Tag Manager ฝั่งเซิร์ฟเวอร์
หากคุณส่งพารามิเตอร์เพิ่มเติม คุณต้อง ตั้งค่าไคลเอ็นต์ Google Analytics 4 ในคอนเทนเนอร์ของเซิร์ฟเวอร์เพื่อแยกวิเคราะห์ พารามิเตอร์เพิ่มเติมและสร้างข้อมูลเหตุการณ์จากพารามิเตอร์เหล่านั้น
แท็กเซิร์ฟเวอร์บางรายการจะมีพารามิเตอร์เพิ่มเติมในคำขอขาออก โดยไม่ต้องตั้งค่า หากต้องการยกเว้นพารามิเตอร์เหล่านั้น ให้สร้างการเปลี่ยนรูปแบบ เพื่อนำค่าออก
วิธีใช้พารามิเตอร์เพิ่มเติมในแท็กอื่นๆ
- ในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ ให้คลิกตัวแปรในการนำทางด้านซ้าย
- สร้างตัวแปรที่กำหนดโดยผู้ใช้ใหม่
- ในการกำหนดค่าตัวแปร ให้เลือกประเภทตัวแปรข้อมูลเหตุการณ์
- ในเส้นทางคีย์ ให้ป้อนชื่อของพารามิเตอร์
- ตั้งชื่อตัวแปรแล้วบันทึก
ตอนนี้คุณใช้พารามิเตอร์เหตุการณ์ในแท็กอื่นๆ ภายในคอนเทนเนอร์เซิร์ฟเวอร์ได้แล้ว
3. ไม่บังคับ: ส่งข้อมูลจากแหล่งที่มาอื่นๆ ที่ไม่ใช่เว็บไซต์
คุณสามารถใช้ Measurement Protocol ของ Google Analytics เพื่อเปิดใช้การรองรับการติดแท็กฝั่งเซิร์ฟเวอร์จากแหล่งที่มาต่างๆ เช่น แอปบนอุปกรณ์เคลื่อนที่และแอปพลิเคชันแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ ตัวเลือกนี้ช่วยให้คุณส่งเหตุการณ์ไปยังคอนเทนเนอร์ในรูปแบบ Measurement Protocol ได้ คอนเทนเนอร์จะส่งเหตุการณ์เหล่านั้นไปยัง Google Analytics โดยใช้กลไกเดียวกับเหตุการณ์ SGTM อื่นๆ ทั้งหมด
ตัวเลือกนี้ไม่รองรับฟีเจอร์ทั้งหมดของปลายทาง Measurement Protocol เช่น การดึงข้อมูลทางภูมิศาสตร์และอุปกรณ์จากการติดแท็กเหตุการณ์
แอปบนอุปกรณ์เคลื่อนที่
หากต้องการให้แอป Android หรือ iOS ส่งข้อมูลไปยังคอนเทนเนอร์ของเซิร์ฟเวอร์ คุณจะต้อง สร้างแท็กรูปภาพที่กำหนดเองและกำหนดค่าให้ใช้ Measurement Protocol โดยทำดังนี้
- ในคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่ (Android หรือ iOS) ให้คลิกแท็ก > ใหม่
- ในการกำหนดค่าแท็ก ให้เลือกประเภทแท็กรูปภาพที่กำหนดเอง
- ตั้งค่า URL ของรูปภาพเป็นรูปภาพพิกเซลในคอนเทนเนอร์เซิร์ฟเวอร์ที่
เส้นทางในไคลเอ็นต์ Measurement Protocol ที่คุณระบุไว้ก่อนหน้านี้
ต่อท้ายพารามิเตอร์ Measurement Protocol ที่ต้องการไว้ท้าย URL ของพิกเซล
https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home - ยกเลิกการเลือกเปิดใช้การไม่ใช้แคช
- บันทึกแท็กและนำคอนเทนเนอร์ไปใช้จริง
- ในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ ให้คลิกไคลเอ็นต์ > ใหม่
- ในการกำหนดค่าไคลเอ็นต์ ให้เลือกประเภทไคลเอ็นต์ Measurement Protocol
- ตั้งค่าเส้นทางการเปิดใช้งานเป็นเส้นทางของปลายทางการรวบรวมข้อมูลของแอป
- บันทึกการกำหนดค่าไคลเอ็นต์และเผยแพร่คอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
แอปแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์
หากต้องการส่งข้อมูล Measurement Protocol ไปยังคอนเทนเนอร์ของเซิร์ฟเวอร์ ให้แทนที่
www.google-analytics.com ชื่อโฮสต์ด้วยชื่อโดเมนของคอนเทนเนอร์
เซิร์ฟเวอร์ เช่น
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
หากต้องการรับ Hit ของ Measurement Protocol ให้กําหนดค่าการติดตั้ง Tag Manager ฝั่งเซิร์ฟเวอร์ด้วยไคลเอ็นต์ Measurement Protocol โดยทําดังนี้
- ในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ ให้คลิกไคลเอ็นต์ > ใหม่
- ในการกำหนดค่าไคลเอ็นต์ ให้เลือกประเภทไคลเอ็นต์ Measurement Protocol
- ตั้งค่าเส้นทางการเปิดใช้งานเป็นเส้นทางของปลายทางเซิร์ฟเวอร์
- บันทึกการกำหนดค่าไคลเอ็นต์และนำคอนเทนเนอร์ไปใช้จริง
ขั้นตอนถัดไป
หากต้องการส่งข้อมูลในบริบทของบุคคลที่หนึ่งอย่างแท้จริง คุณต้องแสดงสคริปต์ของ Google เช่น ไลบรารี Google Analytics จากเซิร์ฟเวอร์ของคุณเอง