মোবাইল অ্যাপের জন্য সার্ভার-সাইড ট্যাগিং

আপনি Google ট্যাগ ম্যানেজারে সার্ভার-সাইড ট্যাগিংয়ের সাথে কাজ করার জন্য Firebase SDK-এর জন্য Google Analytics ব্যবহার করে আপনার মোবাইল অ্যাপগুলি কনফিগার করতে পারেন।

সার্ভার-সাইড ট্যাগিং আপনাকে Google Analytics এর মতো গন্তব্য পণ্যগুলিতে পাঠানোর আগে আপনার ডেটা স্টেজ, রিডাক্ট এবং বৃদ্ধি করতে দেয়। সার্ভার-সাইড ট্যাগিং সম্পর্কে আরও জানুন।

মোবাইল অ্যাপের জন্য সার্ভার-সাইড ট্যাগিং সেট আপ করতে:

1. সার্ভার-সাইড ট্যাগিংয়ের জন্য আপনার অ্যাপ প্রস্তুত করুন
2. মোবাইল ট্রাফিক সমর্থন করার জন্য আপনার সার্ভার কন্টেইনার কনফিগার করুন
3. আপনার GA4 প্রপার্টিতে সার্ভার-সাইড ট্যাগিং সক্ষম করুন

পূর্বশর্ত

• আপনাকে আপনার অ্যাপে Firebase SDK-এর জন্য Google Analytics অন্তর্ভুক্ত করতে হবে এবং এটিকে আপনার Google Analytics 4 প্রপার্টির সাথে সংযুক্ত করতে হবে। Firebase SDK-এর জন্য Google Analytics সম্পর্কে আরও জানুন।
• আপনার একটি Google ট্যাগ ম্যানেজার অ্যাকাউন্ট এবং একটি সার্ভার ধারক প্রয়োজন৷ আপনার যদি একটি না থাকে, একটি নতুন ট্যাগ ম্যানেজার অ্যাকাউন্ট এবং কন্টেইনার তৈরি করুন ।
• আপনাকে একটি ট্যাগিং সার্ভার সেট আপ করতে হবে।

ধাপ 1: সার্ভার-সাইড ট্যাগিংয়ের জন্য আপনার অ্যাপ প্রস্তুত করুন

iOS

1. সার্ভার-সাইড ট্যাগিং আপলোড বৈশিষ্ট্য সক্ষম করুন এবং Info.plist ফাইলে সার্ভার-সাইড ট্যাগিং ডিবাগ মোডের জন্য কাস্টম URL স্কিম সেট আপ করুন৷ অ্যাপের বান্ডেল শনাক্তকারী দিয়ে নিচের BUNDLE_ID টি প্রতিস্থাপন করুন।

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. ডিবাগ বা প্রিভিউ মোড সক্ষম করতে, লঞ্চ URL পাস করার জন্য একটি লাইফসাইকেল পদ্ধতিতে Analytics.handleOpen(_:) এ একটি কল যোগ করুন।

   সুইফটইউআই

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   যে অ্যাপগুলি SwiftUI বা UIScene ব্যবহার করে না, তাদের জন্য কোনো পদক্ষেপের প্রয়োজন নেই। SDK ApplicationDidFinishLaunchingNotification থেকে লঞ্চ URLটি পায়।

অ্যান্ড্রয়েড

1. Firebase SDK-এর জন্য Google Analytics-এর সাম্প্রতিক রিলিজ ইনস্টল করুন।

2. অ্যাপ্লিকেশনের AndroidManifest.xml ফাইলে নিম্নলিখিত যোগ করে sGTM সক্ষম করুন৷

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

ধাপ 2: মোবাইল ট্রাফিক সমর্থন করতে আপনার সার্ভার কন্টেইনার কনফিগার করুন

