১. ভূমিকা
সর্বশেষ হালনাগাদ: ২০১৯-০৪-৩০
আপনি যা তৈরি করবেন
- এই কোডল্যাবে, আপনি শিখবেন কীভাবে মেজারমেন্ট প্রোটোকল ব্যবহার করে GA4-এ এক্সটার্নাল ইভেন্ট পাঠাতে হয়।
- এই কোডল্যাবটি ধরে নেয় যে আপনার ইতিমধ্যেই গুগল অ্যানালিটিক্স ৪ প্রয়োগ করা একটি ওয়েবপেজ/সাইট রয়েছে।
আপনি যা শিখবেন
- আপনার প্রথম এমপি কল করার পদক্ষেপ
- কলের জন্য প্রয়োজনীয় প্যারামিটারগুলো বুঝুন
- আপনার টেস্ট কলটি পাঠান এবং যাচাই করুন
- কলটি করার জন্য পাইথনে একটি নমুনা স্ক্রিপ্ট তৈরি করুন।
আপনার যা যা লাগবে
- একটি ওয়েবসাইট/ওয়েবপেজ
- পরিবর্তন করার জন্য যেকোনো IDE
- GA4 অ্যাকাউন্ট
- ঐচ্ছিক - পাইথন ডেভেলপমেন্ট এনভায়রনমেন্ট (অথবা কোলাব)
২. আবশ্যিক ক্ষেত্রগুলো সংগ্রহ করুন।
GA4-এ API সিক্রেট তৈরি করুন
GA4-এ যান এবং Admin > Data Streams > আপনার স্ট্রিমটি বেছে নিন > Measurement Protocol > Create-এ গিয়ে আপনার নতুন API সিক্রেট তৈরি করুন।
আপনি যেকোনো ডাকনাম দিতে পারেন, এবং গোপন মানটি প্রদর্শিত হবে, যা আপনি আপনার কলে ব্যবহার করতে পারবেন।
ক্লায়েন্ট আইডি সংগ্রহ করুন
আপনার ক্লায়েন্ট আইডি সংগ্রহ করতে আপনি নিচের যেকোনো পদ্ধতি ব্যবহার করতে পারেন।
- gTag এর মাধ্যমে সংগ্রহ করা
এই দুটি বিষয়ই নিচে বিস্তারিতভাবে ব্যাখ্যা করা হলো।
gTag এর মাধ্যমে সংগ্রহ করা
আপনি আপনার ওয়েবসাইট থেকে নিম্নলিখিত উপায়ে আপনার ক্লায়েন্ট আইডি পুনরুদ্ধার করতে পারেন:
gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
Do something with clientID)
}
আপনার পরিকাঠামোর উপর নির্ভর করে নিচে আরও কিছু লিঙ্ক দেওয়া হলো।
৩. আহ্বানটি গঠন করা
আপনি GA4-এর ইভেন্ট বিল্ডার ব্যবহার করে একটি নমুনা কল তৈরি করতে পারেন। (এর জন্য আপনাকে লগইন করতে হবে এবং কুকি চালু রাখতে হবে)। নিশ্চিত করুন যে টগলটি "gtag.js"-এ সেট করা আছে।
আপনাকে নিম্নলিখিত ক্ষেত্রগুলি পূরণ করতে হবে।
- api_secret - GA4-এ আগেই তৈরি করা হয়েছে
- measurement_id- এটি পেতে, আপনি Admin > Data Streams-এ গিয়ে আপনার স্ট্রিমটি বেছে নিন। এটি নিচে দেখানো ছবির মতো প্রদর্শিত হবে।
- client_id - আপনি এই মানটি ইতিমধ্যেই সংগ্রহ করেছেন
- user_id বাধ্যতামূলক নয়। আপনি আপাতত এটি খালি রাখতে পারেন।
- ক্যাটাগরি - ড্রপডাউন থেকে এটিকে 'কাস্টম'-এ পরিবর্তন করুন এবং আপনার পছন্দমতো যেকোনো ইভেন্টের নাম দিন (কোনো অটো কালেক্টেড ইভেন্ট ব্যবহার করবেন না)। এখানে আমরা 'test_from_codelab' ব্যবহার করছি।
ঐচ্ছিকভাবে, আপনি নিচের বাটনগুলোতে ক্লিক করে ইভেন্ট প্যারামিটার এবং/অথবা ব্যবহারকারীর বৈশিষ্ট্যসমূহও প্রদান করতে পারেন।
সবকিছু পূরণ করার পরে, আপনি এইরকম কিছু দেখতে পাবেন, যেখানে "ইভেন্ট যাচাই করুন" (Validate Event) লেখা একটি বাটন থাকবে।
এখানে পৌঁছানোর পর, কমলা রঙে হাইলাইট করা 'VALIDATE EVENT' বোতামটিতে ক্লিক করুন। এটি নিচের বার্তাটি প্রদর্শন করবে, যা নির্দেশ করবে যে ইভেন্টটি বৈধ, এবং আপনি এখন 'SEND TO GA' করার জন্য একটি বোতাম দেখতে পাবেন। এই পর্যায়ে, যদি ইভেন্টটি অবৈধ হিসেবে আসে, তাহলে টুলটি আপনাকে নির্দিষ্ট ফিল্ডটি বলে দেবে যেখানে সমস্যা আছে, এবং আপনি সেটি ঠিক করে আবার চেষ্টা করতে পারবেন।
আপনি এখন বোতামটিতে ক্লিক করতে পারেন, এবং এটি GA4-এ একটি টেস্ট ইভেন্ট পাঠাবে।
৪. GA4-এ ইভেন্ট যাচাইকরণ
ইভেন্টটি পাঠানোর পর, আপনি আপনার GA4 অ্যাকাউন্টে গিয়ে রিয়েলটাইম চেক করতে পারেন। সেখানে আপনি ইভেন্টটি দেখতে পাবেন।
রিয়েলটাইম ভিউ থেকে আসল ইভেন্ট রিপোর্টিং ট্যাবে ইভেন্টগুলো আসতে প্রায় ২৪ ঘণ্টা সময় লাগতে পারে, তাই নিয়মিত ইভেন্ট রিপোর্টিং-এ এটি সঙ্গে সঙ্গে দেখতে না পেলে চিন্তার কোনো কারণ নেই!
৫. পাইথন স্ক্রিপ্ট তৈরি করা
এখন যেহেতু আপনি এটি পরীক্ষা করে দেখেছেন, আপনি এপিআই কল এবং ইভেন্ট পেলোডটি খতিয়ে দেখে পাইথনে (বা আপনার পছন্দের যেকোনো ভাষায়) একটি অনুরূপ আর্কিটেকচার তৈরি করতে পারেন যা এই কলটি করতে সক্ষম। এরপর আপনি আপনার কাঙ্ক্ষিত ফ্রিকোয়েন্সিতে এটি শিডিউল করতে এবং কার্যকর করতে পারেন। এই অংশের জন্য, আপনি পাইথন সাপোর্ট করে এমন আপনার পছন্দের যেকোনো আইডিই (IDE) ব্যবহার করতে পারেন অথবা একটি গুগল কোলাব নোটবুক ব্যবহার করতে পারেন, যার জন্য আপনার ডিভাইসে কোনো ইনস্টলেশনের প্রয়োজন হয় না।
GA4 ইভেন্ট বিল্ডারে ফিরে গেলে আপনি দেখতে পাবেন যে এন্ডপয়েন্টটি নিম্নরূপ।
POST /mp/collect?measurement_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
ইভেন্ট পেলোডটি নিম্নরূপ ছিল।
{
"client_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
আপনি এই ধরনের কিছু ব্যবহার করে এটিকে পাইথনে অনুবাদ করতে পারেন।
import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
"client_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)
একবার আপনি সঠিক মানগুলো দিয়ে এটি কার্যকর করলে, একইভাবে GA4-এ ইভেন্টটি রিয়েলটাইমে প্রতিফলিত হতে দেখবেন।
৬. অভিনন্দন
অভিনন্দন, আপনি GA4-এ সফলভাবে মেজারমেন্ট প্রোটোকল ব্যবহার করেছেন। এখন আপনি গুগল অ্যানালিটিক্সে আরও অর্থবহ ডেটা পাঠাতে এবং আপনার মার্কেটিং ও বিজনেস অ্যানালিটিক্স উন্নত করতে শক্তিশালী সলিউশন আর্কিটেকচার তৈরি করতে পারেন। এর থেকে সর্বোত্তম সুবিধা পেতে, আমরা গুগল অ্যাডসের সাথে সংযোগ স্থাপন করার এবং এই ইভেন্টগুলোকে কনভার্সন হিসেবে ইম্পোর্ট করার পরামর্শ দিচ্ছি।
আপনি শিখেছেন
- এমপি কল করার জন্য সঠিক ভেরিয়েবলগুলো কীভাবে সংগ্রহ করবেন
- টেস্ট ইভেন্টগুলি কীভাবে পাঠাতে এবং যাচাই করতে হয়
- এমপি কল পাঠানোর জন্য কীভাবে একটি স্ক্রিপ্ট তৈরি করবেন