הפעלת התנהגות ספציפית לאזור של תגים

המאמר הזה מיועד למפתחים שמציגים סקריפטים של Google מהשרת שלהם. מומלץ להפעיל את ההתנהגות הספציפית לאזור עבור התגים כדי לקבל גישה לתכונות כמו סטטוס הסכמה מתקדם, וכדי לשלוט בהתנהגות התגים על סמך המיקום של המשתמשים.

לפני שמתחילים

המדריך הזה מניח שביצעתם את הפעולות הבאות:

שלב 1: מגדירים את כותרת הבקשה

צריך לשלוח כותרות בקשות ספציפיות שמכילות את פרטי האזור של המשתמש, כפי שמתואר בסעיפים שבהמשך.

אתם יכולים להתחיל ישירות משלב 2 אם:

  • אתם משתמשים ב-App Engine. App Engine שולח כותרות גיאוגרפיות באופן אוטומטי.
  • אתם משתמשים בספק תשתית אחר מזה שמפורט בהמשך. עליכם להגדיר כותרות בהתאמה אישית.

Cloud Run עם מאזן עומסים של GCP

אפשר לשלוח נתוני מיקום גיאוגרפי באמצעות כל הכותרות של בקשות HTTP, או לבקשות ספציפיות. מכיוון שהוספת כותרות של בקשות בהתאמה אישית תחויב בתשלום על כל מיליון בקשות, מומלץ לכלול מידע גיאוגרפי רק עבור בקשות להצגת סקריפטים של Google. האפשרות הזו דורשת שלבי הגדרה נוספים, אבל היא עוזרת לנהל את התשתית בצורה חסכונית ככל האפשר.

בקשות לסקריפטים

כדי לכלול כותרות גיאוגרפיות רק לבקשות סקריפט, צריך להגדיר קצה עורפי חדש וליצור כללי ניתוב.

כדי ליצור קצה עורפי חדש:

  1. פתח את מאזן העומסים של GCP
  2. במאזן העומסים, פותחים את הקטע הגדרות קצה עורפי. יוצרים שירות חדש לקצה העורפי.
    צילום מסך של הגדרות התצורה של הקצה העורפי
  3. הגדר את השירות לקצה העורפי החדש שלך:
    • סוג קצה עורפי: בוחרים את הסוג של קבוצת נקודות הקצה ברשת שבה משתמשת האפליקציה. אם משתמשים ב-Cloud Run, בוחרים באפשרות Serverless networkendpoint group (קבוצת נקודות קצה לרשת ללא שרת).
    • בקטע קצה עורפי חדש, בוחרים את קבוצת נקודות הקצה ברשת לפריסת 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. יוצרים כותרת בקשה מותאמת אישית חדשה לכל כותרת למטה:

שם הכותרת ערך הכותרת
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

מאזן עומסים של GCP

אפשר לשלוח נתוני מיקום גיאוגרפי באמצעות כל הכותרות של בקשות HTTP, או לבקשות ספציפיות. מכיוון שהוספת כותרות של בקשות בהתאמה אישית תחויב בתשלום על כל מיליון בקשות, מומלץ לכלול מידע גיאוגרפי רק עבור בקשות להצגת סקריפטים של Google. האפשרות הזו דורשת שלבי הגדרה נוספים, אבל היא עוזרת לנהל את התשתית בצורה חסכונית ככל האפשר.

בקשות לסקריפטים

כדי לכלול כותרות גיאוגרפיות רק לבקשות סקריפט, צריך להגדיר קצה עורפי חדש וליצור כללי ניתוב.

כדי ליצור קצה עורפי חדש:

  1. פתח את מאזן העומסים של GCP
  2. במאזן העומסים, פותחים את הקטע הגדרות קצה עורפי. יוצרים שירות חדש לקצה העורפי.
    צילום מסך של הגדרות התצורה של הקצה העורפי
  3. הגדר את השירות לקצה העורפי החדש שלך:
    • סוג קצה עורפי: בוחרים את הסוג של קבוצת נקודות הקצה ברשת שבה משתמשת האפליקציה. אם משתמשים ב-Cloud Run, בוחרים באפשרות Serverless networkendpoint group (קבוצת נקודות קצה לרשת ללא שרת).
    • בקטע קצה עורפי חדש, בוחרים את קבוצת נקודות הקצה ברשת לפריסת 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. יוצרים כותרת בקשה מותאמת אישית חדשה לכל כותרת למטה:

שם הכותרת ערך הכותרת
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

