การกำหนดค่าโดเมนที่กำหนดเอง

บทความนี้มีไว้สําหรับนักพัฒนาซอฟต์แวร์ที่ต้องการโฮสต์การติดแท็กฝั่งเซิร์ฟเวอร์ในบริบทของบุคคลที่หนึ่งเดียวกับเว็บไซต์ การโฮสต์จากต้นทางเดียวกันเป็นแนวทางปฏิบัติแนะนำเพื่อให้คุณใช้ประโยชน์จากคุกกี้ที่เซิร์ฟเวอร์กำหนดและได้รับประโยชน์ด้านความปลอดภัยและใช้ได้นาน วิธีการด้านล่างใช้สำหรับการตั้งค่าการแสดงผลจากแหล่งที่มาเดียวกัน ไม่ว่าแท็ก Google ที่ติดตั้งใช้งานในเว็บไซต์จะเป็น gtag.js หรือ gtm.js ก็ตาม

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

ตารางด้านล่างแสดงวิธีโฮสต์เซิร์ฟเวอร์การติดแท็กเมื่อโฮสต์เว็บไซต์หลักใน www.example.com

	ต้นทางเดียวกัน (แนวทางปฏิบัติแนะนำ)	โดเมนย่อย	โดเมนเริ่มต้น
URL ตัวอย่าง	https://www.example.com/metrics	https://metrics.example.com	https://metrics.run.app
การเข้าถึงคุกกี้ที่ตั้งค่าโดยเซิร์ฟเวอร์	เข้าถึงสิทธิประโยชน์ด้านความปลอดภัยและความทนทานได้อย่างเต็มที่	เข้าถึงสิทธิประโยชน์ด้านความปลอดภัยและความทนทานได้อย่างเต็มที่	ไม่มี ตั้งค่าได้เฉพาะคุกกี้ JavaScript
ความซับซ้อนในการตั้งค่า	กำหนดค่า CDN หรือตัวจัดสรรภาระงานเพื่อส่งต่อคำขอ อาจต้องอัปเดตรายการ DNS	อัปเดตรายการ DNS	มีการกําหนดค่าล่วงหน้า

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

โดเมนย่อย ต้นทางเดียวกัน

ข้อกำหนดเบื้องต้น

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

• ตั้งค่าคอนเทนเนอร์เซิร์ฟเวอร์ใน Tag Manager
• ตั้งค่าเซิร์ฟเวอร์การติดแท็ก
• CDN หรือตัวจัดสรรภาระงานที่ส่งต่อคำขอได้
• หากคุณใช้ App Engine: เซิร์ฟเวอร์การติดแท็กต้องใช้งานเวอร์ชัน 2.2.0 ขึ้นไป หากต้องการเตรียมเซิร์ฟเวอร์การติดแท็กให้พร้อมรับอนาคต ให้ย้ายข้อมูลไปยัง Cloud Run

กำหนดค่าโดเมนที่กำหนดเอง

คุณสามารถสร้างค่าคอนเทนเนอร์ของเซิร์ฟเวอร์ให้ทำงานบนเส้นทางจากโดเมนเดียวกันกับเว็บไซต์ของคุณได้ เช่น หากเว็บไซต์มีการเข้าชมเว็บที่ www.example.com ให้จองเส้นทาง เช่น www.example.com/metrics สำหรับคอนเทนเนอร์ของเซิร์ฟเวอร์

1. เลือกเส้นทางของโดเมนที่จะใช้กับเซิร์ฟเวอร์การติดแท็ก

ระบบจะสงวนเส้นทางนี้ไว้สําหรับการติดตั้งใช้งานการแสดงโฆษณาของบุคคลที่หนึ่งนี้ ตรวจสอบว่าคุณเลือกเส้นทางที่ยังไม่ได้ใช้

ตัวอย่างเส้นทางที่คุณอาจต้องการใช้ ได้แก่ /collect, /metrics, /data

จดสตริงเส้นทางนี้ไว้ คุณจะใช้รหัสนี้ในขั้นตอนต่อๆ มาแทน /metrics ในทุกที่ที่เห็น /metrics

2. กำหนดเส้นทางการเข้าชมไปยังเซิร์ฟเวอร์การติดแท็ก

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

