डेटा इंपोर्ट डेवलपर गाइड

Google Analytics मैनेजमेंट एपीआई, Google Analytics की डेटा इंपोर्ट सुविधा को प्रोग्राम के हिसाब से ऐक्सेस करने की सुविधा देता है.

सुविधा के बारे में जानकारी

मैनेजमेंट एपीआई की मदद से, अपलोड की गई फ़ाइलों की सूची बनाई जा सकती है. साथ ही, फ़ाइलों को मिटाने और पाने के साथ-साथ डेटा सेट की सूची भी बनाई जा सकती है. डेटा इंपोर्ट की सुविधा के फ़ायदों के बारे में जानने के लिए, सहायता केंद्र का डेटा इंपोर्ट के बारे में लेख पढ़ें.

डेटा इंपोर्ट करने की सुविधा चालू करने वाले मैनेजमेंट एपीआई में, दो संसाधन शामिल हैं:

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

इस्तेमाल के उदाहरण

डेटा इंपोर्ट की सुविधा में तीन टॉप लेवल कैटगरी हैं. हर कैटगरी के अपने इस्तेमाल के उदाहरण हैं. संगठन की जानकारी इस तरह से दी जाती है:

• डेटा इंपोर्ट हिट करना
  • रिफ़ंड डेटा
• एक्सटेंडेड डेटा इंपोर्ट
  • उपयोगकर्ता का डेटा
  • कैंपेन का डेटा
  • भौगोलिक डेटा
  • कॉन्टेंट का डेटा
  • प्रॉडक्ट डेटा
• खास जानकारी का डेटा इंपोर्ट
  • लागत डेटा

हिट डेटा आयात

धनवापसी डेटा

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

Google Analytics में रिफ़ंड का डेटा इंपोर्ट करने का तरीका जानने के लिए, रिफ़ंड डेटा इंपोर्ट का उदाहरण देखें.

विस्तारित डेटा आयात

उपयोगकर्ता डेटा

बाहरी सीआरएम टूल से उपयोगकर्ता की व्यक्तिगत पहचान से जुड़ी जानकारी अपलोड की जा सकती है. साथ ही, अपने सबसे अहम सेगमेंट के लिए Google Ads की रीमार्केटिंग ऑडियंस बनाई जा सकती है.

Google Ads में रीमार्केटिंग ऑडियंस बनाने के लिए, Google Analytics में उपयोगकर्ता का डेटा इंपोर्ट करने का तरीका जानने के लिए देखें:

• Google Ads की रीमार्केटिंग ऑडियंस बनाने के लिए, उपयोगकर्ता का डेटा इंपोर्ट करना.

कैंपेन का डेटा

अपने कारोबार की परफ़ॉर्मेंस का विश्लेषण अपने हिसाब से करने के लिए, Google Analytics में कैंपेन का डेटा इंपोर्ट किया जा सकता है.

Google Analytics में कैंपेन डेटा इंपोर्ट करने का तरीका जानने के लिए, मैनेजमेंट एपीआई का इस्तेमाल करके कैंपेन डेटा इंपोर्ट करना देखें.

भौगोलिक डेटा

क्षेत्रों में भौगोलिक आईडी की मैपिंग इंपोर्ट की जा सकती हैं. इससे, Google Analytics के डेटा को कस्टम क्षेत्र के हिसाब से रिपोर्ट किया जा सकता है. उदाहरण के लिए, अमेरिका में आपके कारोबार कुछ राज्यों, पूर्व, मध्य, और पश्चिम में हो सकते हैं. वहीं, यूरोप के लिए आपका कारोबार उत्तर, मध्य, और दक्षिण देशों में हो सकता है. डेटा इंपोर्ट करते समय, ga:regionId, ga:cityId, ga:countryIsoCode या ga:subContinentCode को बटन के तौर पर इस्तेमाल किया जा सकता है. इलाके के हिसाब से टारगेट करने वाली टेबल में, शहर के आईडी और देश के आईडी देखे जा सकते हैं. देश के ISO कोड और उपमहाद्वीप कोड को ISO-3166-1 ऐल्फ़ा-2 और UN M.49 टेबल में देखा जा सकता है.

भौगोलिक डेटा इंपोर्ट करने के बारे में ज़्यादा जानकारी के लिए, भौगोलिक डेटा इंपोर्ट का उदाहरण देखें.

सामग्री डेटा

किसी वेबसाइट पर पब्लिश किए गए लेखों का ज़्यादा विश्लेषण करने के लिए, Google Analytics का इस्तेमाल किया जा सकता है. जैसे, लेखक और विषय का मेटाडेटा.

Google Analytics में कॉन्टेंट डेटा इंपोर्ट करने का तरीका जानने के लिए, कॉन्टेंट डेटा इंपोर्ट का उदाहरण देखें.

उत्पाद डेटा

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

Google Analytics में अपना प्रॉडक्ट डेटा इंपोर्ट करने का तरीका जानने के लिए, मैनेजमेंट एपीआई का इस्तेमाल करके प्रॉडक्ट डेटा इंपोर्ट करना देखें.

सारांश डेटा आयात

लागत का डेटा

Google से बाहर के ऐसे कैंपेन का लागत डेटा अपलोड किया जा सकता है जिनके लिए पैसे नहीं दिए जाते. साथ ही, लागत पर मुनाफ़ा (आरओआई) विश्लेषण करने के लिए Google Analytics प्लैटफ़ॉर्म का इस्तेमाल किया जा सकता है. साथ ही, ऑनलाइन विज्ञापन और मार्केटिंग निवेशों के लिए कैंपेन की परफ़ॉर्मेंस की तुलना की जा सकती है.

