הטמעת 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('js', new Date());
  gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID

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