প্রচারাভিযান পরিমাপ - Android SDK

এই দস্তাবেজটি Android v3 এর জন্য Google Analytics SDK দিয়ে প্রচারাভিযান এবং ট্রাফিক উত্সগুলি কীভাবে পরিমাপ করতে হয় তার একটি ওভারভিউ প্রদান করে৷

ওভারভিউ

গুগল অ্যানালিটিক্সে প্রচারাভিযান পরিমাপ আপনার অ্যাপ্লিকেশনের মধ্যে ব্যবহারকারীর কার্যকলাপে প্রচারাভিযান এবং ট্র্যাফিক উত্সের অ্যাট্রিবিউশন সক্ষম করে৷ এই বিকল্পগুলি Android এর জন্য Google Analytics SDK-এ প্রচারাভিযান এবং ট্র্যাফিক সোর্স অ্যাট্রিবিউশনের জন্য উপলব্ধ:

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

নিম্নলিখিত বিভাগগুলি কখন এবং কীভাবে আপনার অ্যাপে প্রতিটি ধরণের প্রচারাভিযানের পরিমাপ প্রয়োগ করতে হবে তা বর্ণনা করবে।

প্রচারাভিযানের পরামিতি

প্রচারাভিযানের পরামিতিগুলি ট্রাফিক উত্স এবং প্রচারাভিযানগুলি সম্পর্কে তথ্য পাস করতে ব্যবহৃত হয় যা ব্যবহারকারীদের আপনার অ্যাপে নিয়ে আসছে৷

নীচের সারণীতে উপলব্ধ প্রচারাভিযানের পরামিতি রয়েছে যা Google Play বা সাধারণ প্রচারাভিযানের পরিমাপে ব্যবহার করা যেতে পারে:

প্যারামিটার	বর্ণনা	উদাহরণ(গুলি)
`utm_campaign`	প্রচারাভিযান নাম; একটি নির্দিষ্ট পণ্য প্রচার বা কৌশলগত প্রচারাভিযান সনাক্ত করতে কীওয়ার্ড বিশ্লেষণের জন্য ব্যবহৃত হয়	`utm_campaign=spring_sale`
`utm_source`	প্রচারের উৎস; একটি সার্চ ইঞ্জিন, নিউজলেটার, বা অন্য উৎস সনাক্ত করতে ব্যবহৃত হয়	`utm_source=google`
`utm_medium`	প্রচারের মাধ্যম; একটি মাধ্যম সনাক্ত করতে ব্যবহৃত হয় যেমন ইমেল বা প্রতি-ক্লিক খরচ (cpc)	`utm_medium=cpc`
`utm_term`	প্রচারের মেয়াদ; বিজ্ঞাপনের জন্য কীওয়ার্ড সরবরাহ করতে অর্থপ্রদানের অনুসন্ধানের সাথে ব্যবহৃত হয়	`utm_term=running+shoes`
`utm_content`	প্রচারের বিষয়বস্তু; A/B পরীক্ষা এবং বিষয়বস্তু-লক্ষ্যযুক্ত বিজ্ঞাপনের জন্য ব্যবহৃত বিজ্ঞাপন বা লিঙ্কগুলিকে আলাদা করতে যা একই URL-এ নির্দেশ করে	`utm_content=logolink` `utm_content=textlink`
`gclid`	Google Ads অটোট্যাগিং প্যারামিটার ; বিজ্ঞাপন পরিমাপ করতে ব্যবহৃত। এই মানটি গতিশীলভাবে তৈরি হয় এবং কখনই সংশোধন করা উচিত নয়।

সাধারণ প্রচারাভিযান এবং ট্রাফিক সোর্স অ্যাট্রিবিউশন

একটি অ্যাপ ইনস্টল করার পরে, এটি বিজ্ঞাপন প্রচারাভিযান, ওয়েবসাইট বা অন্যান্য অ্যাপ থেকে রেফারেল দ্বারা চালু করা যেতে পারে। এই পরিস্থিতিতে, সরাসরি একটি ট্র্যাকারে প্রচারাভিযান ক্ষেত্রগুলি সেট করে পরবর্তী সেশনে ব্যবহারকারীর কার্যকলাপের জন্য ট্র্যাফিক উত্স বা বিপণন প্রচারাভিযানের উল্লেখ করা যেতে পারে।

