เปิดใช้ลักษณะการทำงานเฉพาะภูมิภาคสำหรับแท็ก

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

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

คู่มือนี้จะถือว่าคุณได้ดำเนินการต่อไปนี้แล้ว

• ตั้งค่าคอนเทนเนอร์เซิร์ฟเวอร์ใน Tag Manager
• ตั้งค่าเซิร์ฟเวอร์การติดแท็ก
• ตั้งค่าการแสดงสคริปต์ของบุคคลที่หนึ่ง

ขั้นตอนที่ 1: ตั้งค่าส่วนหัวของคำขอ

คุณต้องส่งส่วนหัวของคำขอที่เฉพาะเจาะจงซึ่งมีข้อมูลภูมิภาคของผู้ใช้ตามที่อธิบายไว้ในส่วนด้านล่าง

คุณเริ่มที่ขั้นตอนที่ 2 ได้โดยตรงในกรณีต่อไปนี้

• คุณใช้ App Engine App Engine จะส่งส่วนหัวทางภูมิศาสตร์โดยอัตโนมัติ
• คุณใช้ผู้ให้บริการโครงสร้างพื้นฐานรายอื่นที่ไม่อยู่ในรายการด้านล่าง คุณต้องตั้งค่าส่วนหัวที่กำหนดเอง

Cloud Run ที่มีตัวจัดสรรภาระงาน GCP

คุณส่งข้อมูลตำแหน่งทางภูมิศาสตร์พร้อมส่วนหัวของคำขอ HTTP ทั้งหมดหรือสำหรับคำขอที่ต้องการได้ เนื่องจากการเพิ่มส่วนหัวของคำขอที่กำหนดเองจะมีค่าธรรมเนียมต่อคำขอ 1 ล้านรายการ เราจึงขอแนะนำให้ใส่เฉพาะข้อมูลทางภูมิศาสตร์สำหรับคำขอในการแสดงสคริปต์ Google เท่านั้น ตัวเลือกนี้ในช่วงแรกต้องมีการตั้งค่าเพิ่มเติม แต่จะช่วยให้คุณใช้งานโครงสร้างพื้นฐานได้อย่างคุ้มค่ามากที่สุด

คำขอสคริปต์

หากต้องการใส่ส่วนหัวทางภูมิศาสตร์สำหรับคำขอสคริปต์เท่านั้น คุณต้องตั้งค่าแบ็กเอนด์ใหม่และสร้างกฎการกำหนดเส้นทาง

วิธีสร้างแบ็กเอนด์ใหม่

1. เปิดตัวจัดสรรภาระงาน GCP
2. ในตัวจัดสรรภาระงาน ให้เปิดส่วนการกำหนดค่าแบ็กเอนด์ สร้างบริการแบ็กเอนด์ใหม่
   
3. กำหนดค่าบริการแบ็กเอนด์ใหม่ของคุณ:
   • ประเภทแบ็กเอนด์: เลือกประเภทกลุ่มปลายทางของเครือข่ายที่แอปพลิเคชันใช้ หากใช้ Cloud Run ให้เลือกกลุ่มปลายทางเครือข่ายแบบ Serverless
   • ในแบ็กเอนด์ใหม่ ให้เลือกกลุ่มปลายทางของเครือข่ายของ Tag Manager ฝั่งเซิร์ฟเวอร์ที่คุณใช้งานได้
     
4. เปิดส่วนการกำหนดค่าขั้นสูง เพิ่มส่วนหัวของคำขอที่กำหนดเอง
   

   ชื่อส่วนหัว	ค่าของส่วนหัว
   X-Gclb-ประเทศ	{client_region}
   ภูมิภาค X-Gclb	{client_region_subdivision}

5. บันทึกบริการแบ็กเอนด์ใหม่

วิธีกำหนดค่ากฎการกำหนดเส้นทาง

