मेज़रमेंट प्रोटोकॉल के साथ काम करना

इस दस्तावेज़ में, मेज़रमेंट प्रोटोकॉल में सामान्य हिट भेजने का तरीका बताया गया है.

खास जानकारी

इस दस्तावेज़ में बताया गया है कि Google Analytics मेज़रमेंट प्रोटोकॉल को सामान्य हिट टाइप भेजने के लिए, एचटीटीपी अनुरोधों को कैसे फ़ॉर्मैट किया जाए. इसे पढ़ें:

ज़रूरी वैल्यू भेजना

उपयोगकर्ता इंटरैक्शन का डेटा भेजने के लिए, इस एंडपॉइंट पर एचटीटीपी पोस्ट करने का अनुरोध करें.

POST /collect HTTP/1.1
Host: www.google-analytics.com

payload_data

हर पेलोड के लिए नीचे दिए गए पैरामीटर ज़रूरी हैं:

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.
&t=              // Hit Type.

हर पेलोड में एक मान्य हिट टाइप होना चाहिए. साथ ही, हर हिट टाइप के लिए, ज़रूरी फ़ील्ड का अपना सेट होता है. इसलिए, /home पेज के लिए पेज व्यू भेजने के लिए, आपको इस पेलोड का इस्तेमाल करना होगा:

v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome

नीचे दिए गए सेक्शन में, हिट के सामान्य टाइप के उदाहरण दिए गए हैं.

एक ही अनुरोध में कई हिट की बैच बनाना

एक ही अनुरोध में कई हिट भेजने के लिए, /collect के बजाय /batch एंडपॉइंट का इस्तेमाल करें और हर पेलोड को उसकी लाइन में तय करें.

उदाहरण के लिए, किसी वेबसाइट के "होम", "हमारे बारे में जानकारी", और "संपर्क करें" पेजों के लिए पेज व्यू हिट भेजने के लिए, नीचे दिए गए बैच अनुरोध भेजे जा सकते हैं.

POST /batch HTTP/1.1
Host: www.google-analytics.com

v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fabout
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fcontact

बैच की सीमाएं

मेज़रमेंट प्रोटोकॉल हिट की स्टैंडर्ड सीमाओं के अलावा, कई अनुरोधों की अतिरिक्त सीमाएं नीचे दी गई हैं:

  • हर अनुरोध के लिए, ज़्यादा से ज़्यादा 20 हिट दिए जा सकते हैं.
  • सभी हिट पेलोड का कुल साइज़ 16 हज़ार बाइट से ज़्यादा नहीं हो सकता.
  • कोई भी एक हिट पेलोड 8 हज़ार बाइट से ज़्यादा नहीं हो सकता.

सामान्य हिट टाइप भेजना

Google Analytics पर सामान्य हिट टाइप भेजने के तरीके के उदाहरण नीचे दिए गए हैं. इन उदाहरणों के अलावा, अलग-अलग पैरामीटर को मिलाकर, एक-दूसरे से डेटा को मैच किया जा सकता है. इससे, नए डेटा को एक-दूसरे से लिंक किया जा सकता है. उदाहरण के लिए, यह समझने के लिए कि किस पेज पर इवेंट हुआ, इवेंट ट्रैकिंग पैरामीटर के साथ pagePath पैरामीटर, p भेजें. इसके बारे में नीचे बताया गया है.

Google Analytics को भेजे जा सकने वाले सभी पैरामीटर की पूरी सूची देखने के लिए, पैरामीटर रेफ़रंस पढ़ें.

पेज ट्रैकिंग

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=pageview      // Pageview hit type.
&dh=mydemo.com   // Document hostname.
&dp=/home        // Page.
&dt=homepage     // Title.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

ईवेंट ट्रैकिंग

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=event         // Event hit type
&ec=video        // Event Category. Required.
&ea=play         // Event Action. Required.
&el=holiday      // Event label.
&ev=300          // Event value.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

बेहतर ई-कॉमर्स ट्रैकिंग

के साथ नहीं भेजे जा सकते.

