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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מדיניות אבטחת תוכן (CSP)

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

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

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

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

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

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

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

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

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

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

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

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

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

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. מבטלים את הסימון של הפעלה של עקיפת מטמון (cache busting).
  5. שומרים את התג ומפרסמים את מאגר התגים.
  6. במאגר התגים בצד השרת, לוחצים על Clients > New (לקוחות > חדש).
  7. בקטע Client Configuration (הגדרת הלקוח), בוחרים את סוג הלקוח Measurement Protocol.
  8. מגדירים את נתיב ההפעלה לנתיב של נקודת הקצה (endpoint) של איסוף הנתונים באפליקציה.
  9. שומרים את הגדרת הלקוח ומפרסמים את מאגר התגים בצד השרת.

אפליקציות שפועלות משרת לשרת

כדי לשלוח נתונים של Measurement Protocol למאגר התגים בצד השרת, מחליפים את שם המארח 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. מגדירים את Activation Path (נתיב ההפעלה) לנתיב של נקודת הקצה של השרת.
  4. שומרים את הגדרת הלקוח ומפרסמים את מאגר התגים.

השלבים הבאים

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

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