הגדרת שער של Google Tag למפרסמים

Google Cloud

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

יצירת ה-Backend החדש

1. פתיחת מאזן העומסים של GCP

2. במאזן העומסים, פותחים את הקטע Backend configuration (הגדרת השרת העורפי). יוצרים שירות קצה עורפי חדש.

3. מגדירים את שירות ה-Backend החדש עם מידע על מיקום גיאוגרפי:

   • מציינים שם, כמו measurement-be-svc.
   • מגדירים את סוג הקצה העורפי בתור קבוצה של נקודות קצה ברשת באינטרנט.
   • מגדירים את הפרוטוקול ל-HTTPS ומשאירים את הערך שמופיע מראש בשדה זמן קצוב לתפוגה.
   • בקטע Backends, לוחצים על התפריט הנפתח Internet network endpoint group (קבוצת נקודות קצה ברשת האינטרנט) ויוצרים קבוצת נקודות קצה חדשה ברשת האינטרנט:
     • מגדירים את סוג קבוצת נקודות קצה ברשת לקבוצת נקודות קצה ברשת לאינטרנט (גלובלית, אזורית).
     • מגדירים את Scope לערך Global.
     • מגדירים את Add through (הוספה דרך) לFully qualified domain name and port (שם דומיין שמוגדר במלואו ויציאה).
     • מגדירים את שם הדומיין שמוגדר במלואו לערך G-12345.fps.goog.
     • לוחצים על יצירה כדי ליצור את נקודת הקצה.
     • סוגרים את הכרטיסייה קבוצה של נקודות קצה ברשת כדי לחזור לכרטיסייה שירות עורפי חדש.
   • מחפשים את השם של קבוצת נקודות הקצה החדשה ברשת ובוחרים אותה.
   • פותחים את הקטע הגדרות מתקדמות. מוסיפים את כותרות הבקשה המותאמות אישית הבאות.

     הכותרת	ערך הכותרת
     Host	G-12345.fps.goog
     X-Forwarded-Country	{client_region}
     X-Forwarded-Region	{client_region_subdivision}

   • בודקים את ההגדרות האחרות. לא צריך את Cloud CDN או את Cloud Armor לשילוב הזה, ולכן אפשר להשבית את שניהם בבטחה.
   • שומרים את שירות ה-Backend החדש.

הגדרת כללי ניתוב

1. במאזן העומסים, פותחים את הקטע כללי ניתוב.