নিম্নলিখিত বিভাগটি ধরে নেয় যে আপনার একটি বিদ্যমান সার্ভার-সাইড ট্যাগিং স্থাপনা রয়েছে এবং আপনি এর ধারণার সাথে পরিচিত। আপনি যদি সার্ভার-সাইড ট্যাগিং-এ নতুন হন, আপনি সার্ভার-সাইড ট্যাগিং মৌলিক কোর্সটি নিতে পারেন।

Google Analytics সেট আপ করুন: GA4 (অ্যাপ) ক্লায়েন্ট

একটি ক্লায়েন্ট হল একটি ট্যাগ ম্যানেজার রিসোর্স টাইপ যা নির্দিষ্ট ধরনের ইনকামিং রিকোয়েস্টকে বাধা দেয় এবং ইভেন্ট তৈরি করে যা Google Analytics 4 এর মতো গন্তব্যে পাস করা যেতে পারে। এই ক্ষেত্রে, HTTP অনুরোধটি একটি Google Analytics 4 ইভেন্ট, তাই আপনাকে কনফিগার করতে হবে অন্তর্নির্মিত Google Analytics: GA4 (অ্যাপ) ক্লায়েন্ট। প্রতি ডেটা উৎস যেমন GA SDK এবং ওয়েবসাইটের জন্য আপনার শুধুমাত্র একটি GA4 ক্লায়েন্ট প্রয়োজন। ক্লায়েন্টরা কীভাবে কাজ করে সে সম্পর্কে আরও জানুন।

1. আপনার সার্ভার কন্টেইনারে, ক্লায়েন্টে যান এবং নতুন ক্লিক করুন।

2. ক্লায়েন্ট কনফিগারেশন ক্লিক করুন, তারপর Google Analytics নির্বাচন করুন: GA4 (অ্যাপ) ।

   

3. আপনার ক্লায়েন্টের জন্য একটি নাম লিখুন এবং সংরক্ষণ করুন ক্লিক করুন।

আপনার Google Analytics কনফিগার করুন: GA4 ট্যাগ

Google Analytics-এ ডেটা পাঠাতে, আপনাকে সার্ভার কন্টেইনারে একটি Google Analytics: GA4 ট্যাগ তৈরি করতে হবে। ক্লায়েন্ট ইনকামিং HTTP অনুরোধকে একটি ইভেন্ট ডেটা অবজেক্টে পার্স করে। ট্যাগটি এই ইভেন্ট ডেটা অবজেক্টটি নেবে, এটিকে সঠিক বিন্যাসে ম্যাপ করবে এবং তারপর এটি Google Analytics 4-এ পাঠাবে।

1. আপনার সার্ভার কন্টেইনারে, ট্যাগ- এ যান এবং নতুন ক্লিক করুন।

2. ট্যাগ কনফিগারেশন-এ ক্লিক করুন, তারপর Google Analytics বেছে নিন: GA4 ।

   

ডিফল্টরূপে, ট্যাগটি ক্লায়েন্ট দ্বারা তৈরি ইভেন্ট ডেটা অবজেক্ট থেকে সমস্ত প্রাসঙ্গিক ক্ষেত্র এবং পরামিতি উত্তরাধিকারী হবে:

• যদি ইনকামিং Google Analytics 4 অনুরোধ Google Analytics: GA4 (App) ক্লায়েন্টের মধ্য দিয়ে যায়, তাহলে ট্যাগটি অ্যাপ আইডি এবং ইভেন্ট প্যারামিটারের উত্তরাধিকারী হয়।
• যদি ইনকামিং Google Analytics 4 অনুরোধগুলি Google Analytics: GA4 (ওয়েব) ক্লায়েন্টের মধ্য দিয়ে যায়, তাহলে ট্যাগটি পরিমাপ আইডি এবং ইভেন্ট প্যারামিটারগুলিকে উত্তরাধিকারী করে।

