অ্যান্ড্রয়েডের জন্য গুগল ট্যাগ ম্যানেজার

একজন ডেভেলপার হিসেবে, আপনি অ্যাপ মার্কেটপ্লেসে অ্যাপ্লিকেশন বাইনারিগুলো নতুন করে তৈরি ও পুনরায় জমা না দিয়েই, আপনার মোবাইল অ্যাপ্লিকেশনগুলোতে মেজারমেন্ট ট্যাগ এবং পিক্সেল প্রয়োগ ও পরিচালনা করতে গুগল ট্যাগ ম্যানেজার ব্যবহার করতে পারেন। যে ডেভেলপাররা গুগল অ্যানালিটিক্স ফর ফায়ারবেস এসডিকে (Google Analytics for Firebase SDK) নিয়ে কাজ করেন, তারা অ্যাপটি প্রকাশের পরেও এর প্রয়োগ পরিচালনা ও পরিবর্তন করার জন্য সহজেই ট্যাগ ম্যানেজার যুক্ত করতে পারেন।

ডেভেলপাররা গুরুত্বপূর্ণ ইভেন্টগুলো লগ করতে পারেন এবং পরে সিদ্ধান্ত নিতে পারেন কোন ট্যাগ বা পিক্সেলগুলো ফায়ার করা হবে।

পূর্বশর্ত

শুরু করার আগে:

• ফায়ারবেস কনসোলে , আপনার অ্যাপটিকে ফায়ারবেস প্রজেক্টে যুক্ত করুন।
• আপনার অ্যাপের জন্য গুগল অ্যানালিটিক্স সেট আপ করুন , যার মধ্যে রয়েছে আপনার ফায়ারবেস প্রজেক্টে গুগল অ্যানালিটিক্স সক্রিয় করা এবং আপনার অ্যাপে গুগল অ্যানালিটিক্স ফর ফায়ারবেস এসডিকে (SDK) যোগ করা।
• একটি ট্যাগ ম্যানেজার অ্যাকাউন্ট তৈরি করুন ।
• একটি গুগল ট্যাগ ম্যানেজার কন্টেইনার কনফিগার করুন ।

নিম্নলিখিত বিভাগগুলিতে আপনার অ্যান্ড্রয়েড অ্যাপ্লিকেশনে গুগল ট্যাগ ম্যানেজার কনফিগার এবং ব্যবহার করার ধাপগুলি বর্ণনা করা হয়েছে।

১. আপনার প্রজেক্টে গুগল ট্যাগ ম্যানেজার যোগ করুন

1. আপনার মডিউলের Gradle ফাইলে (সাধারণত app/build.gradle ), Tag Manager লাইব্রেরির উপর নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন:

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.3.0'
   }
   

2. আপনার ট্যাগ ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

3. একটি বহনযোগ্য কন্টেইনার নির্বাচন করুন।

4. উপরের নেভিগেশন বারে থাকা ভার্সন- এ ক্লিক করুন।

5. আপনি যে কন্টেইনার সংস্করণটি ব্যবহার করতে চান, সেটিতে ক্লিক করুন।

6. ডাউনলোড-এ ক্লিক করুন।

7. app/src/main/assets/containers ফোল্ডারটি না থাকলে তৈরি করুন। ডাউনলোড করা কন্টেইনারটি ফোল্ডারটিতে কপি করুন।

২. ইভেন্ট এবং ভেরিয়েবল লগ করুন

ট্যাগ ম্যানেজার, গুগল ট্যাগ ম্যানেজারে আপনার কনফিগার করা ট্যাগগুলোকে ট্রিগার করতে ও তৈরি করতে, গুগল অ্যানালিটিক্স ফর ফায়ারবেস এসডিকে দ্বারা লগ করা ইভেন্ট, প্যারামিটার এবং ইউজার প্রপার্টি ব্যবহার করে।

ইভেন্ট লগ করা এবং ব্যবহারকারীর প্রোপার্টি সেট করার নির্দেশাবলীর জন্য Firebase ডেভেলপার ডকুমেন্টেশন পড়ুন।

ট্যাগ ম্যানেজারে ভেরিয়েবল কনফিগার করুন

গুগল ট্যাগ ম্যানেজারে ব্যবহারের জন্য ইভেন্ট প্যারামিটার এবং ইউজার প্রপার্টির মান সংগ্রহ করতে, আপনি ট্যাগ ম্যানেজার ইন্টারফেসে ভেরিয়েবল কনফিগার করতে পারেন।