2. מוסיפים את הכללים הבאים של מארח ונתיב:

   מארח	נתיב	בק-אנד
   *	/metrics/*	measurement-be-svc

3. מעדכנים את ההגדרה של מאזן העומסים.

4. בדפדפן, מאמתים את ההגדרה על ידי ניווט אל: https://example.com/metrics/healthy. בדף צריך להופיע הטקסט ok. כדי לוודא שהמידע הגיאוגרפי נכלל, עוברים אל: https://example.com/metrics/?validate_geo=healthy. בדף צריך להופיע הטקסט ok.

Cloudflare

כדי להציג את התג ב-Google Tag Gateway למפרסמים, צריך ליצור רשומת CNAME עבור תת-דומיין חדש, ליצור כלל Origin להעברת בקשות וליצור כלל Transform כדי לכלול מידע על מיקום גיאוגרפי. כדי להשלים את ההגדרה הזו, צריך מינוי לתוכנית Cloudflare Enterprise. אם אין לכם תוכנית Enterprise, כדאי להשתמש במקום זאת בהגדרה האוטומטית של Cloudflare.

יצירת רשומת CNAME

בוחרים תת-דומיין להזמנה עבור רשומת ה-CNAME. כדי לאכלס את הדוגמאות לאורך המסמך הזה, צריך למלא את הפרטים הבאים. רשומת ה-CNAME הזו אף פעם לא נחשפת מחוץ להגדרות של Cloudflare, ולכן השם הוא שרירותי.

CNAME subdomain: fps

1. בכרטיסייה DNS, פותחים את הקטע Records (רשומות).
2. מוסיפים רשומה חדשה עם ההגדרה הבאה:
   • מגדירים את Type (סוג) ל-CNAME.
   • מגדירים את Name לערך fps.
   • מגדירים את Target לערך G-12345.fps.goog.
3. שומרים את רשומת ה-CNAME.

יצירת כלל מקור

1. בכרטיסייה Rules (כללים), פותחים את Origin Rules (כללי מקור) ויוצרים כלל.
2. מזינים שם לכלל, למשל Route measurement.
3. מתאימים בקשות נכנסות על סמך ביטוי מסנן בהתאמה אישית ולוחצים על עריכת הביטוי.
4. מדביקים את הביטוי הבא בכלי ליצירת ביטויים: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. מעדכנים את כותרת המארח לכתיבה מחדש אל... G-12345.fps.goog.
6. מעדכנים את רשומת ה-DNS להחלפה ב... fps.example.com.
7. שומרים את כלל המקור.
8. אם יש כללים אחרים של מקור, מגדילים את המיקום של הכלל החדש שנוצר כדי שהוא יפעל אחרי כל נתיבי wildcard אחרים.
9. בדפדפן, מאמתים את ההגדרה על ידי ניווט אל: https://example.com/metrics/healthy. הדף צריך להציג את הטקסט ok.

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

1. בכרטיסייה 'כללים', פותחים את ההגדרות.
2. מפעילים את האפשרות הוספת כותרות של מיקום המבקר.
3. מחכים כמה דקות עד שהכלל יופעל. בדפדפן, מאמתים את ההגדרה על ידי מעבר אל https://example.com/metrics/?validate_geo=healthy. הדף צריך להציג את הטקסט ok.

Akamai

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

יצירת כלל ההפניה האוטומטית

1. יצירת גרסה חדשה של הגדרת ההצגה בכלי לניהול נכסים
2. בקטע Property Configuration Settings (הגדרות של נכס), מוסיפים תג חדש Rule
   • מזינים שם, למשל Route measurement
3. הוספת התאמה חדשה
   • מגדירים את התפריטים הנפתחים של ההתאמה לערכים Path (נתיב) ו-is one of (הוא אחד מהערכים)
   • מגדירים את ערך ההתאמה ל-/metrics/*
4. הוספת התנהגות חדשה
   • בוחרים באפשרות Standard Property Behavior (התנהגות נכס רגילה) ובוחרים בהתנהגות Origin Server (שרת מקור).
   • מגדירים את Origin Server Hostname לערך G-12345.fps.goog
   • מגדירים את העברת כותרת מארח לשם מארח של מקור
5. שומרים את הכלל החדש ומחילים את השינויים
   • חשוב לבדוק את כלל ההפניה האוטומטית החדש בסביבת הבדיקה לפני שמעבירים אותו לסביבת הייצור.
   • טיפ: חשוב לוודא שאין לכם כללים שמשנים או מסירים את כותרות התגובה היוצאות. יכול להיות שהסקריפטים של Google ייכשלו אם חסרה כותרת התגובה Content-Type.

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

1. בוחרים את כלל ההפניה האוטומטית (שנוצר למעלה) בקטע הגדרות התצורה של הנכס.

2. הוספת התנהגות חדשה

   • בוחרים באפשרות Standard Property Behavior (התנהגות רגילה של נכס) ובוחרים בהתנהגות Content Targeting (EdgeScape) (טירגוט תוכן (EdgeScape))
   • מעבירים את האפשרות הפעלה למצב true

3. שומרים את ההתנהגות החדשה ומפרסים את השינויים.

   • חשוב לבדוק את כלל ההפניה האוטומטית החדש בסביבת הבדיקה לפני שמעבירים אותו לסביבת הייצור.

4. בדפדפן, מאמתים את ההגדרה על ידי ניווט אל: https://example.com/metrics/healthy. בדף צריך להופיע הטקסט ok. כדי לוודא שהמידע הגיאוגרפי נכלל, עוברים אל: https://example.com/metrics/?validate_geo=healthy. בדף צריך להופיע הטקסט ok.

אחר

כדי להציג את התג בשער Google Tag למפרסמים, צריך להגדיר את הרשת להעברת תוכן (CDN) או את מאזן העומסים כך שהבקשות ינותבו לנקודת הקצה של שער Google Tag למפרסמים.

1. מוסיפים מקור או קצה עורפי שמפנים אל G-12345.fps.goog.
2. שינוי הכותרת Host כך שתהיה שווה ל-G-12345.fps.goog. מאפשרים להעביר את כל קובצי ה-Cookie ואת כל מחרוזות השאילתה.
3. כדי להעביר את פרטי המיקום הגיאוגרפי של המבקר, צריך לכלול את אחת מהכותרות הבאות:
   • ‫X-Forwarded-CountryRegion – המדינה והאזור של המשתמש בקוד יחיד בתקן ISO 3166-2 (לדוגמה: US-CA).
   • ‫X-Forwarded-Country ו-X-Forwarded-Region:
     • ‫X-Forwarded-Country – המדינה של המשתמש כקוד ISO 3166-1 alpha-2 (לדוגמה: US).
     • (אופציונלי) X-Forwarded-Region – קוד חלוקת המשנה של האזור של המשתמש (לדוגמה: CA).
   • אם כוללים את שני סוגי הכותרות, המערכת תשתמש ב-X-Forwarded-CountryRegion.
4. מוסיפים כלל נתיב ל-/metrics/* כדי לנתב את התנועה לשער Google Tag למפרסמים.
5. מגדירים את הנתיב השמור כך שתהיה לו עדיפות גבוהה יותר מכלל ברירת המחדל.
6. בדפדפן, מאמתים את ההגדרה על ידי ניווט אל: https://example.com/metrics/healthy. הדף צריך להציג את הטקסט ok.

gtag.js

בחלק העליון של הקטע <head>, מאתרים את שתי שורות הסקריפט עם מזהה Google Tag:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>

ומחליפים אותם בנתיב המדידה:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

בחלק העליון של הקטע <head>, מחליפים את קטע הקוד של Tag Manager בקטע הקוד הבא:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->