תגי Google Floodlight

המאמר הזה מיועד למפתחים שרוצים להעביר תגי Floodlight ממאגר תגים של Tag Manager באינטרנט למאגר תגים בצד השרת.

Tag Manager בצד השרת מאפשר להעביר את תגי המכירות ותגי המונה ב-Google Floodlight מדף האינטרנט לשרת. העברת התגים האלה לשרת תפחית את כמות הקוד שתצטרכו להריץ בדף ותעזור לכם לקצר את זמני הטעינה של הדפים.

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

כדי להעביר תגים לשרת, צריך לוודא שיש לכם:

• הרשאת אדמין ל-Google Tag Manager ול-Floodlight
• הגדרה והתקנה של Google Tag Manager
• הגדרת מאגר תגים בצד השרת
• הגדרת הלקוח Google Analytics: GA4

שלב 1: מגדירים את התג לקישור המרות

אפשר לשלוח נתוני המרות אל Google Tag Manager דרך חשבון Floodlight רק אחרי שמגדירים תג Conversion Linker.

אם כבר הגדרתם תג Conversion Linker במאגר התגים בצד השרת, תוכלו לדלג על השלב הזה.

כדי להגדיר את התג Conversion Linker:

1. מסביבת העבודה של מאגר התגים בצד השרת, פותחים את התפריט Tags (תגים) בצד שמאל של הדף.
2. כדי להוסיף תג חדש, לוחצים על New (חדש).
3. בוחרים את סוג התג Conversion Linker (מקשר המרות).
4. מגדירים את הטריגר שיוביל להפעלת התג Conversion Linker בצד השרת.
   ברוב המקרים, הטריגר All pages (כל הדפים) הוא האפשרות הטובה ביותר.
5. נותנים שם לתג ולוחצים על Save (שמירה).

שלב 2: מגדירים את תגי Floodlight

Google Tag Manager תומך בתגי מונה של Floodlight ובתגי מכירות של Floodlight במאגר התגים בצד השרת.

מונה Floodlight

כדי להגדיר תג Floodlight Counter:

1. בסביבת העבודה של מאגר התגים בצד השרת, בוחרים בתפריט Tags (תגים) בצד שמאל של הדף.
2. כדי להוסיף תג חדש, לוחצים על New (חדש).

3. בוחרים את סוג התג Floodlight Counter.

   

4. כדי לאסוף את הערכים הנדרשים להגדרת התג, פותחים חלון נוסף בדפדפן ונכנסים ל-Campaign Manager 360. לוחצים על מפרסמים ולאחר מכן על שם המפרסם. מזינים את הערכים הבאים בתג המונה החדש של Tag Manager Floodlight:

   • Advertiser ID: מזהה המפרסם יופיע בדף הפרטים של המפרסם, מתחת לשם המפרסם. הערך הזה מופיע גם כערך של src= בקטע קוד של תג Floodlight שנוצר.
   • Group Tag String: בטבלת הפעילות, מזהים את הפעילות שרוצים לעבוד איתה ומחפשים את מחרוזת תג הקבוצה שמופיעה בעמודה משמאל. הוא מופיע גם בתור הערך של type= בקטע קוד של תג Floodlight שנוצר.
   • Activity Tag String: בטבלה Activity, מזהים את הפעילות שרוצים לעבוד איתה ומחפשים את המחרוזת של תג הפעילות שמופיעה בעמודה משמאל. הוא מופיע גם בתור הערך של cat= בקטע קוד של תג Floodlight שנוצר.

5. מגדירים את שיטת הספירה הרצויה:

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

6. פותחים את החלון Choose a trigger.

7. בתפריט Trigger configuration (הגדרת הטריגר), בוחרים בטריגר. ברוב המקרים, האפשרות הטובה ביותר היא All Pages.

   

8. מזינים שם לתג ולוחצים על שמירה.

   

מכירות Floodlight

כדי להגדיר תג Floodlight Sales:

1. בסביבת העבודה של מאגר התגים בצד השרת, בוחרים בתפריט Tags (תגים) בצד שמאל של הדף.
2. כדי להוסיף תג חדש, לוחצים על New (חדש).

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

   *   Order ID (Transaction ID)
   *   Revenue (Value)
   

