קוד מעקב: מסחר אלקטרוני

הערה: בחומר העזר הזה מתוארות השיטות שמשמשות אותך למסחר אלקטרוני בדוחות של Google Analytics. למידע נוסף על הגדרת מעקב אחר מסחר אלקטרוני, אפשר לעיין במאמר מעקב אחר מסחר אלקטרוני.

שיטות של מסחר אלקטרוני ב-GATC

  • _addItem(transactionId, sku, name, category, price, quantity)
  • _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
  • _trackTrans()

פרטי השיטה

_addItem()

    _addItem(transactionId, sku, name, category, price, quantity)

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

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

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

    • חישוב כמויות באמצעות התוכנה שלכם.
      • באותו סשן, פריטים כפולים שנוספו (לפי מק"ט) לא משפיעים על חישוב הכמות.
      • באותו סשן, אם מוסיפים שני פריטים כשלכל אחד מהם יש אותו מק"ט, המידע על הפריט הראשון יוחלף בפריט השני.
    • מוודאים שלכל פריט במלאי יש מק"ט ייחודי.
      • אם יש במלאי פריטים שונים עם אותו מק"ט, ומבקר קונה את שניהם, יתקבלו נתונים רק של המוצרים האחרונים שנוספו.
    • יש לוודא שאובייקט עסקה של הורה מוגדר לפריטים שנוספו.
      • אם לא קיים אובייקט טרנזקציה ראשי לפריט שנוסף, הפריט מצורף במקום זאת לאובייקט עסקה ריק.
      • אם מוסיפים פריט ללא אובייקט טרנזקציה ראשי, בדוחות יוצגו מוצרים לפי מק"ט שאינם משויכים לשום עסקה.
    • צריך לספק ערך לפרמטר name בכל שלב.
      • לא חייבים להשתמש בפרמטר name, אבל פריטים שנוספו לעסקה בלי הפרמטר name לא מופיעים בפירוט המוצרים של עסקה. למרות שעדיין אפשר לראות את ההכנסה הכוללת של העסקה, לא ניתן יהיה לראות את ההכנסה שפריט מסוים תרם לסכום הכולל של העסקה.
       _gaq.push(['_addItem',
      '1234',         // transaction ID - necessary to associate item with transaction
      'DD44',         // SKU/code - required
      'T-Shirt',      // product name - necessary to associate revenue with product
      'Olive Medium', // category or variation
      '11.99',        // unit price - required
      '1'             // quantity - required
   ]);

    פרמטרים

      String   transactionId אופציונלי מזהה ההזמנה של העסקה לשיוך לפריט.
      String   sku חובה. קוד המק"ט של הפריט.
      String   name חובה. שם המוצר. חובה כדי להציג נתונים בדוח פרטי המוצר.
      String   category אופציונלי. קטגוריית המוצר.
      String   price חובה. מחיר המוצר.
      String   quantity חובה. הכמות לרכישה.

_addTrans()

    _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
    יצירת אובייקט עסקה עם הערכים הנתונים. כמו ב-_addItem(), השיטה הזו מטפלת רק במעקב אחר עסקאות, ולא מספקת פונקציונליות נוספת של מסחר אלקטרוני. לכן, אם העסקה היא עותק כפול של עסקה קיימת באותו סשן, ערכי העסקה הישנים מוחלפים בערכי העסקה החדשים. הארגומנטים בשיטה הזו מותאמים למיקום, ולכן חשוב לציין את כל הפרמטרים, גם אם לחלק מהם יש ערך ריק. 
       _gaq.push(['_addTrans',
      '1234',           // transaction ID - required
      'Womens Apparel', // affiliation or store name
      '28.28',          // total - required; Shown as "Revenue" in the
                        // Transactions report. Does not include Tax and Shipping.
      '1.29',           // tax
      '15.00',          // shipping
      'San Jose',       // city
      'California',     // state or province
      'USA'             // country
   ]);

    פרמטרים

      String   transactionId חובה. מספר מזהה ייחודי ופנימי לעסקה הזו.
      String   affiliation אופציונלי. שיוך שותף או חנות (לא מוגדר אם הוא חסר).
      String   total חובה. הסכום הכולל בדולרים של העסקה. הוא לא כולל מיסים ודמי משלוח, ויש להתייחס אליו רק כ'סך הכולל' אם הוא כולל משלוח ומיסים באופן מפורש.
      String   tax אופציונלי. סכום המס של העסקה.
      String   shipping אופציונלי. דמי משלוח עבור העסקה.
      String   city אופציונלי. העיר שיש לשייך לעסקה.
      String   state אופציונלי. הסטטוס שרוצים לשייך לעסקה.
      String   country אופציונלי. המדינה שאליה רוצים לשייך את העסקה.

    החזרות

      _gat.GA_EComm_.Transactions_ אובייקט העסקה שנוצר או שונה.

_trackTrans()

    _trackTrans()
    שליחה של נתוני העסקאות והפריטים לשרת של Google Analytics. צריך לקרוא לשיטה הזו אחרי _trackPageview() ולהשתמש בה בשילוב עם השיטות _addItem() ו-addTrans(). צריך להפעיל אותה אחרי שמגדירים פריטים ורכיבי טרנזקציה. 
    _gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
   '1234',           // transaction ID - required
   'Womens Apparel', // affiliation or store name
   '28.28',          // total - required
   '1.29',           // tax
   '15.00',          // shipping
   'San Jose',       // city
   'California',     // state or province
   'USA'             // country
]);
_gaq.push(['_addItem',
   '1234',           // transaction ID - necessary to associate item with transaction
   'DD44',           // SKU/code - required
   'T-Shirt',        // product name
   'Olive Medium',   // category or variation
   '11.99',          // unit price - required
   '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);