דלת קדמית של Azure

באמצעות כללים Engine, יוצרים קבוצת כללים עם הפעולה modify request header (שינוי כותרת הבקשה), בעזרת המיפוי הבא:

שם הכותרת ערך כותרת
X-Azure-Country {geo_country}
צילום מסך של הגדרת Azure Front Door

Cloudflare

הפעילו את האפשרות Add visit location header (הוספת כותרות של מיקומי מבקרים) בקטע ההמרות מנוהלות:

פעולה זו תוסיף באופן אוטומטי את הכותרת הבאה לערך שלה:

שם הכותרת ערך כותרת
CF-IPCountry המדינה של המשתמש
צילום מסך של הגדרת ה-cloudflare

שלב 2: הגדרת המשתנה 'אזור המבקר'

אם הגדרתם כותרות גיאוגרפיות כפי שצוין למעלה, Tag Manager מזהה באופן אוטומטי את האזור או המדינה על ידי קריאת הכותרת של בקשת ה-HTTP. לחלופין, אפשר להגדיר כותרות מותאמות אישית.

זיהוי אוטומטי

  1. פותחים את Google Tag Manager.
  2. פותחים את מאגר התגים בצד השרת.
  3. בתפריט משתנים, מגדירים את רשימת המשתנים המובנים.
  4. בוחרים באפשרות אזור למבקר.

הכותרות הגיאוגרפיות יהיו זמינות לשימוש במשתנה אזור של מבקר.

כותרות מותאמות אישית

  1. פותחים את Google Tag Manager.
  2. פותחים את מאגר התגים בצד השרת.
  3. בתפריט משתנים יוצרים משתנה חדש בהגדרת המשתמש מסוג אזור מבקרים.
  4. בקטע תצורת משתנה, בוחרים באפשרות משתנה מותאם אישית.

  5. בתפריט משתנים יוצרים שני משתנים חדשים של כותרת בקשה: אחד למדינה שלכם ואחד לקוד חלוקת משנה. ממלאים את הערכים בקודי המדינות בכותרות של בקשת ה-HTTP.

  6. משתמשים במשתנים שיצרתם במשתנה אזור המבקר כפי שמוצג בצילום המסך.

    צילום מסך של הגדרות המשתנה

  7. נותנים שם למשתנה מסוג 'הגדרות אירוע' ושומרים אותו.

שלב 3: מפעילים הגדרות ספציפיות לאזור באפליקציית הלקוח

כדי להשתמש באזור המבקר לעיבוד בקשות HTTP נכנסות, צריך להוסיף אותו ללקוח.

  1. בוחרים את הלקוח או יוצרים לקוח חדש שעליו רוצים להחיל את הגדרת האזור. הלקוחות הנתמכים הם:

    • Google Tag Manager: מאגר תגים באתר
    • Google Analytics: GA4
    • Google Analytics: Universal Analytics

  2. אם אתם מגדירים לקוחות GA4 או UA, מסמנים את התיבה נתיבי ברירת המחדל של gtag.js למזהים ספציפיים ומזינים את מזהה המדידה של מאגר התגים באתר.

  3. מסמנים את האפשרות הפעלת הגדרות ספציפיות לאזור. בשדה Region, מוסיפים את המשתנה {{Visitor Region}} שיצרתם בשלב הקודם.

  4. שומרים את הלקוח.

שלב 4: מוודאים שהגדרות האזור חלות

כדי לבדוק אם ההגדרות פועלות:

  1. פותחים את מצב תצוגה מקדימה של מאגר התגים בצד השרת.
  2. טעינת האתר בזמן שימוש בהצגת מודעות על ידי צד ראשון.
  3. בחלון התצוגה המקדימה, לוחצים על הלקוח עם הצהרת Google Analytics GA4 או על Universal Analytics שנתבעה עליהם בעלות. צילום מסך של לקוח
  4. כדי להציג את האזור בפועל, משנים את לחצן הבחירה Display Variables (משתני תצוגה) לערכים. צילום מסך של השדה 'אזור מבקר'
    • ✅ ההטמעה נכונה אם הנכס Region מציג קוד מדינה.
    • ❌ אם הנכס Region מציג undefined או חסר, השרת לא מקבל נתונים לגבי אזורים. כדי לבדוק אם כותרות ה-HTTP של השרת מוגדרות בהתאם למשתנים המוגדרים מראש ש-Google Tag Manager מחפש, ניתן לעיין במאמר הגדרת כותרת הבקשה.

השלבים הבאים