4. כדי לאסוף את הערכים הנדרשים להגדרת התג, פותחים חלון נוסף בדפדפן ונכנסים ל-Campaign Manager 360. לוחצים על מפרסמים ואז על שם המפרסם. מזינים את הערכים הבאים בתג המונה החדש של Tag Manager Floodlight:

   • Advertiser ID: מזהה המפרסם יופיע בדף הפרטים של המפרסם, מתחת לשם המפרסם. הערך הזה מופיע גם כערך של src= בקטע קוד של תג Floodlight שנוצר.
   • Group Tag String: בטבלת הפעילות, מזהים את הפעילות שרוצים לעבוד איתה ומחפשים את מחרוזת תג הקבוצה שמופיעה בעמודה משמאל. הוא מופיע גם בתור הערך של type= בקטע קוד של תג Floodlight שנוצר.
   • Activity Tag String: בטבלה Activity, מזהים את הפעילות שרוצים לעבוד איתה ומחפשים את המחרוזת של תג הפעילות שמופיעה בעמודה משמאל. הוא מופיע גם בתור הערך של cat= בקטע קוד של תג Floodlight שנוצר.

5. מגדירים את שיטת הספירה הרצויה:

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

6. פותחים את החלון Choose a trigger.

7. בתפריט Trigger configuration (הגדרת הטריגר), בוחרים בטריגר. ברוב המקרים, האפשרות הטובה ביותר היא All Pages.

8. מזינים שם לתג ולוחצים על שמירה.

אופציונלי: הגדרה של המרות משופרות

אם אתם לא משתמשים בהמרות משופרות, אפשר לדלג לשלב אימות ההגדרה.

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

הגדרת משתנה של פרטים שהמשתמשים סיפקו

יש 3 שיטות שבהן אפשר להטמיע המרות משופרות ב-Tag Manager. צריך לבחור רק אפשרות אחת לאיסוף של פרטים שהמשתמשים סיפקו.

	איסוף אוטומטי	הגדרה ידנית	הגדרת קוד
שיטת האיסוף	המערכת מתבססת על הקוד באתר כדי לאסוף באופן אוטומטי פרטים שהמשתמשים סיפקו. אם נדרשת לכם שליטה על המקורות שמהם נאספים נתונים, כדאי לבחור בהגדרה ידנית או בהגדרה באמצעות קוד.	מציינים משתני JavaScript או מאפייני CSS נבחרים לאיסוף של פרטים שהמשתמשים סיפקו. אם נדרשת לכם שליטה על הגיבוב (hashing) וקביעת פורמט הנתונים, כדאי לבחור בהגדרה באמצעות קוד.	מוסיפים לדפי האתר קטע קוד שבאמצעותו יישלחו נתוני לקוחות שעברו גיבוב (hash) לצורכי התאמה. השיטה הזו היא האפשרות הטובה ביותר לשיפור הדיוק של ההמרות המשופרות, כי בכל פעם שיופעל תג ההמרה, הנתונים יישלחו בפורמט עקבי.
רמת המורכבות	פשוט	אמצעי הגעה לאתר	מורכבת
המיומנויות	לא נדרשות מיומנויות	HTML ו-CSS	פיתוח אתרים

איסוף אוטומטי

1. במאגר התגים של האתר, פותחים את התפריט משתנים.
2. יוצרים User-Defined Variable חדש מסוג User-Provided Data (פרטים שהמשתמשים סיפקו).
3. מגדירים את Type (סוג) לערך Automatic collection (איסוף אוטומטי).
4. נותנים שם למשתנה, לדוגמה My user-defined data.
5. לוחצים על שמירה.

הגדרה ידנית

1. במאגר התגים של האתר, פותחים את התפריט משתנים.
2. יוצרים User-Defined Variable חדש מסוג User-Provided Data (פרטים שהמשתמשים סיפקו).
3. מגדירים את הסוג כהגדרה ידנית.

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

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

5. כדי לציין רכיב מה-DOM, יוצרים New Variable (משתנה חדש) > Variable Configuration (הגדרות משתנה) > DOM Element (רכיב DOM).

