המאמר הזה מיועד למפתחים שמפעילים סקריפטים של Google מהשרת שלהם. מומלץ להפעיל התנהגות ספציפית לאזור עבור תגים כדי להשתמש בתכונות כמו סטטוס הסכמה מתקדם, וכדי לשלוט בהתנהגות התגים על סמך המיקום של המשתמשים.
אם אתם מציגים סקריפט מדומיין אינטראקציה ישירה, אתם צריכים לספק את נתוני המיקום הגיאוגרפי של המשתמש בכותרת הבקשה כדי שתוכלו להשתמש בפרמטרים event_location.country ו-event_location.region. אם כתובת ה-IP זמינה בכותרת הבקשה, היא מקבלת עדיפות בקביעת המיקום הגיאוגרפי. אחרת, הפרמטרים event_location.country ו-event_location.region משמשים לשליחת מידע על המדינה והאזור, בהתאמה.
לפני שמתחילים
במדריך הזה אנחנו יוצאים מנקודת הנחה שביצעתם את הפעולות הבאות:
- הגדרת מאגר תגים בצד השרת ב-Tag Manager
- הגדרת שרת תיוג
- הגדרת הצגת סקריפטים מאינטראקציה ישירה (First-Party)
שלב 1: הגדרת כותרת הבקשה
צריך לשלוח כותרות ספציפיות של בקשות שמכילות את פרטי האזור של המשתמש, כמו שמתואר בקטעים הבאים.
אתם יכולים להתחיל ישירות משלב 2 אם:
- אתם משתמשים ב-App Engine. App Engine שולח כותרות גיאוגרפיות באופן אוטומטי.
- אתם משתמשים בספק תשתית שונה מהספקים שמפורטים בהמשך. צריך להגדיר כותרות בהתאמה אישית.
Cloud Run עם מאזן עומסים של GCP
אפשר לשלוח מידע על מיקום גיאוגרפי עם כל כותרות הבקשות של HTTP, או עם בקשות ספציפיות. הוספה של כותרות מותאמות אישית לבקשות כרוכה בתשלום על כל מיליון בקשות, ולכן מומלץ לכלול מידע גיאוגרפי רק בבקשות להצגת סקריפטים של Google. האפשרות הזו דורשת יותר הגדרות בהתחלה, אבל היא עוזרת לכם להפעיל את התשתית בצורה חסכונית ככל האפשר.
בקשות סקריפט
כדי לכלול את כותרות המיקום הגיאוגרפי רק בבקשות של סקריפטים, צריך להגדיר קצה עורפי חדש וליצור כללי ניתוב.
כדי ליצור קצה עורפי חדש:
- פתיחת מאזן העומסים של GCP
- במאזן העומסים, פותחים את הקטע Backend configuration (הגדרות ה-Backend). יוצרים שירות קצה עורפי חדש.
- מגדירים את שירות הקצה העורפי החדש:
- Backend type: בוחרים את הסוג של קבוצת נקודות קצה ברשת שבו האפליקציה משתמשת. אם משתמשים ב-Cloud Run, בוחרים באפשרות קבוצה של נקודות קצה ברשת ללא שרת.
- בNew backend (קצה עורפי חדש), בוחרים את קבוצת נקודות הקצה ברשת של פריסת Tag Manager בצד השרת.
- פותחים את הקטע הגדרות מתקדמות. מוסיפים את כותרות הבקשה המותאמות אישית.
שם הכותרת ערך הכותרת X-Gclb-Country {client_region} X-Gclb-Region {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. יוצרים כותרות מותאמות אישית חדשות של בקשות לכל כותרת מהכותרות הבאות:
| הכותרת | ערך הכותרת |
|---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
מאזן עומסים ב-GCP
אפשר לשלוח מידע על מיקום גיאוגרפי עם כל כותרות הבקשות של HTTP, או עם בקשות ספציפיות. הוספה של כותרות מותאמות אישית לבקשות כרוכה בתשלום על כל מיליון בקשות, ולכן מומלץ לכלול מידע גיאוגרפי רק בבקשות להצגת סקריפטים של Google. האפשרות הזו דורשת יותר הגדרות בהתחלה, אבל היא עוזרת לכם להפעיל את התשתית בצורה חסכונית ככל האפשר.
בקשות סקריפט
כדי לכלול את כותרות המיקום הגיאוגרפי רק בבקשות של סקריפטים, צריך להגדיר קצה עורפי חדש וליצור כללי ניתוב.
כדי ליצור קצה עורפי חדש:
- פתיחת מאזן העומסים של GCP
- במאזן העומסים, פותחים את הקטע Backend configuration (הגדרות ה-Backend). יוצרים שירות קצה עורפי חדש.
- מגדירים את שירות הקצה העורפי החדש:
- Backend type: בוחרים את הסוג של קבוצת נקודות קצה ברשת שבו האפליקציה משתמשת. אם משתמשים ב-Cloud Run, בוחרים באפשרות קבוצה של נקודות קצה ברשת ללא שרת.
- בNew backend (קצה עורפי חדש), בוחרים את קבוצת נקודות הקצה ברשת של פריסת Tag Manager בצד השרת.
- פותחים את הקטע הגדרות מתקדמות. מוסיפים את כותרות הבקשה המותאמות אישית.
שם הכותרת ערך הכותרת X-Gclb-Country {client_region} X-Gclb-Region {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. יוצרים כותרות מותאמות אישית חדשות של בקשות לכל כותרת מהכותרות הבאות:
| הכותרת | ערך הכותרת |
|---|---|
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 Front Door
באמצעות מנוע הכללים, יוצרים קבוצת כללים עם הפעולה שינוי כותרת הבקשה עם המיפוי הבא:
| שם הכותרת | ערך הכותרת |
|---|---|
| X-Azure-Country | {geo_country} |
Cloudflare
מפעילים את האפשרות 'הוספת כותרות של מיקום המבקר' בקטע 'שינויים מנוהלים':
הפעולה הזו תוסיף באופן אוטומטי את הכותרת הבאה יחד עם הערך שלה:
| שם הכותרת | ערך הכותרת |
|---|---|
| CF-IPCountry | המדינה של המשתמש |
שלב 2: הגדרת המשתנה Visitor Region
אם הגדרתם כותרות גיאוגרפיות כמו שמתואר למעלה, Tag Manager יזהה באופן אוטומטי את האזור או המדינה על ידי קריאת כותרת הבקשה של ה-HTTP. אפשרות אחרת היא להגדיר כותרות בהתאמה אישית.
זיהוי אוטומטי
- פותחים את Google Tag Manager
- פותחים את מאגר התגים בצד השרת.
- בתפריט Variables (משתנים), Configure (הגדרה) את רשימת המשתנים המובנים.
- בוחרים באפשרות אזור המבקר.
מעכשיו אפשר להשתמש בכותרות הגיאוגרפיות במשתנה Visitor Region (אזור המבקר).
כותרות מותאמות אישית
- פותחים את Google Tag Manager
- פותחים את מאגר התגים בצד השרת.
- בתפריט Variables (משתנים), יוצרים משתנה שהוגדר על ידי המשתמש חדש מסוג Visitor Region (אזור המבקר).
- בקטע Variable Configuration (הגדרת המשתנה), בוחרים באפשרות Custom Variable (משתנה מותאם אישית).
בתפריט Variables (משתנים), יוצרים שני משתנים חדשים מסוג Request header (כותרת בקשה): אחד למדינה ואחד לקוד של חלוקה משנית. ממלאים את הערכים עם קודי המדינות בכותרות הבקשה של ה-HTTP.
משתמשים במשתנים שיצרתם במשתנה Visitor Region (אזור המבקר) כמו שמוצג בצילום המסך.
נותנים שם למשתנה ולוחצים על שמירה.
שלב 3: הפעלת הגדרות ספציפיות לאזור בלקוח
כדי להשתמש באזור של המבקר לעיבוד בקשות HTTP נכנסות, צריך להוסיף אותו ללקוח.
בוחרים את הלקוח Google Tag Manager: Web container (מאגר תגים באינטרנט).
מסמנים את האפשרות הפעלת הגדרות ספציפיות לאזור. מוסיפים את המשתנה {{Visitor Region}} שיצרתם בשלב הקודם לשדה Region (אזור).
שומרים את הלקוח.
שלב 4: מוודאים שההגדרות של האזור חלות
כדי לבדוק אם ההגדרות פועלות:
- פותחים את מצב התצוגה המקדימה של מאגר התגים בצד השרת.
- טוענים את האתר בזמן השימוש בהצגת מודעות מהדומיין הנוכחי.
- בחלון התצוגה המקדימה, לוחצים על הלקוח Google Analytics GA4 שנרשם.
- כדי לראות את האזור בפועל, משנים את לחצן הבחירה הצגת משתנים לערכים.
- ✅ ההטמעה שלכם נכונה אם מאפיין האזור מציג קוד מדינה.
- ❌ אם המאפיין Region מציג
undefinedאו חסר, השרת שלכם לא מקבל נתוני אזור. בודקים אם כותרות ה-HTTP של השרת מוגדרות בהתאם למשתנים המוגדרים מראש ש-Google Tag Manager מחפש. אפשר לעיין במאמר בנושא הגדרת כותרת הבקשה.