שליחת נתונים ל-Tag Manager בצד השרת

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

במאמר הזה נסביר איך:

  • שליחת נתונים מאתר למאגר התגים בצד השרת
  • שליחת נתונים נוספים למאגר תגים בצד השרת
  • קבלת נתונים במאגר התגים בצד השרת
  • שליחת נתונים ממקורות שאינם אתרים

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

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

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

אפשר לנתב נתונים דרך הטמעה בצד השרת באמצעות Tag Manager או gtag.js. בוחרים את אפשרות ההטמעה הרצויה.

בוחרים אפשרות הטמעה.

אופציונלי: שליחת פרמטרים נוספים עם כל אירוע

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

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

בוחרים את אפשרות ההטמעה.

המלצות להגדרה

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

  • פיקסל תמונה
  • Fetch API
  • XHR
  • קובץ שירות (service worker) שפועל במסגרת iframe שנטענת מדומיין מאגר התגים בצד השרת.

כדי לוודא שכל השיטות נתמכות, צריך לבדוק את הדברים הבאים:

Content-security policy‏ (CSP)

Directive תוכן מטרה
img-src [SERVER_CONTAINER_URL] בקשות למדידה
connect-src [SERVER_CONTAINER_URL] בקשות למדידה
frame-src [SERVER_CONTAINER_URL] הטמעה של קובץ שירות (service worker)

בנוסף, X-Frame-Options לא יכול להגביל את הטעינה של מסגרות iframe מכתובת ה-URL של מאגר התגים בצד השרת.

כדאי לעיין במדיניות הספציפית לכל מוצר בכתובת https://developers.google.com/tag-platform/security/guides/csp.

2. קבלת נתונים במאגר התגים בצד השרת

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

כדי לראות את רשימת הלקוחות הזמינים:

  1. פותחים את Google Tag Manager.

  2. פותחים את מאגר התגים של השרת.

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

  4. לוחצים על שם הלקוח כדי לראות או לערוך את הפרטים.

הגדרות אופציונליות של לקוחות

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

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

  • קריטריונים להפעלה: הקריטריונים להפעלה מגדירים מתי הלקוח יגיב לבקשות:

    • נתיבי ברירת מחדל ב-gtag.js למזהים ספציפיים: ההגדרה הזו מאפשרת להפעיל קוד JavaScript מ-gtag.js דרך כתובת ה-URL של מאגר התגים בצד השרת. כשההגדרה הזו מופעלת, הלקוח הזה יפעיל נתיבי בקשה בתגובה לבקשות ל-gtag.js בברירת המחדל, למשל /gtag/js?id=TAG_ID. לוחצים על הוספת מזהה מדידה כדי להוסיף מזהים של יעדים.

אופציונלי: קבלת נתונים נוספים ב-Tag Manager בצד השרת

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

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

כדי להשתמש בפרמטרים נוספים בתגים אחרים:

  1. במאגר התגים של השרת, לוחצים על Variables (משתנים) בתפריט הניווט הימני.
  2. יוצרים משתנה חדש שמוגדר על ידי המשתמש.
  3. בקטע Variable Configuration (הגדרת המשתנה), בוחרים את סוג המשתנה Event Data (נתוני אירוע).
  4. בקטע נתיב מפתח, מזינים את שם הפרמטר.
  5. נותנים שם למשתנה ולוחצים על שמירה.

עכשיו אפשר להשתמש בפרמטר event בכל תג אחר במאגר התגים בצד השרת.

3. אופציונלי: שליחת נתונים ממקורות אחרים מלבד אתרים

אפשר להשתמש ב-Measurement Protocol של Google Analytics כדי להפעיל תמיכה בתיוג בצד השרת ממקורות כמו אפליקציות לנייד ואפליקציות שפועלות משרת לשרת. האפשרות הזו מאפשרת לשלוח אירועים למאגר התגים בפורמט Measurement Protocol. מאגר התגים שולח את האירועים האלה ל-Google Analytics באמצעות אותו מנגנון שבו נשלחים כל האירועים האחרים של SGTM.

האפשרות הזו לא תומכת בכל התכונות של נקודת הקצה של Measurement Protocol, כמו הסקת מידע גיאוגרפי ומידע על המכשיר מאירועי תיוג.

אפליקציות לנייד

כדי שאפליקציית Android או iOS שלכם תשלח נתונים למאגר התגים בצד השרת, תצטרכו ליצור תג תמונה מותאם אישית ולהגדיר אותו לשימוש ב-Measurement Protocol:

  1. במאגר התגים לנייד (Android או iOS), לוחצים על Tags > New (תגים > חדש).
  2. בקטע Tag Configuration (הגדרת התג), בוחרים את סוג התג Custom Image (תמונה בהתאמה אישית).
  3. מגדירים את הערך של Image URL (כתובת URL של תמונה) לתמונת פיקסל במאגר התגים בצד השרת בנתיב בלקוח של Measurement Protocol שציינתם קודם. מוסיפים את הפרמטרים הרצויים של Measurement Protocol לסוף כתובת ה-URL של הפיקסל:
    https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
  4. מבטלים את הבחירה באפשרות הפעלה של עקיפת מטמון.
  5. שומרים את התג ומפרסמים את מאגר התגים.
  6. במאגר התגים בצד השרת, לוחצים על Clients > New (לקוחות > חדש).
  7. בקטע Client Configuration (הגדרת הלקוח), בוחרים את סוג הלקוח Measurement Protocol.
  8. מגדירים את נתיב ההפעלה לנתיב של נקודת הקצה (endpoint) של איסוף הנתונים באפליקציה.
  9. שומרים את הגדרת הלקוח ומפרסמים את מאגר התגים בצד השרת.

אפליקציות: נתוני שרת-לשרת

כדי לשלוח נתונים של פרוטוקול המדידה למאגר התגים בצד השרת, מחליפים את שם המארח www.google-analytics.com בשם הדומיין של מאגר התגים בצד השרת. לדוגמה:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

כדי לקבל היטים של Measurement Protocol, צריך להגדיר את ההתקנה של Tag Manager בצד השרת עם לקוח Measurement Protocol:

  1. במאגר התגים בצד השרת, לוחצים על Clients > New (לקוחות > חדש).
  2. בקטע Client Configuration (הגדרת הלקוח), בוחרים את סוג הלקוח Measurement Protocol.
  3. מגדירים את נתיב ההפעלה לנתיב של נקודת הקצה של השרת.
  4. שומרים את הגדרת הלקוח ומפרסמים את מאגר התגים.

השלבים הבאים

כדי לשלוח נתונים בהקשר אמיתי של אינטראקציה ישירה (First-Party), צריך להציג סקריפטים של Google, כמו ספריית Google Analytics, מהשרתים שלכם.

טעינת סקריפטים של Google דרך השרת שלי