डेटा आयात डेवलपर गाइड

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

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

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

डेटा इंपोर्ट की सुविधा चालू करने वाले, Management API के दो संसाधन:

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

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

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

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

हिट डेटा आयात

धनवापसी डेटा

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

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

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

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

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

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

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

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

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

Google Analytics में कैंपेन डेटा इंपोर्ट करने का तरीका जानने के लिए, Management API का इस्तेमाल करके कैंपेन डेटा इंपोर्ट करना लेख पढ़ें.

भौगोलिक डेटा

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

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

सामग्री डेटा

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

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

उत्पाद डेटा

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

Google Analytics में अपना प्रॉडक्ट डेटा इंपोर्ट करने का तरीका जानने के लिए, Management API का इस्तेमाल करके प्रॉडक्ट डेटा इंपोर्ट करना लेख पढ़ें.

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

लागत का डेटा

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

Google Analytics में लागत डेटा इंपोर्ट करने का तरीका जानने के लिए, Management API का इस्तेमाल करके लागत डेटा इंपोर्ट करना लेख पढ़ें.

कॉन्सेप्ट

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

फ़ाइल अपलोड करने के बाद, अपलोड की स्थिति तब तक 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."
  ]
}

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

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

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

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

यह पता लगाने के लिए कि डेटा सेट के लिए किस टाइप को सेट किया गया है, कस्टम डेटा सोर्स सूची वाले तरीके का इस्तेमाल करके देखें कि 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 है.