ส่งข้อมูลไปยัง Tag Manager ฝั่งเซิร์ฟเวอร์

บทความนี้อธิบายวิธีต่างๆ ในการส่งเหตุการณ์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ หากต้องการข้อมูลพื้นฐานเพิ่มเติม โปรดดูวิธีการทำงานของการติดแท็กฝั่งเซิร์ฟเวอร์

บทความนี้จะอธิบายวิธีทำสิ่งต่อไปนี้

  • ส่งข้อมูลจากเว็บไซต์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
  • ส่งข้อมูลเพิ่มเติมไปยังคอนเทนเนอร์เซิร์ฟเวอร์
  • รับข้อมูลในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์
  • ส่งข้อมูลจากแหล่งที่มาอื่นที่ไม่ใช่เว็บไซต์

ก่อนเริ่มต้น

คู่มือนี้จะถือว่าคุณมีสิ่งต่อไปนี้อยู่แล้ว

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 ไปยังคอนเทนเนอร์เซิร์ฟเวอร์ ไคลเอ็นต์ต้องอ้างสิทธิ์คำขอ

วิธีดูรายชื่อไคลเอ็นต์ที่ใช้ได้

  1. เปิด Google Tag Manager

  2. เปิดคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์

  3. คลิกไคลเอ็นต์ในแถบนำทางทางด้านซ้าย ไคลเอ็นต์ GA4 จะ ติดตั้งไว้ล่วงหน้าในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์โดยค่าเริ่มต้น

  4. คลิกชื่อลูกค้าเพื่อดูหรือแก้ไขรายละเอียด

การตั้งค่าไคลเอ็นต์ที่ไม่บังคับ

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

  • ลำดับความสำคัญ: กำหนดลำดับการเรียกใช้ไคลเอ็นต์ ระบบจะเรียกใช้โดยเริ่มจากตัวเลขที่มีค่ามาก และไคลเอ็นต์แรกที่ตรงกันกับคำขอที่เข้ามาใหม่จะเป็นไคลเอ็นต์ที่ใช้งานกับคำขอนั้น

  • เกณฑ์การเปิดใช้งาน: เกณฑ์การเปิดใช้งานจะกำหนดเวลาที่ไคลเอ็นต์จะ ตอบสนองต่อคำขอ

    • เส้นทางตามค่าเริ่มต้นของ gtag.js สำหรับรหัสแบบเจาะจง: ใช้การตั้งค่านี้เพื่อเปิดใช้ gtag.js JavaScript ที่แสดงผ่าน URL ของคอนเทนเนอร์เซิร์ฟเวอร์ เมื่อเปิดใช้ ไคลเอ็นต์นี้จะทำงานตามคำขอไปที่เส้นทางตามค่าเริ่มต้นของคำขอ gtag.js เช่น /gtag/js?id=TAG_ID คลิกเพิ่ม รหัสการวัดเพื่อเพิ่ม รหัสปลายทางอย่างน้อย 1 รายการ

ไม่บังคับ: รับข้อมูลเพิ่มเติมใน Tag Manager ฝั่งเซิร์ฟเวอร์

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

แท็กเซิร์ฟเวอร์บางรายการจะมีพารามิเตอร์เพิ่มเติมในคำขอขาออก โดยไม่ต้องตั้งค่า หากต้องการยกเว้นพารามิเตอร์เหล่านั้น ให้สร้างการเปลี่ยนรูปแบบ เพื่อนำค่าออก

วิธีใช้พารามิเตอร์เพิ่มเติมในแท็กอื่นๆ

  1. ในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ ให้คลิกตัวแปรในการนำทางด้านซ้าย
  2. สร้างตัวแปรที่กำหนดโดยผู้ใช้ใหม่
  3. ในการกำหนดค่าตัวแปร ให้เลือกประเภทตัวแปรข้อมูลเหตุการณ์
  4. ในเส้นทางคีย์ ให้ป้อนชื่อของพารามิเตอร์
  5. ตั้งชื่อตัวแปรแล้วบันทึก

ตอนนี้คุณใช้พารามิเตอร์เหตุการณ์ในแท็กอื่นๆ ภายในคอนเทนเนอร์เซิร์ฟเวอร์ได้แล้ว

3. ไม่บังคับ: ส่งข้อมูลจากแหล่งที่มาอื่นๆ ที่ไม่ใช่เว็บไซต์

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

ตัวเลือกนี้ไม่รองรับฟีเจอร์ทั้งหมดของปลายทาง Measurement Protocol เช่น การดึงข้อมูลทางภูมิศาสตร์และอุปกรณ์จากการติดแท็กเหตุการณ์

แอปบนอุปกรณ์เคลื่อนที่

หากต้องการให้แอป Android หรือ iOS ส่งข้อมูลไปยังคอนเทนเนอร์ของเซิร์ฟเวอร์ คุณจะต้อง สร้างแท็กรูปภาพที่กำหนดเองและกำหนดค่าให้ใช้ Measurement Protocol โดยทำดังนี้

  1. ในคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่ (Android หรือ iOS) ให้คลิกแท็ก > ใหม่
  2. ในการกำหนดค่าแท็ก ให้เลือกประเภทแท็กรูปภาพที่กำหนดเอง
  3. ตั้งค่า 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
  4. ยกเลิกการเลือกเปิดใช้การไม่ใช้แคช
  5. บันทึกแท็กและนำคอนเทนเนอร์ไปใช้จริง
  6. ในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ ให้คลิกไคลเอ็นต์ > ใหม่
  7. ในการกำหนดค่าไคลเอ็นต์ ให้เลือกประเภทไคลเอ็นต์ Measurement Protocol
  8. ตั้งค่าเส้นทางการเปิดใช้งานเป็นเส้นทางของปลายทางการรวบรวมข้อมูลของแอป
  9. บันทึกการกำหนดค่าไคลเอ็นต์และเผยแพร่คอนเทนเนอร์ฝั่งเซิร์ฟเวอร์

แอปแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์

หากต้องการส่งข้อมูล 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 โดยทําดังนี้

  1. ในคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์ ให้คลิกไคลเอ็นต์ > ใหม่
  2. ในการกำหนดค่าไคลเอ็นต์ ให้เลือกประเภทไคลเอ็นต์ Measurement Protocol
  3. ตั้งค่าเส้นทางการเปิดใช้งานเป็นเส้นทางของปลายทางเซิร์ฟเวอร์
  4. บันทึกการกำหนดค่าไคลเอ็นต์และนำคอนเทนเนอร์ไปใช้จริง

ขั้นตอนถัดไป

หากต้องการส่งข้อมูลในบริบทของบุคคลที่หนึ่งอย่างแท้จริง คุณต้องแสดงสคริปต์ของ Google เช่น ไลบรารี Google Analytics จากเซิร์ฟเวอร์ของคุณเอง

โหลด สคริปต์ของ Google ผ่านเซิร์ฟเวอร์ของฉัน