একটি ট্র্যাকারে ফিল্ড ডেটা পেতে এবং সেট করার জন্য কখনও কখনও ট্র্যাকার অবজেক্টের একটি রেফারেন্স থাকা প্রয়োজন। যেহেতু ga()
কমান্ড কিউতে যোগ করা কমান্ডগুলি অ্যাসিঙ্কোনাসভাবে কার্যকর হয় এবং একটি মান ফেরত দেয় না, এবং যেহেতু ট্র্যাকারগুলি সাধারণত create
কমান্ড ব্যবহার করে তৈরি করা হয়, তাই ট্র্যাকার অবজেক্টের রেফারেন্স পাওয়ার জন্য create
কমান্ড কার্যকর না হওয়া পর্যন্ত অপেক্ষা করতে হবে। আপনি প্রস্তুত কলব্যাকের মাধ্যমে এটি করতে পারেন।
প্রস্তুত কলব্যাক
প্রস্তুত কলব্যাক হল একটি ফাংশন যা আপনি ga()
কমান্ড সারিতে যোগ করতে পারেন। analytics.js লাইব্রেরি সম্পূর্ণরূপে লোড হওয়ার সাথে সাথেই ফাংশনটি চালু করা হবে এবং সারিতে যোগ করা সমস্ত পূর্ববর্তী কমান্ডগুলি কার্যকর করা হয়েছে৷
যেহেতু সারির সমস্ত কমান্ড ক্রমানুসারে কার্যকর করা হয়, তাই একটি create
কমান্ড যোগ করার পরে সারিতে একটি প্রস্তুত কলব্যাক যোগ করা নিশ্চিত করবে যে ট্র্যাকার তৈরি হওয়ার পরে প্রস্তুত কলব্যাকটি কার্যকর করা হয়েছে। যদি একটি ডিফল্ট ট্র্যাকার তৈরি করা হয় যখন একটি প্রস্তুত কলব্যাক আহ্বান করা হয়, এটি কলব্যাকের প্রথম (এবং শুধুমাত্র) যুক্তি হিসাবে পাস করা হয়।
নিম্নলিখিত কোডটি দেখায় কিভাবে ডিফল্ট ট্র্যাকার অবজেক্ট অ্যাক্সেস করতে হয় এবং এটি কনসোলে লগ করতে হয়:
ga('create', 'UA-XXXXX-Y', 'auto');
ga(function(tracker) {
// Logs the tracker created above to the console.
console.log(tracker);
});
ga অবজেক্ট পদ্ধতির মাধ্যমে ট্র্যাকার পাওয়া
আপনি যদি একটি ডিফল্ট ট্র্যাকার ব্যবহার না করে থাকেন, বা আপনার যদি পৃষ্ঠায় একাধিক ট্র্যাকার থাকে, আপনি ga
অবজেক্ট পদ্ধতিগুলির একটির মাধ্যমে সেই ট্র্যাকারগুলি অ্যাক্সেস করতে পারেন।
একবার analytics.js লাইব্রেরি সম্পূর্ণরূপে লোড হয়ে গেলে, এটি ga
অবজেক্টে অতিরিক্ত পদ্ধতি যোগ করে। এই দুটি পদ্ধতি, getByName
এবং getAll
, ট্র্যাকার অবজেক্ট অ্যাক্সেস করতে ব্যবহৃত হয়।
getByName
আপনি যে ট্র্যাকারটি অ্যাক্সেস করতে চান তার নাম যদি আপনি জানেন তবে আপনি getByName
পদ্ধতি ব্যবহার করে তা করতে পারেন:
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
ga(function() {
// Logs the "myTracker" tracker object to the console.
console.log(ga.getByName('myTracker'));
});
সব পেতে
সমস্ত তৈরি ট্র্যাকারগুলির একটি অ্যারে পেতে, getAll
পদ্ধতিটি ব্যবহার করুন:
ga('create', 'UA-XXXXX-Y', 'auto', 'tracker1');
ga('create', 'UA-XXXXX-Z', 'auto', 'tracker2');
ga(function() {
// Logs an array of all tracker objects.
console.log(ga.getAll());
});
একটি ট্র্যাকারে ডেটা সংরক্ষণ করা হচ্ছে
একবার আপনার কাছে একটি ট্র্যাকার অবজেক্টের একটি রেফারেন্স পাওয়া গেলে, আপনি ট্র্যাকারে বর্তমানে সঞ্চিত যেকোনো ক্ষেত্রের মান অ্যাক্সেস করতে এটির get
পদ্ধতি ব্যবহার করতে পারেন।
ga('create', 'UA-XXXXX-Y', 'auto');
ga(function(tracker) {
// Logs the trackers name.
// (Note: default trackers are given the name "t0")
console.log(tracker.get('name'));
// Logs the client ID for the current user.
console.log(tracker.get('clientId'));
// Logs the URL of the referring site (if available).
console.log(tracker.get('referrer'));
});
ডেটা আপডেট করুন
ট্র্যাকার অবজেক্ট set
পদ্ধতি ব্যবহার করে আপডেট করা যেতে পারে। একটি ট্র্যাকারের set
পদ্ধতি একটি ট্র্যাকার অবজেক্টে কল করা যেতে পারে বা ga()
কমান্ড কিউতে একটি set
কমান্ড যোগ করে।
যেহেতু একটি ট্র্যাকার অবজেক্টের রেফারেন্স পাওয়ার জন্য প্রস্তুত কলব্যাক ব্যবহার করা প্রয়োজন, ga()
কমান্ড সারি ব্যবহার করা একটি ট্র্যাকার আপডেট করার প্রস্তাবিত উপায়।
ga()
কমান্ড সারি
set
কমান্ড দুটি উপায়ে আহ্বান করা যেতে পারে: দুটি প্যারামিটার, একটি ক্ষেত্র এবং এর সংশ্লিষ্ট মান পাস করে, অথবা ক্ষেত্র/মান জোড়ার একটি বস্তু পাস করে।
নিম্নলিখিত উদাহরণটি ডিফল্ট ট্র্যাকারে page
ক্ষেত্রটিকে '/about'
এ সেট করে:
ga('set', 'page', '/about');
এই উদাহরণটি একই সময়ে page
এবং title
ক্ষেত্র সেট করে:
ga('set', {
page: '/about',
title: 'About Us'
});
একটি নামযুক্ত ট্র্যাকার ব্যবহার করে
আপনি যদি ডিফল্ট ট্র্যাকারের পরিবর্তে একটি নামযুক্ত ট্র্যাকার ব্যবহার করেন তবে আপনি কমান্ড স্ট্রিং-এ এর নাম পাস করতে পারেন।
নিম্নলিখিত কলটি "myTracker" নামের ট্র্যাকারে page
ক্ষেত্র সেট করে:
ga('myTracker.set', 'page', '/about');
ট্র্যাকার বস্তু নিজেই
যদি আপনার কাছে ট্র্যাকার অবজেক্টের একটি রেফারেন্স থাকে তবে আপনি সেই ট্র্যাকারের set
পদ্ধতিটিকে সরাসরি কল করতে পারেন:
ga(function(tracker) {
tracker.set('page', '/about');
});
অ্যাম্পারস্যান্ড সিনট্যাক্স
ট্র্যাকার ক্ষেত্রগুলি সাধারণত তাদের ক্ষেত্রের নাম ব্যবহার করে সেট করা হয়। (analytics.js ক্ষেত্র এবং তাদের নামের সম্পূর্ণ তালিকার জন্য ক্ষেত্রের রেফারেন্স দেখুন।)
ক্ষেত্রগুলি পেতে এবং সেট করার একটি বিকল্প উপায় হল তাদের সংশ্লিষ্ট পরিমাপ প্রোটোকল পরামিতি নামের নাম দ্বারা তাদের উল্লেখ করা।
উদাহরণস্বরূপ, নিম্নলিখিত দুটি console.log
অভিব্যক্তি উভয়ই নথির শিরোনাম কনসোলে লগ করে:
ga(function(tracker) {
// Gets the title using the analytics.js field name.
console.log(tracker.get('title'));
// Gets the title using the measurement protocol
// parameter name, prefixed with an ampersand.
console.log(tracker.get('&dt'));
});
সাধারণভাবে, অ্যাম্পারস্যান্ড সিনট্যাক্স বাঞ্ছনীয় নয় এবং শুধুমাত্র তখনই ব্যবহার করা উচিত যখন একটি পরিমাপ প্রোটোকল প্যারামিটারের জন্য analytics.js ক্ষেত্রের নামটি বিদ্যমান না থাকে (এটি analytics.js-এ প্রয়োগ করার আগে পরিমাপ প্রোটোকলে একটি নতুন বৈশিষ্ট্য যুক্ত করা হলে এটি মাঝে মাঝে ঘটে। )
পরবর্তী পদক্ষেপ
এখন যেহেতু আপনি জানেন কিভাবে ট্র্যাকার তৈরি করতে হয় এবং সেগুলিতে সংরক্ষিত ডেটা আপডেট করতে হয়, পরবর্তী পদক্ষেপটি হল কীভাবে প্রক্রিয়াকরণের জন্য সেই ডেটা Google Analytics-এ পাঠাতে হয় তা শেখা।