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

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

כדי לגרום לאפליקציה ל-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 דרך השרת שלי