प्रबंधन API का उपयोग करके उत्पाद डेटा आयात करना

एंड्रयू वेल्स, Google Analytics डेवलपर संबंध – मई 2014

इस गाइड में बताया गया है कि Management API का इस्तेमाल करके प्रॉडक्ट डेटा को इंपोर्ट करके, बेहतर ई-कॉमर्स को आसानी से लागू कैसे किया जा सकता है. प्रॉडक्ट डेटा इंपोर्ट करने के बारे में ज़्यादा जानकारी के लिए, प्रॉडक्ट डेटा इंपोर्ट का उदाहरण देखें.

शुरुआती जानकारी

Google Analytics में प्रॉडक्ट डेटा इंपोर्ट करने से, ई-कॉमर्स डेटा को प्रोसेस करना आसान हो जाता है और उसे कम करने के लिए, पेज व्यू और इवेंट जैसे हिट के साथ भेजना पड़ता है. कलेक्शन के समय Google Analytics को भेजे गए एक प्रॉडक्ट आईडी या SKU को, आपके इंपोर्ट किए गए प्रॉडक्ट डेटा के साथ जोड़ा जा सकता है. इससे, आपकी रिपोर्ट में प्रॉडक्ट के डाइमेंशन और मेट्रिक की जानकारी अपने-आप भर जाती है.

शुरू करने से पहले

समाधान की इस गाइड को पूरा करने से पहले, इसे पढ़ें:

खास जानकारी

अगर आपको प्रॉडक्ट डेटा के लिए डेटा इंपोर्ट की सुविधा चालू करनी है, तो:

  1. डेटा सेट बनाना
  2. अपलोड करने के लिए, प्रॉडक्ट डेटा की CSV फ़ाइल तैयार करना
  3. Management API का इस्तेमाल करके प्रॉडक्ट डेटा अपलोड करना
  4. प्रॉडक्ट की SKU भेजने के लिए, अपना ई-कॉमर्स कोड अपडेट करें

वेब इंटरफ़ेस का इस्तेमाल करके Google Analytics पर डेटा सेट अपलोड करने का तरीका जानने के लिए, बेहतर ई-कॉमर्स की उपयोगकर्ता गाइड देखें.

डेटा सेट बनाएं

प्रॉडक्ट डेटा इंपोर्ट करने का पहला कदम, अपने प्रॉडक्ट डेटा के लिए डेटा सेट बनाना है. साथ ही, वह स्कीमा सेट करना है जो उन डाइमेंशन और मेट्रिक के बारे में बताता है जिन्हें आपको इंपोर्ट करना है.

अपना डेटा सेट बनाने के लिए, डेटा इंपोर्ट डेवलपर गाइड का पालन करें. डेटा सेट टाइप के तौर पर प्रॉडक्ट डेटा और प्रॉडक्ट SKU को कुंजी के तौर पर चुनें.

पहली इमेज: प्रॉडक्ट डेटा सेट बनाना.

डेटा सेट बनाने के बाद, कस्टम डेटा सोर्स का आईडी नोट कर लें. इसका इस्तेमाल, Management API का इस्तेमाल करके, Google Analytics में अपने प्रॉडक्ट डेटा को इंपोर्ट करने के लिए अगले चरण में किया जाएगा.

अपलोड करने के लिए प्रॉडक्ट डेटा की CSV तैयार करना

आपके प्रॉडक्ट डेटा CSV में एक हेडर लाइन, प्रॉडक्ट SKU के लिए एक कॉलम, और हर डाइमेंशन और/या मेट्रिक के लिए एक कॉलम होना चाहिए. यह कॉलम डेटा सेट स्कीमा के हिसाब से तय किया जाता है.

इंपोर्ट के लिए अपना प्रॉडक्ट डेटा CSV तैयार करने के लिए, डेटा इंपोर्ट डेवलपर गाइड का पालन करें. इसके लिए, पहले कॉलम में प्रॉडक्ट SKU को कुंजी के तौर पर इस्तेमाल करें.

दूसरी इमेज: प्रॉडक्ट डेटा को 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

मैनेजमेंट एपीआई का इस्तेमाल करके प्रॉडक्ट डेटा अपलोड करना

डेटा सेट बनाने, स्कीमा तय करने, और CSV में अपलोड करने के लिए अपना प्रॉडक्ट डेटा तैयार करने के बाद, Management API का इस्तेमाल करके अपना प्रॉडक्ट डेटा अपलोड करें.

प्रॉडक्ट डेटा को अपलोड, पुष्टि, और प्रोसेस करने के बाद, प्रॉडक्ट SKU को अपलोड किए गए प्रॉडक्ट डेटा के साथ जोड़ दिया जाएगा. ऐसा तब होगा, जब आपकी प्रॉपर्टी से Google Analytics को भेजे गए आने वाले हिट का मैच होगा.

प्रॉडक्ट SKU भेजने के लिए अपना ई-कॉमर्स कोड अपडेट करें

प्रॉडक्ट डेटा अपलोड करने के बाद, अपना ई-कॉमर्स कोड अपडेट करें, ताकि आप अपनी हर हिट के साथ प्रॉडक्ट SKU के साथ-साथ अपनी रिपोर्ट में मौजूद कस्टम डाइमेंशन या मेट्रिक जैसा कोई भी अतिरिक्त डेटा भेज सकें.

// 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.

लागू किए गए बेहतर ई-कॉमर्स के ज़रिए भेजे गए प्रॉडक्ट आईडी, अब इंपोर्ट किए गए प्रॉडक्ट डेटा सेट में मौजूद प्रॉडक्ट SKU से मैच किए जाएंगे. साथ ही, आपकी रिपोर्ट में, अपलोड किया गया अतिरिक्त प्रॉडक्ट डेटा अपने-आप भर जाएगा.