পরিমাপ প্রোটোকল ব্যবহার করে GA4 এ অ্যাপ ইভেন্ট পাঠান

1. ভূমিকা

শেষ আপডেট: ২০২১-০৬-০৮

তুমি কী তৈরি করবে

এই কোডল্যাবে, আপনি শিখবেন কিভাবে পরিমাপ প্রোটোকল ব্যবহার করে GA4 এ বহিরাগত ইভেন্ট পাঠাতে হয়।

এই কোডল্যাব ধরে নিচ্ছে যে আপনার কাছে ইতিমধ্যেই Google Analytics for Firebase ব্যবহার করে একটি অ্যাপ চালু করা আছে। আপনি যদি Firebase ব্যবহার করে Google Analytics ব্যবহার করে কীভাবে ইন্টিগ্রেট করবেন তা শিখতে চান, তাহলে প্রথমে এই কোডল্যাবটি দেখুন। আপনি যদি Firebase ব্যবহার করে অ্যাপ তৈরি করতে শিখতে চান, তাহলে Firebase Android Codelab-Build Friendly Chat দেখুন।

তুমি কি শিখবে

• আপনার প্রথম এমপি কল করার পদক্ষেপ
• কলের জন্য প্রয়োজনীয় প্যারামিটারগুলি বুঝুন
• আপনার পরীক্ষা কল পাঠান এবং যাচাই করুন
• কল করার জন্য পাইথনে একটি নমুনা স্ক্রিপ্ট তৈরি করুন

তোমার যা লাগবে

• আপনার অ্যান্ড্রয়েড বা আইওএস অ্যাপ
• পরিবর্তন করার জন্য যেকোনো IDE
• GA4 অ্যাকাউন্ট
• ঐচ্ছিক - পাইথন ডেভেলপমেন্ট এনভায়রনমেন্ট (অথবা Colab )

2. বাধ্যতামূলক ক্ষেত্রগুলি সংগ্রহ করুন

GA4 এ API সিক্রেট তৈরি করুন

GA4 এ নেভিগেট করুন এবং অ্যাডমিন > ডেটা স্ট্রিম > আপনার স্ট্রিম নির্বাচন করুন > পরিমাপ প্রোটোকল > তৈরি করুন -এ নেভিগেট করে আপনার নতুন API সিক্রেট তৈরি করুন।

আপনি যেকোনো ডাকনাম দিতে পারেন, এবং গোপন মানটি প্রদর্শিত হবে, যা আপনি আপনার কলে ব্যবহার করতে পারবেন।

যদি আপনি নিশ্চিত না হন যে GA4 কীভাবে অ্যাক্সেস করবেন, তাহলে আপনি আপনার Firebase Project-এ যেতে পারেন, Project Settings > Integrations > Google Analytics চেক করতে পারেন এবং "Manage"-এ ক্লিক করতে পারেন। Google Analytics সংযোগটি দৃশ্যমান হওয়া উচিত এবং আপনি সেখান থেকে সরাসরি নেভিগেট করতে পারেন।

app_instance_id সংগ্রহ করুন

আপনার app_instance_id সংগ্রহ করতে আপনি নীচের যেকোনো পদ্ধতি ব্যবহার করতে পারেন।

1. BigQuery এক্সপোর্ট ব্যবহার করা হচ্ছে
2. আপনার অ্যাপ সোর্স কোডে নেটিভলি আনা হচ্ছে

এই দুটি বিষয়ই নীচে বিস্তারিতভাবে ব্যাখ্যা করা হল

1. BigQuery এক্সপোর্ট ব্যবহার করা হচ্ছে

যদি আপনার BigQuery এক্সপোর্ট সক্ষম থাকে, তাহলে আপনি নীচের পদক্ষেপগুলি অনুসরণ করতে পারেন

• Firebase-এ সাইন ইন করুন
• প্রজেক্ট সেটিংস > ইন্টিগ্রেশন > বিগকুয়েরিতে নেভিগেট করুন।
• ডেটাসেটের কাছে "View in BigQuery" এ ক্লিক করুন।

