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

Google Tag (gtag.js) הוא קטע קוד שאפשר להוסיף לאתר כדי למדוד את פעילות המשתמשים במגוון מוצרי 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) בכל דף באתר. חשוב להסיר שילובים קיימים של תגים מדור קודם (למשל, 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('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 עם הערך "Google" ב-method:

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: ניתן להשתמש בכרטיסייה Network כדי לסנן בקשות שמכילות את המילה "google", על מנת לבדוק את אופן שליחת הנתונים.
• (בצד השרת) דוח 'זמן אמת של Google Analytics': יוצרים חשבון Google Analytics בחינם ומשתמשים בדוח זמן אמת כדי לראות אם ההיטים של התג התקבלו על ידי השרתים של Google.

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

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

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

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