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

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

खास जानकारी

इस दस्तावेज़ में बताया गया है कि 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 हिट दिए जा सकते हैं.
  • सभी हिट पेलोड का कुल साइज़ 16K बाइट से ज़्यादा नहीं हो सकता.
  • कोई भी हिट पेलोड 8K बाइट से ज़्यादा नहीं हो सकता.

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

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.

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