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

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

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

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

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

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

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

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

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

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

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

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

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

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

כששולחים בקשת HTTP לקונטיינר של שרת, הלקוח צריך לטעון בעלות על הבקשה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. בקונטיינר לנייד (Android או iOS), לוחצים על תגים > חדש.
  2. בקטע Tag Configuration (הגדרת התג), בוחרים את סוג התג Custom Image (תמונה בהתאמה אישית).
  3. מגדירים את הערך של Image 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. מגדירים את נתיב ההפעלה לנתיב של נקודת הקצה לאיסוף הנתונים של האפליקציה.
  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. שומרים את הגדרת הלקוח ומפרסמים את המאגר.

השלבים הבאים

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

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