ई-कॉमर्स हिट के बजाय, बेहतर ई-कॉमर्स हिट का इस्तेमाल किया जाना चाहिए. अगर आपने पहले ही ई-कॉमर्स ट्रैकिंग लागू की है और आपको बेहतर ई-कॉमर्स ट्रैकिंग का इस्तेमाल शुरू करना है, तो आपके पास दो विकल्प हैं:

नई प्रॉपर्टी का इस्तेमाल करना

एक नई प्रॉपर्टी बनाई जा सकती है और नई प्रॉपर्टी पर बेहतर ई-कॉमर्स हिट भेजे जा सकते हैं.

किसी मौजूदा प्रॉपर्टी को माइग्रेट करना

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

इंप्रेशन का आकलन करना

v=1                                      // Version.
&tid=UA-XXXXX-Y                          // Tracking ID / Property ID.
&cid=555                                 // Anonymous Client ID.
&t=pageview                              // Pageview hit type.
&dh=mydemo.com                           // Document hostname.
&dp=/home                                // Page.
&dt=homepage                             // Title.

&il1nm=Search%20Results                  // Impression list 1. Required.
&il1pi1id=P12345                         // Product Impression 1 ID. Either ID or name must be set.
&il1pi1nm=Android%20Warhol%20T-Shirt     // Product Impression 1 name. Either ID or name must be set.
&il1pi1ca=Apparel%2FT-Shirts             // Product Impression 1 category.
&il1pi1br=Google                         // Product Impression 1 brand.
&il1pi1va=Black                          // Product Impression 1 variant.
&il1pi1ps=1                              // Product Impression 1 position.
&il1pi1cd1=Member                        // Custom dimension.

&il2nm=Recommended%20Products            // Impression list 2.
&il2pi1nm=Yellow%20T-Shirt               // Product Impression 1 name.
&il2pi2nm=Red%20T-Shirt                  // Product Impression 2 name.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

कार्रवाइयों को मापना

v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type.
&ec=UX                                // Event Category. Required.
&ea=click                             // Event Action. Required.
&el=Results                           // Event label.

&pa=click                             // Product action (click). Required.
&pal=Search%20Results                 // Product Action List.
&pr1id=P12345                         // Product 1 ID. Either ID or name must be set.
&pr1nm=Android%20Warhol%20T-Shirt     // Product 1 name. Either ID or name must be set.
&pr1ca=Apparel                        // Product 1 category.
&pr1br=Google                         // Product 1 brand.
&pr1va=Black                          // Product 1 variant.
&pr1ps=1                              // Product 1 position.
    

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

इंप्रेशन और कार्रवाइयों को मिलाना

v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID /  Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type.
&ec=UX                                // Event Category. Required.
&ea=click                             // Event Action. Required.
&el=Results                           // Event label.

&pa=detail                            // Product action (detail). Required.
&pr1id=P12345                         // Product 1 ID. Either ID or name must be set.
&pr1nm=Android%20Warhol%20T-Shirt     // Product 1 name. Either ID or name must be set.
&pr1ca=Apparel                        // Product 1 category.
&pr1br=Google                         // Product 1 brand.
&pr1va=Black                          // Product 1 variant.
&pr1ps=1                              // Product 1 position.

&il1nm=Related%20Products             // Impression list.
&il1pi1id=P12345                      // Product Impression 1 ID.
&il1pi1nm=Android%20Warhol%20T-Shirt  // Product Impression 1 name.
&il1pi1ca=Apparel%2FT-Shirts          // Product Impression 1 category.
&il1pi1br=Google                      // Product Impression 1 brand.
&il1pi1va=Black                       // Product Impression 1 variant.
&il1pi1ps=1                           // Product Impression 1 position.
   

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

खरीदारी का आकलन करना

v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=pageview                           // Pageview hit type.
&dh=mydemo.com                        // Document hostname.
&dp=/receipt                          // Page.
&dt=Receipt%20Page                    // Title.

