שליטה בפרמטרים של האירועים שזמינים לתגים באמצעות טרנספורמציות

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

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

מהם טרנספורמציות?

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

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

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

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

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

מתן הרשאה לתגים להשתמש בפרמטרים של אירועים

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

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

1. בסביבת העבודה, פותחים את התפריט Transformations (טרנספורמציות).
2. יוצרים כלל טרנספורמציה חדש.
3. לוחצים על Transformation Configuration (הגדרת טרנספורמציה) ובוחרים באפשרות Allow parameters (אישור פרמטרים).
4. מוסיפים פרמטרים של אירועים שאפשר להשתמש בהם בתגים. לרשימת כל הפרמטרים הנפוצים של אירועים
5. אופציונלי: בקטע תנאי התאמה אפשר להגדיר כללים להפעלת הטרנספורמציה. כברירת מחדל, כללי הטרנספורמציה חלים תמיד.
6. בקטע Affected Tags, בוחרים את סוגי התגים או את התגים הספציפיים שתגובה שלהם תהיה מותנה בכלל הטרנספורמציה הזה. כברירת מחדל, הטרנספורמציה חלה על כל התגים.
7. נותנים שם לכלל הטרנספורמציה ושומרים אותו.

דוגמה: רישום ביומן של מידע נבחר בטבלה ב-BigQuery

שליטה על הפרמטרים שמתועדים ביומן מאפשרת לכם:

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

איך עושים את זה?

כדי לאפשר רישום ביומן רק של פרמטרים מסוימים:

1. יוצרים כלל טרנספורמציה חדש.
2. לוחצים על Transformation Configuration (הגדרת טרנספורמציה) ובוחרים באפשרות Allow parameters (אישור פרמטרים).
3. בקטע Parameters to Allow (פרמטרים להרשאה), מוסיפים את הפרמטרים הנחוצים, למשל event_name,‏ page_hostname,‏ page_path,‏ client_id וכו'.
4. בקטע תגים מושפעים, בוחרים את התג ששולח נתונים למחסן הנתונים. ב-BigQuery, אפשר להשתמש ב-addEventCallback וב-BigQuery APIs בתג בהתאמה אישית, או לבדוק את גלריית התבניות של הקהילה כדי למצוא אפשרויות מוכנות מראש למעקב אחר מאגר הנתונים של השרת.
5. נותנים שם לטרנספורמציה ושומרים אותה. הוא אמור להיראות כך:

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

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

כדי לשנות או להוסיף פרמטרים מסוימים של אירועים:

1. בסביבת העבודה, פותחים את התפריט Transformations (טרנספורמציות).
2. יוצרים כלל טרנספורמציה חדש.
3. לוחצים על Transformation Configuration (הגדרת טרנספורמציה) ובוחרים באפשרות Augment event (שיפור האירוע).

4. בקטע Parameters to Augment:

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

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

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

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

7. נותנים שם לכלל הטרנספורמציה ושומרים אותו.

דוגמה: הגדרת בידינג מבוסס-ערך לאירועי רכישה

בידינג מבוסס-ערך עוזר לכם לשפר את ביצועי הקמפיין על ידי אופטימיזציה של הוצאות הפרסום כך שתתמקדו במשתמשים שתורמים יותר לעסק. אחרי שמגדירים בידינג מבוסס-ערך, מערכת Google Ads משתמשת בערך ההמרה כדי להגדיר הצעות מחיר שיהיו רווחיות יותר עבורכם. הטרנספורמציה Augment event שימושית להגדרת בידינג מבוסס-ערך בצד השרת.

איך עושים את זה?

ההוראות הבאות רלוונטיות רק אם לא צוין ערך המרה בתג מעקב ההמרות של Google Ads.

כדי להגדיר בידינג מבוסס-ערך:

1. יוצרים כלל טרנספורמציה חדש.
2. לוחצים על Transformation Configuration (הגדרת טרנספורמציה) ובוחרים באפשרות Augment event (שיפור האירוע).
3. בקטע Parameters to Augment (פרמטרים להרחבה), מוסיפים שורה חדשה. מגדירים משתנה כדי לטעון את הערך הכספי של הפריט לטרנספורמציה:
   1. בפרמטר Name, מזינים את שם הערך שרוצים לשנות, לדוגמה value. מחליפים את כל השדות value כי הם מייצגים את הערך הכספי של אירוע.
   2. בפרמטר Value, מגדירים משתנה שאוחזר מחירים ממסד הנתונים. לדוגמה, אם אתם מאחסנים נתוני מוצרים ב-Firestore, מוסיפים משתנה Firestore Lookup.
4. בקטע תנאי התאמה, מגדירים שהטרנספורמציה הזו תחול רק על אירועים מסוימים. כדי להחיל בידינג מבוסס-ערך רק על אירועי רכישה, מגדירים את הערך: {{Event Name}} שווה purchase.
5. בקטע תגים שמושפעים, מוסיפים את כל תגי מעקב ההמרות של Google Ads שאליהם צריך לחול הטרנספורמציה הזו.
6. נותנים שם לתג ושומרים אותו. הוא אמור להיראות כך:

החרגת פרמטרים של אירועים מהתגים

הטרנספורמציה Exclude parameters שימושית להסרת פרמטרים ספציפיים של אירועים מהתגים.

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

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

1. בסביבת העבודה, פותחים את התפריט Transformations (טרנספורמציות).
2. יוצרים כלל טרנספורמציה חדש.
3. לוחצים על Transformation Configuration (הגדרת טרנספורמציה) ובוחרים באפשרות Exclude parameters (החרגת פרמטרים).
4. מוסיפים פרמטרים של אירועים שאי אפשר להשתמש בהם בתגים. כאן אפשר לראות את כל הפרמטרים הנפוצים של אירועים.
5. אופציונלי: בקטע תנאי התאמה אפשר להגדיר כללים להפעלת הטרנספורמציה. כברירת מחדל, כללי הטרנספורמציה חלים תמיד.
6. בקטע Affected Tags, בוחרים את סוגי התגים או את התגים הספציפיים שתגובה שלהם תהיה מותנה בכלל הטרנספורמציה הזה. כברירת מחדל, הטרנספורמציה חלה על כל התגים.
7. נותנים שם לכלל הטרנספורמציה ושומרים אותו.

דוגמה: החרגת מאפיינים מותאמים אישית נבחרים ב-GA4 על סמך הסכמת המשתמש

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

איך עושים את זה?

כדי להסיר מאפיין מותאם אישית:

1. יוצרים כלל טרנספורמציה חדש.
2. לוחצים על Transformation Configuration (הגדרת טרנספורמציה) ובוחרים באפשרות Exclude parameters (החרגת פרמטרים).
3. בקטע Parameters to Exclude (פרמטרים להחרגה), מוסיפים שורה חדשה ומגדירים את המאפיינים המותאמים אישית שרוצים להחריג, לדוגמה, payment_type, ‏ payment_status.
4. בקטע תנאי התאמה, מגדירים שהטרנספורמציה תחול רק כאשר משתמש דוחה קובצי cookie מסוג analytics_storage.
   יוצרים את התנאים הבאים:
   • {{gcs}} שווה G100
   • {{gcs}} שווה G110
5. אופציונלי: בקטע תגים שמושפעים, מוסיפים את כל התגים שעליהם הטרנספורמציה הזו אמורה לחול.
6. נותנים שם לתג ושומרים אותו. הוא אמור להיראות כך:

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

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

1. פותחים את האתר.

2. בוחרים באפשרות Preview (תצוגה מקדימה) במאגר התגים של השרת ב-Google Tag Manager.

   Tag Assistant מופעל ומטעין את מאגר התגים בצד השרת.

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

אימות שהטרנספורמציה בוצעה:

1. אם רוצים לאמת את האירוע, פותחים את הכרטיסייה Tags.

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

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

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

   1. הרשאת פרמטרים
   2. פרמטרים להרחבה
   3. החרגת פרמטרים

   

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

   

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