এই নথিটি বর্ণনা করে কিভাবে পরিমাপ প্রোটোকলে সাধারণ হিট পাঠাতে হয়।
ওভারভিউ
এই ডকুমেন্টটি দেখায় কিভাবে HTTP অনুরোধগুলিকে Google Analytics পরিমাপ প্রোটোকলে সাধারণ হিট ধরনের পাঠাতে হয়। পর এটা:
- প্রোটোকল রেফারেন্স - প্রোটোকল অনুরোধগুলি কীভাবে ফর্ম্যাট করতে হয় তার একটি সম্পূর্ণ বিবরণ।
- প্যারামিটার রেফারেন্স – প্রোটোকল দ্বারা গৃহীত সমস্ত পরামিতির একটি তালিকা।
প্রয়োজনীয় মান পাঠানো
ব্যবহারকারীর ইন্টারঅ্যাকশন ডেটা পাঠাতে, এই শেষ পয়েন্টে একটি HTTP POST অনুরোধ করুন।
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-এ হিট পাঠাতে সক্ষম হয় না। এর উদাহরণ হল পুরোনো মোবাইল ফোন যা ফায়ারওয়ালের পিছনে জাভাস্ক্রিপ্ট বা কর্পোরেট ইন্ট্রানেট চালাতে পারে না। এই ক্ষেত্রে এটি একটি প্রক্সি সার্ভারে অনুরোধ পাঠানো সাধারণ যেটি পরে হিটগুলিকে 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.