&ti=T12345                            // Transaction ID. Required.
&ta=Google%20Store%20-%20Online       // Affiliation.
&tr=37.39                             // Revenue.
&tt=2.85                              // Tax.
&ts=5.34                              // Shipping.
&tcc=SUMMER2013                       // Transaction coupon.

&pa=purchase                          // Product action (purchase). Required.
&pr1id=P12345                         // Product 1 ID. Either ID or name must be set.
&pr1nm=Android%20Warhol%20T-Shirt     // Product 1 name. Either ID or name must be set.
&pr1ca=Apparel                        // Product 1 category.
&pr1br=Google                         // Product 1 brand.
&pr1va=Black                          // Product 1 variant.
&pr1ps=1                              // Product 1 position.
    

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

रिफ़ंड को मेज़र करना

अगर आपको किसी इवेंट का इस्तेमाल करके रिफ़ंड डेटा भेजना है और वह इवेंट आम तौर पर, मेज़र किए गए ऑनसाइट व्यवहार (यानी उपयोगकर्ता की ओर से शुरू नहीं किया गया) का हिस्सा नहीं है, तो हमारा सुझाव है कि आप एक नॉन-इंटरैक्शन इवेंट भेजें. इससे बाउंस रेट, सेशन की अवधि वगैरह जैसी मेट्रिक पर इवेंट का असर नहीं पड़ेगा.

 // Refund an entire transaction and send with a non-interaction event.
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type.
&ec=Ecommerce                         // Event Category. Required.
&ea=Refund                            // Event Action. Required.
&ni=1                                 // Non-interaction parameter.

&ti=T12345                            // Transaction ID. Required.
&pa=refund                            // Product action (refund). Required.
    

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

 // Refund a single product.
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type.
&ec=Ecommerce                         // Event Category. Required.
&ea=Refund                            // Event Action. Required.
&ni=1                                 // Non-interaction parameter.

&ti=T12345                            // Transaction ID. Required.
&pa=refund                            // Product action (refund). Required.
&pr1id=P12345                         // Product 1 ID. Required.
&pr1qt=1                              // Product 1 quantity. Required.
    

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

चेकआउट प्रोसेस को मेज़र करना

1. चेकआउट के चरणों का आकलन करना
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=pageview                           // Pageview hit type.
&dh=mydemo.com                        // Document hostname.
&dp=/checkout                         // Page.
&dt=Checkout                          // Title.

&pa=checkout                          // Product action (checkout).
&pr1id=P12345                         // Product 1 ID. Either ID or name must be set.
&pr1nm=Android%20Warhol%20T-Shirt     // Product 1 name. Either ID or name must be set.
&pr1ca=Apparel                        // Product 1 category.
&pr1br=Google                         // Product 1 brand.
&pr1va=Black                          // Product 1 variant.
&pr1pr=29.20                          // Product 1 Price.
&pr1qt=1                              // Product 1 quantity.
&cos=1                                // Checkout step #1.
&col=Visa                             // Checkout step option.
    

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

2. चेकआउट विकल्पों का आकलन करना
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type
&ec=Checkout                          // Event Category. Required.
&ea=Option                            // Event Action. Required.

&pa=checkout_option                   // Product action (checkout_option).
&cos=2                                // Checkout step.
&col=FedEx                            // Checkout step option.
    

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

आंतरिक प्रचार को मापना

प्रमोशन से मिले इंप्रेशन
v=1                                      // Version.
&tid=UA-XXXXX-Y                          // Tracking ID / Property ID.
&cid=555                                 // Anonymous Client ID.
&t=pageview                              // Pageview hit type.
&dh=mydemo.com                           // Document hostname.
&dp=/home                                // Page.
&dt=homepage                             // Title.

&promo1id=PROMO_1234                     // Promotion 1 ID. Either ID or name must be set.
&promo1nm=Summer%20Sale                  // Promotion 1 name. Either ID or name must be set.
&promo1cr=summer_banner2                 // Promotion Creative.
&promo1ps=banner_slot1                   // Promotion Position.
    

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

