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

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

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

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

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

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

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

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

  1. เปิด Google Tag Manager

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

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

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

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

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

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

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

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

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

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

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

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

  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 ผ่าน เซิร์ฟเวอร์ของฉัน