দ্রষ্টব্য: টগলটি প্রায় ২৪-৪৮ ঘন্টা সক্রিয় থাকার পরেই ডেটাসেটটি উপলব্ধ হবে।

• BigQuery-তে, আপনি টেবিলে user_pseudo_id পরীক্ষা করতে পারেন। এটি হল app_instance_id যা আপনি আপনার কলে ব্যবহার করতে পারেন

2. আপনার অ্যাপ সোর্স কোডে নেটিভলি আনা হচ্ছে

যদি আপনার অ্যাপটি জাভা ব্যবহার করে তৈরি করা হয়, তাহলে আপনি 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();
            }
        }
    });

কোটলিনের জন্য, আপনি নীচেরটি চেষ্টা করতে পারেন

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 অ্যাপ থাকে, তাহলে আপনি Swift-এ নিম্নলিখিতগুলি ব্যবহার করতে পারেন

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
*/

আপনার পরিকাঠামোর উপর নির্ভর করে নীচে আরও লিঙ্ক দেওয়া হল

• অ্যান্ড্রয়েড - getAppInstanceId()
• সুইফট - অ্যাপইনস্ট্যান্সআইডি()
• অবজেক্টিভ-সি - অ্যাপইনস্ট্যান্সআইডি
• সি++ - গেটঅ্যানালিটিক্সইনস্ট্যান্সআইডি()
• ইউনিটি - GetAnalyticsInstanceIdAsync()

৩. কল তৈরি করা

আপনি GA4-তে ইভেন্ট বিল্ডার ব্যবহার করে একটি নমুনা কল তৈরি করতে পারেন। (এর জন্য আপনাকে লগইন করতে হবে এবং কুকিজ সক্রিয় করতে হবে)। নিশ্চিত করুন যে টগলটি "firebase" এ সেট করা আছে।

আপনাকে নিম্নলিখিত ক্ষেত্রগুলি পূরণ করতে হবে

• api_secret - GA4 তে ইতিমধ্যেই তৈরি করা হয়েছে।
• firebase_app_id - এটি পেতে, আপনি Admin > Data Streams > choose your stream এ যেতে পারেন। এটি নীচের মত প্রদর্শিত হওয়া উচিত।

• app_instance_id - আপনি ইতিমধ্যেই এই মানটি পুনরুদ্ধার করেছেন।
• user_id বাধ্যতামূলক নয়। আপনি আপাতত এটি খালি রাখতে পারেন।
• বিভাগ - ড্রপডাউন থেকে এটি "কাস্টম" এ পরিবর্তন করুন, এবং আপনার পছন্দের যেকোনো ইভেন্টের নাম দিন (কোনও স্বয়ংক্রিয়ভাবে সংগৃহীত ইভেন্ট ব্যবহার করবেন না)। এখানে আমরা "test_from_codelab" ব্যবহার করছি।

ঐচ্ছিকভাবে, আপনি নীচের বোতামগুলিতে ক্লিক করে ইভেন্ট প্যারামিটার এবং/অথবা ব্যবহারকারীর বৈশিষ্ট্য প্রদান করতে পারেন।

সবকিছু পূরণ করার পর, "Validate Event" বোতাম সহ আপনি এরকম কিছু দেখতে পাবেন।

একবার আপনি এই স্থানে পৌঁছানোর পর, "VALIDATE EVENT" এ ক্লিক করুন, কমলা রঙে হাইলাইট করা বোতামটি। এটি নীচের বার্তাটি প্রদর্শন করবে, যেখানে উল্লেখ করা হবে যে ইভেন্টটি বৈধ, এবং আপনি এখন "SAEND TO GA" লেখা একটি বোতাম দেখতে পাবেন। এই মুহুর্তে, যদি ইভেন্টটি অবৈধ হিসাবে আসে, তাহলে টুলটি আপনাকে সঠিক ক্ষেত্রটি বলবে যেখানে কোনও সমস্যা আছে, এবং আপনি এটি ঠিক করতে পারেন এবং পুনরায় চেষ্টা করতে পারেন।

