הטמעת Google Tag במערכת ניהול התוכן או בכלי לבניית אתרים

‫Google Tag הוא קטע קוד שאפשר להוסיף לאתר כדי למדוד את פעילות המשתמשים במגוון מוצרים של Google, כולל Google Analytics,‏ Google Ads ו-Google Marketing Platform. מידע נוסף על Google Tag

במדריך הזה מוסבר איך לשלב את Google Tag במערכת ניהול התוכן (CMS) או בכלי לבניית אתרים, כדי להעניק למשתמשי הקצה גישה למוצרי המדידה של Google.

קהל

המדריך הזה מיועד לבעלים של מערכות ניהול תוכן (CMS) או של כלים לבניית אתרים שרוצים לספק למשתמשים שלהם שילוב עם מוצרי המדידה של Google. המדריך הזה לא מיועד למשתמשים במערכת ניהול תוכן (CMS) או בכלי ליצירת אתרים.

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

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

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

סקירה כללית

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

1. יצירת שילוב עם Google Tag
2. עדכון מבנה קלט של משתמשים
3. הטמעה של API להפעלת סטטוס הסכמה
4. הגדרת נתוני אירועים
5. אימות השילוב המעודכן
6. עדכון ההוראות לפריסת המשתמשים

יצירת שילוב עם Google Tag

יצירת שילוב עם Google Tag מאפשרת ללקוחות שלכם לפרוס מוצרי מדידה של Google (באמצעות gtag.js) בכל דף באתר שלהם. חשוב להסיר את כל השילובים הקיימים של תגים מדור קודם (לדוגמה, analytics.js) לפני שיוצרים שילוב עם gtag.js.

כדי ליצור שילוב עם Google Tag, מחליפים את קטע הקוד הקיים בקטע הקוד הבא. מוודאים שהמשתמשים יכולים להחליף את TAG_ID במזהה התג שלהם.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GOOGLE_TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
  gtag('js', new Date());

  gtag('config', 'GOOGLE_TAG_ID');
</script>

שימו לב לנקודות הבאות:

• מפרסמים יכולים לבטל את ההסכמה לתכונות להתאמה אישית של מודעות, כמו רימרקטינג, באמצעות הפרמטר allow_ad_personalization_signals (ראו השבתת האיסוף של נתוני פרסום בהתאמה אישית).
• מומלץ שקטע הקוד של Google Tag יופיע רק פעם אחת בכל דף. קטע הקוד יכול להכיל כמה מזהי תגים. אם יש מופע קיים של gtag.js, צריך להוסיף את מזהי התגים החדשים לתג הקיים. מידע נוסף

עדכון המבנה של קלט של משתמשים

הלקוחות שלכם צריכים להיות מסוגלים לספק כמה סוגים של מזהה Google Tag דרך ממשק אחד, ללא קשר למוצר המדידה של Google שהם משתמשים בו.

לדוגמה, הקוד הבא מציג קלט פשוט של Google Tag. השילוב צריך להיות מוגדר כפריסה של Google Tag. אפשר להוסיף כתוביות לשיטה הזו כדי להסביר איך פורסים את Google Ads ואת Google Analytics.

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

קלט מזהה התג צריך לקבל כמה וריאציות של מזהים באמצעות תבנית הביטוי הרגולרי [A-Z]{1,3}\\w{5,}[\w]*.

הטמעה של API להפעלת סטטוס הסכמה (שנקרא גם סטטוס הסכמה)

ל-Google Tag יש API להפעלת סטטוס הסכמה מובנה לניהול הסכמה מהמשתמש. הוא יכול להבחין בין הסכמת המשתמש לשימוש בקובצי Cookie למטרות פרסום לבין הסכמה לשימוש בקובצי Cookie למטרות ניתוח.

התוצאה הצפויה היא שהלקוחות יקבלו לפחות את השיחה gtag('consent', 'update' {...}) משולבת, בלי שהלקוח יצטרך לבצע פעולה כלשהי. הפעולה הזו תבטיח שתגי Google (Google Ads, ‏ Floodlight, ‏ Google Analytics, ‏ Conversion Linker) יוכלו לקרוא את הסטטוס העדכני של הסכמת המשתמש ולכלול את הסטטוס בבקשות לרשת שנשלחות אל Google (באמצעות הפרמטר &gcs).

