ייבוא נתוני מוצרים באמצעות ממשק ה-API לניהול

אנדרו וויילס, קשרי המפתחים של Google Analytics – מאי 2014

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

מבוא

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

לפני שתתחיל

לפני שתשלימו את מדריך הפתרונות, כדאי לקרוא את המאמרים הבאים:

סקירה

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

  1. יצירת מערך הנתונים
  2. הכנת קובץ ה-CSV של נתוני המוצרים להעלאה
  3. העלאת נתוני המוצרים באמצעות Management API
  4. עדכון קוד המסחר האלקטרוני כדי לשלוח את המק"ט של המוצר

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

צור את מערך הנתונים

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

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

איור 1: יצירת קבוצת נתוני מוצרים.

אחרי שיוצרים את קבוצת הנתונים, חשוב לזכור מהו מזהה מקור הנתונים המותאם אישית, שבו תשתמשו בשלב הבא כדי לייבא את נתוני המוצרים אל Google Analytics באמצעות Management API.

הכנת קובץ ה-CSV של נתוני המוצרים להעלאה

קובץ ה-CSV של נתוני המוצרים צריך להכיל שורת כותרת, עמודה למק"ט של המוצר, ועמודה לכל מאפיין ו/או מדד שרוצים לייבא, כפי שמוגדר בסכימה של מערך הנתונים.

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

איור 2: הכנת נתוני מוצרים להעלאה בקובץ CSV.

קובץ ה-CSV נראה כך:

ga:productSku,ga:productName,ga:productBrand,ga:productCategoryNew,ga:productVariant,ga:productPrice
12345,Triblend Shortsleeve T-Shirt,Google,Apparel,black,15.25
67890,Donut Friday Scented T-Shirt,Google,Apparel,gray,33.85
10292,Kaiser the Snake T-Shirt,Google,Apparel,green,19.10
67584,Organic Cotton Android T-Shirt,Google,Apparel,black,13.50
90876,Maps Biking T-Shirt,Google,Apparel,blue,15.65

העלאת נתוני המוצרים באמצעות Management API

אחרי שיצרתם את קבוצת הנתונים, הגדרתם את הסכימה והכנת את נתוני המוצרים להעלאה כקובץ CSV, תוכלו להעלות את נתוני המוצרים באמצעות Management API.

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

עדכון קוד המסחר האלקטרוני לשליחת המק"ט של המוצר

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

// Example of sending a transaction when joining with imported product data.
ga('create', 'UA-XXXX-Y');
ga('require', 'ec', 'ec.js'); // Load the Enhanced Ecommerce plug-in. Required.

// The product name, price, and other product data will be added to this hit
// at collection time if the value of the id field matches a Product SKU
// you've uploaded.
ga('ec:addImpression', {
  'id': '12345',              // Product ID/SKU (Key). Required.
  'list': 'Search Results',
  'position': 1,
  'dimension1': 'Member'
});

ga('send', 'pageview');       // Send the impression with a pageview hit.

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