บทความนี้มีไว้สําหรับนักพัฒนาซอฟต์แวร์ที่ให้บริการสคริปต์ Google จากเซิร์ฟเวอร์ของตนเอง เราขอแนะนำให้เปิดใช้ลักษณะการทำงานเฉพาะภูมิภาคสำหรับแท็กเพื่อปลดล็อกฟีเจอร์ เช่น โหมดความยินยอมขั้นสูง และเพื่อควบคุมลักษณะการทํางานของแท็กตามสถานที่ที่ผู้ใช้อยู่
ก่อนเริ่มต้น
คู่มือนี้จะถือว่าคุณได้ดำเนินการต่อไปนี้แล้ว
- ตั้งค่าคอนเทนเนอร์เซิร์ฟเวอร์ใน Tag Manager
- ตั้งค่าเซิร์ฟเวอร์การติดแท็ก
- ตั้งค่าการแสดงสคริปต์ของบุคคลที่หนึ่ง
ขั้นตอนที่ 1: ตั้งค่าส่วนหัวของคำขอ
คุณต้องส่งส่วนหัวของคำขอที่เฉพาะเจาะจงซึ่งมีข้อมูลภูมิภาคของผู้ใช้ตามที่อธิบายไว้ในส่วนด้านล่าง
คุณเริ่มที่ขั้นตอนที่ 2 ได้โดยตรงในกรณีต่อไปนี้
- คุณใช้ App Engine App Engine จะส่งส่วนหัวทางภูมิศาสตร์โดยอัตโนมัติ
- คุณใช้ผู้ให้บริการโครงสร้างพื้นฐานรายอื่นที่ไม่อยู่ในรายการด้านล่าง คุณต้องตั้งค่าส่วนหัวที่กำหนดเอง
Cloud Run ที่มีตัวจัดสรรภาระงาน GCP
คุณส่งข้อมูลตำแหน่งทางภูมิศาสตร์พร้อมส่วนหัวของคำขอ HTTP ทั้งหมดหรือสำหรับคำขอที่ต้องการได้ เนื่องจากการเพิ่มส่วนหัวของคำขอที่กำหนดเองจะมีค่าธรรมเนียมต่อคำขอ 1 ล้านรายการ เราจึงขอแนะนำให้ใส่เฉพาะข้อมูลทางภูมิศาสตร์สำหรับคำขอในการแสดงสคริปต์ Google เท่านั้น ตัวเลือกนี้ในช่วงแรกต้องมีการตั้งค่าเพิ่มเติม แต่จะช่วยให้คุณใช้งานโครงสร้างพื้นฐานได้อย่างคุ้มค่ามากที่สุด
คำขอสคริปต์
หากต้องการใส่ส่วนหัวทางภูมิศาสตร์สำหรับคำขอสคริปต์เท่านั้น คุณต้องตั้งค่าแบ็กเอนด์ใหม่และสร้างกฎการกำหนดเส้นทาง
วิธีสร้างแบ็กเอนด์ใหม่
- เปิดตัวจัดสรรภาระงาน GCP
- ในตัวจัดสรรภาระงาน ให้เปิดส่วนการกำหนดค่าแบ็กเอนด์ สร้างบริการแบ็กเอนด์ใหม่
- กำหนดค่าบริการแบ็กเอนด์ใหม่ของคุณ:
- ประเภทแบ็กเอนด์: เลือกประเภทกลุ่มปลายทางของเครือข่ายที่แอปพลิเคชันใช้ หากใช้ Cloud Run ให้เลือกกลุ่มปลายทางเครือข่ายแบบ Serverless
- ในแบ็กเอนด์ใหม่ ให้เลือกกลุ่มปลายทางของเครือข่ายของ Tag Manager ฝั่งเซิร์ฟเวอร์ที่คุณใช้งานได้
- เปิดส่วนการกำหนดค่าขั้นสูง เพิ่มส่วนหัวของคำขอที่กำหนดเอง
ชื่อส่วนหัว ค่าของส่วนหัว X-Gclb-ประเทศ {client_region} ภูมิภาค X-Gclb {client_region_subdivision} - บันทึกบริการแบ็กเอนด์ใหม่
วิธีกำหนดค่ากฎการกำหนดเส้นทาง
- เปิดส่วนกฎการกำหนดเส้นทางในตัวจัดสรรภาระงาน เลือกโหมด เส้นทางและกฎโฮสต์ขั้นสูง
- อัปเดตพารามิเตอร์
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
- บันทึกการเปลี่ยนแปลง
คำขอทั้งหมด
หากต้องการส่งข้อมูลตำแหน่งทางภูมิศาสตร์ที่มีคำขอ HTTP ทั้งหมด คุณต้องเพิ่มส่วนหัวของคำขอที่กำหนดเองในบริการแบ็กเอนด์ที่มีอยู่ โปรดดูเอกสารของ Google Cloud สร้างส่วนหัวของคำขอที่กำหนดเองใหม่ 1 รายการสำหรับส่วนหัวแต่ละรายการด้านล่าง
ชื่อส่วนหัว | ค่าของส่วนหัว |
---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
ตัวจัดสรรภาระงาน GCP
คุณส่งข้อมูลตำแหน่งทางภูมิศาสตร์พร้อมส่วนหัวของคำขอ HTTP ทั้งหมดหรือสำหรับคำขอที่ต้องการได้ เนื่องจากการเพิ่มส่วนหัวของคำขอที่กำหนดเองจะมีค่าธรรมเนียมต่อคำขอ 1 ล้านรายการ เราจึงขอแนะนำให้ใส่เฉพาะข้อมูลทางภูมิศาสตร์สำหรับคำขอในการแสดงสคริปต์ Google เท่านั้น ตัวเลือกนี้ในช่วงแรกต้องมีการตั้งค่าเพิ่มเติม แต่จะช่วยให้คุณใช้งานโครงสร้างพื้นฐานได้อย่างคุ้มค่ามากที่สุด
คำขอสคริปต์
หากต้องการใส่ส่วนหัวทางภูมิศาสตร์สำหรับคำขอสคริปต์เท่านั้น คุณต้องตั้งค่าแบ็กเอนด์ใหม่และสร้างกฎการกำหนดเส้นทาง
วิธีสร้างแบ็กเอนด์ใหม่
- เปิดตัวจัดสรรภาระงาน GCP
- ในตัวจัดสรรภาระงาน ให้เปิดส่วนการกำหนดค่าแบ็กเอนด์ สร้างบริการแบ็กเอนด์ใหม่
- กำหนดค่าบริการแบ็กเอนด์ใหม่ของคุณ:
- ประเภทแบ็กเอนด์: เลือกประเภทกลุ่มปลายทางของเครือข่ายที่แอปพลิเคชันใช้ หากใช้ Cloud Run ให้เลือกกลุ่มปลายทางเครือข่ายแบบ Serverless
- ในแบ็กเอนด์ใหม่ ให้เลือกกลุ่มปลายทางของเครือข่ายของ Tag Manager ฝั่งเซิร์ฟเวอร์ที่คุณใช้งานได้
- เปิดส่วนการกำหนดค่าขั้นสูง เพิ่มส่วนหัวของคำขอที่กำหนดเอง
ชื่อส่วนหัว ค่าของส่วนหัว X-Gclb-ประเทศ {client_region} ภูมิภาค X-Gclb {client_region_subdivision} - บันทึกบริการแบ็กเอนด์ใหม่
วิธีกำหนดค่ากฎการกำหนดเส้นทาง
- เปิดส่วนกฎการกำหนดเส้นทางในตัวจัดสรรภาระงาน เลือกโหมด เส้นทางและกฎโฮสต์ขั้นสูง
- อัปเดตพารามิเตอร์
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
- บันทึกการเปลี่ยนแปลง
คำขอทั้งหมด
หากต้องการส่งข้อมูลตำแหน่งทางภูมิศาสตร์ที่มีคำขอ 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 | การแยกย่อยของผู้ใช้ |
![การตั้งค่าส่วนหัวใน AWS CloudFront](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/aws-headers.png?authuser=19&hl=th)
ประตูหน้าบ้านสี Azure
ใช้ Rule Engine เพื่อสร้างชุดกฎที่มีการดำเนินการแก้ไขส่วนหัวของคำขอด้วยการแมปต่อไปนี้
ชื่อส่วนหัว | ค่าของส่วนหัว |
---|---|
เอ็กซ์อาซูร์-คันทรี | {geo_country} |
![ภาพหน้าจอของการกำหนดค่าประตูหน้า Azure](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/azure-headers.png?authuser=19&hl=th)
Cloudflare
เปิดใช้ "เพิ่มส่วนหัวสถานที่ตั้งของผู้เข้าชม" ในส่วนการเปลี่ยนรูปแบบที่มีการจัดการ โดยทำดังนี้
การดำเนินการนี้จะเพิ่มส่วนหัวต่อไปนี้พร้อมกับค่าโดยอัตโนมัติ
ชื่อส่วนหัว | ค่าของส่วนหัว |
---|---|
ประเทศ CF-IP | ประเทศของผู้ใช้ |
![ภาพหน้าจอของการกำหนดค่า Cloudflare](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/cloudflare-headers.png?authuser=19&hl=th)
ขั้นตอนที่ 2: ตั้งค่าตัวแปรภูมิภาคผู้เข้าชม
หากคุณตั้งค่าส่วนหัวทางภูมิศาสตร์ตามที่ระบุไว้ข้างต้น เครื่องจัดการแท็กจะตรวจหาภูมิภาคหรือประเทศโดยอัตโนมัติด้วยการอ่านส่วนหัวของคำขอ HTTP หรือคุณจะตั้งค่าส่วนหัวที่กำหนดเองก็ได้
การตรวจหาอัตโนมัติ
- เปิด Google Tag Manager
- เปิดคอนเทนเนอร์เซิร์ฟเวอร์
- ในเมนูตัวแปร ให้กำหนดค่ารายการตัวแปรบิวท์อิน
- เลือกภูมิภาคของผู้เข้าชม
ตอนนี้ส่วนหัวทางภูมิศาสตร์จะพร้อมใช้งานในตัวแปรภูมิภาคผู้เข้าชม
ส่วนหัวที่กำหนดเอง
- เปิด Google Tag Manager
- เปิดคอนเทนเนอร์เซิร์ฟเวอร์
- ในเมนูตัวแปร ให้สร้างตัวแปรใหม่ที่กำหนดโดยผู้ใช้ประเภทภูมิภาคของผู้เข้าชม
- ในการกำหนดค่าตัวแปร ให้เลือกตัวแปรที่กำหนดเอง
ในเมนูตัวแปร ให้สร้างตัวแปรส่วนหัวของคำขอใหม่ 2 รายการ โดยรายการหนึ่งสำหรับประเทศของคุณ และอีกตัวแปรสำหรับรหัสส่วนย่อย กรอกค่าด้วยรหัสประเทศในส่วนหัวของคำขอ HTTP
ใช้ตัวแปรที่สร้างขึ้นในตัวแปรภูมิภาคผู้เข้าชมดังที่แสดงในภาพหน้าจอ
ตั้งชื่อตัวแปรแล้วบันทึก
ขั้นตอนที่ 3: เปิดใช้การตั้งค่าเฉพาะภูมิภาคในไคลเอ็นต์
หากต้องการใช้ภูมิภาคของผู้เข้าชมในการประมวลผลคำขอ HTTP ขาเข้า คุณต้องเพิ่มภูมิภาคนั้นลงในไคลเอ็นต์
เลือกไคลเอ็นต์หรือสร้างไคลเอ็นต์ใหม่ที่คุณต้องการใช้การตั้งค่าภูมิภาคด้วย ไคลเอ็นต์ที่รองรับมีดังนี้
- Google Tag Manager: คอนเทนเนอร์เว็บ
- Google Analytics: GA4
- Google Analytics: Universal Analytics
หากกําหนดค่าไคลเอ็นต์ GA4 หรือ UA ให้เลือกช่องเส้นทาง gtag.js เริ่มต้นสําหรับรหัสที่เฉพาะเจาะจง แล้วป้อนรหัสการวัดของคอนเทนเนอร์เว็บ
เลือกเปิดใช้การตั้งค่าเฉพาะภูมิภาค เพิ่มตัวแปร {{ภูมิภาคผู้เข้าชม}} ที่คุณสร้างในขั้นตอนก่อนหน้าลงในช่องภูมิภาค
บันทึกลูกค้า
ขั้นตอนที่ 4: ยืนยันว่ามีการใช้การตั้งค่าภูมิภาคแล้ว
หากต้องการทดสอบว่าการตั้งค่าใช้งานได้หรือไม่ ให้ทำดังนี้
- เปิดโหมดแสดงตัวอย่างของคอนเทนเนอร์เซิร์ฟเวอร์
- โหลดเว็บไซต์ขณะใช้การแสดงของบุคคลที่หนึ่ง
- ในหน้าต่างแสดงตัวอย่าง ให้คลิกไคลเอ็นต์ Google Analytics GA4 หรือ Universal Analytics ที่อ้างสิทธิ์แล้ว
- หากต้องการดูภูมิภาคจริง ให้เปลี่ยนปุ่มตัวเลือกตัวแปรดิสเพลย์เป็นค่า
- ✅ การใช้งานถูกต้องหากพร็อพเพอร์ตี้ภูมิภาคแสดงรหัสประเทศ
- ❌ หากพร็อพเพอร์ตี้ภูมิภาคแสดง
undefined
หรือพร็อพเพอร์ตี้ขาดหายไป แสดงว่าเซิร์ฟเวอร์ไม่ได้รับข้อมูลภูมิภาค ตรวจสอบว่าได้ตั้งค่าส่วนหัว HTTP ของเซิร์ฟเวอร์ตามตัวแปรที่กำหนดไว้ล่วงหน้าที่ Google Tag Manager ต้องการหรือไม่ โปรดดูที่ตั้งค่าส่วนหัวของคำขอ