ga() কমান্ড সারি আপনাকে analytics.js লাইব্রেরির সাথে যা করতে হবে প্রায় সবকিছু করার জন্য একটি ইন্টারফেস প্রদান করে।
জাভাস্ক্রিপ্ট ট্র্যাকিং স্নিপেট প্রাথমিক ga() কমান্ড সারি ফাংশন সংজ্ঞায়িত করে, তাই analytics.js লাইব্রেরি সম্পূর্ণরূপে লোড হওয়ার আগেও এটি ব্যবহার করা যেতে পারে। analytics.js লাইব্রেরি লোড হওয়ার সাথে সাথে, কমান্ড সারিতে থাকা আইটেমগুলি যে ক্রমে প্রাপ্ত হয়েছিল সেই ক্রমে কার্যকর করা হয়৷ একবার এটি হয়ে গেলে, সারিতে ঠেলে দেওয়া নতুন কমান্ডগুলি অবিলম্বে কার্যকর করা হয়।
ট্র্যাকিং স্নিপেট যতটা সম্ভব ছোট রাখার জন্য, ga() কমান্ড সারিটি বিভিন্ন ফরম্যাটে আর্গুমেন্ট গ্রহণ করার জন্য ওভারলোড করা হয়। এই নথিতে ga() কমান্ড সারি ফাংশন চালু করার বিভিন্ন উপায়ের বিবরণ রয়েছে।
| ফাংশন স্বাক্ষর | |
|---|---|
ga(command, [...fields], [fieldsObject]) | নিম্নলিখিত ফাংশন স্বাক্ষর সহ |
ga(readyCallback) | একটি ফাংশন পাস করে যেহেতু analytics.js লাইব্রেরি সম্পূর্ণরূপে লোড হওয়ার পরেই কমান্ডগুলি কার্যকর করা হয়, তাই analytics.js লাইব্রেরি লোড এবং প্রস্তুত হলে একটি ফাংশন কমান্ড সারি পাস করার সবচেয়ে সাধারণ কারণ হল একটি কলব্যাক। |
সারিতে কমান্ড যোগ করা হচ্ছে
নিম্নলিখিত ফাংশন স্বাক্ষর সহ ga() কমান্ড সারি ফাংশন আহ্বান করা লাইব্রেরি লোড হওয়ার পরে কার্যকর করার জন্য নির্ধারিত সারিতে কমান্ডগুলিকে ঠেলে দেবে।
ব্যবহার
ga(command, [...fields], [fieldsObject])
পরামিতি
| নাম | টাইপ | প্রয়োজন | বর্ণনা | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
command | string | হ্যাঁ | সারিতে যোগ করার জন্য কমান্ডের প্রতিনিধিত্বকারী একটি শনাক্তকারী। শনাক্তকারী তিনটি অংশ নিয়ে গঠিত (প্রথম দুটি ঐচ্ছিক): [trackerName.][pluginName:]methodName
| |||||||||
...fields | * | না | সাধারণ ক্ষেত্রগুলি দ্রুত নির্দিষ্ট করার জন্য এক বা একাধিক ঐচ্ছিক সুবিধার পরামিতি। অনুমোদিত ক্ষেত্রগুলির সংখ্যা এবং নির্দিষ্ট ক্ষেত্রগুলি কল করা কমান্ড পদ্ধতির উপর নির্ভর করে পরিবর্তিত হয়। | |||||||||
fieldsObject | Object | না | কোনো যদি একটি ক্ষেত্র একটি |
পৃথক ক্ষেত্রের ডকুমেন্টেশনের জন্য ক্ষেত্রের রেফারেন্স দেখুন।
উদাহরণ
পৃথক কমান্ড উদাহরণের জন্য নীচের কমান্ড পদ্ধতি বিভাগ দেখুন।
প্রস্তুত কলব্যাক
একটি ফাংশন পাস করে ga() কমান্ড সারি ফাংশনকে আহ্বান করলে সারির পরবর্তী পয়েন্টে সম্পাদনের জন্য পাস করা ফাংশন নির্ধারণ করা হবে।
যেহেতু analytics.js লাইব্রেরি সম্পূর্ণরূপে লোড হওয়ার পরেই কমান্ডগুলি কার্যকর করা হয়, তাই analytics.js লাইব্রেরি লোড এবং প্রস্তুত হলে একটি ফাংশন কমান্ড সারি পাস করার সবচেয়ে সাধারণ কারণ হল একটি কলব্যাক।
ব্যবহার
ga(readyCallback)
পরামিতি
| নাম | টাইপ | প্রয়োজন | বর্ণনা |
|---|---|---|---|
readyCallback | Function | হ্যাঁ | একটি কলব্যাক ফাংশন যখন লাইব্রেরি সম্পূর্ণরূপে লোড হয় এবং সাথে ইন্টারঅ্যাক্ট করার জন্য প্রস্তুত থাকে তখন আহ্বান করা হবে৷ ফাংশনটি প্রথম আর্গুমেন্ট হিসাবে ডিফল্ট ট্র্যাকার অবজেক্টের সাথে আহ্বান করা হয়। যদি কোনো ডিফল্ট ট্র্যাকার তৈরি না করা হয়, প্রথম আর্গুমেন্টটি দ্রষ্টব্য: যখন কলব্যাক ফাংশন আহ্বান করা হয়, তখন সমস্ত |
উদাহরণ
// Queues a tracker object for creation.
ga('create', 'UA-XXXXX-Y', 'auto');
// Once the tracker has been created, log the
// client ID to the console.
ga(function(tracker) {
console.log(tracker.get('clientId'));
});
// Queues a named tracker object for creation.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
// When there is no default tracker, the first
// argument of the ready callback is `undefined`.
ga(function(tracker) {
console.log(tracker); // Logs `undefined`.
});
কমান্ড পদ্ধতির বিশদ বিবরণ
নিম্নলিখিত সমস্ত পদ্ধতির একটি তালিকা যা ga() কমান্ড কিউতে পাস করা যেতে পারে (প্লাগইন পদ্ধতি ব্যতীত)।
create
নির্দিষ্ট ক্ষেত্রগুলির সাথে একটি নতুন ট্র্যাকার উদাহরণ তৈরি করে।
ব্যবহার
ga('create', [trackingId], [cookieDomain], [name], [fieldsObject]);
পরামিতি
পৃথক ক্ষেত্রের ডকুমেন্টেশনের জন্য ক্ষেত্রের রেফারেন্স দেখুন।
রিটার্নস
undefined
উদাহরণ
// Creates a default tracker for the Property UA-XXXXX-Y
// and uses automatic cookie domain configuration.
ga('create', 'UA-XXXXX-Y', 'auto');
// Creates a tracker with the name "myTracker" for the Property
// UA-XXXXX-Y, sets the cookieDomain to "example.com", and specifies
// a transport mechanism of "beacon".
ga('create', 'UA-XXXXX-Y', 'example.com', 'myTracker', {
transport: 'beacon'
});
send
Google Analytics-এ একটি হিট পাঠায়।
ব্যবহার
ga('[trackerName.]send', [hitType], [...fields], [fieldsObject]);
যে ক্ষেত্রগুলি পাঠানো হয় সেগুলি হল ...fields প্যারামিটার এবং fieldsObject নির্দিষ্ট করা মানগুলি, বর্তমানে ট্র্যাকারে সঞ্চিত ক্ষেত্রগুলির সাথে মার্জ করা হয়েছে৷
পরামিতি
যে ক্ষেত্রগুলি ...fields প্যারামিটার দ্বারা নির্দিষ্ট করা যেতে পারে সেগুলি হিটের প্রকারের উপর নির্ভর করে পরিবর্তিত হয়। নিম্নলিখিত সারণী প্রতিটি হিট প্রকারের সাথে সঙ্গতিপূর্ণ ক্ষেত্রগুলিকে তালিকাভুক্ত করে৷ তালিকাভুক্ত নয় এমন হিট প্রকারগুলি স্বীকার করে না ...fields পরামিতি, শুধুমাত্র fieldsObject .
| হিট টাইপ | ...fields |
|---|---|
pageview | page |
event | eventCategory , eventAction , eventLabel , eventValue |
social | socialNetwork , socialAction , socialTarget |
timing | timingCategory , timingVar , timingValue , timingLabel |
পৃথক ক্ষেত্রের ডকুমেন্টেশনের জন্য ক্ষেত্রের রেফারেন্স দেখুন।
রিটার্নস
undefined
উদাহরণ
// Sends a pageview hit.
ga('send', 'pageview');
// Sends an event hit for the tracker named "myTracker" with the
// following category, action, and label, and sets the nonInteraction
// field value to true.
ga('send', 'event', 'link', 'click', 'http://example.com', {
nonInteraction: true
});
set
একটি ট্র্যাকার অবজেক্টে একটি একক ক্ষেত্র এবং মান জোড়া বা ক্ষেত্র/মান জোড়ার একটি গ্রুপ সেট করে।
ব্যবহার
// Sets a single field and value.
ga('[trackerName.]set', fieldName, fieldValue);
// Sets a group of field/value pairs.
ga('[trackerName.]set', fieldsObject);
পরামিতি
পৃথক ক্ষেত্রের ডকুমেন্টেশনের জন্য ক্ষেত্রের রেফারেন্স দেখুন।
রিটার্নস
undefined
উদাহরণ
// Sets the page field to "/about.html".
ga('set', 'page', '/about.html');
// Sets the page field to "/about.html" and the title to "About".
ga('set', {
page: '/about.html',
title: 'About'
});
require
একটি analytics.js প্লাগইন প্রয়োজন।
ব্যবহার
ga('[trackerName.]require', pluginName, [pluginOptions]);
পরামিতি
| নাম | টাইপ | প্রয়োজন | বর্ণনা |
|---|---|---|---|
pluginName | string | হ্যাঁ | প্লাগইন এর নাম প্রয়োজন হবে. দ্রষ্টব্য: প্লাগইনটি একটি অফিসিয়াল analytics.js প্লাগইন না হলে, এটি অবশ্যই পৃষ্ঠার অন্য কোথাও প্রদান করতে হবে। |
pluginOptions | Object | না | একটি ইনিশিয়ালাইজেশন অবজেক্ট যা ইনস্ট্যান্টেশনের পরে প্লাগইন কনস্ট্রাক্টরের কাছে পাঠানো হবে। |
রিটার্নস
undefined
উদাহরণ
// Requires the Enhanced Ecommerce plugin.
ga('require', 'ec');
// Requires the Advertising Features plugin
// named "myTracker" and override its default cookie name.
ga('myTracker.require', 'displayfeatures', {
cookieName: 'display_features_cookie'
});
provide
ga() কমান্ড সারির সাথে ব্যবহারের জন্য একটি analytics.js প্লাগইন এবং এর পদ্ধতি প্রদান করে।
ga('provide', pluginName, pluginConstuctor);
পরামিতি
| নাম | টাইপ | প্রয়োজন | বর্ণনা |
|---|---|---|---|
pluginName | string | হ্যাঁ | প্লাগইনের নাম দেওয়া হচ্ছে। যে নামটি যেকোন প্রয়োজনের কলে ব্যবহৃত একই নাম হতে হবে। |
pluginConstuctor | Function | হ্যাঁ | একটি কনস্ট্রাক্টর ফাংশন সমস্ত প্লাগইন যুক্তি এবং পদ্ধতি প্রদান করে। এই কনস্ট্রাক্টরটিকে প্রয়োজনীয় পদ্ধতিতে নির্দিষ্ট করা pluginsOptions অবজেক্টের সাথে আহ্বান করা হবে। |
উদাহরণ
// Defines a plugin constructor
function MyPlugin(tracker, options) {
// ...
}
// Provides the plugin for use with the ga() command queue.
ga('provide', 'myplugin', MyPlugin);
remove
একটি ট্র্যাকার বস্তু সরান.
ব্যবহার
ga('[trackerName.]remove');
উদাহরণ
// Remove the default tracker.
ga('remove');
// Remove the tracker named "myTracker".
ga('myTracker.remove');