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

บทความนี้มีไว้สําหรับนักพัฒนาซอฟต์แวร์ที่แสดงสคริปต์ 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-Country	{client_region}
   X-Gclb-Region	{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-Country	{client_region}
   X-Gclb-Region	{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}

CloudFront ของ Amazon Web Services (AWS)

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

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

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

Azure Front Door

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

ชื่อส่วนหัว	ค่าของส่วนหัว
X-Azure-Country	{geo_country}

Cloudflare

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

1. เลือกลูกค้าหรือสร้างลูกค้าใหม่ที่ต้องการใช้การตั้งค่าภูมิภาค โปรแกรมที่รองรับ ได้แก่

   • Google Tag Manager: คอนเทนเนอร์ฝั่งเว็บ
   • Google Analytics: GA4

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

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

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

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

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

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

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

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