1. เพิ่มต้นทางหรือแบ็กเอนด์ที่นำไปยังเว็บไซต์ของคุณ
2. ลบล้างส่วนหัวของโฮสต์ให้เป็นชื่อโฮสต์ของเว็บไซต์ เช่น example.com
3. อนุญาตให้ส่งต่อคุกกี้และสตริงการค้นหาทั้งหมด หากแพลตฟอร์มไม่มีตัวเลือกนี้ นั่นหมายความว่าน่าจะดำเนินการเช่นนี้อยู่แล้วโดยค่าเริ่มต้น
4. เพิ่มต้นทางหรือแบ็กเอนด์อื่นที่นำไปยังเซิร์ฟเวอร์การติดแท็ก ซึ่งอาจเป็นโดเมนจากผู้ให้บริการคลาวด์ เช่น metrics.run.app
5. ลบล้างส่วนหัวของโฮสต์ให้เป็นค่าเดียวกันกับโดเมนที่ระบุไว้ก่อนหน้านี้ อนุญาตให้ส่งต่อคุกกี้และสตริงการค้นหาทั้งหมด
6. เพิ่มกฎของเส้นทาง เช่น /metrics/* เพื่อกําหนดเส้นทางการเข้าชมไปยังเซิร์ฟเวอร์การติดแท็ก
7. กําหนดค่าเส้นทางการติดแท็กฝั่งเซิร์ฟเวอร์ที่จองไว้ให้มีลําดับความสําคัญสูงกว่ากฎเริ่มต้น
8. อัปเดต DNS ให้นำไปยัง CDN หรือตัวจัดสรรภาระงาน หากยังไม่ได้ดำเนินการ การอัปเดต DNS อาจใช้เวลาสักพักในการเผยแพร่
9. ไปที่ปลายทาง /healthy ในโดเมนที่คุณเพิ่งสร้าง เช่น https://example.com/metrics/healthy คุณควรเห็น ok

3. อัปเดต URL ของเซิร์ฟเวอร์ใน Google Tag Manager

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

วิธีอัปเดตเป็นปลายทางใหม่

1. เปิด Google Tag Manager
2. เปิดคอนเทนเนอร์เซิร์ฟเวอร์ที่ตั้งค่าในต้นทางเดียวกับเว็บไซต์
3. ในแท็บผู้ดูแลระบบ > การตั้งค่าคอนเทนเนอร์ ให้นํา URL ก่อนหน้าทั้งหมดออก ขั้นตอนนี้จําเป็นเนื่องจาก URL ของคอนเทนเนอร์เซิร์ฟเวอร์ทั้งหมดต้องใช้เส้นทางเดียวกัน
4. คลิกเพิ่ม URL แล้วป้อน URL รวมถึงคำนำหน้าเส้นทาง
5. บันทึกและกลับไปที่พื้นที่ทํางาน
6. คลิกปุ่มแสดงตัวอย่างเพื่อเริ่มเซสชันการแก้ไขข้อบกพร่องใหม่และส่งคำขอในแท็บแยกต่างหาก
7. คลิกคำขอที่ส่ง ตรวจสอบว่าลูกค้าอ้างสิทธิ์คำขอขาเข้าแล้ว

แก้ไขปัญหาทั่วไป

1. ตัวอย่างไม่แสดงคําขอขาเข้า
   1. ไปที่เครื่องมือสำรวจบันทึกของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ ยืนยันว่าการติดตั้งใช้งานการติดแท็กฝั่งเซิร์ฟเวอร์ได้รับการเข้าชม หากไม่ได้เปิด ให้ทำตามวิธีการในขั้นตอนที่ 1
   2. ยืนยันว่า CDN หรือตัวจัดสรรภาระงานส่งต่อคุกกี้
   3. ตรวจสอบว่าคุณมีเซิร์ฟเวอร์เวอร์ชันตัวอย่างเพียงเซิร์ฟเวอร์เดียว และเซิร์ฟเวอร์ติดแท็กมีการตั้งค่า PREVIEW_SERVER_URL
   4. ตรวจสอบว่าเซิร์ฟเวอร์เวอร์ชันตัวอย่างทำงานอยู่โดยไปที่ PREVIEW_SERVER_URL + /healthy คุณควรเห็น ok
2. ไคลเอ็นต์ไม่ได้อ้างสิทธิ์คำขอ - อัปเดต URL ในการตั้งค่า คอนเทนเนอร์เพื่อใช้เส้นทางที่สงวนไว้ หาก URL ไม่มีเส้นทางหรือเส้นทางแตกต่างกัน ลูกค้าจะไม่ทํางานอย่างถูกต้อง