টিপ: ট্যাগের সংস্পর্শে আসার আগে আপনি আপনার ক্লায়েন্ট থেকে ইভেন্ট প্যারামিটার আউটপুট অন্তর্ভুক্ত, বাদ দিতে বা সংশোধন করতে বিকল্পভাবে রূপান্তর ব্যবহার করতে পারেন। রূপান্তরের মাধ্যমে, আপনি সংবেদনশীল তথ্য রক্ষা করতে পারেন এবং পরবর্তী প্রক্রিয়াকরণের জন্য কোন ইভেন্ট প্যারামিটারগুলি উপলব্ধ রয়েছে তার উপর সূক্ষ্ম নিয়ন্ত্রণ রাখতে পারেন৷

মোবাইল ট্রাফিকের জন্য ট্রিগার সেট আপ করুন

তারপর GA4 ট্যাগ কখন ফায়ার হবে তা আপনার নির্ধারণ করা উচিত। গুগল অ্যানালিটিক্স: GA4 (অ্যাপ) ক্লায়েন্ট একটি ইভেন্ট ডেটা অবজেক্টে ইনকামিং অনুরোধকে পার্স করে এবং ট্যাগটি তার মানগুলিকে উত্তরাধিকার সূত্রে পাবে। অতএব, আপনি সাধারণত চাইবেন যে যখনই GA4 ক্লায়েন্ট অনুরোধটি দাবি করবে তখন ট্যাগটি ফায়ার হোক।

ট্রিগার সেট আপ করতে:

1. ট্যাগ সেটিংসে, ট্রিগারিং এ ক্লিক করুন।
2. একটি নতুন ট্রিগার তৈরি করতে, উপরের ডানদিকে কোণায় + আইকনে ক্লিক করুন।
3. ট্রিগার প্রকার নির্বাচন করতে ট্রিগার কনফিগারেশন ক্লিক করুন।

4. তালিকা থেকে কাস্টম বা কাস্টম ইভেন্ট নির্বাচন করুন।

   • কাস্টম ট্রিগার টাইপ, ডিফল্টরূপে, যখন কোনো ইভেন্ট সার্ভার-সাইড ক্লায়েন্ট দ্বারা তৈরি হয় তখন ট্যাগটি ফায়ার করে।
   • কাস্টম ইভেন্ট ট্রিগার প্রকারটি একটি নির্দিষ্ট ইভেন্টের নাম বা একটি ইভেন্ট যা একটি রেগুলার এক্সপ্রেশন প্যাটার্নের সাথে মেলে ট্যাগ ফায়ার করতে ব্যবহার করা যেতে পারে।

5. এই ট্রিগারের জন্য সক্রিয়করণ অবস্থার তালিকা সক্রিয় করতে যেমন শুধুমাত্র মোবাইল বা ওয়েব ইভেন্ট ডেটাতে ফায়ার করার জন্য, কিছু ইভেন্ট নির্বাচন করুন।

   1. আপনি ইভেন্টের নাম প্রাক-নির্বাচিত দেখতে পাবেন। সেই নির্বাচককে ক্লিক করুন এবং তালিকা থেকে বিল্ট-ইন ভেরিয়েবল নির্বাচন করুন।
   2. স্বয়ংক্রিয়ভাবে ইভেন্ট তৈরি করা ক্লায়েন্টের নাম ফেরত দিতে, ক্লায়েন্টের নাম নির্বাচন করুন।

   3. সেই অনুযায়ী শর্ত সেট করতে আপনি আগে কনফিগার করা ক্লায়েন্টের নাম ব্যবহার করুন। আপনার ট্রিগার এই মত দেখতে হবে:

      

      দ্রষ্টব্য: ক্লায়েন্টের নাম যা আপনি পূর্ববর্তী ধাপে উল্লেখ করেছেন। ক্লায়েন্টের ধরন হল Google Analytics: GA4 (App)। ক্লায়েন্ট নেম ভেরিয়েবল ক্লায়েন্টের প্রকারের নাম নয়।