উদাহরণস্বরূপ, আপনি আপনার অ্যাপে নিম্নলিখিত কাস্টম ইভেন্টটি লগ করতে পারেন:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

তারপর, image_name এবং full_text parameter মানগুলো গ্রহণ করার জন্য আপনি ট্যাগ ম্যানেজারে নিম্নলিখিতভাবে নতুন ইভেন্ট প্যারামিটার ভেরিয়েবল কনফিগার করতে পারেন:

• ভেরিয়েবলের নাম : ছবির নাম
• ভেরিয়েবল টাইপ : ইভেন্ট প্যারামিটার
• ইভেন্ট প্যারামিটার কী-এর নাম : image_name

এবং:

• ভেরিয়েবলের নাম : সম্পূর্ণ লেখা
• ভেরিয়েবল টাইপ : ইভেন্ট প্যারামিটার
• ইভেন্ট প্যারামিটার কী-এর নাম : full_text

একইভাবে, আপনি আপনার অ্যাপে নিম্নলিখিত ইউজার প্রপার্টিটি সেট করতে পারেন:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

তারপর, favorite_food ভ্যালুটি ক্যাপচার করার জন্য আপনি Google Tag Manager-এ একটি নতুন Firebase User Property ভ্যারিয়েবল কনফিগার করতে পারেন:

• ভেরিয়েবলের নাম : প্রিয় খাবার
• ভেরিয়েবল টাইপ : ফায়ারবেস ব্যবহারকারীর প্রপার্টি
• ইভেন্ট প্যারামিটার কী-এর নাম : favorite_food

ইভেন্টগুলি পরিবর্তন এবং ব্লক করুন

ট্যাগ ম্যানেজার আপনাকে Google Analytics for Firebase SDK দ্বারা ইভেন্টগুলি লগ হওয়ার আগে সেগুলিকে পরিবর্তন এবং ব্লক করার সুবিধা দেয়। ইভেন্ট পরিবর্তন করার মাধ্যমে আপনি অ্যাপ আপডেট ছাড়াই ইভেন্ট প্যারামিটারের মান যোগ, অপসারণ বা পরিবর্তন করতে পারেন অথবা ইভেন্টের নাম সামঞ্জস্য করতে পারেন। যে ইভেন্টগুলি ব্লক করা হয় না, সেগুলি Google Analytics for Firebase SDK দ্বারা লগ করা হবে।

Google Analytics for Firebase SDK স্বয়ংক্রিয়ভাবে কিছু ইভেন্ট এবং ব্যবহারকারীর প্রোপার্টিও লগ করে। আপনি কোনো কোড যোগ না করেই ট্যাগ ম্যানেজারে স্বয়ংক্রিয়ভাবে সংগৃহীত ইভেন্ট এবং প্রোপার্টিগুলো ব্যবহার করতে পারেন। তবে, আপনি এগুলো ব্লক করতে পারবেন না।

৩. ইভেন্ট পাঠান

ফায়ারবেস ইভেন্টের নাম ভেরিয়েবল, ফায়ারবেস ইভেন্টের প্যারামিটার ভেরিয়েবল এবং অন্যান্য ভেরিয়েবল ট্রিগার সেট আপ করতে ব্যবহৃত হয়। যখনই আপনি একটি ফায়ারবেস ইভেন্ট লগ করেন, ট্রিগারের শর্তগুলো মূল্যায়ন করা হয়। ডিফল্টরূপে, গুগল অ্যানালিটিক্স ফর ফায়ারবেস ইভেন্টগুলো স্বয়ংক্রিয়ভাবে চালু হয়। গুগল অ্যানালিটিক্সে ইভেন্ট পাঠানো ব্লক করার জন্য ট্যাগ ম্যানেজারে একটি গুগল অ্যানালিটিক্স ফর ফায়ারবেস ট্যাগ যোগ করা সম্ভব।

৪. আপনার কন্টেইনারটি প্রিভিউ, ডিবাগ এবং পাবলিশ করুন।

আপনার কন্টেইনারের কোনো সংস্করণ প্রকাশ করার আগে, এটি উদ্দেশ্য অনুযায়ী কাজ করছে কিনা তা নিশ্চিত করতে আপনি এটি প্রিভিউ করে দেখতে চাইবেন। গুগল ট্যাগ ম্যানেজার আপনাকে ওয়েব ইন্টারফেসে লিঙ্ক এবং কিউআর কোড তৈরি করে এবং সেগুলি ব্যবহার করে আপনার অ্যাপ্লিকেশনটি খোলার মাধ্যমে আপনার কন্টেইনারের সংস্করণগুলি প্রিভিউ করার সুযোগ দেয়। এছাড়াও, যেকোনো অপ্রত্যাশিত আচরণ ডিবাগ করার জন্য আপনি একটি ভার্বোস লগিং মোড চালু করতে পারেন।

