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

บทความนี้มีไว้สําหรับนักพัฒนาซอฟต์แวร์ที่ต้องการโฮสต์การติดแท็กฝั่งเซิร์ฟเวอร์ในบริบทของบุคคลที่หนึ่งเดียวกับเว็บไซต์ การโฮสต์จากต้นทางเดียวกันเป็นแนวทางปฏิบัติแนะนำเพื่อให้คุณใช้ประโยชน์จากคุกกี้ที่เซิร์ฟเวอร์กำหนดและได้รับประโยชน์ด้านความปลอดภัยและใช้ได้นาน วิธีการด้านล่างใช้สำหรับการตั้งค่าการแสดงโฆษณาจากแหล่งที่มาเดียวกัน ไม่ว่าแท็ก 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 ไม่มีเส้นทางหรือเส้นทางแตกต่างกัน ไคลเอ็นต์จะไม่ทํางานอย่างถูกต้อง