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

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

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

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

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

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

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

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

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

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

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

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

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

2. קבלת נתונים בקונטיינר בצד השרת

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

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

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

  2. פותחים את מאגר התגים בצד השרת.

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

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

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

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

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

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

    • ללקוחות UA: נתיבי ברירת המחדל של Universal Analytics: הלקוח מופעלת כשנתיבי הבקשות כוללים את /collect, /r/collect ו- נתיבים דומים אחרים המשמשים את קובצי JavaScript ששולחים נתונים אל Google ניתוח נתונים. ההגדרה הזו פעילה כברירת מחדל.

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

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

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

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

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

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

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

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

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

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

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

  1. בקונטיינר לנייד (Android או iOS), לוחצים על תגים > חדש.
  2. בקטע Tag Configuration (הגדרת התג), בוחרים בסוג התג תמונה מותאמת אישית.
  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 > (לקוחות) חדש.
  7. ב-Client Configuration, בוחרים את הלקוח Measurement Protocol מהסוג הזה.
  8. מגדירים את Activity Path (נתיב ההפעלה) לנתיב של נקודת הקצה לאיסוף של האפליקציה.
  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 > (לקוחות) חדש.
  2. ב-Client Configuration, בוחרים את הלקוח Measurement Protocol מהסוג הזה.
  3. מגדירים את Activation Path (נתיב ההפעלה) לנתיב של נקודת הקצה של השרת.
  4. שומרים את הגדרת הלקוח ומפרסמים את מאגר התגים.

השלבים הבאים

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

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