บทความนี้อธิบายวิธีต่างๆ ในการส่งเหตุการณ์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ หากต้องการข้อมูลพื้นฐานเพิ่มเติม โปรดดู วิธีการทำงานของการติดแท็กฝั่งเซิร์ฟเวอร์
บทความนี้จะอธิบายวิธีต่อไปนี้
- ส่งข้อมูลจากเว็บไซต์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
- ส่งข้อมูลเพิ่มเติมไปยังคอนเทนเนอร์ของเซิร์ฟเวอร์
- รับข้อมูลในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
- ส่งข้อมูลจากแหล่งที่มาอื่นๆ นอกเหนือจากเว็บไซต์
ก่อนเริ่มต้น
คู่มือนี้จะถือว่าคุณมีสิ่งต่อไปนี้อยู่แล้ว
1. ส่งข้อมูลจากเว็บไซต์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
คุณสามารถกำหนดเส้นทางข้อมูลผ่านการติดตั้งใช้งานฝั่งเซิร์ฟเวอร์ผ่าน Tag Manager หรือ gtag.js เลือกตัวเลือกการติดตั้งใช้งาน
ไม่บังคับ: ส่งพารามิเตอร์เพิ่มเติมกับแต่ละเหตุการณ์
คุณสามารถส่งพารามิเตอร์เพิ่มเติมได้ 2 ประเภท ได้แก่ พารามิเตอร์ระดับการกําหนดค่าและพารามิเตอร์ระดับเหตุการณ์ พารามิเตอร์การกําหนดค่าจะส่งผลต่อลักษณะการทํางานของแท็ก Google และตั้งค่าได้ในระดับแท็ก Google เท่านั้น
พารามิเตอร์เหตุการณ์จะระบุข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์ และตั้งค่าสําหรับเหตุการณ์ทั้งหมด เหตุการณ์ที่เลือก หรือเหตุการณ์ page_view ได้
คำแนะนำในการตั้งค่า
เราขอแนะนําให้ใช้แท็ก Google Analytics ในหน้าเว็บเพื่อส่งข้อมูลไปยังคอนเทนเนอร์ของเซิร์ฟเวอร์ แท็กนี้สามารถใช้วิธีการขนส่งที่แตกต่างกันเพื่อให้มั่นใจว่าเหตุการณ์จะส่งถึงผู้รับในอัตราที่ดีที่สุด วิธีการดังกล่าวรวมถึงแต่ไม่จำกัดเพียง
- พิกเซลภาพ
- Fetch API
- XHR
- Service Worker ที่ทํางานใน iframe ที่โหลดจากโดเมนคอนเทนเนอร์ของเซิร์ฟเวอร์
ตรวจสอบสิ่งต่อไปนี้เพื่อให้แน่ใจว่าระบบรองรับทุกวิธี
นโยบายรักษาความปลอดภัยเนื้อหา (CSP)
| คําสั่ง | เนื้อหา | วัตถุประสงค์ |
| 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 ไปยังคอนเทนเนอร์ของเซิร์ฟเวอร์ ไคลเอ็นต์ต้องอ้างสิทธิ์คำขอนั้น
วิธีดูรายการไคลเอ็นต์ที่ใช้ได้
เปิดคอนเทนเนอร์ของเซิร์ฟเวอร์
คลิกไคลเอ็นต์ ในแถบการนําทางด้านซ้าย ระบบจะติดตั้งไคลเอ็นต์ Google Analytics ไว้ล่วงหน้าในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์โดยค่าเริ่มต้น
คลิกชื่อไคลเอ็นต์เพื่อดูหรือแก้ไขรายละเอียด
การตั้งค่าไคลเอ็นต์ที่ไม่บังคับ
ในกรณีส่วนใหญ่ ไคลเอ็นต์ไม่จําเป็นต้องมีการแก้ไข อย่างไรก็ตาม กรณีการใช้งานของคุณอาจแตกต่างออกไปและคุณอาจต้องการแก้ไขการตั้งค่าใดการตั้งค่าหนึ่งต่อไปนี้
ลําดับความสําคัญ: กําหนดลําดับการเรียกใช้ไคลเอ็นต์ ระบบจะเรียกใช้โดยเริ่มจากตัวเลขที่มีค่ามาก และไคลเอ็นต์แรกที่ตรงกันกับคําขอที่เข้ามาใหม่จะเป็นไคลเอ็นต์ที่ใช้งานกับคําขอนั้น
เกณฑ์การเปิดใช้งาน: เกณฑ์การเปิดใช้งานจะกําหนดเวลาที่ไคลเอ็นต์จะตอบสนองต่อคําขอ
- เส้นทาง 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 ในคอนเทนเนอร์ของเซิร์ฟเวอร์เพื่อแยกวิเคราะห์พารามิเตอร์เพิ่มเติมและสร้างข้อมูลเหตุการณ์จากพารามิเตอร์เหล่านั้น
แท็กเซิร์ฟเวอร์บางแท็กจะรวมพารามิเตอร์เพิ่มเติมไว้ในคําขอขาออกโดยไม่ต้องตั้งค่า หากต้องการยกเว้นพารามิเตอร์เหล่านั้น ให้สร้างการแปลง เพื่อนำค่าออก
วิธีใช้พารามิเตอร์เพิ่มเติมในแท็กอื่นๆ
- ในคอนเทนเนอร์ของเซิร์ฟเวอร์ ให้คลิกตัวแปร ในการนำทางด้านซ้าย
- สร้างตัวแปรที่กําหนดโดยผู้ใช้ใหม่
- ในการกําหนดค่าตัวแปร ให้เลือกประเภทตัวแปรข้อมูลเหตุการณ์
- ในเส้นทางคีย์ ให้ป้อนชื่อพารามิเตอร์
- ตั้งชื่อตัวแปรแล้วบันทึก
ตอนนี้คุณสามารถใช้พารามิเตอร์เหตุการณ์ในแท็กอื่นๆ ภายในคอนเทนเนอร์เซิร์ฟเวอร์ได้แล้ว
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 จากเซิร์ฟเวอร์ของคุณเอง