6. ট্রিগার সংরক্ষণ করুন এবং একটি বর্ণনামূলক নাম লিখুন। উদাহরণস্বরূপ, আপনি "সমস্ত GA4 অ্যাপ ইভেন্ট" ব্যবহার করতে পারেন।

7. নতুন ট্রিগারের জায়গায় আপনার এখন ট্যাগ সেটিংসে ফিরে আসা উচিত। ট্যাগটি সংরক্ষণ করুন এবং একটি বর্ণনামূলক নাম লিখুন, উদাহরণস্বরূপ "GA4।" আপনার ট্যাগ এই মত হওয়া উচিত:

   

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

আপনার ধারক পূর্বরূপ

পরিবর্তনগুলি প্রকাশ করার আগে আপনি আপনার সার্ভার ধারকটির পূর্বরূপ দেখতে এবং ডিবাগ করতে Google ট্যাগ ম্যানেজার ব্যবহার করতে পারেন৷ মনে রাখবেন যে আপনি আপনার GA4 প্রপার্টিতে সার্ভার-সাইড ট্যাগিং সক্ষম না করা পর্যন্ত প্রিভিউ কাজ করবে না।

আপনার অ্যাপ্লিকেশন অনুরোধগুলি পূর্বরূপ কনফিগারেশন ট্রিগার করতে, আপনাকে করতে হবে:

1. আপনার Google ট্যাগ ম্যানেজার সার্ভার কন্টেনারে থাকাকালীন পূর্বরূপ নির্বাচন করুন।
2. উপরের ডানদিকে আরও অ্যাকশন আইকনে ক্লিক করুন ⋮ এবং একটি অ্যাপ থেকে অনুরোধ পাঠান নির্বাচন করুন।

3. আপনার অ্যাপ আইডি লিখুন এবং QR কোড জেনারেট করুন ক্লিক করুন।

   

4. আপনার ফোনের ক্যামেরা অ্যাপ দিয়ে QR কোড স্ক্যান করুন। আপনার অ্যাপের সাথে ইন্টারঅ্যাক্ট করতে এগিয়ে যান যেমন আপনি সাধারণত পূর্বরূপ ইভেন্ট তৈরি করতে চান।

5. ডায়ালগ বন্ধ করতে ওকে ক্লিক করুন।

আপনার ধারক প্রকাশ করুন

আপনি আপনার পরিবর্তনগুলি যাচাই করার পরে, সমস্ত ট্র্যাফিকের জন্য সেই পরিবর্তনগুলিকে লাইভ করতে কন্টেইনারটি প্রকাশ করুন৷ প্রকাশনা, সংস্করণ এবং অনুমোদন সম্পর্কে আরও জানুন।

ধাপ 3: আপনার GA4 প্রপার্টিতে সার্ভার-সাইড ট্যাগিং সক্ষম করুন

1. আপনার Google Analytics 4 প্রপার্টিতে অ্যাডমিনে যান।
2. ডাটা স্ট্রীম খুলুন।

3. iOS বা Android ট্যাব থেকে আপনার অ্যাপ্লিকেশনের স্ট্রিম কনফিগারেশন নির্বাচন করুন।

   

4. SDK সেটিংস কনফিগার করুন , তারপর সার্ভার-সাইড ট্যাগ ম্যানেজার কনফিগার করুন ক্লিক করুন।

   

