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

המסמך הזה מיועד למשתמשים שרוצים לפרוס את שער Google Tag למפרסמים. מומלץ להשתמש בשער Google Tag למפרסמים כדי להגדיר את התג בצורה הכי עמידה.

סקירה כללית

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

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

הדיאגרמה הזו מייצגת את זרימת המידע בשער Google Tag למפרסמים:

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

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

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

כדי להתחיל, בוחרים את סוג ההגדרה.

Self service In-UI

1. בחירת נתיבי המדידה

אתם צריכים להקצות נתיב מדידה ייחודי בדומיין של האתר כדי להציג כל תג או מאגר תגים של Google Tag Manager.

הדרישות לגבי נתיב המדידה:

• הנתיבים לא יכולים להיות בשימוש בדומיין שלכם.
• כל נתיב לא יכול להיות נתיב הבסיס /.
• כל נתיב לא יכול לחרוג מ-100 תווים.

‫Google Tag Manager:

אם אתם משתמשים ב-Google Tag Manager, אתם צריכים לספק רק את מזהה מאגר התגים (למשל, GTM-XXXXXX). ההגדרה הזו מספיקה לכל התגים (כמו Google Analytics,‏ Google Ads וכו') שכבר נוספו למאגר התגים הזה.

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

כדי להגדיר שער Google Tag למפרסמים, בוחרים נתיב שלא נמצא כבר בשימוש באתר. כדי להקטין את הסיכוי שהנתיב יתנגש עם נתיב שכבר קיים באתר, אפשר לבחור כל שילוב של אותיות ומספרים. אם רוצים נתיב קריא יותר, אפשר לבחור להשתמש במילה כמו /gtm,‏ /metrics,‏ /analytics או כל מילה אחרת שרוצים.

לדוגמה:

תרחיש לדוגמה	מזהה	נתיב ההצגה של התגים	נקודת קצה של מקור
Standalone Tag 1	G-12345	/abjfo/	g-12345.fps.goog
Standalone Tag 2	G-67890	/fjdso/	g-67890.fps.goog
מאגר תגים של GTM	GTM-ABCDEF	/cvfjk/	gtm-abcdef.fps.goog

כדי לאכלס את הדוגמאות במסמך הזה, צריך למלא את הפרטים הבאים.

Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics

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

איך מטפלים בכמה תגים או מאגרי תגים:

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

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

• כמה מאגרי תגים נפרדים של Google Tag Manager.
• תגים נפרדים (למשל, G-XXXXXX) שלא נמצאים בתוך מאגר תגים.

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

2. ניתוב תנועת הגולשים

בקטע הזה מניחים שהאתר שלכם כבר משתמש ב-CDN או במאזן עומסים שתומך בניתוח תעבורה לפי נתיבים.

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.
     • לוחצים על CREATE כדי ליצור את נקודת הקצה.
     • סוגרים את הכרטיסייה קבוצה של נקודות קצה ברשת כדי לחזור לכרטיסייה שירות לקצה העורפי חדש.
   • מחפשים את השם של קבוצת נקודות הקצה החדשה ברשת ובוחרים אותה.
   • פותחים את הקטע הגדרות מתקדמות. מוסיפים את כותרות הבקשה המותאמות אישית הבאות.

     הכותרת	ערך הכותרת
     Host	G-12345.fps.goog
     X-Forwarded-CountryRegion	{client_region_subdivision}
     X-Forwarded-Geolocation	latlong={client_city_lat_long};city={client_city}

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

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

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 למפרסמים, צריך ליצור רשומת CNAME לתת-דומיין חדש, ליצור כלל מקור להעברת בקשות וליצור כלל טרנספורמציה כדי לכלול מידע על מיקום גיאוגרפי. כדי להשלים את ההגדרה הזו, צריך מינוי לתוכנית Cloudflare Enterprise. אם אין לכם מינוי לתוכנית Enterprise, כדאי להשתמש במקום זאת בהגדרה בממשק המשתמש של Cloudflare.

יצירת רשומת CNAME

הערה: תגים לא ישתמשו ברשומת ה-CNAME הזו. Cloudflare משתמשת בה כדי לנתב בקשות באופן פנימי.

בוחרים תת-דומיין להזמנה עבור רשומת ה-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. הוספת התאמה חדשה
   • מגדירים את התפריטים הנפתחים של ההתאמה לערכים נתיב והוא אחד מהערכים הבאים.
   • מגדירים את ערך ההתאמה ל-/metrics/*
4. הוספת התנהגות חדשה
   • בוחרים באפשרות Standard Property Behavior (התנהגות רגילה של נכס) ובוחרים בהתנהגות Origin Server (שרת המקור).
   • מגדירים את Origin Server Hostname לערך G-12345.fps.goog.
   • מגדירים את העברת כותרת מארח לשם מארח של מקור
5. שומרים את הכלל החדש ומפעילים את השינויים
   • חשוב לבדוק את כלל ההפניה האוטומטית החדש בסביבת הבדיקה לפני שמעבירים אותו לסביבת הייצור.
   • טיפ: חשוב לוודא שאין לכם כללים שמשנים או מסירים את כותרות התגובה היוצאות. יכול להיות שהסקריפטים של Google ייכשלו אם חסרה כותרת התגובה Content-Type.

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

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

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.

Amazon CloudFront

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

הוספת מקור חדש

1. עוברים לדף CloudFront ב-Amazon Web Services ‏ (AWS)
2. בוחרים הפצה של CloudFront
3. בכרטיסייה Origins (מקורות), יוצרים מקור עם ההגדרות הבאות:
   • מגדירים את Origin domain (דומיין המקור) לערך G-12345.fps.goog.
   • מגדירים את Protocol ל-HTTPS Only

יצירת התנהגות ההפניה האוטומטית

1. עוברים לדף CloudFront ב-AWS
2. בוחרים הפצה של CloudFront
3. בכרטיסייה Behaviors (התנהגויות), יוצרים Behavior (התנהגות) חדש עם ההגדרות הבאות:
   • מגדירים את תבנית הנתיב ל-/metrics/*
   • הגדרת מקור וקבוצות מקור לערך G-12345.fps.goog
   • מגדירים את האפשרות דחיסת אובייקטים באופן אוטומטי ללא.
   • מגדירים את מדיניות פרוטוקול הצפייה לHTTPS בלבד
   • מגדירים את שיטות HTTP המותרות לערך GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE
   • בקטע Cache key and origin requests (מפתח מטמון ובקשות מקור), בוחרים באפשרות Cache policy and origin request policy (מדיניות מטמון ומדיניות בקשות מקור).
     • הגדרת מדיניות המטמון לערך CachingDisabled
     • מגדירים את מדיניות בקשת המקור לערך AllViewerExceptHostHeader
4. ברשימה התנהגות, מוודאים שערך Precedence של ההתנהגות החדשה גבוה יותר מכל שאר ההתנהגויות.
   • כדי לשנות את Precedence בוחרים את ההתנהגות הרצויה ולוחצים על הלחצן העברה למעלה עד שהיא מופיעה מעל כל שאר ההתנהגויות.
5. בדפדפן, מאמתים את ההגדרה על ידי מעבר אל: https://example.com/metrics/healthy. הדף צריך לכלול את הטקסט ok.

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

1. כדי להעביר את פרטי המיקום הגיאוגרפי הנדרשים, צריך להגדיר את Headers (כותרות) לערך AllViewerExceptHostHeader (כל הצופים חוץ מכותרת המארח) בהתנהגות ההפניה האוטומטית.
   • רשימה מלאה של כותרות המיקום של הצופים ב-CloudFront מפורטת במאמר הזה
2. מחכים כמה דקות עד שההפצה תופעל. בדפדפן, מאמתים את ההגדרה על ידי ניווט אל: https://example.com/metrics/?validate_geo=healthy. הדף צריך לכלול את הטקסט ok.

Fastly

כדי להציג את התג בשער Google Tag למפרסמים, צריך להגדיר את שירות ה-CDN של Fastly להעברת בקשות ולהוסיף מידע על מיקום גיאוגרפי. התהליך הזה כולל יצירה של תנאי אחד, מארח אחד ו-2 קטעי VCL.

יצירת התנאי והמארח

קודם כל, מגדירים תנאי לזיהוי בקשות לשער ומארח להפניית הבקשות ל-Google.

1. יוצרים תנאי חדש עם ההגדרה הבאה:

   • Type (סוג): Request
   • שם: Google Tag Gateway Path (או שם אחר שתבחרו)
   • החלה אם…: req.url.path ~ "^/metrics"

2. יוצרים מארח חדש עם ההגדרות הבאות:

   • שם המארח/כתובת: fps.goog

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

   • לוחצים על צירוף תנאי ובוחרים את התנאי שיצרתם בשלב 1.
   • מגדירים את Override host לערך fps.goog.
   • משאירים את שאר ההגדרות כברירת מחדל.
   • לוחצים על עדכון כדי לשמור את המארח.

הוספה של מזהה Google Tag וכותרות מיקום גיאוגרפי

לאחר מכן, מוסיפים קטעי VCL (שפת תצורה של Varnish) כדי לצרף את מזהה Google Tag ואת נתוני המיקום הגיאוגרפי של הלקוח. צריך ליצור שני קטעים נפרדים – אחד ל-vcl_miss ואחד ל-vcl_pass – באמצעות אותו קוד בדיוק.

1. בשירות, עוברים אל VCL Snippets ויוצרים Snippet עם השדות הבאים:

   • שם: Geo_MISS (או שם אחר שתבחרו)
   • מיקום מודעה: Within Subroutine
   • Subroutine: vcl_miss

   • ‫VCL:

     if (req.url.path ~ "^/metrics") {
       set bereq.http.X-Gtg-Tag-Id = "G-12345";
       set bereq.http.X-Forwarded-Country = client.geo.country_code;
       set bereq.http.X-Forwarded-Region = client.geo.region;
       set bereq.http.X-Forwarded-Geolocation = "latlong=" +
         client.geo.latitude + "," + client.geo.longitude + ";city=" +
         client.geo.city;
     }
     

2. יוצרים עוד תוסף עם השדות הבאים:

   • שם: Geo_PASS (או שם אחר שתבחרו)
   • Type (סוג): vcl_pass

   • ‫VCL:

     if (req.url.path ~ "^/metrics") {
       set bereq.http.X-Gtg-Tag-Id = "G-12345";
       set bereq.http.X-Forwarded-Country = client.geo.country_code;
       set bereq.http.X-Forwarded-Region = client.geo.region;
       set bereq.http.X-Forwarded-Geolocation = "latlong=" +
         client.geo.latitude + "," + client.geo.longitude + ";city=" +
         client.geo.city;
     }
     

   עכשיו אמורים להיות לכם שני קטעי קוד חדשים ונפרדים. כך מוודאים שכותרות המיקום הגיאוגרפי יתווספו לכל בקשה שצריך לאחזר מהמארח, בין אם מדובר ב'אי מציאה במטמון' (vcl_miss) או ב'פגיעה במטמון' (vcl_pass).

הפעלה ואימות של הגדרה מלאה

אחרי שיוצרים את המארח, התנאי וקטעי ה-VCL, אפשר להפעיל ולבדוק את ההגדרה המלאה.

1. לוחצים על הפעלה כדי לפרוס את כל השינויים החדשים.

2. מאמתים את ההגדרה על ידי הפעלת שני הבדיקות בדפדפן:

   • בדיקה 1 (תיוג וניתוב): עוברים אל https://example.com/metrics/healthy
   • בדיקה 2 (מיקום גאוגרפי): עוברים אל 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. כדי לוודא שהמידע הגיאוגרפי נכלל, עוברים אל: https://example.com/metrics/?validate_geo=healthy. הדף צריך לכלול את הטקסט ok.

שלב 3: מעדכנים את הסקריפטים באתר כדי להשתמש בנתיב המדידה

מחליפים את הסקריפטים בכל דף באתר באחד מהסקריפטים הבאים:

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 -->

הערה: שער Google Tag למפרסמים לא תומך בקטע הקוד <noscript>. כדי להשתמש בפונקציונליות של <noscript>, צריך להמשיך להשתמש בקטע הקוד הרגיל של Google Tag Manager <noscript> שמפנה אל www.googletagmanager.com.

בדיקת הגדרת המדידה

כדי לבדוק את הגדרת המדידה, מגדירים במאגר התגים לפחות תג אחד שמופעל.

1. עוברים אל Tag Assistant ומציגים תצוגה מקדימה של מאגר התגים.
2. עוברים בין חלקים שונים באתר כדי להפעיל אירועים.

3. בכרטיסייה Summary (סיכום) > Output (פלט) > Hits Sent (היטים שנשלחו), מוודאים שההיטים מנותבים אל /metrics.