প্লাগইন ব্যবহার করে

প্লাগইন হল স্ক্রিপ্ট যা ব্যবহারকারীর মিথস্ক্রিয়া পরিমাপ করতে সহায়তা করার জন্য analytics.js এর কার্যকারিতা বাড়ায়। প্লাগইনগুলি সাধারণত বৈশিষ্ট্যগুলির একটি সেটের জন্য নির্দিষ্ট যা সমস্ত Google Analytics ব্যবহারকারীদের জন্য প্রয়োজন নাও হতে পারে, যেমন ইকমার্স বা ক্রস-ডোমেন পরিমাপ , এবং তাই ডিফল্টরূপে analytics.js-এ অন্তর্ভুক্ত নয়৷

এই নির্দেশিকা ব্যাখ্যা করে কিভাবে analytics.js প্লাগইনগুলির প্রয়োজন এবং ব্যবহার করতে হয়।

প্লাগইন প্রয়োজন

require কমান্ডটি একটি প্লাগইনের নাম নেয় এবং এটিকে ga() কমান্ড সারির সাথে ব্যবহারের জন্য নিবন্ধন করে। যদি প্লাগইন কনফিগারেশন বিকল্পগুলি গ্রহণ করে, সেই বিকল্পগুলি require কমান্ডের চূড়ান্ত যুক্তি হিসাবে পাস করা যেতে পারে।

নিম্নলিখিতটি সম্পূর্ণ require কমান্ডের স্বাক্ষর:

ga('[trackerName.]require', pluginName, [pluginOptions]);

উদাহরণস্বরূপ, ডিফল্ট ট্র্যাকারের সাথে ব্যবহারের জন্য আপনার কীভাবে উন্নত ইকমার্স প্লাগইন প্রয়োজন হবে তা এখানে:

ga('require', 'ec');

এবং এখানে আপনি কিভাবে "myTracker" নামের একটি ট্র্যাকারের জন্য বিজ্ঞাপন বৈশিষ্ট্য প্লাগইন প্রয়োজন হবে এবং একটি কনফিগারেশন বিকল্প পাস করুন যা ডিফল্ট কুকি নামের মানকে ওভাররাইড করে:

ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

প্লাগইন কোড লোড হচ্ছে

require কমান্ড ga() কমান্ড সারির সাথে ব্যবহারের জন্য প্লাগইন পদ্ধতিগুলি শুরু করে, কিন্তু এটি প্লাগইন স্ক্রিপ্ট নিজেই লোড করে না। আপনি যদি একটি তৃতীয় পক্ষের প্লাগইন ব্যবহার করেন, বা নিজে একটি প্লাগইন লিখছেন , তাহলে আপনাকে পৃষ্ঠায় প্লাগইন কোডটি ম্যানুয়ালি যোগ করতে হবে।

পৃষ্ঠায় প্লাগইন কোড যোগ করার জন্য প্রস্তাবিত পদ্ধতি হল async অ্যাট্রিবিউট সেট সহ একটি <script> ট্যাগের মাধ্যমে যাতে এটি আপনার সাইটে অন্যান্য বৈশিষ্ট্যের লোডিং ব্লক করে না।

নিম্নলিখিত কোড উভয়েরই প্রয়োজন এবং একটি অনুমানমূলক লিঙ্ক ট্র্যাকিং প্লাগইন লোড করে:

<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>

<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>

প্লাগইন লোড হওয়ার জন্য অপেক্ষা করা হচ্ছে

কারণ analytics.js লাইব্রেরি এবং analytics.js প্লাগইন উভয়ই অ্যাসিঙ্ক্রোনাসভাবে লোড করা হয়, প্লাগইনগুলি কখন সম্পূর্ণরূপে লোড হয় এবং ব্যবহারের জন্য প্রস্তুত তা জানা একটি চ্যালেঞ্জ হতে পারে৷

analytics.js লাইব্রেরি এই সমস্যার সমাধান করে যখন এটি এখনও লোড করা হয়নি এমন একটি প্লাগইনের জন্য require কমান্ডের সম্মুখীন হয় তখন কমান্ড কিউ কার্যকর করা বন্ধ করে। একবার প্লাগইন লোড হয়ে গেলে, সারি সম্পাদন স্বাভাবিক হিসাবে চলতে থাকে।

ফলস্বরূপ, এটি অত্যন্ত গুরুত্বপূর্ণ যে আপনি যে প্লাগইনগুলি ব্যবহার করছেন সেগুলি সঠিকভাবে লোড এবং চালানো নিশ্চিত করতে পরীক্ষা করা৷ যদি একটি প্লাগইন লোড করতে ব্যর্থ হয় বা একটি ত্রুটি থাকে, তাহলে এটি পরবর্তী সমস্ত analytics.js কমান্ডগুলিকে কার্যকর হতে বাধা দেবে৷

প্লাগইন পদ্ধতি কল

একটি প্লাগইন প্রয়োজন হওয়ার পরে, এর পদ্ধতিগুলি ga() কমান্ড সারির সাথে ব্যবহারের জন্য উপলব্ধ হয়ে যায়। প্লাগইন পদ্ধতি কল করার জন্য এখানে কমান্ড স্বাক্ষর আছে:

ga('[trackerName.][pluginName:]methodName', ...args);

উদাহরণস্বরূপ, উন্নত ইকমার্স প্লাগইনের addProduct পদ্ধতিটিকে এভাবে বলা যেতে পারে:

ga('ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

অথবা কমান্ড স্ট্রিং এ ট্র্যাকার নাম যোগ করে একটি নামযুক্ত ট্র্যাকারে:

ga('myTracker.ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

পরবর্তী পদক্ষেপ

আপনি যদি এই বিভাগে সমস্ত নির্দেশিকা পড়ে থাকেন, তাহলে আপনার analytics.js-এর বেশিরভাগ বৈশিষ্ট্যের সাথে পরিচিত হওয়া উচিত। পরবর্তী নির্দেশিকা ব্যাখ্যা করে কিভাবে আপনার analytics.js বাস্তবায়ন ডিবাগ করতে হয় যাতে আরও সহজে ত্রুটি সনাক্ত করা যায় এবং আপনার কোড ঠিক কী করছে তা দেখতে।