প্রিভিউ কন্টেইনার

কোনো কন্টেইনার প্রিভিউ করার আগে, গুগল ট্যাগ ম্যানেজার ওয়েব ইন্টারফেসে আপনি যে কন্টেইনারটির ভার্সন প্রিভিউ করতে চান সেটি নির্বাচন করে এবং তারপর 'Preview ' সিলেক্ট করে একটি প্রিভিউ ইউআরএল তৈরি করুন। পরবর্তী ধাপগুলোর জন্য এই প্রিভিউ ইউআরএলটি সংরক্ষণ করুন।

চিত্র ১: ট্যাগ ম্যানেজার ওয়েব ইন্টারফেস থেকে একটি প্রিভিউ ইউআরএল নিন।

আপনার কন্টেইনারের প্রিভিউ দেখতে (যদি আপনি অ্যান্ড্রয়েড স্টুডিও ব্যবহার করেন, তবে সরাসরি ধাপ ৩-এ চলে যান):

1. আপনার AndroidManifest ফাইলে এই প্রিভিউ অ্যাক্টিভিটিটি যোগ করুন:

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. আপনার অ্যাপ্লিকেশনের প্যাকেজ নামটি অন্তর্ভুক্ত করতে এই লাইনটি পরিবর্তন করুন:

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. গুগল ট্যাগ ম্যানেজার ওয়েব ইন্টারফেসে, একটি প্রিভিউ লিঙ্ক তৈরি করুন:

   1. আপনার ট্যাগ ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।
   2. একটি বহনযোগ্য কন্টেইনার নির্বাচন করুন।
   3. উপরের নেভিগেশন বারে থাকা ভার্সন- এ ক্লিক করুন।
   4. আপনি যে কন্টেইনার সংস্করণটি প্রিভিউ করতে চান, সেটির উপর অ্যাকশন > প্রিভিউ-তে ক্লিক করুন।
   5. আপনার অ্যাপ্লিকেশনের প্যাকেজ নামটি লিখুন।
   6. প্রিভিউ লিঙ্ক শুরু করতে জেনারেট-এ ক্লিক করুন।

4. আপনার অ্যাপ্লিকেশনটি বন্ধ করুন এবং তৈরি হওয়া প্রিভিউ লিঙ্ক বা কিউআর কোড ব্যবহার করে এটি চালু করুন।

5. ওয়েব ইন্টারফেসে থাকা 'Generate end preview link' অপশন থেকে তৈরি হওয়া লিঙ্কে ক্লিক করে আপনি প্রিভিউ মোড থেকে বেরিয়ে আসতে পারেন।

ডিবাগ কন্টেইনার

আপনার কন্টেইনার বাস্তবায়নের সমস্যা সমাধান করতে, বিশদ লগিং চালু করুন:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

প্রকাশ কন্টেইনার

আপনার কন্টেইনারটি প্রিভিউ করে এবং এটি ঠিকমতো কাজ করছে কিনা তা যাচাই করার পর, আপনি এটি পাবলিশ করতে পারেন। আপনার কন্টেইনারটি পাবলিশ করার পর, আপনার ট্যাগ কনফিগারেশনগুলো মোবাইল অ্যাপ ব্যবহারকারীদের জন্য উপলব্ধ হয়ে যাবে।

দ্রষ্টব্য: মোবাইল কন্টেইনারের ক্ষেত্রে, প্রথমবার কোনো কন্টেইনার ডাউনলোড না করা পর্যন্ত প্রাথমিক ট্যাগ কনফিগারেশন সেট করার জন্য একটি ডিফল্ট কন্টেইনার ব্যবহৃত হয়। একবার অ্যাপটি ইন্টারনেটের সাথে সংযুক্ত হয়ে একটি কন্টেইনার ডাউনলোড করে ফেললে, এটি আর কখনও ডিফল্ট কন্টেইনারটি ব্যবহার করবে না। অ্যাপ্লিকেশনগুলো পর্যায়ক্রমে কন্টেইনার আপডেটের জন্য পরীক্ষা করে, সাধারণত প্রতি ১২ ঘণ্টা পর পর।

পরবর্তী পদক্ষেপ

উন্নত কনফিগারেশন পড়ুন।