1. เปิดส่วนกฎการกำหนดเส้นทางในตัวจัดสรรภาระงาน เลือกโหมด เส้นทางและกฎโฮสต์ขั้นสูง
2. อัปเดตพารามิเตอร์ pathRules เพื่อแมป gtm.js, /gtag/js และ /gtag/destination กับบริการแบ็กเอนด์ใหม่
   

   pathRules:
   - paths:
     - /gtm.js
     - /gtag*
     service: projects/project_id/global/backendServices/new backend service
   - paths:
     - /*
     service: projects/project_id/global/backendServices/original backend service
   

3. บันทึกการเปลี่ยนแปลง

คำขอทั้งหมด

หากต้องการส่งข้อมูลตำแหน่งทางภูมิศาสตร์ที่มีคำขอ HTTP ทั้งหมด คุณต้องเพิ่มส่วนหัวของคำขอที่กำหนดเองในบริการแบ็กเอนด์ที่มีอยู่ โปรดดูเอกสารของ Google Cloud สร้างส่วนหัวของคำขอที่กำหนดเองใหม่ 1 รายการสำหรับส่วนหัวแต่ละรายการด้านล่าง

ชื่อส่วนหัว	ค่าของส่วนหัว
X-Gclb-Country	{client_region}
X-Gclb-Country	{client_region_subdivision}

ตัวจัดสรรภาระงาน GCP

คุณส่งข้อมูลตำแหน่งทางภูมิศาสตร์พร้อมส่วนหัวของคำขอ HTTP ทั้งหมดหรือสำหรับคำขอที่ต้องการได้ เนื่องจากการเพิ่มส่วนหัวของคำขอที่กำหนดเองจะมีค่าธรรมเนียมต่อคำขอ 1 ล้านรายการ เราจึงขอแนะนำให้ใส่เฉพาะข้อมูลทางภูมิศาสตร์สำหรับคำขอในการแสดงสคริปต์ Google เท่านั้น ตัวเลือกนี้ในช่วงแรกต้องมีการตั้งค่าเพิ่มเติม แต่จะช่วยให้คุณใช้งานโครงสร้างพื้นฐานได้อย่างคุ้มค่ามากที่สุด

คำขอสคริปต์

หากต้องการใส่ส่วนหัวทางภูมิศาสตร์สำหรับคำขอสคริปต์เท่านั้น คุณต้องตั้งค่าแบ็กเอนด์ใหม่และสร้างกฎการกำหนดเส้นทาง

วิธีสร้างแบ็กเอนด์ใหม่

1. เปิดตัวจัดสรรภาระงาน GCP
2. ในตัวจัดสรรภาระงาน ให้เปิดส่วนการกำหนดค่าแบ็กเอนด์ สร้างบริการแบ็กเอนด์ใหม่
   
3. กำหนดค่าบริการแบ็กเอนด์ใหม่ของคุณ:
   • ประเภทแบ็กเอนด์: เลือกประเภทกลุ่มปลายทางของเครือข่ายที่แอปพลิเคชันใช้ หากใช้ Cloud Run ให้เลือกกลุ่มปลายทางเครือข่ายแบบ Serverless
   • ในแบ็กเอนด์ใหม่ ให้เลือกกลุ่มปลายทางของเครือข่ายของ Tag Manager ฝั่งเซิร์ฟเวอร์ที่คุณใช้งานได้
     
4. เปิดส่วนการกำหนดค่าขั้นสูง เพิ่มส่วนหัวของคำขอที่กำหนดเอง
   

   ชื่อส่วนหัว	ค่าของส่วนหัว
   X-Gclb-ประเทศ	{client_region}
   ภูมิภาค X-Gclb	{client_region_subdivision}

5. บันทึกบริการแบ็กเอนด์ใหม่

วิธีกำหนดค่ากฎการกำหนดเส้นทาง

1. เปิดส่วนกฎการกำหนดเส้นทางในตัวจัดสรรภาระงาน เลือกโหมด เส้นทางและกฎโฮสต์ขั้นสูง
2. อัปเดตพารามิเตอร์ pathRules เพื่อแมป gtm.js, /gtag/js และ /gtag/destination กับบริการแบ็กเอนด์ใหม่
   

   pathRules:
   - paths:
     - /gtm.js
     - /gtag*
     service: projects/project_id/global/backendServices/new backend service
   - paths:
     - /*
     service: projects/project_id/global/backendServices/original backend service
   

3. บันทึกการเปลี่ยนแปลง

คำขอทั้งหมด

หากต้องการส่งข้อมูลตำแหน่งทางภูมิศาสตร์ที่มีคำขอ HTTP ทั้งหมด คุณต้องเพิ่มส่วนหัวของคำขอที่กำหนดเองในบริการแบ็กเอนด์ที่มีอยู่ โปรดดูเอกสารของ Google Cloud สร้างส่วนหัวของคำขอที่กำหนดเองใหม่ 1 รายการสำหรับส่วนหัวแต่ละรายการด้านล่าง

ชื่อส่วนหัว	ค่าของส่วนหัว
X-Gclb-Country	{client_region}
X-Gclb-Country	{client_region_subdivision}

Amazon Web Services (AWS) CloudFront

สร้างนโยบายคำขอต้นทางเพื่อเพิ่มส่วนหัว CloudFront-Viewer-Country และ CloudFront-Viewer-Country-Region ในคำขอ

วิธีนี้จะเพิ่มส่วนหัวต่อไปนี้พร้อมกับค่าโดยอัตโนมัติ

ชื่อส่วนหัว	ค่าของส่วนหัว
CloudFront-Viewer-Country	ประเทศของผู้ใช้
CloudFront-Viewer-Country-Region	การแยกย่อยของผู้ใช้

ประตูหน้าบ้านสี Azure

ใช้ Rule Engine เพื่อสร้างชุดกฎที่มีการดำเนินการแก้ไขส่วนหัวของคำขอด้วยการแมปต่อไปนี้

ชื่อส่วนหัว	ค่าของส่วนหัว
เอ็กซ์อาซูร์-คันทรี	{geo_country}

Cloudflare

เปิดใช้ "เพิ่มส่วนหัวสถานที่ตั้งของผู้เข้าชม" ในส่วนการเปลี่ยนรูปแบบที่มีการจัดการ โดยทำดังนี้

การดำเนินการนี้จะเพิ่มส่วนหัวต่อไปนี้พร้อมกับค่าโดยอัตโนมัติ

ชื่อส่วนหัว	ค่าของส่วนหัว
ประเทศ CF-IP	ประเทศของผู้ใช้

ขั้นตอนที่ 2: ตั้งค่าตัวแปรภูมิภาคผู้เข้าชม

หากคุณตั้งค่าส่วนหัวทางภูมิศาสตร์ตามที่ระบุไว้ข้างต้น เครื่องจัดการแท็กจะตรวจหาภูมิภาคหรือประเทศโดยอัตโนมัติด้วยการอ่านส่วนหัวของคำขอ HTTP หรือคุณจะตั้งค่าส่วนหัวที่กำหนดเองก็ได้

การตรวจหาอัตโนมัติ

1. เปิด Google Tag Manager
2. เปิดคอนเทนเนอร์เซิร์ฟเวอร์
3. ในเมนูตัวแปร ให้กำหนดค่ารายการตัวแปรบิวท์อิน
4. เลือกภูมิภาคของผู้เข้าชม

ตอนนี้ส่วนหัวทางภูมิศาสตร์จะพร้อมใช้งานในตัวแปรภูมิภาคผู้เข้าชม

ส่วนหัวที่กำหนดเอง

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

5. ในเมนูตัวแปร ให้สร้างตัวแปรส่วนหัวของคำขอใหม่ 2 รายการ โดยรายการหนึ่งสำหรับประเทศของคุณ และอีกตัวแปรสำหรับรหัสส่วนย่อย กรอกค่าด้วยรหัสประเทศในส่วนหัวของคำขอ HTTP

   หมายเหตุ: รูปแบบต้องเป็นไปตาม ISO-3166-2

6. ใช้ตัวแปรที่สร้างขึ้นในตัวแปรภูมิภาคผู้เข้าชมดังที่แสดงในภาพหน้าจอ

   

7. ตั้งชื่อตัวแปรแล้วบันทึก

ขั้นตอนที่ 3: เปิดใช้การตั้งค่าเฉพาะภูมิภาคในไคลเอ็นต์

หากต้องการใช้ภูมิภาคของผู้เข้าชมในการประมวลผลคำขอ HTTP ขาเข้า คุณต้องเพิ่มภูมิภาคนั้นลงในไคลเอ็นต์

1. เลือกไคลเอ็นต์หรือสร้างไคลเอ็นต์ใหม่ที่คุณต้องการใช้การตั้งค่าภูมิภาคด้วย ไคลเอ็นต์ที่รองรับมีดังนี้

   • Google Tag Manager: คอนเทนเนอร์เว็บ
   • Google Analytics: GA4
   • Google Analytics: Universal Analytics

2. หากกําหนดค่าไคลเอ็นต์ GA4 หรือ UA ให้เลือกช่องเส้นทาง gtag.js เริ่มต้นสําหรับรหัสที่เฉพาะเจาะจง แล้วป้อนรหัสการวัดของคอนเทนเนอร์เว็บ

3. เลือกเปิดใช้การตั้งค่าเฉพาะภูมิภาค เพิ่มตัวแปร {{ภูมิภาคผู้เข้าชม}} ที่คุณสร้างในขั้นตอนก่อนหน้าลงในช่องภูมิภาค

4. บันทึกลูกค้า

ขั้นตอนที่ 4: ยืนยันว่ามีการใช้การตั้งค่าภูมิภาคแล้ว

หากต้องการทดสอบว่าการตั้งค่าใช้งานได้หรือไม่ ให้ทำดังนี้

1. เปิดโหมดแสดงตัวอย่างของคอนเทนเนอร์เซิร์ฟเวอร์
2. โหลดเว็บไซต์ขณะใช้การแสดงของบุคคลที่หนึ่ง
3. ในหน้าต่างแสดงตัวอย่าง ให้คลิกไคลเอ็นต์ Google Analytics GA4 หรือ Universal Analytics ที่อ้างสิทธิ์แล้ว
4. หากต้องการดูภูมิภาคจริง ให้เปลี่ยนปุ่มตัวเลือกตัวแปรดิสเพลย์เป็นค่า
   • ✅ การใช้งานถูกต้องหากพร็อพเพอร์ตี้ภูมิภาคแสดงรหัสประเทศ
   • ❌ หากพร็อพเพอร์ตี้ภูมิภาคแสดง undefined หรือพร็อพเพอร์ตี้ขาดหายไป แสดงว่าเซิร์ฟเวอร์ไม่ได้รับข้อมูลภูมิภาค ตรวจสอบว่าได้ตั้งค่าส่วนหัว HTTP ของเซิร์ฟเวอร์ตามตัวแปรที่กำหนดไว้ล่วงหน้าที่ Google Tag Manager ต้องการหรือไม่ โปรดดูที่ตั้งค่าส่วนหัวของคำขอ

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

• ตั้งค่าโหมดความยินยอมสําหรับภูมิภาคที่เฉพาะเจาะจงในคอนเทนเนอร์เว็บ