উদাহরণ স্বরূপ, Google Analytics প্রচারাভিযানের পরামিতিগুলির জন্য অ্যাপটি চালু করার অভিপ্রায়কে নিম্নলিখিত বাস্তবায়নটি পরীক্ষা করে:

package com.example.app;

import com.google.analytics.tracking.android.Fields;
import com.google.analytics.tracking.android.GoogleAnalytics;
import com.google.analytics.tracking.android.MapBuilder;
import com.google.analytics.tracking.android.Tracker;

import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;

import java.util.Map;

/*
 * An example of how to implement general campaign attribution in Android.
 *
 * If the intent that launched the Activity has a URI, parse it for campaign
 * parameters and send the referring data to Google Analytics.
 */
public class MainActivity extends Activity {

  private static final String GA_PROPERTY_ID = "UA-XXXX-Y";
  private static final String SCREEN_LABEL = "Home Screen";

  // This examples assumes the use of Google Analytics campaign
  // "utm" parameters, like "utm_source".
  private static final String CAMPAIGN_SOURCE_PARAM = "utm_source";

  Tracker mTracker;

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    mTracker = GoogleAnalytics.getInstance(this).getTracker(GA_PROPERTY_ID);
  }

  @Override
  public void onStart() {
    super.onStart();

    // Set screen name on tracker so that all subsequent hits will use this
    // value.
    mTracker.set(Fields.SCREEN_NAME, SCREEN_LABEL);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Send a screenview using any available campaign or referrer data.
    MapBuilder.createAppView().setAll(getReferrerMapFromUri(uri));
  }

  /*
   * Given a URI, returns a map of campaign data that can be sent with
   * any GA hit.
   *
   * @param uri A hierarchical URI that may or may not have campaign data
   *     stored in query parameters.
   *
   * @return A map that may contain campaign or referrer
   *     that may be sent with any Google Analytics hit.
   */
  Map<String,String> getReferrerMapFromUri(Uri uri) {

    MapBuilder paramMap = new MapBuilder();

    // If no URI, return an empty Map.
    if (uri == null) { return paramMap.build(); }

    // Source is the only required campaign field. No need to continue if not
    // present.
    if (uri.getQueryParameter(CAMPAIGN_SOURCE_PARAM) != null) {

      // MapBuilder.setCampaignParamsFromUrl parses Google Analytics campaign
      // ("UTM") parameters from a string URL into a Map that can be set on
      // the Tracker.
      paramMap.setCampaignParamsFromUrl(uri.toString());

     // If no source parameter, set authority to source and medium to
     // "referral".
     } else if (uri.getAuthority() != null) {

       paramMap.set(Fields.CAMPAIGN_MEDIUM, "referral");
       paramMap.set(Fields.CAMPAIGN_SOURCE, uri.getAuthority());

     }

     return paramMap.build();
  }
}

বিকল্পভাবে, যদি আপনার কাছে Google Analytics প্রচারাভিযানের পরামিতিগুলি ছাড়া অন্য কোনো ফর্মে প্রচারাভিযানের তথ্য থাকে, তাহলে আপনি এটিকে একটি Map সেট করে নিজে পাঠাতে পারেন:

// May return null if EasyTracker has not yet been initialized with a property ID.
EasyTracker easyTracker = EasyTracker.getInstance(this);
easyTracker.set(Fields.SCREEN_NAME, "Home Screen");

// In this example, campaign information is set using a Map, rather than
// a url string with Google Analytics campaign parameters.
// Note that Fields.CAMPAIGN_KEYWORD is not necessary for this campaign.
HashMap<String, String> campaignData = new HashMap<String, String>();
campaignData.put(Fields.CAMPAIGN_SOURCE, "email");
campaignData.put(Fields.CAMPAIGN_MEDIUM, "email marketing");
campaignData.put(Fields.CAMPAIGN_NAME, "summer_campaign");
campaignData.put(Fields.CAMPAIGN_CONTENT, "email_variation_1");

