এই ডকুমেন্টটি Android v2 এর জন্য Google Analytics SDK-এর কিছু উন্নত কনফিগারেশন বৈশিষ্ট্যের একটি ওভারভিউ প্রদান করে।
ওভারভিউ
অ্যান্ড্রয়েডের জন্য গুগল অ্যানালিটিক্স SDK বাস্তবায়নের বিশ্বব্যাপী অবস্থা পরিচালনা করতে এবং Google অ্যানালিটিক্স সার্ভারে ডেটা পাঠানোর জন্য দুটি শ্রেণী ব্যবহার করে। EasyTracker সরলীকৃত কনফিগারেশন এবং সেশন ম্যানেজমেন্ট প্রদান করতে এই ক্লাসগুলিকে মোড়ক করে:
-
GoogleAnalytics– একটি সিঙ্গলটন যাTrackerঅবজেক্ট পাওয়া সহ আপনার বাস্তবায়নের বিশ্বব্যাপী অবস্থা পরিচালনা করে। -
Tracker– যে ক্লাসের সাহায্যে আপনি Google Analytics-এ ডেটা পাঠান।
উদাহরণস্বরূপ, একটি সাধারণ Activity একটি দৃশ্য পরিমাপ করতে:
import android.app.Activity
import com.google.analytics.tracking.android.GoogleAnalytics
import com.google.analytics.tracking.android.Tracker
/**
* A simple Activity that sends a screen view to Google Analytics
* when it is displayed to the user.
*/
public class HomeScreen extends Activity {
private Tracker mGaTracker;
private GoogleAnalytics mGaInstance;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Get the GoogleAnalytics singleton. Note that the SDK uses
// the application context to avoid leaking the current context.
mGaInstance = GoogleAnalytics.getInstance(this);
// Use the GoogleAnalytics singleton to get a Tracker.
mGaTracker = mGaInstance.getTracker("UA-XXXX-Y"); // Placeholder tracking ID.
... // The rest of your onCreate() code.
}
@Override
public void onStart() {
super.onStart();
// Send a screen view when the Activity is displayed to the user.
mGaTracker.sendView("/HomeScreen");
}
}
একাধিক ট্র্যাকার ব্যবহার করা
SDK-এর সংস্করণ 2 অনুযায়ী, আপনি একক বাস্তবায়নে একাধিক ট্র্যাকার ব্যবহার করতে পারেন, প্রতি অনন্য ট্র্যাকিং আইডিতে একটি। সমস্ত ট্র্যাকার আপনার GoogleAnalytics সিঙ্গলটন দ্বারা ধারণ করা একই বৈশ্বিক অবস্থা শেয়ার করে।
নিম্নলিখিত উদাহরণে, একটি স্ক্রিন ভিউ দুটি পৃথক বৈশিষ্ট্যে দুটি ট্র্যাকার ব্যবহার করে পাঠানো হয়, প্রতিটির নিজস্ব স্বতন্ত্র সম্পত্তি আইডি সহ:
import android.app.Activity
import com.google.analytics.tracking.android.GoogleAnalytics
import com.google.analytics.tracking.android.Tracker
/**
* A simple Activity that sends a screen view to Google Analytics
* when it is displayed to the user.
*/
public class HomeScreen extends Activity {
private GoogleAnalytics mGaInstance;
private Tracker mGaTracker1;
private Tracker mGaTracker2;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Get the GoogleAnalytics singleton.
mGaInstance = GoogleAnalytics.getInstance(this);
// Use the GoogleAnalytics singleton to get two Trackers with
// unique property IDs.
mGaTracker1 = mGaInstance.getTracker("UA-XXXX-Y");
mGaTracker2 = mGaInstance.getTracker("UA-XXXX-Z");
... // The rest of your onCreate() code.
}
@Override
public void onStart() {
super.onStart();
// Send a screen view to "UA-XXXX-Y" the Activity is displayed to the user.
mGaTracker1.sendView("/HomeScreen");
// Send another screen view to the second property, "UA-XXXX-Z".
mGaTracker2.sendView("/Home");
}
}
মনে রাখবেন যে EasyTracker দ্বারা প্রদত্ত স্বয়ংক্রিয় পরিমাপ বৈশিষ্ট্যগুলি শুধুমাত্র তাদের কল করার জন্য ডিফল্ট ট্র্যাকার ব্যবহার করবে৷ আপনি যদি এই EasyTracker বৈশিষ্ট্যগুলি ব্যবহার করেন এবং অন্যান্য ট্র্যাকার ব্যবহার করে ডেটা পাঠাতে চান তবে আপনাকে ম্যানুয়ালি তা করতে হবে।
ডিফল্ট ট্র্যাকার
যদিও একটি বাস্তবায়ন একাধিক ট্র্যাকার ব্যবহার করতে পারে, বিশ্বব্যাপী এটির একটি ডিফল্ট ট্র্যাকার রয়েছে। পুনরুদ্ধার করা প্রথম Tracker ডিফল্ট ট্র্যাকার হয়ে যায়।
ডিফল্ট ট্র্যাকার পেতে, ব্যবহার করুন:
// Get singleton. GoogleAnalytics myInstance = GoogleAnalytics.getInstance(this); // Get default tracker. Tracker myDefault = myInstance.getDefaultTracker();
ডিফল্ট ট্র্যাকার সেট করতে, ব্যবহার করুন:
// First get a tracker using a new property ID.
Tracker newTracker = myInstance.getTracker("UA-XXXX-2");
// Then make newTracker the default tracker globally.
myInstance.setDefaultTracker(newTracker);
প্রেরণ
ডিসপ্যাচ সেটিংস GAServiceManager singleton দ্বারা পরিচালিত হয়। প্রেরণের সময়কাল সেট করতে:
// Set dispatch period to 30 seconds. GAServiceManager.getInstance().setDispatchPeriod(30);
নির্ধারিত ব্যবধানের বাইরে ম্যানুয়ালি প্রেরণ করতে:
// Manually dispatch any queued hits. GAServiceManager.getInstance().dispatch();
স্যাম্পলিং
আপনি Google Analytics-এ পাঠানো হিটের সংখ্যা সীমিত করতে ক্লায়েন্ট-সাইড স্যাম্পলিং সক্ষম করতে পারেন। যদি আপনার অ্যাপের বিপুল সংখ্যক ব্যবহারকারী থাকে বা অন্যথায় গুগল অ্যানালিটিক্সে প্রচুর পরিমাণে ডেটা পাঠায়, তাহলে নমুনা সক্ষম করা নিরবচ্ছিন্ন প্রতিবেদন নিশ্চিত করতে সহায়তা করবে।
উদাহরণস্বরূপ, EasyTracker এবং XML এর মাধ্যমে 50% হারে ক্লায়েন্ট-সাইড স্যাম্পলিং সক্ষম করতে, আপনার analytics.xml ফাইলে নিম্নলিখিত প্যারামিটারটি ব্যবহার করুন:
<string name="ga_sampleFrequency">50.0</string>
আপনি প্রোগ্রামগতভাবে ক্লায়েন্ট-সাইড স্যাম্পলিং সক্ষম করতে পারেন:
// Get tracker from singleton.
GoogleAnalytics gaInstance = GoogleAnalytics.getInstance(this);
Tracker tracker = gaInstance.getTracker("UA-XXXX-Y"); // Placeholder property ID.
// Set a sample rate of 50%.
tracker.setSampleRate(50.0d);
অ্যাপ-স্তরের অপ্ট আউট
আপনি একটি অ্যাপ-লেভেল অপ্ট আউট পতাকা সক্ষম করতে পারেন যা সমগ্র অ্যাপ জুড়ে Google Analytics অক্ষম করবে। একবার সেট হয়ে গেলে, পতাকাটি অ্যাপটির জীবনের জন্য বা এটি রিসেট না হওয়া পর্যন্ত টিকে থাকবে।
অ্যাপ-স্তরের অপ্ট আউট সেটিং পেতে, ব্যবহার করুন:
// Get singleton.
GoogleAnalytics myInstance = GoogleAnalytics.getInstance(this);
// Get the app opt out preference using an AppOptOutCallback.
myInstance.requestAppOptOut(new AppOptOutCallback() {
@Override
public void reportAppOptOut(boolean optOut) {
if (optOut) {
... // Alert the user that they've opted out.
}
});
}
অ্যাপ-স্তরের অপ্ট আউট পতাকা সেট করতে, ব্যবহার করুন:
myInstance.setAppOptOut(appPreferences.userOptOut);
পরীক্ষা এবং ডিবাগিং
Android এর জন্য Google Analytics SDK একটি ডিবাগ মোড প্রদান করে যা আপনার লগগুলিতে Google Analytics-এ কোন ডেটা পাঠানো হচ্ছে সে সম্পর্কে দরকারী তথ্য প্রিন্ট করবে।
EasyTracker ব্যবহার করে ডিবাগ মোড সক্ষম করতে, আপনার analytics.xml রিসোর্স ফাইলে নিম্নলিখিত যোগ করুন:
<bool name="ga_debug">true</bool>
প্রোগ্রামগতভাবে ডিবাগ মোড সক্ষম করতে, ব্যবহার করুন:
// Get singleton using application context. GoogleAnalytics myInstance = GoogleAnalytics.getInstance(this); // Enable debug mode. myInstance.setDebug(true);
আউটপুট GAV2 ট্যাগ ব্যবহার করে লগক্যাটে প্রিন্ট করা হবে।