Google ট্যাগ API রেফারেন্স

Google ট্যাগ (gtag.js) API একটি একক ফাংশন নিয়ে গঠিত, gtag() , নিম্নলিখিত সিনট্যাক্স সহ:

gtag(<command>, <command parameters>);

• <command> নিম্নলিখিত কমান্ডগুলির মধ্যে একটি:
  • config
  • get
  • set
  • event
  • consent
• <command parameters> হল সেই প্যারামিটারগুলি যা আপনি gtag() এ পাস করতে পারেন। কমান্ড প্যারামিটার কমান্ড অনুযায়ী পরিবর্তিত হয়; কমান্ড রেফারেন্স পড়ুন, নীচে.

আপনি আপনার পৃষ্ঠার যেকোন জায়গায় gtag() কমান্ডগুলি ব্যবহার করতে পারেন, যতক্ষণ না আপনার কমান্ডগুলি Google ট্যাগ স্নিপেটের নীচে প্রদর্শিত হয়। কিভাবে একটি পৃষ্ঠায় স্নিপেট যোগ করতে হয় তা জানতে, ইনস্টলেশন গাইড দেখুন।

পরামিতি সুযোগ

আপনি স্বতন্ত্র ইভেন্ট, সমস্ত ইভেন্ট একটি নির্দিষ্ট <TARGET_ID> এ পাঠানো বা বিশ্বব্যাপী সমস্ত ইভেন্টের জন্য প্যারামিটারের মান স্কোপ করতে পারেন। event , config এবং set কমান্ড ব্যবহার করে এটি অর্জন করা হয়।

একটি স্কোপে সেট করা প্যারামিটার মানগুলি একই প্যারামিটারের জন্য আলাদা স্কোপে সেট করা মানগুলিকে পরিবর্তন করে না। নীচের উদাহরণে, config কমান্ড আগে set কমান্ডের সাথে বরাদ্দ করা campaign_id জন্য বিশ্বব্যাপী মান পরিবর্তন করে না। উভয় কমান্ড কার্যকর হওয়ার পরে, campaign_id বৈশ্বিক মান এখনও '1234' ।

// Set global campaign ID
gtag('set', { 'campaign_id': '1234' });

// Set campaign ID for <TARGET_ID>
gtag('config','<TARGET_ID>', { 'campaign_id': 'ABCD' });

প্যারামিটার অগ্রাধিকার

যদি বিভিন্ন স্কোপে একই প্যারামিটারে বিভিন্ন মান বরাদ্দ করা হয়, ইভেন্টগুলি প্রক্রিয়া করার সময় শুধুমাত্র একটি একক মান ব্যবহার করা হয়। event স্কোপ করা প্যারামিটার মানগুলি config স্কোপ করা প্যারামিটারগুলির চেয়ে অগ্রাধিকার নেবে এবং set ব্যবহার করে বিশ্বব্যাপী স্কোপ করা প্যারামিটারগুলির চেয়ে config প্যারামিটারগুলি অগ্রাধিকার পাবে।

// Set campaign information at the global scope
gtag('set', { 'campaign_name': 'Black Friday Sale' });

// Set currency for <TARGET_ID1> to 'USD'
gtag('config','<TARGET_ID1>', { 'currency': 'USD' });

// Process a conversion event with currency: 'GBP'
gtag('event','conversion', { 'currency': 'GBP', 'send_to': '<TARGET_ID1>' });

// Process a conversion event with currency: 'EUR'
gtag('event','conversion');

// Process a conversion event with currency: 'USD'
gtag('event','conversion', { 'send_to': '<TARGET_ID1>' });

config

আপনাকে লক্ষ্যে অতিরিক্ত কনফিগারেশন তথ্য যোগ করার অনুমতি দেয়। এটি সাধারণত একটি পণ্যের জন্য একটি পণ্য-নির্দিষ্ট কনফিগারেশন, কিন্তু আপনি যদি Google Ads এবং Google Analytics উভয়ই ব্যবহার করেন তবে আপনাকে এটি শুধুমাত্র একবার কনফিগার করতে হবে।

gtag('config', '<TARGET_ID>', {<additional_config_info>});

