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

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

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

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

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

পূর্বশর্ত

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

আইওএস

  1. Info.plist ফাইলে সার্ভার-সাইড ট্যাগিং আপলোড ফিচারটি সক্রিয় করুন এবং সার্ভার-সাইড ট্যাগিং ডিবাগ মোডের জন্য কাস্টম ইউআরএল স্কিম সেট আপ করুন। নিম্নলিখিত ক্ষেত্রে 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. ডিবাগ বা প্রিভিউ মোড চালু করতে, একটি লাইফসাইকেল মেথডে Analytics.handleOpen(_:) কলটি যোগ করে লঞ্চ URL-টি পাস করুন।

    SwiftUI 

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

    ইউআইসিন 

    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. Google Analytics for Firebase SDK-এর সর্বশেষ সংস্করণটি ইনস্টল করুন।

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

ধাপ ২: মোবাইল ট্র্যাফিক সমর্থন করার জন্য আপনার সার্ভার কন্টেইনারটি কনফিগার করুন।

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

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

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

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

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

    ট্যাগ ম্যানেজারে Google Analytics: GA4 (অ্যাপ) ক্লায়েন্ট বিকল্প দেখানো ছবি।

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

আপনার গুগল অ্যানালিটিক্স: GA4 ট্যাগ কনফিগার করুন

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

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

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

    ট্যাগ ম্যানেজারে Google Analytics: GA4 ট্যাগ সেটিংস দেখানো ছবি।

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

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

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

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

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

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

  4. তালিকা থেকে কাস্টম অথবা কাস্টম ইভেন্ট বেছে নিন।

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

  5. এই ট্রিগারের জন্য অ্যাক্টিভেশন শর্তাবলীর তালিকা সক্রিয় করতে, যেমন এটিকে শুধুমাত্র মোবাইল বা ওয়েব ইভেন্টের ডেটার উপর ভিত্তি করে ফায়ার করার জন্য, ‘কিছু ইভেন্ট’ (Some Events) নির্বাচন করুন।

    1. আপনি দেখবেন ইভেন্টের নাম আগে থেকেই নির্বাচিত করা আছে। সেই সিলেক্টরে ক্লিক করুন এবং তালিকা থেকে ‘Choose Built-In Variable’ নির্বাচন করুন।
    2. যে ক্লায়েন্ট ইভেন্টটি তৈরি করেছে তার নাম স্বয়ংক্রিয়ভাবে পেতে, ‘ক্লায়েন্টের নাম’ নির্বাচন করুন।

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

      ট্যাগ ম্যানেজারে ট্রিগার তৈরি করার পর ট্রিগার কনফিগারেশন স্ক্রিনের ছবি।

  6. ট্রিগারটি সংরক্ষণ করুন এবং একটি বর্ণনামূলক নাম দিন। উদাহরণস্বরূপ, আপনি 'All GA4 App Events' ব্যবহার করতে পারেন।

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

    ট্রিগার সেট করার পর GA4 ট্যাগটির ছবি।

আপনার কন্টেইনারের প্রিভিউ দেখুন

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

আপনার অ্যাপ অনুরোধগুলির মাধ্যমে প্রিভিউ কনফিগারেশন চালু করতে হলে, আপনাকে যা করতে হবে তা হলো:

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

  3. আপনার অ্যাপ আইডি প্রবেশ করান এবং 'Generate QR Code'-এ ক্লিক করুন।

    'Generate QR Code'-এ ক্লিক করলে একটি QR কোড দেখানো ছবি।

  4. আপনার ফোনের ক্যামেরা অ্যাপ দিয়ে কিউআর কোডটি স্ক্যান করুন। প্রিভিউ ইভেন্ট তৈরি করতে স্বাভাবিকভাবে আপনার অ্যাপটি ব্যবহার করুন।

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

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

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

ধাপ ৩: আপনার GA4 প্রপার্টিতে সার্ভার-সাইড ট্যাগিং সক্রিয় করুন।

  1. আপনার Google Analytics 4 প্রপার্টিতে, Admin- এ যান।
  2. উন্মুক্ত ডেটা প্রবাহ ।

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

    GA4-এ ডেটা স্ট্রিম পৃষ্ঠাটি দেখানো ছবি।

  4. Configure SDK settings-এ ক্লিক করুন, তারপর Configure server-side Tag Manager-এ ক্লিক করুন।

    GA4-এ সার্ভার-সাইড ট্যাগ ম্যানেজার কনফিগার করার বিকল্পটি দেখানো ছবি।

  5. সার্ভার কন্টেইনার ইউআরএল-এ পরিমাপের ডেটা পাঠানোর জন্য SDK সক্ষম করতে:

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

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

    GA4-এর কনফিগারেশন পৃষ্ঠার ছবি

  6. সেভ-এ ক্লিক করুন। এসডিকে আপডেট করা সার্ভার কন্টেইনার ইউআরএল সংগ্রহ করবে এবং পরিমাপের ডেটা সেখানে পাঠিয়ে দেবে।

জ্ঞাত সীমাবদ্ধতা

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

    • স্বয়ংক্রিয়ভাবে লগ-ইন করা ইন-অ্যাপ কেনাকাটা গুগল প্লে ব্যাকএন্ডের সাথে ইন্টিগ্রেশনের উপর নির্ভর করে এবং সার্ভার কন্টেইনারে পাঠানো হবে না।
    • অ্যান্ড্রয়েডে app_remove ইভেন্টটি রিপোর্ট করা হবে না।

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

এপিআই

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