আপনি এখন বোতামটিতে ক্লিক করতে পারেন, এবং এটি GA4-তে একটি পরীক্ষামূলক ইভেন্ট পাঠাবে।

৪. GA4-তে ইভেন্টগুলি যাচাই করা

ইভেন্টটি পাঠানোর পর, আপনি আপনার GA4 অ্যাকাউন্টে নেভিগেট করতে পারেন এবং রিয়েলটাইম পরীক্ষা করতে পারেন। আপনি ইভেন্টটি সম্পন্ন হতে দেখতে পাবেন।

ইভেন্টগুলি রিয়েলটাইম ভিউ থেকে আসল ইভেন্ট রিপোর্টিং ট্যাবে প্রচারিত হতে প্রায় ২৪ ঘন্টা সময় লাগতে পারে, তাই নিয়মিত ইভেন্ট রিপোর্টিংয়ে যদি আপনি এটি তাৎক্ষণিকভাবে না দেখেন তবে চিন্তা করার দরকার নেই!

যদি আপনি সমস্যা বা অসঙ্গতির সম্মুখীন হন, তাহলে এখানে পরিমাপ প্রোটোকলের জ্ঞাত সীমাবদ্ধতাগুলি পরীক্ষা করে দেখা কার্যকর হতে পারে।

৫. পাইথন স্ক্রিপ্ট তৈরি করা

এখন আপনি এটি পরীক্ষা করে দেখেছেন, আপনি API কল এবং ইভেন্ট পেলোড পরীক্ষা করে Python (অথবা আপনার পছন্দের যেকোনো ভাষায়) একই ধরণের আর্কিটেকচার তৈরি করতে পারেন যা এই কলটি করতে পারে। তারপর আপনি আপনার পছন্দসই ফ্রিকোয়েন্সিতে এটি নির্ধারণ করতে পারেন এবং এটি পরিচালনা করতে পারেন। এই অংশের জন্য, আপনি আপনার পছন্দের যেকোনো IDE ব্যবহার করতে পারেন যা Python সমর্থন করে অথবা শুধুমাত্র একটি 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 তে রিয়েলটাইমে ইভেন্টটি প্রতিফলিত হতে দেখবেন।

৬. অভিনন্দন

অভিনন্দন, আপনি GA4-তে সফলভাবে পরিমাপ প্রোটোকল ব্যবহার করেছেন। এখন আপনি Google Analytics-এ আরও অর্থপূর্ণ ডেটা পাঠানোর জন্য এবং আপনার মার্কেটিং এবং ব্যবসায়িক বিশ্লেষণ উন্নত করার জন্য শক্তিশালী সমাধান আর্কিটেকচার তৈরি করতে পারেন। এর সর্বাধিক সুবিধা অর্জনের জন্য, আমরা Google Ads-এর সাথে সংযোগ স্থাপন এবং এই ইভেন্টগুলিকে রূপান্তর হিসাবে আমদানি করার পরামর্শ দিচ্ছি। এই বিষয়ে বিস্তারিত নির্দেশাবলীর জন্য আপনি এই কোডল্যাবের ধাপ 6 দেখতে পারেন। রূপান্তর ট্র্যাকিংয়ের উদ্দেশ্যে, Google Ads শুধুমাত্র IDFA-এর সাথে সম্পর্কিত ডেটা বা গত 60 দিনের মধ্যে Firebase SDK থেকে সংগৃহীত ডিভাইস আইডি দেখাবে। মনে রাখবেন যে এটি এখনও একটি আলফা API এবং এখানে তালিকাভুক্ত সীমাবদ্ধতাগুলি অতিক্রম করতে ভুলবেন না যা সম্পূর্ণ লঞ্চের আগে সমাধান করা উচিত।

তুমি শিখেছো

• এমপি কল করার জন্য সঠিক ভেরিয়েবলগুলি কীভাবে সংগ্রহ করবেন
• পরীক্ষার ইভেন্টগুলি কীভাবে পাঠাবেন এবং যাচাই করবেন
• এমপি কল পাঠানোর জন্য কীভাবে একটি স্ক্রিপ্ট তৈরি করবেন