<TARGET_ID> হল একটি শনাক্তকারী যা হিটগুলির লক্ষ্যকে স্বতন্ত্রভাবে চিহ্নিত করে, যেমন একটি Google Analytics সম্পত্তি বা একটি Google Ads অ্যাকাউন্ট। <additional_config_info> হল এক বা একাধিক প্যারামিটার-মান জোড়া।

এই উদাহরণটি একটি Google বিজ্ঞাপন অ্যাকাউন্টে ডেটা পাঠাতে একটি ট্যাগ কনফিগার করে:

gtag('config', 'TAG_ID');

যেখানে "TAG_ID" হল Google ট্যাগের ট্যাগ আইডি ৷

অতিরিক্ত কনফিগার তথ্য কীভাবে পাঠাতে হয় তা প্রদর্শন করতে, এখানে একটি উদাহরণ রয়েছে যা একটি send_page_view প্যারামিটার সহ একটি Analytics অ্যাকাউন্টে ডেটা পাঠাতে একটি ট্যাগ কনফিগার করে যা false মান পাস করে এবং একটি groups প্যারামিটার যা 'agency' এর একটি মান পাস করে।

gtag('config', 'TAG_ID', {
  'send_page_view': false,
  'groups': 'agency'
});

get

আপনাকে set কমান্ডের সাথে সেট করা মান সহ gtag.js থেকে বিভিন্ন মান পেতে অনুমতি দেয়।

gtag('get', '<target>', '<field_name>', callback)

যুক্তি	টাইপ	উদাহরণ	বর্ণনা
<লক্ষ্য>	string	জি-XXXXXXXXXX	থেকে মান আনার লক্ষ্য।
<ক্ষেত্র_নাম>	ক্ষেত্রের নাম	ক্লায়েন্ট_আইডি	মাঠে নামতে হবে।
কলব্যাক	Function	(field) => console.log(field)	একটি ফাংশন যা অনুরোধ করা ফিল্ডের সাথে আহ্বান করা হবে, অথবা এটি সেট না থাকলে undefined ।

ক্ষেত্রের নাম

ক্ষেত্রের নাম আপনি gtag('set') কমান্ড দিয়ে সেট করা একটি কাস্টম ক্ষেত্রের নাম হতে পারে, অথবা নিম্নলিখিত মানগুলির মধ্যে একটি হতে পারে:

ক্ষেত্রের নাম	সমর্থিত টার্গেট
ক্লায়েন্ট_আইডি	Google Analytics 4
সেশন_আইডি	Google Analytics 4
gclid	গুগল বিজ্ঞাপন ফ্লাডলাইট

দ্রষ্টব্য: আপনি যদি এই ক্ষেত্রের নামের সাথে set কমান্ড ব্যবহার করেন, তাহলে আপনার সেট করা মান অগ্রাধিকার পাবে।

উদাহরণ

একটি প্রতিশ্রুতি মধ্যে মান পেতে

const gclidPromise = new Promise(resolve => {
  gtag('get', 'DC-XXXXXXXX', 'gclid', resolve)
});

gclidPromise.then((gclid) => {
  // Do something with gclid...
})

পরিমাপ প্রোটোকল ইভেন্ট পাঠান

gtag('get', 'G-XXXXXXXXXX', 'client_id', (clientID) => {
  sendOfflineEvent(clientID, "tutorial_begin")
});

function sendOfflineEvent(clientID, eventName, eventData) {
  // Send necessary data to your server...
}

আপনি সেট একটি মান পান

gtag('set', {campaign_name: 'Spring_Sale'});

gtag('get', 'G-XXXXXXXXXX', 'campaign_name', (campaign_name) => {
  // Do something with currency value you set earlier.
})

set

সেট কমান্ড আপনাকে প্যারামিটারগুলি সংজ্ঞায়িত করতে দেয় যা পৃষ্ঠার প্রতিটি পরবর্তী ইভেন্টের সাথে যুক্ত হবে।

দ্রষ্টব্য: আমরা যেখানেই সম্ভব config বা event কমান্ড ব্যবহার করার পরামর্শ দিই।

gtag('set', {<parameter-value-pair>, <parameter-value-pair>});

উদাহরণস্বরূপ, আপনি প্রচারাভিযানের পরামিতিগুলি ভাগ করতে পারেন যাতে একই পৃষ্ঠায় একাধিক ট্যাগ দ্বারা অ্যাক্সেস করা যায়।