प्रचार क्लिक
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type
&ec=Internal%20Promotions             // Event Category. Required.
&ea=click                             // Event Action. Required.
&el=Summer%20Sale                     // Event label.

&promoa=click                         // Promotion action (click). Required.
&promo1id=PROMO_1234                  // Promotion 1 ID. Either ID or name must be set.
&promo1nm=Summer%20Sale               // Promotion 1 name. Either ID or name must be set.
&promo1cr=summer_banner2              // Promotion Creative.
&promo1ps=banner_slot1                // Promotion Position.
    

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

ईकॉमर्स ट्रैकिंग

ई-कॉमर्स डेटा भेजने के लिए, पूरे लेन-देन को दिखाने के लिए एक transaction हिट भेजें. इसके बाद, लेन-देन में हर आइटम के लिए item हिट भेजें. लेन-देन आईडी ti पूरी खरीदारी को दिखाने के लिए, सभी हिट को एक साथ जोड़ता है.

लेन-देन हिट

v=1               // Version.
&tid=UA-XXXXX-Y   // Tracking ID / Property ID.
&cid=555          // Anonymous Client ID.

&t=transaction    // Transaction hit type.
&ti=12345         // transaction ID. Required.
&ta=westernWear   // Transaction affiliation.
&tr=50.00         // Transaction revenue.
&ts=32.00         // Transaction shipping.
&tt=12.00         // Transaction tax.
&cu=EUR           // Currency code.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

आइटम हिट

v=1               // Version.
&tid=UA-XXXXX-Y   // Tracking ID / Property ID.
&cid=555          // Anonymous Client ID.

&t=item           // Item hit type.
&ti=12345         // Transaction ID. Required.
&in=sofa          // Item name. Required.
&ip=300           // Item price.
&iq=2             // Item quantity.
&ic=u3eqds43      // Item code / SKU.
&iv=furniture     // Item variation / category.
&cu=EUR           // Currency code.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

सामाजिक इंटरैक्शन

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=social        // Social hit type.
&sa=like         // Social Action. Required.
&sn=facebook     // Social Network. Required.
&st=/home        // Social Target. Required.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

अपवाद ट्रैकिंग

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=exception       // Exception hit type.
&exd=IOException   // Exception description.
&exf=1             // Exception is fatal?

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

उपयोगकर्ता समय ट्रैकिंग

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=timing        // Timing hit type.
&utc=jsonLoader  // Timing category.
&utv=load        // Timing variable.
&utt=5000        // Timing time.
&utl=jQuery      // Timing label.

 // These values are part of browser load times

&dns=100         // DNS load time.
&pdt=20          // Page download time.
&rrt=32          // Redirect time.
&tcp=56          // TCP connect time.
&srt=12          // Server response time.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

ऐप्लिकेशन / स्क्रीन ट्रैकिंग

v=1                         // Version.
&tid=UA-XXXXX-Y             // Tracking ID / Property ID.
&cid=555                    // Anonymous Client ID.

&t=screenview               // Screenview hit type.
&an=funTimes                // App name.
&av=1.5.0                   // App version.
&aid=com.foo.App            // App Id.
&aiid=com.android.vending   // App Installer Id.

&cd=Home                    // Screen name / content description.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.

प्रॉक्सी सर्वर का इस्तेमाल करना

कुछ एनवायरमेंट, सीधे Google Analytics को हिट नहीं भेज सकते. इसके उदाहरण पुराने मोबाइल फ़ोन हैं, जो फ़ायरवॉल के पीछे JavaScript या कॉर्पोरेट इंट्रानेट नहीं चला सकते. इन मामलों में, अनुरोध आम तौर पर ऐसे प्रॉक्सी सर्वर पर भेजे जाते हैं जो हिट को Google Analytics पर भेजने के लिए, मेज़रमेंट प्रोटोकॉल का इस्तेमाल करता है.

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

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=pageview      // Pageview hit type.
&uip=1.2.3.4     // IP address override.
&ua=Opera/9.80   // User agent override.

इस हिट को मेज़रमेंट प्रोटोकॉल हिट बिल्डर में देखें.