Google Analytics में लागत डेटा इंपोर्ट करने का तरीका जानने के लिए, मैनेजमेंट एपीआई का इस्तेमाल करके लागत डेटा इंपोर्ट करना देखें.

कॉन्सेप्ट

प्रोसेस की स्थिति

फ़ाइल अपलोड होने के बाद, अपलोड की स्थिति PENDING रहेगी, जब तक कि अपलोड की पुष्टि और उसे प्रोसेस नहीं किया जाता. प्रोसेस हो जाने पर, स्टेटस बदलकर COMPLETED हो जाएगा.

अगर प्रोसेस करते समय कोई गड़बड़ी हुई है और अपलोड नहीं हो पाया, तो अपलोड की स्थिति FAILED होगी. फ़ाइल में मौजूद समस्या(समस्याओं) की पहचान करने के लिए, गड़बड़ियों की सूची दी जाएगी. यहां उस अपलोड का उदाहरण दिया गया है जिसकी पुष्टि नहीं हो पाई:

{
  id: "YU4DersR_ORzyzXC_AoWw",
  kind: "analytics#upload",
  accountId: "12345",
  customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
  status: "FAILED",
  errors:
  [
    "Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
    "Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
    "Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
    "Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
  ]
}

ध्यान दें: आप समय-समय पर मैनेजमेंट एपीआई से, क्वेरी अपलोड की सूची बनाने और status फ़ील्ड की जांच करने के लिए क्वेरी कर सकते हैं.

लागत डेटा योग बनाम ओवरराइट

कस्टम डेटा सोर्स / लागत डेटा के लिए डेटा सेट बनाते समय, आपके पास यह तय करने का विकल्प होता है कि ऐसे मामलों को कैसे मैनेज किया जाए, जिनमें अपलोड की गई फ़ाइल में, किसी डेटा लाइन की कुंजी, जैसे कि तारीख, सोर्स, मीडियम, और मौजूदा लाइन से मैच होता हो. इसके विकल्प हैं:

• योग (डिफ़ॉल्ट) - नए डेटा को मैच करने वाले किसी पिछले डेटा में जोड़ दिया जाएगा और मेट्रिक को एक साथ जोड़ दिया जाएगा.
• ओवरराइट - नया डेटा, मिलते-जुलते पिछले डेटा को बदल देगा.

डेटा सेट के लिए सेट किए गए टाइप का पता लगाने के लिए कस्टम डेटा सोर्स की सूची वाले तरीके का इस्तेमाल करें. इससे यह पता चलेगा कि importBehavior प्रॉपर्टी को OVERWRITE पर सेट किया गया है या SUMMATION पर.

लागत डेटा पंक्ति स्तर योग बनाम ओवरराइट

हेडर में ga:importBehavior कॉलम शामिल करके, अपलोड की जाने वाली हर फ़ाइल के लिए डेटा सेट के व्यवहार को बदला जा सकता है. पंक्ति-प्रति-पंक्ति के आधार पर आप ga:importBehavior का मान SUMMATION या OVERWRITE पर सेट कर सकते हैं.

उदाहरण के लिए, नीचे दी गई फ़ाइल Facebook/cpc और Yahoo/cpc के किसी भी पिछले लागत डेटा को बदल देगी, लेकिन Bing/cpc के लिए पंक्ति उस खास तारीख और सोर्स/माध्यम कॉम्बिनेशन के किसी भी मौजूदा लागत डेटा में जोड़ दी जाएगी.

ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE

फ़ॉर्मैट और कंस्ट्रेंट

Google Analytics में डेटा अपलोड करने के लिए, यह सही फ़ॉर्मैट वाली CSV फ़ाइल में होना चाहिए. इस सेक्शन में बताया गया है कि डेटा इंपोर्ट के सभी टाइप पर अपलोड करने के लिए, किन शर्तों को पूरा करना होगा.

अगर नीचे दी गई किसी भी शर्त का उल्लंघन होता है या पार्स करने की गड़बड़ी होती है, तो अपलोड का अनुरोध गड़बड़ी के मैसेज के साथ काम नहीं करेगा. एपीआई, एक बार में 10 गड़बड़ियों को रिपोर्ट करेगा, ताकि उपयोगकर्ताओं को अमान्य अपलोड की संख्या कम करने में मदद मिल सके.

फ़ाइल की सीमाएं

• कोड में बदलने का तरीका: UTF-8
• फ़ाइल का साइज़ ज़्यादा से ज़्यादा 1 जीबी हो सकता है

हेडर कंस्ट्रेंट

• पहली पंक्ति को कॉलम हेडर माना जाता है और ऐसा करना ज़रूरी है. यह उन डाइमेंशन और मेट्रिक को तय करेगा जो किसी खास कॉलम में होंगे.

लाइन कंस्ट्रेंट

• लाइन की सीमा 1 एमबी है.

सेल फ़ॉर्मैटिंग

• सेल में ज़्यादा से ज़्यादा 2048 वर्ण हो सकते हैं.
• किसी सेल के आगे और पीछे की स्पेस हटा दी जाएंगी.
• किसी सेल में कॉमा लगाने के लिए, सेल की वैल्यू डबल कोट में होनी चाहिए. उदाहरण, source1,"medium,ether",group1,100 - दूसरे सेल का मान मध्यम है.
• किसी सेल में डबल कोट लगाने के लिए, डबल कोट को शुरू और खत्म करने के अलावा, डबल कोट से कोई दूसरा डबल कोटेशन मार्क हटाएं. उदाहरण, source1,"medium""ether",group1,100 - दूसरे सेल का मान medium"ether है.