নীচের উদাহরণটি একটি ব্ল্যাক ফ্রাইডে শপিং ইভেন্টের জন্য একটি প্রচারাভিযানের নাম এবং আইডি সেট করার চিত্র তুলে ধরে। যেহেতু আপনি set ব্যবহার করেছেন, অন্য সব ট্যাগ, যেমন, GA4 ইভেন্ট ট্যাগ বা Google বিজ্ঞাপন রিমার্কেটিং ট্যাগ, এই ডেটা অ্যাক্সেস করতে পারে।

gtag('set', 'campaign', {
  'id': 'abc',
  'source': 'google',
  'name': 'black_friday_promotion',
  'term': 'running+shoes',
});

event

ইভেন্ট ডেটা পাঠাতে event কমান্ড ব্যবহার করুন।

gtag('event', '<event_name>', {<event_params>});

<event_name> হয়:

• একটি প্রস্তাবিত ইভেন্ট । প্রতিটি প্রস্তাবিত ইভেন্ট প্রস্তাবিত প্যারামিটার নিতে পারে।
• একটি কাস্টম ঘটনা. একটি কাস্টম ইভেন্ট হল একটি নির্বিচারে ইভেন্টের নাম যা আপনি নির্বিচারে প্যারামিটার সহ তৈরি করেন। আরও তথ্যের জন্য, ইভেন্ট সেট আপ দেখুন।

<event_params> হল এক বা একাধিক প্যারামিটার-মান জোড়া। প্রতিটি জোড়া একটি কমা দ্বারা পৃথক করা হয়েছে৷

নিম্নলিখিত event কমান্ডটি দুটি পরামিতি সহ প্রস্তাবিত ইভেন্ট screen_view ফায়ার করে: app_name এবং screen_name ।

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

গুরুত্বপূর্ণ: Google ট্যাগ স্নিপেট অবশ্যই একই পৃষ্ঠায়, event কমান্ডের উপরে প্রদর্শিত হবে, নতুবা আপনার ডেটা পাঠানো হবে না।

consent

সম্মতি কনফিগার করতে consent কমান্ড ব্যবহার করুন।

gtag('consent', {<consent_arg>}, {<consent_params>});

এই প্যারামিটারগুলি কনফিগার করা আচরণ সম্পর্কে আরও তথ্যের জন্য সহায়তা কেন্দ্রে সম্মতি দেখুন৷

<consent_arg> হল 'default' বা 'update' এর মধ্যে একটি। ডিফল্ট সম্মতি প্যারামিটার সেট করতে 'default' ব্যবহার করা হয় যেগুলি ব্যবহার করা উচিত এবং 'update' ব্যবহার করা হয় এই প্যারামিটারগুলি আপডেট করার জন্য যখন একজন ব্যবহারকারী তাদের সম্মতি নির্দেশ করে।

নিম্নলিখিত <consent_params> সমর্থিত:

ক্ষেত্রের নাম	অনুমোদিত মান	বর্ণনা
ad_storage	'granted' | 'denied'	সঞ্চয়স্থান সক্ষম করে, যেমন কুকিজ (ওয়েব) বা ডিভাইস শনাক্তকারী (অ্যাপ), বিজ্ঞাপন সম্পর্কিত।
ad_user_data	'granted' | 'denied'	বিজ্ঞাপনের উদ্দেশ্যে Google-এ ব্যবহারকারীর ডেটা পাঠানোর জন্য সম্মতি সেট করে।
ad_personalization	'granted' | 'denied'	ব্যক্তিগতকৃত বিজ্ঞাপনের জন্য সম্মতি সেট করে।
analytics_storage	'granted' | 'denied'	সঞ্চয়স্থান সক্ষম করে, যেমন কুকিজ (ওয়েব) বা অ্যাপ শনাক্তকারী (অ্যাপ), বিশ্লেষণ সম্পর্কিত, যেমন পরিদর্শন সময়কাল।
wait_for_update	যেকোনো ধনাত্মক পূর্ণসংখ্যা	সম্মতি আপডেট কলের জন্য অপেক্ষা করার জন্য মিলিসেকেন্ডে একটি সময় সেট করে।