שלבי הטמעה נוספים יהיו פריסה או סיוע למפרסמים בפריסה (למשל, באמצעות ממשק משתמש) של gtag('consent', default' {...})הסטטוסgtag('consent', default' {...}) וביטול החסימה של Google Tag (כלומר, הפעלה מותנית שלא מבוססת על הסכמה) כדי לאפשר הפעלה של סטטוס ההסכמה באופן שתומך מובנה בסטטוס הסכמה.

פרטים על ההטמעה מופיעים במאמר בנושא ניהול הגדרות הסכמה (אתרים).

הגדרת נתוני אירועים

צריך לשלוח נתוני אירועים מפורטים מהאתר של הלקוח לחשבון Google שלו, בלי שהלקוח יצטרך לבצע פעולה כלשהי. לדוגמה, אפשר להוסיף את האירועים לאורך משפך רכישה (כלומר, ‫add_to_cart, begin_checkout, add_payment_info, add_shipping_info וגם purchase), יצירת לידים והרשמות.

אלה שיטות מומלצות להוספת אירועים:

• רישום כל מה שאפשר
• הגדרת לפחות 8 אירועים מרכזיים
• הגדרת עדיפות לאירועים של מסחר אלקטרוני

רישום כל מה שאפשר

מומלץ להגדיר אירועים כברירת מחדל. למשל:

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

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

האירועים נשלחים באמצעות הפקודה event. הוא כולל את אותו מזהה מפתח של Google Tag שציינתם בתג הגלובלי לאתר שמתואר למעלה:

gtag('event', 'my_event', {
  'developer_id.<developer ID>': true,
  // Additional event parameters
});

לדוגמה, אפשר להשתמש בפקודה event כדי לשלוח אירוע login עם ערך method של Google:

gtag('event', 'login', {
  'developer_id.<developer ID>': true,
  'method': 'Google'
});

<!-- Event snippet for sales conversion page -->
<script>
  gtag('event', 'conversion', {
      'developer_id.<developer ID>': true,
      'value': <value>,
      'currency': '<currency>',
      'transaction_id': '<transaction_id>'
  });
</script>

שימו לב לנקודות הבאות:

• מזהה הפיתוח <developer ID> הוא ייחודי וספציפי לפלטפורמה שלכם. מצרפים את המזהה לכל אירוע.
• הפרמטרים הבאים הם אופציונליים ואפשר להשמיט אותם:
  • ‫'value' הוא הערך המספרי של האירוע המרכזי (למשל המחיר של רכישה)
  • ‫'currency' הוא קוד מטבע בן שלוש אותיות, ששימושי למפרסמים שמקבלים מספר מטבעות
  • ‫'transaction_id' הוא מזהה ייחודי של העסקה (למשל מזהה הזמנה); הוא משמש למטרות ביטול כפילויות.
• חלק מהפרמטרים הם אופציונליים, אבל מומלץ לכלול כמה שיותר מידע שזמין לגבי כל אירוע.
  • פרמטרים מספקים מידע נוסף על האינטראקציה של המשתמשים עם האתר או האפליקציה שלכם. לדוגמה, כשמישהו צופה במוצר שאתם מוכרים, אפשר לכלול פרמטרים שמתארים את המוצר שצפו בו, כמו השם, הקטגוריה והמחיר שלו.
  • חלק מהפרמטרים מאכלסים באופן אוטומטי את המאפיינים והמדדים שהוגדרו מראש ב-Google Analytics, ומאפשרים למשתמשים להבין טוב יותר את הלקוחות שלהם.

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

<!-- Event snippet for sales conversion page
    In your HTML page, add the snippet and call gtag_report_conversion
    when someone clicks on the chosen link or button. -->
<script>
  function gtag_report_conversion(url) {
  var callback = function () {
    if (typeof(url) != 'undefined') {
      window.location = url;
    }
  };
  gtag('event', 'conversion', {
    'developer_id.<developer ID>': true,
    'value': <value>,
    'currency': '<currency>',
    'transaction_id': '<transaction_id>',
    'event_callback': callback
  });
  return false;
}
</script>

