הגדרת דומיין מותאם אישית

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

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

בטבלה הבאה מוסבר איך אפשר לארח שרת תיוג כשאתר ההורה מתארח ב-www.example.com:

	מקור זהה (שיטה מומלצת)	תת-דומיין	דומיין ברירת המחדל
כתובת URL לדוגמה	https://www.example.com/metrics	https://metrics.example.com	https://metrics.run.app
גישה לקובצי cookie שהוגדרו על ידי השרת	גישה מלאה להטבות של אבטחה ועמידות.	גישה מלאה להטבות של אבטחה ועמידות.	ללא. אפשר להגדיר רק קובצי cookie של JavaScript.
מורכבות ההגדרה	מגדירים CDN או מאזן עומסים להעברת בקשות. יכול להיות שתצטרכו לעדכן את רשומות ה-DNS.	מעדכנים את הרשומות ב-DNS.	מגיע מוגדרת מראש.

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

תת-דומיין מקור זהה

דרישות מוקדמות

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

• הגדרת מאגר תגים בצד השרת ב-Tag Manager
• הגדרת שרת תיוג
• CDN או מאזן עומסים שיכולים להעביר בקשות.
• אם אתם משתמשים ב-App Engine: שרת התיוג צריך לפעול בגרסה 2.2.0 ואילך. כדי לשמור על השרת לתיוג מוכן לעתיד, כדאי לעבור ל-Cloud Run.

הגדרת הדומיין המותאם אישית

אפשר להגדיר את מאגר התגים בצד השרת כך שיפעל בנתיב מאותו דומיין שבו נמצא האתר. לדוגמה, אם האתר שלכם משרת את תנועת הגולשים בכתובת www.example.com, כדאי להקצות נתיב כמו www.example.com/metrics למאגר התגים של השרת.

1. בוחרים נתיב בדומיין לשימוש בשרת התיוג

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

דוגמאות לנתיבים שאפשר להשתמש בהם: /collect, /metrics, /data

חשוב לשים לב למחרוזת הנתיב הזו. תשתמשו בו בשלבים הבאים במקום /metrics בכל מקום שבו מופיע: /metrics

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

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

אם האתר שלכם כבר מוגדר עם CDN או מאזן עומסים שתומכים ניתוב תנועה לפי נתיבים, אפשר לדלג לשלב 4.

1. מוסיפים מקור או קצה עורפי שמפנים לאתר שלכם.
2. משנים את הכותרת Host כך שתהיה שם המארח של האתר, למשל: example.com
3. העברה של כל קובצי ה-cookie ומחרוזות השאילתה. אם האפשרות הזו לא קיימת בפלטפורמה, סביר להניח שהיא מבצעת את הפעולה הזו כברירת מחדל.
4. מוסיפים עוד מקור או קצה עורפי שמפנה לשרת התיוג. זה יכול להיות הדומיין שספק הענן מספק, למשל metrics.run.app
5. משנים את הכותרת Host כך שתהיה שווה לדומיין שצוין למעלה. מאפשרים העברה של כל קובצי ה-cookie ומחרוזות השאילתה.
6. מוסיפים כלל נתיב, כמו /metrics/*, כדי לנתב את התנועה לשרת התיוג.
7. מגדירים לנתיב התיוג ששמור בצד השרת עדיפות גבוהה יותר מזו של כלל ברירת המחדל.
8. מעדכנים את ה-DNS כך שיצביע על ה-CDN או על מאזן העומסים, אם עדיין לא עשיתם זאת. יכול להיות שיחלוף זמן מה עד שהעדכונים של ה-DNS יתפשטו.
9. נכנסים לנקודת הקצה /healthy בדומיין שהגדרתם, למשל https://example.com/metrics/healthy. אמור להופיע הסמל ok.

3. עדכון כתובת ה-URL של השרת ב-Google Tag Manager

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

כדי לעדכן לנקודת הקצה החדשה:

1. פותחים את Google Tag Manager
2. פותחים את מאגר התגים של השרת שמוגדר באותו מקור כמו האתר.
3. בכרטיסייה ניהול > הגדרות מאגר התגים, מסירים את כל כתובות ה-URL הקודמות. הפעולה הזו נדרשת כי כל כתובות ה-URL של מאגר התגים בצד השרת חייבות לשתף את אותו נתיב.
4. לוחצים על הוספת כתובת URL ומזינים את כתובת ה-URL, כולל הקידומת של הנתיב.
5. שומרים וחוזרים לסביבת העבודה.
6. לוחצים על הלחצן Preview כדי להתחיל סשן ניפוי באגים חדש ולשלוח בקשה בכרטיסייה נפרדת.
7. לוחצים על הבקשה שנשלחה. מוודאים שהלקוח הגיש תלונה על הבקשה הנכנסת.

פתרון בעיות נפוצות

1. בתצוגה המקדימה לא מוצגות בקשות נכנסות
   1. עוברים לכלי לניהול יומנים של הפרויקט בענן. מוודאים שהפריסה של התיוג בצד השרת מקבלת תנועה. אם לא, פועלים לפי ההוראות שמפורטות בשלב 1.
   2. מוודאים ש-CDN או מאזן העומסים מעבירים קובצי cookie.
   3. מוודאים שיש לכם שרת תצוגה מקדימה אחד וששרתי התיוג מוגדרים עם PREVIEW_SERVER_URL.
   4. מוודאים ששרת התצוגה המקדימה פועל על ידי לחיצה על PREVIEW_SERVER_URL + /healthy. אמור להופיע הסמל ok.
2. Clients are not claiming requests (הלקוחות לא מאשרים בקשות) – מעדכנים את כתובת ה-URL בקטע Container Settings (הגדרות הקונטיינר) כך שתשתמש בנתיב ששמור. אם כתובת ה-URL לא מכילה את הנתיב או שהם שונים, הלקוחות לא יפעלו כראוי.