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

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

เอกสารนี้จะกล่าวถึงวิธีต่อไปนี้

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

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

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

• ตั้งค่าคอนเทนเนอร์ของเซิร์ฟเวอร์ใน Tag Manager
• ตั้งค่าเซิร์ฟเวอร์การติดแท็ก

1. ส่งข้อมูลจากเว็บไซต์ไปยังคอนเทนเนอร์ฝั่งเซิร์ฟเวอร์

คุณสามารถกำหนดเส้นทางข้อมูลผ่านการติดตั้งใช้งานฝั่งเซิร์ฟเวอร์ผ่าน Tag Manager หรือ gtag.js เลือกตัวเลือกการติดตั้งใช้งาน

Tag Manager gtag.js

เลือกตัวเลือกการติดตั้งใช้งาน

ไม่บังคับ: ส่งพารามิเตอร์เพิ่มเติมพร้อมกับแต่ละเหตุการณ์

คุณสามารถส่งพารามิเตอร์เพิ่มเติมได้ 2 ประเภท ได้แก่ พารามิเตอร์ระดับการกําหนดค่าและพารามิเตอร์ระดับเหตุการณ์ พารามิเตอร์การกําหนดค่าจะส่งผลต่อลักษณะการทํางานของแท็ก Google หรือแท็กปลายทาง Google Analytics และตั้งค่าได้เฉพาะในระดับแท็ก Google หรือแท็กปลายทาง Google Analytics เท่านั้น

พารามิเตอร์เหตุการณ์จะระบุข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์ และตั้งค่าสําหรับเหตุการณ์ทั้งหมด เหตุการณ์ที่เลือก หรือเหตุการณ์ 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 ไปยังคอนเทนเนอร์ของเซิร์ฟเวอร์ ไคลเอ็นต์ต้องอ้างสิทธิ์คําขอนั้น

คําสําคัญ: "ไคลเอ็นต์" คืออะแดปเตอร์ระหว่างซอฟต์แวร์ที่ทํางานในอุปกรณ์ของผู้ใช้ กับคอนเทนเนอร์ Tag Manager ฝั่งเซิร์ฟเวอร์ โดยจะรับข้อมูลการวัดผลจากอุปกรณ์ แปลงข้อมูลดังกล่าวเป็นเหตุการณ์อย่างน้อย 1 เหตุการณ์ ประมวลผลข้อมูลในคอนเทนเนอร์ และจัดแพ็กเกจผลลัพธ์เพื่อส่งกลับไปยังอุปกรณ์

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

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

ตัวเลือกนี้ไม่รองรับฟีเจอร์ทั้งหมดของปลายทาง 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 ผ่าน เซิร์ฟเวอร์ของฉัน