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

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

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

קהל

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

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

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

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

סקירה כללית

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

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

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

בעזרת שילוב עם Google Tag, הלקוחות שלכם יוכלו לפרוס מוצרי מדידה של Google (דרך gtag.js) בכל דף באתר שלהם. לפני שיוצרים שילוב עם gtag.js, צריך להסיר את כל שילובי התגים הקיימים מדור קודם (למשל, analytics.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 ול-Google Ads, אבל כל תהליך מוביל לממשק אחד שבו המשתמשים מספקים את מזהה Google Tag שלהם.

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

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

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

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

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

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

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

עליכם לשלוח נתוני אירועים עשירים מהאתר של הלקוח לחשבון 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 4

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

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

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

• Google Tag עם יעד של Google Analytics 4
• Google Tag שלכם לרימרקטינג ולמעקב המרות

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

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

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

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

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

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