הגדרת לפחות 8 אירועים מרכזיים

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

• ‫view_item_list: כשמשתמש צופה ברשימת פריטים (למשל, רשימת מוצרים). מידע נוסף

  gtag('event', 'view_item_list', {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Item",
      currency: "USD",
      discount: 2.22,
      price: 99.9,
      quantity: 1
    }]
  });
  

• ‫add_to_cart: כשמשתמש מוסיף מוצר אחד או יותר לעגלת קניות. מידע נוסף

  gtag('event', 'add_to_cart', {
    value: 99.0,
    currency: "USD",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Product",
      price: 99.0,
      currency: 'USD',
      quantity: 1,
      item_category: "All Products"
    }]
  });
  

• ‫begin_checkout: כשמשתמש מתחיל את תהליך התשלום על מוצר אחד או יותר. מידע נוסף

  gtag('event', 'begin_checkout') {
    value: 99.0,
    currency: "USD",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Product",
      price: 99.0,
      currency: 'USD',
      quantity: 1,
      item_category: "All Products"
    }]
  });
  

• ‫purchase: כשמשתמש רוכש מוצר או שירות אחד או יותר. מידע נוסף

  gtag('event', 'purchase', {value: XX, currency: 'USD', items: [{xx},{xx}]});
  

• ‫sign_up: כשמשתמש נרשם, כדי שהמשתמש יוכל לראות את שיטות ההרשמה הפופולריות ביותר (למשל, חשבון Google, כתובת אימייל). מידע נוסף

  gtag('event', 'sign_up', {method: 'web'});
  

• ‫generate_lead: כשמשתמש שולח טופס. מידע נוסף

  gtag('event', 'generate_lead', {value: XX, currency: 'USD'});
  

• ‫subscribe: כשמשתמש נרשם לשירות או לניוזלטר.

  gtag('event', 'subscribe', {value: XX, currency: 'USD', coupon: 'XX'});
  

• ‫book_appointment: כשמשתמש קובע תור.

  gtag('event', 'book_appointment', {value: XX, currency: 'USD', coupon: 'XX'});
  

המלצות נוספות

‫Google תומך בהרבה יותר אירועים ופרמטרים, במיוחד עבור מסחר אלקטרוני. באופן כללי, מומלץ לתעד את הפרטים הבאים:

• כל אירוע הצלחה שמשויך ישירות לערך
• אירועי הצלחה שתורמים לאירועים מרכזיים בסיסיים (add_to_cart,‏ sign_up וכו')
• אינטראקציות ראשוניות ואינטראקציות של משתמשים שעוזרות למפרסמים להבין איך הם יוצרים קשר עם משתמשי הקצה שלהם

ריכזנו כאן מקורות מידע נוספים שמסבירים על איסוף אירועים:

• אירועים
• אירועים מומלצים לפי תרחיש שימוש
• מדידת מסחר אלקטרוני בנכסים ב-Google Analytics

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

אימות השילוב המעודכן

לפני שמעבירים את השינויים לסביבת הייצור, חשוב לוודא שהם תואמים ל:

• ‫Google Tag עם יעד ב-Google Analytics
• ‫Google Tag לרימרקטינג ולמעקב המרות

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

• ‫Google Tag Assistant: בעזרת Tag Assistant אפשר לראות אילו תגים מסוג Google Tag הופעלו ומה הסדר שבו הם הופעלו. מצב ניפוי באגים של Tag Assistant מראה אילו נתונים מועברים אל שכבת הנתונים ואילו אירועים הפעילו את העברות הנתונים האלה.
• הכלים למפתחים ב-Chrome: משתמשים בכרטיסייה רשת כדי לסנן בקשות שמכילות את המילה google, כדי לוודא איך הנתונים נשלחים.
• (בצד השרת) דוח הפעילות בזמן אמת ב-Google Analytics: יוצרים חשבון Google Analytics בחינם ומשתמשים בדוח פעילות בזמן אמת כדי לבדוק אם השרתים של Google מקבלים את ההיטים של התג.

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

במידת האפשר, מומלץ לשתף עם Google גישת בדיקה לצורך אימות שוטף.

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

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