1. ভূমিকা
শেষ আপডেট: 2021-06-08
আপনি কি নির্মাণ করবেন
এই কোডল্যাবে, আপনি শিখবেন কিভাবে পরিমাপ প্রোটোকল ব্যবহার করে GA4 এ বাহ্যিক ইভেন্ট পাঠাতে হয়।
এই কোডল্যাব ধরে নেয় যে আপনার কাছে ইতিমধ্যেই Firebase-এর জন্য Google Analytics-এর সাথে একটি অ্যাপ আছে। আপনি যদি Firebase-এর জন্য Google Analytics-এর সাথে একীভূত করতে শিখতে চান, তাহলে প্রথমে এই কোডল্যাবটি পড়ুন। আপনি যদি Firebase-এর সাহায্যে একটি অ্যাপ তৈরি করতে শিখতে চান, তাহলে অনুগ্রহ করে Firebase Android Codelab-Build Friendly Chat দেখুন।
আপনি কি শিখবেন
- আপনার প্রথম এমপি কল করার পদক্ষেপ
- কলের জন্য প্রয়োজনীয় পরামিতিগুলি বুঝুন
- আপনার পরীক্ষার কল পাঠান এবং যাচাই করুন
- কল করতে পাইথনে একটি নমুনা স্ক্রিপ্ট তৈরি করুন
আপনি কি প্রয়োজন হবে
- আপনার Android বা iOS অ্যাপ
- পরিবর্তন করতে কোনো IDE
- GA4 অ্যাকাউন্ট
- ঐচ্ছিক - পাইথন ডেভেলপমেন্ট এনভায়রনমেন্ট (বা Colab )
2. বাধ্যতামূলক ক্ষেত্রগুলি সংগ্রহ করুন
GA4 এ API সিক্রেট তৈরি করুন
GA4 এ নেভিগেট করুন এবং অ্যাডমিন > ডেটা স্ট্রীম > আপনার স্ট্রিম বেছে নিন > পরিমাপ প্রোটোকল > তৈরি করুন- এ নেভিগেট করে আপনার নতুন API গোপন তৈরি করুন
আপনি যেকোনো ডাকনাম প্রদান করতে পারেন, এবং গোপন মান প্রদর্শিত হবে, যা আপনি আপনার কলে ব্যবহার করতে পারেন
আপনি GA4 কিভাবে অ্যাক্সেস করবেন তা নিশ্চিত না হলে, আপনি আপনার ফায়ারবেস প্রজেক্টে যেতে পারেন, প্রজেক্ট সেটিংস > ইন্টিগ্রেশন > Google Analytics চেক করুন এবং "ম্যানেজ" এ ক্লিক করুন। Google Analytics সংযোগটি দৃশ্যমান হওয়া উচিত এবং আপনি সেখান থেকে সরাসরি নেভিগেট করতে পারেন
app_instance_id সংগ্রহ করুন
আপনি আপনার app_instance_id সংগ্রহ করতে নিচের যেকোনো পদ্ধতি ব্যবহার করতে পারেন।
- BigQuery এক্সপোর্ট ব্যবহার করে
- আপনার অ্যাপ সোর্স কোডে নেটিভলি আনা হচ্ছে
এই উভয় নিচে বিস্তারিত ব্যাখ্যা করা হয়
- BigQuery এক্সপোর্ট ব্যবহার করে
আপনার যদি BigQuery এক্সপোর্ট চালু থাকে, তাহলে আপনি নিচের ধাপগুলি অনুসরণ করতে পারেন
- Firebase এ সাইন ইন করুন
- প্রোজেক্ট সেটিংস > ইন্টিগ্রেশন > BigQuery-এ নেভিগেট করুন
- ডেটাসেটের কাছে "BigQuery-এ দেখুন"-এ ক্লিক করুন
দ্রষ্টব্য: প্রায় 24-48 ঘন্টার জন্য টগল সক্ষম করার পরেই ডেটাসেটটি উপলব্ধ হবে
- BigQuery-এ, আপনি টেবিলে user_pseudo_id চেক করতে পারেন। এটি হল অ্যাপ_ইনস্ট্যান্স_আইডি যা আপনি আপনার কলে ব্যবহার করতে পারেন
- আপনার অ্যাপ সোর্স কোডে নেটিভলি আনা হচ্ছে
যদি আপনার অ্যাপটি জাভা ব্যবহার করে তৈরি করা হয়, তাহলে আপনি app_instance_id পুনরুদ্ধার করতে এরকম কিছু ব্যবহার করতে পারেন
FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(new OnCompleteListener<String>() {
@Override
public void onComplete(@NonNull Task<String> task) {
if (task.isSuccessful()) {
String user_pseudo_id = task.getResult();
}
}
});
Kotlin জন্য, আপনি নীচের চেষ্টা করতে পারেন
Thread {
Firebase.analytics.appInstanceId.addOnSuccessListener { user_pseudo_id ->
Log.d("Firebase", "user_pseudo_id using appInstanceId is $user_pseudo_id")
/*
Store the value to your server or do something with the retrieved id
*/
}
}.start()
আপনার যদি একটি iOS অ্যাপ থাকে তবে আপনি সুইফটে নিম্নলিখিতগুলি ব্যবহার করতে পারেন
let user_pseudo_id = Analytics.appInstanceID()
print("user_pseudo_id = \(user_pseudo_id)")
/*
Store the value to your server or do something with the retrieved id
*/
আপনার অবকাঠামোর উপর নির্ভর করে নীচে আরও লিঙ্ক রয়েছে
3. কল নির্মাণ
আপনি GA4 এ ইভেন্ট বিল্ডার ব্যবহার করে একটি নমুনা কল তৈরি করতে পারেন। (এর জন্য আপনাকে লগইন করতে হবে এবং কুকিজ সক্ষম করতে হবে)। নিশ্চিত করুন যে টগলটি "ফায়ারবেস" এ সেট করা আছে
আপনাকে নিম্নলিখিত ক্ষেত্রগুলি পূরণ করতে হবে
- api_secret - GA4 এর আগে তৈরি করা হয়েছে
- firebase_app_id - এটি পেতে, আপনি অ্যাডমিন > ডেটা স্ট্রীম > আপনার স্ট্রিম বেছে নিতে পারেন। এটি নীচের মত প্রদর্শন করা উচিত
- app_instance_id - আপনি ইতিমধ্যে এই মান পুনরুদ্ধার করেছেন
- user_id বাধ্যতামূলক নয়। আপনি আপাতত এটি খালি রাখতে পারেন
- বিভাগ - ড্রপডাউন থেকে এটিকে "কাস্টম" এ পরিবর্তন করুন এবং আপনার পছন্দের যেকোনো ইভেন্টের নাম দিন (কোন স্বয়ংক্রিয় সংগৃহীত ইভেন্ট ব্যবহার করবেন না)। এখানে আমরা "test_from_codelab" ব্যবহার করছি
ঐচ্ছিকভাবে, আপনি নীচের বোতামগুলিতে ক্লিক করে ইভেন্ট প্যারামিটার এবং/অথবা ব্যবহারকারীর বৈশিষ্ট্যগুলি প্রদান করতেও বেছে নিতে পারেন
একবার আপনি সবকিছু পূরণ করে ফেললে, "ইভেন্ট যাচাই করুন" করার জন্য একটি বোতাম সহ আপনাকে এরকম কিছু দেখতে হবে
একবার আপনি এটিতে পৌঁছে গেলে, "VALIDATE EVENT" এ ক্লিক করুন, কমলা রঙে হাইলাইট করা বোতামটি। ইভেন্টটি বৈধ তা উল্লেখ করে এটি নীচের বার্তাটি প্রদর্শন করবে, এবং আপনি এখন "GA তে পাঠান" এ একটি বোতাম দেখতে পাবেন। এই মুহুর্তে, যদি ইভেন্টটি অবৈধ হিসাবে আসে, তাহলে টুলটি আপনাকে সঠিক ক্ষেত্রটি বলবে যেখানে একটি সমস্যা আছে এবং আপনি এটি ঠিক করে আবার চেষ্টা করতে পারেন
আপনি এখন বোতামটিতে ক্লিক করতে পারেন এবং এটি GA4 এ একটি পরীক্ষামূলক ইভেন্ট পাঠাতে হবে
4. GA4-এ ইভেন্টগুলি যাচাই করা
একবার আপনি ইভেন্টটি পাঠিয়ে দিলে, আপনি আপনার GA4 অ্যাকাউন্টে নেভিগেট করতে পারেন এবং রিয়েলটাইম চেক করতে পারেন। আপনি ঘটনা মাধ্যমে আসা দেখতে হবে
ইভেন্টগুলিকে রিয়েলটাইম ভিউ থেকে প্রকৃত ইভেন্ট রিপোর্টিং ট্যাবে প্রচার করতে প্রায় 24 ঘন্টা সময় লাগতে পারে, তাই আপনি যদি নিয়মিত ইভেন্ট রিপোর্টিং এ অবিলম্বে এটি দেখতে না পান তবে চিন্তা করার দরকার নেই!
আপনি যদি সমস্যা বা অসঙ্গতির সম্মুখীন হন, তাহলে পরিমাপ প্রোটোকলের পরিচিত সীমাবদ্ধতাগুলি এখানে পরীক্ষা করা কার্যকর হতে পারে
5. একটি পাইথন স্ক্রিপ্ট তৈরি করা
এখন আপনি এটি পরীক্ষা করে দেখেছেন, আপনি এপিআই কল পরীক্ষা করতে পারেন এবং পাইথনে (বা আপনার পছন্দের যেকোনো ভাষায়) একটি অনুরূপ আর্কিটেকচার তৈরি করতে ইভেন্ট পেলোডটি এই কল করতে পারে। তারপরে আপনি আপনার পছন্দসই ফ্রিকোয়েন্সিতে এটি নির্ধারণ করতে পারেন এবং এটি কার্যকর করতে পারেন। এই অংশের জন্য, আপনি হয় আপনার পছন্দের যেকোনো IDE ব্যবহার করতে পারেন যা পাইথনকে সমর্থন করে অথবা শুধুমাত্র একটি Google Colab নোটবুক ব্যবহার করতে পারেন যার জন্য আপনার ডিভাইসে কোনো ইনস্টলেশনের প্রয়োজন নেই
GA4 ইভেন্ট বিল্ডারকে উল্লেখ করে, আপনি দেখতে পাবেন যে শেষ পয়েন্টটি নীচের মত
POST /mp/collect?firebase_app_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
ইভেন্ট পেলোড নিম্নরূপ ছিল
{
"app_instance_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?firebase_app_id=XXXX&api_secret=XXXX"
payload = {
"app_instance_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 এ ইভেন্টটি রিয়েলটাইমে প্রতিফলিত দেখতে পাবেন।
6. অভিনন্দন
অভিনন্দন, আপনি সফলভাবে GA4 এ পরিমাপ প্রোটোকল ব্যবহার করেছেন। এখন আপনি Google Analytics-এ আরও অর্থপূর্ণ ডেটা পাঠাতে এবং আপনার বিপণন এবং ব্যবসায়িক বিশ্লেষণ উন্নত করতে শক্তিশালী সমাধান আর্কিটেকচার তৈরি করতে পারেন। এটির সর্বাধিক সুবিধা পাওয়ার জন্য, আমরা Google Ads-এর সাথে সংযোগ করার এবং রূপান্তর হিসাবে এই ইভেন্টগুলি আমদানি করার পরামর্শ দিই। আপনি এটি সম্পর্কে বিস্তারিত নির্দেশাবলীর জন্য এই কোডল্যাবে ধাপ 6 উল্লেখ করতে পারেন। রূপান্তর ট্র্যাকিংয়ের উদ্দেশ্যে, Google Ads শুধুমাত্র IDFA বা Firebase SDK থেকে গত 60 দিনের মধ্যে সংগৃহীত ডিভাইস আইডিগুলির সাথে সম্পর্কিত ডেটা দেখাবে। মনে রাখবেন যে এটি এখনও একটি আলফা API এবং এখানে তালিকাভুক্ত সীমাবদ্ধতার মধ্য দিয়ে যেতে ভুলবেন না যা সম্পূর্ণ লঞ্চের আগে সমাধান করা উচিত
আপনি শিখেছেন
- এমপি কল করার জন্য কীভাবে সঠিক ভেরিয়েবল সংগ্রহ করবেন
- পরীক্ষার ইভেন্টগুলি কীভাবে পাঠাবেন এবং যাচাই করবেন
- এমপি কল পাঠানোর জন্য কীভাবে একটি স্ক্রিপ্ট তৈরি করবেন