6. בקטע Selection Method (שיטת הבחירה), תוכלו להשתמש ב-CSS Selector או ב-ID. טיפ: אם משתני ה-CSS שלכם משתנים לעיתים קרובות, כדאי להוסיף מזהה HTML לאתר ולהשתמש במשתנה ID (מזהה).

7. מזינים את שם המזהה או הסלקטור ב-CSS. אפשר להשאיר את השדה Attribute name (שם המאפיין) ריק.

8. נותנים שם למשתנה DOM Element (רכיב DOM) ושומרים אותו. המסך יחזור להגדרות של פרטים שהמשתמשים סיפקו.

9. נותנים שם למשתנה User-Provided Data (פרטים שהמשתמשים סיפקו), לדוגמה My user-defined data.

10. לוחצים על שמירה.

הגדרה באמצעות קוד

שלב 1: זיהוי והגדרה של המשתנים של ההמרות המשופרות

אתם יכולים לשלוח נתונים שגובבו מראש, או לשלוח נתונים לא מגובבים, ו-Google תגבב אותם לפני שהם יגיעו לשרתים. אם אתם מחליטים לשלוח נתונים שגובבו מראש, עליכם להשתמש באלגוריתם SHA256 לקידוד בשיטה הקסדצימלית כדי לקודד את הנתונים. בכל מקרה, עליכם לספק לפחות אחד מהשדות הבאים: email או phone_number.
כדי לדחוף נתונים לא מגובבים לשכבת הנתונים:

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

   var leadsUserData = {
     'email': '[e-mail]',
     'phone_number': '[phone]',
     'address': {
       first_name: 'John',
       last_name: 'Doe',
       street: '123 Lemon',
       city: 'Some city',
       region: 'CA',
       country: 'US',
       postal_code: '12345',
     },
   };
   

2. שולחים את נתוני המשתמש עם אירוע באמצעות הפונקציה dataLayer.push(). לדוגמה:

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'email': '[e-mail]',
         'phone_number': '[phone]',
         'address': {
            first_name: 'John',
            last_name: 'Doe',
            street: '123 Lemon',
            city: 'Some city',
            region: 'CA',
            country: 'US',
           postal_code: '12345',
          },
        },
     });
   <script>
   

המשתנה leadsUserData זמין עכשיו ב-Google Tag Manager.

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

1. מבצעים גיבוב של הפרטים שהמשתמשים סיפקו בעזרת אלגוריתם SHA256 לקידוד בשיטה הקסדצימלית. המפתח לנתונים המקודדים צריך להתחיל ב-sha256_. לדוגמה:

   {'sha256_email_address':await hashEmail(email.trim()),
   }
   

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

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'sha256_email_address': await hashEmail(email.trim()),
         'sha256_phone_number': await hashPhoneNumber(phoneNumber),
         'address': {
           sha265_first_name: await hashString(firstname),
           sha256_last_name: await hashString(lastname),
           sha256_street: await hashString(streetAddress),
           postal_code: '12345',
          },
        },
     });
   <script>
   

המשתנה leadsUserData זמין עכשיו ב-Google Tag Manager.

שלב 2: יוצרים משתנה שקשור לפרטים שהמשתמשים סיפקו

1. במאגר התגים של האתר, פותחים את התפריט משתנים.
2. יוצרים User-Defined Variable חדש מסוג User-Provided Data (פרטים שהמשתמשים סיפקו).
3. מגדירים את האפשרות Type (סוג) כ-Code (קוד).
4. בשדה הרלוונטי של נתוני המשתמשים שרוצים לספק, לוחצים על התפריט הנפתח ובוחרים באפשרות New Variable (משתנה חדש).
5. בקטע Choose Variable Type (בחירת סוג משתנה), בוחרים באפשרות Data Layer Variable (משתנה של שכבת נתונים).
6. בשדה Data Layer Variable (משתנה של שכבת נתונים), מפנים לנתוני המשתמש השמורים. לדוגמה: leadsUserData.
7. נותנים שם למשתנה של שכבת הנתונים ושומרים אותו. המסך יחזור להגדרות של פרטים שהמשתמשים סיפקו.
8. נותנים שם למשתנה User-Provided Data (פרטים שהמשתמשים סיפקו), לדוגמה My user-defined data.
9. לוחצים על שמירה.

