תגי Google Floodlight

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

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

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

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

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

שלב 1: מגדירים את התג מסוג Conversion Linker

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

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

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

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

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

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

מונה Floodlight

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

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

3. בוחרים את סוג התג מונה של Floodlight.

   

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

   • מזהה המפרסם: מזהה המפרסם יופיע אצל המפרסם מתחת לשם המפרסם. הערך הזה הוא נמצא גם כערך של src= בתג Floodlight שנוצר .
   • מחרוזת תג קבוצה: בטבלה 'פעילות', מזהים את הפעילות שבהם רוצים לעבוד, ומוצאים את מחרוזת תג הקבוצה שמופיעה עמודה מימין. אפשר למצוא אותו גם כערך של type= בקטע קוד של תג Floodlight שנוצר.
   • מחרוזת תג פעילות: בטבלה 'פעילות', מזהים את הפעילות שרוצים לעבוד איתה ומוצאים את תג הפעילות המחרוזת בעמודה מימין. זה נמצא גם בתור הערך של 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 אוסף באופן אוטומטי את הערכים הבאים שדה המסחר האלקטרוני התואם:

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

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

   • מזהה המפרסם: מזהה המפרסם יופיע אצל המפרסם מתחת לשם המפרסם. הערך הזה הוא נמצא גם כערך של src= בתג Floodlight שנוצר .
   • מחרוזת תג קבוצה: בטבלה 'פעילות', מזהים את הפעילות שבהם רוצים לעבוד, ומוצאים את מחרוזת תג הקבוצה שמופיעה עמודה מימין. אפשר למצוא אותו גם כערך של type= בקטע קוד של תג Floodlight שנוצר.
   • מחרוזת תג פעילות: בטבלה 'פעילות', מזהים את הפעילות שרוצים לעבוד איתה ומוצאים את תג הפעילות המחרוזת בעמודה מימין. זה נמצא גם בתור הערך של 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. במאגר התגים של האתר, פותחים את התפריט Variables (משתנים).
2. יוצרים משתנה חדש בהגדרת המשתמש מסוג User-Provided Data (פרטים שהמשתמשים סיפקו).
3. מגדירים את האפשרות Automatic collection (איסוף אוטומטי) בשדה Type (סוג).
4. נותנים שם למשתנה. לדוגמה, My user-defined data.
5. לוחצים על שמירה.

הגדרה ידנית

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

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

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

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

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

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

8. נותנים שם למשתנה של רכיב ה-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. במאגר התגים של האתר, פותחים את התפריט Variables (משתנים).
2. יוצרים משתנה חדש בהגדרת המשתמש מסוג 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 כשדה פרטים שהמשתמשים סיפקו למשל, {{My user-provided data}}.

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

   

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

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

הערה: תגי Floodlight, כשהם מופעלים, ישלחו את כל ההמרות הזמינות נתונים ל-Google (כולל פרטים שהמשתמשים סיפקו). אם רוצים לשנות או להחריג פרמטרים של אירועים לפני שהתג מופעל, להגדיר ולהשתמש ולצרף אותם לתג.

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

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

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

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

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

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

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

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

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

   

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

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

השלבים הבאים

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