5. সার্ভার কন্টেইনার URL-এ পরিমাপ ডেটা পাঠাতে SDK সক্ষম করতে:

   1. একটি সার্ভার-সাইড ট্যাগ ম্যানেজার কন্টেইনারে ডেটা পাঠান টগল করুন।
   2. সার্ভার কন্টেইনার URL কপি করুন. আপনি অ্যাডমিন > কনটেইনার সেটিংস > সার্ভার কন্টেইনার URL- এ গিয়ে আপনার Google ট্যাগ ম্যানেজারে এটি খুঁজে পেতে পারেন।

   3. আপনি সার্ভার কন্টেইনারে রুট করতে চান এমন ট্র্যাফিকের শতাংশ নির্বাচন করুন। আপনার সমস্ত ট্র্যাফিকের জন্য সার্ভার-সাইড ট্যাগিং ব্যবহার করার আগে আপনার সার্ভার সেটআপ এবং কনফিগারেশন যাচাই করতে আপনি 100% এর নিচে একটি বিকল্প বেছে নিতে পারেন।

      দ্রষ্টব্য: আপনার সার্ভারে ডেটা পাঠানোর জন্য প্রিভিউ মোড ব্যবহার করে খোলা শুধুমাত্র অ্যাপগুলিকে সক্ষম করতে শুধুমাত্র ডিবাগ ডিভাইস বিকল্প ব্যবহার করুন।

   

6. Save এ ক্লিক করুন। SDK আপডেট করা সার্ভার কন্টেইনার URL এবং সরাসরি পরিমাপ ডেটা পুনরুদ্ধার করবে।

পরিচিত সীমাবদ্ধতা

• অ্যান্ড্রয়েড অ্যাপ্লিকেশনের জন্য:

  • সার্ভার কন্টেনার এবং Google Play পরিষেবার সাথে জড়িত সম্ভাব্য নিরাপত্তা দুর্বলতা এড়াতে, ইভেন্টগুলি SDK এবং আপনার সার্ভার কন্টেইনারের মধ্যে একটি রাষ্ট্রহীন প্রক্সি সার্ভারের মাধ্যমে যাবে৷ এই প্রক্সি অনুরোধের উত্স এবং শেষ পয়েন্ট যাচাই করবে, কিন্তু এটি ইভেন্টগুলি সম্পর্কে কোনও ডেটা পরিদর্শন বা সংরক্ষণ করবে না। GA4 কীভাবে EU-ভিত্তিক ডিভাইসগুলি থেকে ডেটা সংগ্রহ করে তার সাথে সামঞ্জস্যপূর্ণ, প্রক্সিটি EU-ভিত্তিক ট্রাফিকের জন্য EU-তে থাকবে।
  • স্বয়ংক্রিয়ভাবে লগ ইন-অ্যাপ কেনাকাটাগুলি Google Play ব্যাকএন্ডের সাথে একীকরণের উপর নির্ভর করে এবং সার্ভার কন্টেইনারে পাঠানো হবে না।
  • app_remove ইভেন্ট অ্যান্ড্রয়েডে রিপোর্ট করা হবে না।

• আপনার SDK ডেটা এবং রূপান্তরগুলি Google Ads-এ আমদানি করা হয়েছে তা নিশ্চিত করার জন্য Google Analytics-এ আপনার অ্যাপ ডেটা স্ট্রিমগুলিকে আপনার Google Ads অ্যাকাউন্টের সাথে সংযুক্ত করা এখনও প্রয়োজনীয়। সার্ভার-সাইড ট্যাগিং আপনার SDK এবং Google বিজ্ঞাপনের মধ্যে কোনো অন্তর্নিহিত ইন্টিগ্রেশন অফার করে না।

API

আপনি ট্যাগ ম্যানেজার কনফিগারেশন ডেটা অ্যাক্সেস করতে ট্যাগ ম্যানেজার REST API ব্যবহার করতে পারেন। API সম্পর্কে আরও তথ্যের জন্য:

• API এর সাথে কীভাবে কাজ করবেন তা শিখতে বিকাশকারীর নির্দেশিকা পড়ুন।
• ট্যাগ ম্যানেজার রিসোর্স এবং উপলব্ধ ক্রিয়াকলাপগুলির সাথে নিজেকে পরিচিত করতে ট্যাগ ম্যানেজার API রেফারেন্স পর্যালোচনা করুন৷