תגי Google Floodlight

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

‫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 בצד השרת.
   ברוב המקרים, הטריגר All pages (כל הדפים) הוא האפשרות הטובה ביותר.
5. נותנים שם לתג ולוחצים על שמירה.

שלב 2: הגדרת תגי Floodlight

‫Google Tag Manager תומך בתגים Floodlight Counter ו-Floodlight Sales במאגר התגים בצד השרת.

מונה Floodlight

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

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

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

   

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

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

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

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

6. פותחים את החלון בחירת טריגר.

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

   

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

   

מכירות Floodlight

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

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

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

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

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

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

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

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

6. פותחים את החלון בחירת טריגר.

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

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

אופציונלי: הגדרת המרות עם נתונים מעגלות קניות

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

שלב 1 מתוך 2: שליחת פרמטרים של נתוני עגלות הקניות לשכבת הנתונים

1. יוצרים מערך JSON ecommerce.purchase.products. לדוגמה:

       'ecommerce':{
       'purchase':{
           'products': [{
               'id': 'String',
               'price': 'Floating point',
               'quantity': Integer,
               'country': 'String', // Optional
               'accountId': 'String' // Optional
           },
           {
               … // Each SKU (product) in the transaction
               // is in its own array item.
           }]
       }
       }'
   

2. משתמשים בשיטה dataLayer.push כדי שהנתונים יהיו זמינים בשכבת הנתונים של Google Tag Manager.

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

נתוני אירוע

1. במאגר התגים בצד השרת, פותחים את התג Floodlight Sales.
2. בקטע 'דיווח על מוצרים', מסמנים את התיבה שליחת נתוני מכירות ברמת המוצר.
3. בתפריט הנפתח 'מקור נתונים', בוחרים באפשרות נתוני אירועים. מערכת Google Tag Manager תשתמש באופן אוטומטי בנתונים שהועברו לשכבת הנתונים במערך ecommerce.purchase.products.
4. לוחצים על שמירה.

הגדרות בהתאמה אישית

1. במאגר התגים בצד השרת, פותחים את התג Floodlight Sales.
2. בקטע 'דיווח על מוצרים', מסמנים את התיבה שליחת נתוני מכירות ברמת המוצר.
3. בתפריט הנפתח 'מקור נתונים', בוחרים באפשרות הגדרה בהתאמה אישית.
4. בוחרים משתנה דינמי או מזינים ערך באופן ידני בשדות הבאים:
   • נתוני מוצרים: מחרוזת בפורמט מסוים שמכילה את נתוני המוצרים.
   • ‫Merchant ID (מספר חשבון Merchant): מספר חשבון Google Merchant Center של הקמעונאי.
   • תווית פיד: תווית שמזהה את הפיד הספציפי שבו נעשה שימוש ב-Google Merchant Center.
   • שפת הפיד: השפה של הפיד, שמיוצגת באמצעות קוד בן 2 אותיות לפי תקן ISO 639-1.
5. לוחצים על שמירה.

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

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

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

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

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

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

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

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

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

הגדרה ידנית

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

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 Element (רכיב DOM) ושומרים אותו. המסך יחזור להגדרות של פרטים שהמשתמשים סיפקו.

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

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

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

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

אתם יכולים לשלוח נתונים שגובבו (hashed) מראש, או לשלוח נתונים לא מגובבים, ו-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. יוצרים משתנה חדש בהגדרת המשתמש מסוג פרטים שהמשתמשים סיפקו.
3. מגדירים את האפשרות Code (קוד) בשדה Type (סוג).
4. בשדה הרלוונטי של נתוני המשתמש שרוצים לספק, לוחצים על התפריט הנפתח ובוחרים באפשרות משתנה חדש.
5. בקטע בחירת סוג משתנה, בוחרים באפשרות משתנה של שכבת נתונים.
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 Counter כדי להפעיל את התכונה 'המרות משופרות'.

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

בעזרת האפשרות 'פרטים שהמשתמשים סיפקו' אפשר לשלוח מהאתר פרטים מגובבים (hashed) שהמשתמשים סיפקו באינטראקציה ישירה (First-Party) כדי לשפר את הדיוק של המדידה. כדי להטמיע את התכונה הזו, קודם צריך להביע הסכמה לתנאים ולמדיניות בנושא פרטים שהמשתמשים סיפקו בחשבון Search Ads 360.

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

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

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

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

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

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

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

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

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

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

   

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, בוחרים באפשרות תצוגה מקדימה. כלי Tag Assistant יופעל ויטען את מאגר התגים בצד השרת.
3. בכרטיסייה Tags (תגים) מוצגים כל התגים שהופעלו. חשוב לבדוק אם התג שהגדרתם הופעל.
4. בכרטיסייה Console מוצגות שגיאות שהתרחשו במהלך העברת הנתונים למאגר התגים של השרת. בודקים אם יש שגיאות ופותרים אותן.

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

השלבים הבאים

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