এই ডকুমেন্ট সার্ভার-সাইড কন্টেনারে ইভেন্ট পাঠানোর বিভিন্ন উপায় বর্ণনা করে। আরও ব্যাকগ্রাউন্ড তথ্য প্রয়োজন হলে, সার্ভার-সাইড ট্যাগিং কীভাবে কাজ করে তা দেখুন।
এই ডকুমেন্টে কীভাবে:
- আপনার সার্ভার-সাইড কন্টেনারে কোনও ওয়েবসাইট থেকে ডেটা পাঠানো
- সার্ভার কন্টেনারে অতিরিক্ত ডেটা পাঠানো
- আপনার সার্ভার-সাইড কন্টেনারে ডেটা পাওয়া
- ওয়েবসাইট ছাড়া অন্য সোর্স থেকে ডেটা পাঠান
শুরু করার আগে
এই নির্দেশিকা ধরে নেয় যে আপনার কাছে আগে থেকেই এগুলি আছে:
১. আপনার সার্ভার-সাইড কন্টেনারে কোনও ওয়েবসাইট থেকে ডেটা পাঠানো
আপনি Tag Manager বা gtag.js-এর মাধ্যমে সার্ভার-সাইড প্রয়োগের মাধ্যমে ডেটা রাউট করতে পারবেন। প্রয়োগ করার বিকল্প বেছে নিন।
ঐচ্ছিক: প্রতিটি ইভেন্টের সাথে অতিরিক্ত প্যারামিটার পাঠান
আপনি আরও দুই ধরনের অতিরিক্ত প্যারামিটার পাঠাতে পারেন: কনফিগারেশন-লেভেল প্যারামিটার ও ইভেন্ট-লেভেল প্যারামিটার। কনফিগারেশন প্যারামিটার আপনার Google ট্যাগ বা Google Analytics ডেস্টিনেশন ট্যাগ কীভাবে কাজ করবে তা প্রভাবিত করে এবং এটি শুধুমাত্র Google ট্যাগ বা Google Analytics ডেস্টিনেশন ট্যাগ লেভেলে সেট করা যেতে পারে।
ইভেন্ট প্যারামিটার কোনও ইভেন্ট সম্পর্কে অতিরিক্ত তথ্য নির্দিষ্ট করে এবং সব ইভেন্ট, বেছে নেওয়া ইভেন্ট বা page_view ইভেন্টের জন্য সেট করা
যায়।
সাজেশন সেট-আপ করুন
সার্ভার কন্টেনারে ডেটা পাঠাতে আমরা ওয়েব পেজে Google Analytics ট্যাগ ব্যবহার করার সাজেশন দিই। ইভেন্টের সেরা ডেলিভারি রেট নিশ্চিত করতে এই ট্যাগ বিভিন্ন ট্রান্সপোর্ট পদ্ধতি ব্যবহার করতে পারে। এই ধরনের পদ্ধতির মধ্যে এগুলি অন্তর্ভুক্ত থাকলেও তা শুধুমাত্র এগুলির মধ্যেই সীমাবদ্ধ থাকে না:
- ইমেজ পিক্সেল
- Fetch API
- XHR
- আপনার সার্ভার কন্টেনার ডোমেন থেকে লোড করা iframe-এ রান করে এমন সার্ভিস ওয়ার্কার।
সব পদ্ধতি কাজ করে কিনা তা নিশ্চিত করতে নিম্নলিখিত বিষয়গুলি চেক করুন:
কন্টেন্ট-সিকিউরিটি-পলিসি (CSP)
| নির্দেশ | কন্টেন্ট | উদ্দেশ্য |
| img-src | [SERVER_CONTAINER_URL] | পরিমাপ সংক্রান্ত অনুরোধ |
| connect-src | [SERVER_CONTAINER_URL] | পরিমাপ সংক্রান্ত অনুরোধ |
| frame-src | [SERVER_CONTAINER_URL] | সার্ভিস ওয়ার্কার ইমপ্লিমেন্টেশন |
এছাড়াও, X-Frame-Options-এর মাধ্যমে সার্ভার কন্টেনার URL থেকে iframe লোড করার ক্ষেত্রে কোনও বিধিনিষেধ আরোপ করা যাবে না।
প্রতিটি প্রোডাক্টের জন্য নির্দিষ্ট নীতি জানতে https://developers.google.com/tag-platform/security/guides/csp লিঙ্কে গিয়ে দেখুন।
২. আপনার সার্ভার-সাইড কন্টেনারে ডেটা পাওয়া
আপনি কোনও সার্ভার কন্টেনারে HTTP অনুরোধ পাঠালে, ক্লায়েন্টকে সেই অনুরোধ দাবি করতে হবে।
উপলভ্য ক্লায়েন্টের তালিকা দেখতে:
আপনার সার্ভার কন্টেনার খুলুন।
বাঁদিকের নেভিগেশন বারে, ক্লায়েন্ট বিকল্পে ক্লিক করুন। Google Analytics ক্লায়েন্ট আপনার সার্ভার-সাইড কন্টেনারে ডিফল্ট হিসেবে আগে থেকেই ইনস্টল করা থাকে।
বিবরণ দেখতে বা এডিট করতে ক্লায়েন্টের নামের উপরে ক্লিক করুন।
ঐচ্ছিক ক্লায়েন্ট সেটিংস
বেশিরভাগ ক্ষেত্রে, ক্লায়েন্টকে কোনও পরিবর্তন করতে হবে না। তবে, আপনার ব্যবহারের ক্ষেত্র আলাদা হতে পারে এবং আপনি নিম্নলিখিত সেটিংসের মধ্যে কোনও একটি এডিট করতে চাইতে পারেন:
অগ্রাধিকার: ক্লায়েন্ট কোন ক্রমে রান করবে তা নির্ধারণ করে। বেশি নম্বর প্রথমে রান করে এবং ইনকামিং অনুরোধের সাথে ম্যাচ করা প্রথম ক্লায়েন্ট সেই অনুরোধের জন্য অ্যাক্টিভ ক্লায়েন্ট হয়ে যায়।
অ্যাক্টিভেশন সংক্রান্ত শর্ত: ক্লায়েন্ট কখন অনুরোধের উত্তর দেবে তা অ্যাক্টিভেশন সংক্রান্ত শর্ত থেকে জানা যায়:
- নির্দিষ্ট আইডির জন্য ডিফল্ট gtag.js পাথ: আপনার সার্ভার কন্টেনার URL-এর মাধ্যমে
gtag.js জাভাস্ক্রিপ্ট সার্ভিং চালু করতে এই সেটিং ব্যবহার করুন। চালু করা হলে, এই ক্লায়েন্ট ডিফল্ট gtag.js অনুরোধ পাথ, যেমন
/gtag/js?id=TAG_ID-এর অনুরোধের উত্তরে অ্যাক্টিভেট হবে। এক বা একাধিক ডেস্টিনেশন আইডি যোগ করতে, পরিমাপ আইডি যোগ করুন বিকল্পে ক্লিক করুন।
- নির্দিষ্ট আইডির জন্য ডিফল্ট gtag.js পাথ: আপনার সার্ভার কন্টেনার URL-এর মাধ্যমে
gtag.js জাভাস্ক্রিপ্ট সার্ভিং চালু করতে এই সেটিং ব্যবহার করুন। চালু করা হলে, এই ক্লায়েন্ট ডিফল্ট gtag.js অনুরোধ পাথ, যেমন
ঐচ্ছিক: সার্ভার-সাইড ট্যাগ ম্যানেজারে অতিরিক্ত ডেটা পান
আপনি অতিরিক্ত প্যারামিটার পাঠালে, আপনাকে অতিরিক্ত প্যারামিটার পার্স করতে এবং সেগুলি থেকে ইভেন্ট ডেটা তৈরি করতে আপনার সার্ভার কন্টেনারে Google Analytics ক্লায়েন্ট সেট-আপ করতে হবে।
কিছু সার্ভার ট্যাগ কোনও সেট-আপ ছাড়াই তাদের আউটবাউন্ড অনুরোধে অতিরিক্ত প্যারামিটার অন্তর্ভুক্ত করবে। সেইসব প্যারামিটার বাদ দিতে, মান সরিয়ে দেওয়ার জন্য একটি ট্রান্সফর্মেশন তৈরি করুন।
অন্য ট্যাগে অতিরিক্ত প্যারামিটার ব্যবহার করতে:
- আপনার সার্ভার কন্টেনারে, বাঁদিকের নেভিগেশন থেকে ভেরিয়েবল বিকল্পে ক্লিক করুন।
- নতুন ব্যবহারকারী-নির্ধারিত ভেরিয়েবল তৈরি করুন।
- ভেরিয়েবল কনফিগারেশন বিকল্পে গিয়ে, ভেরিয়েবলের ধরন ইভেন্ট ডেটা বেছে নিন।
- কী পাথ-এ প্যারামিটারের নাম লিখুন।
- আপনার ভেরিয়েবলকে একটি নাম দিন এবং সেভ করুন।
এখন আপনি নিজের সার্ভার কন্টেনারের মধ্যে থাকা যেকোনও ট্যাগে ইভেন্ট প্যারামিটার ব্যবহার করতে পারবেন।
৩. ঐচ্ছিক: ওয়েবসাইট ছাড়া অন্য সোর্স থেকে ডেটা পাঠানো
মোবাইল অ্যাপ এবং সার্ভার-টু-সার্ভার অ্যাপ্লিকেশনের মতো সোর্স থেকে সার্ভার-সাইড ট্যাগিং সহায়তা চালু করতে Google Analytics Measurement Protocol ব্যবহার করা যেতে পারে। এই বিকল্পের সাহায্যে আপনি মেজারমেন্ট প্রোটোকল ফর্ম্যাটে আপনার কন্টেনারে ইভেন্ট পাঠাতে পারবেন। অন্যান্য সব SGTM ইভেন্টের মতো একই মেকানিজম ব্যবহার করে কন্টেনারটি Google Analytics-এ সেইসব ইভেন্ট পাঠায়।
এই বিকল্পটি Measurement Protocol এন্ডপয়েন্টের সব ফিচারকে সাপোর্ট করে না, যেমন ট্যাগিং ইভেন্ট থেকে ভৌগোলিক ও ডিভাইস সংক্রান্ত তথ্য বের করা।
মোবাইল অ্যাপ
আপনার Android বা iOS অ্যাপ থেকে সার্ভার কন্টেনারে ডেটা পাঠানোর জন্য, আপনাকে কাস্টম ইমেজ ট্যাগ তৈরি করতে হবে এবং সেটি Measurement Protocol ব্যবহার করার জন্য কনফিগার করতে হবে:
- আপনার মোবাইল কন্টেনারে (Android বা iOS), ট্যাগ > নতুন বিকল্পে ক্লিক করুন।
- ট্যাগ কনফিগারেশনে গিয়ে কাস্টম ছবি ট্যাগ ধরন বেছে নিন।
- ছবির URL-এর ভ্যালু, সার্ভার কন্টেনারে পিক্সেল ছবিতে সেট করুন।
এই ছবি, Measurement Protocol ক্লায়েন্টে আপনার আগে উল্লেখ করা পাথে থাকবে।
আপনার পিক্সেল URL-এর শেষে যেকোনও কাঙ্ক্ষিত পরিমাপ প্রোটোকল প্যারামিটার যোগ করুন:
https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home - ক্যাশে বাস্টিং চালু করুন বিকল্প থেকে টিকচিহ্ন সরিয়ে দিন।
- ট্যাগ সেভ করে কন্টেনার প্রকাশ করুন।
- আপনার সার্ভার-সাইড কন্টেনারে, ক্লায়েন্ট > নতুন বিকল্পে ক্লিক করুন।
- ক্লায়েন্ট কনফিগারেশন বিকল্পে, Measurement Protocol ক্লায়েন্ট টাইপ বেছে নিন।
- আপনার অ্যাপের কালেকশন এন্ডপয়েন্টের পাথে অ্যাক্টিভেশন পাথ সেট করুন।
- ক্লায়েন্ট কনফিগারেশন সেভ করে সার্ভার-সাইড কন্টেনার প্রকাশ করুন।
সার্ভার-টু-সার্ভার অ্যাপ
আপনার সার্ভার কন্টেনারে পরিমাপ প্রোটোকল ডেটা পাঠাতে, আপনার সার্ভার
কন্টেনারের ডোমেনের নামের সাথে
www.google-analytics.com হোস্টনেম পরিবর্তন করুন। যেমন:
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
Measurement Protocol হিট পেতে, Measurement Protocol ক্লায়েন্টের সাথে আপনার সার্ভার-সাইড Tag Manager ইনস্টলেশন কনফিগার করুন:
- আপনার সার্ভার-সাইড কন্টেনারে, ক্লায়েন্ট > নতুন বিকল্পে ক্লিক করুন।
- ক্লায়েন্ট কনফিগারেশন বিকল্পে, Measurement Protocol ক্লায়েন্ট টাইপ বেছে নিন।
- আপনার সার্ভারের এন্ডপয়েন্টের পাথে অ্যাক্টিভেশন পাথ সেট করুন।
- ক্লায়েন্ট কনফিগারেশন সেভ করুন এবং কন্টেনার প্রকাশ করুন।
পরবর্তী ধাপ
সত্যিকারের ফার্স্ট-পার্টি প্রেক্ষাপটে ডেটা পাঠানোর জন্য, আপনাকে নিজের সার্ভার থেকে Google স্ক্রিপ্ট, যেমন Google Analytics লাইব্রেরি পরিবেশন করতে হবে।