הקצאת המשתנה ל-Google Tag

1. במאגר התגים של האתר, פותחים את התפריט Tags (תגים).
2. עורכים את Google Tag שבו משתמשים כדי לשלוח נתונים לשרת התיוג.
3. בקטע Configuration settings (הגדרות אישיות), מוסיפים Configuration parameter (פרמטר ההגדרה) חדש שנקרא user_data. מגדירים את Value (ערך) למשתנה User-provided Data (פרטים שהמשתמשים סיפקו), לדוגמה, {{My user-provided data}}.

4. שומרים את השינויים. התג אמור להיראות כך:

   

הגדרה של תג Floodlight בצד השרת

במאגר התגים בצד השרת, מפעילים את ההמרות המשופרות בתג Floodlight Sales או בתג המונה של Floodlight.

1. מסמנים את התיבה Include user-provided data (הכללת פרטים שהמשתמשים סיפקו).
   
2. לוחצים על Save כדי לשמור את השינויים.

אופציונלי: ערך הכנסה

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

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

כדי ליצור משתנה חדש:

1. במאגר השרת, פותחים את התפריט Variables (משתנים).
2. יוצרים משתנה חדש שמוגדר על ידי המשתמש עבור קלט הנתונים. לדוגמה, אם רוצים להשתמש בערך ממסד נתונים של Firestore, צריך ליצור משתנה של {{Firestore Lookup}}.
3. מציינים את מקורות הנתונים של המשתנה.
4. נותנים למשתנה את השם, לדוגמה 'Profit lookup' (חיפוש רווח) וSave (שמירה).

כדי להשתמש במשתנה בתג המכירות של Floodlight:

1. במאגר התגים של השרת, פותחים את התפריט Tags (תגים).
2. עורכים את התג Floodlight Sales.

3. בקטע פרמטרים ייחודיים:

   • עבור מקור נתונים, בוחרים באפשרות הגדרות אישיות.
   • בשדה Revenue (הכנסה), בוחרים את המשתנה שיצרתם קודם.
   • בשדה Order ID, מזינים מזהה או משתמשים במשתנה כדי לאכלס את מזהה ההזמנה באופן דינמי.

   

4. שומרים את התג.

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

אפשר להעביר שדות מותאמים אישית מדף האינטרנט ל-Google Marketing Platform, כמו match_id.

Google Tag Manager

כדי להגדיר שדות מותאמים אישית ל-Floodlight, צריך להוסיף את x-dc- בתחילת שם הפרמטר:

1. במאגר התגים של האתר, פותחים את התפריט Tags (תגים).
2. עורכים תג מעקב אירועים של GA4 או יוצרים תג חדש.

3. בקטע פרמטרים של אירועים, מוסיפים את שם הפרמטר. כדי לסמן שזה עובר ל-Floodlight, מוסיפים את x-dc- בתחילת הקובץ. לדוגמה, אם שולחים בדרך כלל את השדה match_id, צריך לשנות אותו ל-x-dc-match_id.

   

4. שומרים את התג.

gtag.js

כדי להגדיר שדות מותאמים אישית ל-Floodlight, מוסיפים את x-dc- בתחילת שם הפרמטר של האירוע:

  gtag('event', 'purchase', {
      'x-dc-match_id': [MATCH_ID],
      ...
  })

שלב 3: מאמתים את ההגדרה

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

1. פותחים את האתר.
2. במאגר התגים של Google Tag Manager בצד השרת, בוחרים באפשרות Preview (תצוגה מקדימה). Tag Assistant יתחיל ויטען את מאגר התגים בצד השרת.
3. בכרטיסייה תגים מוצגים כל התגים שהופעלו. חשוב לבדוק אם התג שהגדרתם הופעל.
4. בכרטיסייה Console מוצגות שגיאות שהתרחשו במהלך העברת הנתונים לקונטיינר של השרת. צריך לבדוק אם יש שגיאות ולטפל בהן.

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

השלבים הבאים

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