MapBuilder paramMap = MapBuilder.createAppView();

// Campaign data sent with this hit.
// Note that the campaign data is set on the Map, not the tracker.
easyTracker.send(paramMap
    .setAll(campaignData).build()
);

গুগল প্লে ক্যাম্পেইন অ্যাট্রিবিউশন

Google Play প্রচারাভিযান পরিমাপ আপনাকে দেখতে দেয় যে কোন প্রচারাভিযান এবং ট্র্যাফিক উত্সগুলি ব্যবহারকারীদের Google Play Store থেকে আপনার অ্যাপ ডাউনলোড করতে পাঠাচ্ছে৷ এটি সুপারিশ করা হয় যে সমস্ত বিকাশকারীরা Google Play Store প্রচারাভিযান পরিমাপ প্রয়োগ করুন৷

Google Play প্রচারাভিযান অ্যাট্রিবিউশন বাস্তবায়ন করা

যখন আপনার অ্যাপটি Google Play Store থেকে ডাউনলোড করা হয়, তখন Play Store অ্যাপটি ইনস্টলেশনের সময় আপনার অ্যাপে একটি INTENT_REFERRER সম্প্রচার করে। এই অভিপ্রায়ে আপনার অ্যাপের Google Play Store পৃষ্ঠায় পৌঁছানোর জন্য ব্যবহৃত লিঙ্কের referrer প্যারামিটারের মান রয়েছে, যদি কেউ উপস্থিত থাকে।

একটি প্রচারাভিযানে একটি অ্যাপ ডাউনলোড করার জন্য, আপনাকে অবশ্যই Google Play Store-এ নির্দেশ করে এমন যেকোনো লিঙ্কে একটি referrer প্যারামিটার যোগ করতে হবে এবং আপনার অ্যাপে একটি BroadcastReceiver যোগ করতে হবে এবং আপনার Google Analytics ট্র্যাকারের উদ্দেশ্যের মধ্যে থাকা প্রচারাভিযানের তথ্য সেট করতে হবে।

এটি সুপারিশ করা হয় যে বেশিরভাগ বিকাশকারীরা SDK এর সাথে প্রদত্ত BroadcastReceiver ব্যবহার করেন৷ অন্তর্ভুক্ত রিসিভার ব্যবহার করে Google Play Store প্রচারাভিযান পরিমাপ বাস্তবায়ন করতে:

1. আপনার AndroidManifest.xml ফাইলে Google Analytics রিসিভার যোগ করুন। ম্যানিফেস্টে Google Analytics রিসিভার যোগ করতে, নিম্নলিখিত মার্কআপটি অনুলিপি করুন এবং আটকান:

<!-- Used for Google Play Store Campaign Measurement-->;
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService" />
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

2. Google Play URL-এ Google Analytics ক্যাম্পেইন প্যারামিটার যোগ করুন

এরপরে, Google Play Store-এর সাথে সরাসরি লিঙ্ক করা যেকোন URL-এ একটি referrer প্যারামিটার যোগ করুন এবং সেই প্যারামিটারের মান Google Analytics ক্যাম্পেইন প্যারামিটারের একটি স্ট্রিং-এ সেট করুন যা উত্স বর্ণনা করে, যেমন এই উদাহরণে:

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Dpodcast%252Bapps
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dpodcast%252Bgeneralkeywords

কিভাবে একটি প্রচারাভিযান পরামিতি স্ট্রিং তৈরি করতে হয় তা শিখতে, Google Play URL বিল্ডার ব্যবহার করুন বা ক্যাম্পেইন প্যারামিটার রেফারেন্স বিভাগটি দেখুন।

Google Play URL নির্মাতা

Google Play প্রচারাভিযান পরিমাপের জন্য URL তৈরি করতে নিচের টুলটি ব্যবহার করুন।