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

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

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

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

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
  • গুগল বিজ্ঞাপন
  • ফ্লাডলাইট

উদাহরণ

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

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', {currency: 'USD'});

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

set

আপনাকে পৃষ্ঠায় পরবর্তী সমস্ত gtag() কলগুলিতে টিকে থাকা মানগুলি সেট করার অনুমতি দেয়৷

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

<parameter-value-pair> হল একটি মূল নাম এবং মান যা gtag() কল জুড়ে টিকে থাকে। উদাহরণস্বরূপ, নীচের কোডটি পৃষ্ঠার পরবর্তী সমস্ত ইভেন্টের জন্য country মান 'US' এবং currency মান 'USD' এ সেট করে:

gtag('set', {
  'country': 'US',
  'currency': 'USD'
});

set কমান্ড ব্যবহার করে সরাসরি event কমান্ডে মান পাস করা থেকে ভিন্ন। আপনি যখন একটি event কমান্ডে সরাসরি মানগুলি পাস করেন, তখন সেই মানগুলি শুধুমাত্র বহিস্কার করা ইভেন্টে প্রযোজ্য হয়। কিন্তু set সাথে, মান বর্তমান পৃষ্ঠায় টিকে থাকে এবং পরবর্তী সমস্ত ইভেন্টের সাথে পাস করা হয়। ব্যাখ্যা করার জন্য, নিম্নলিখিত দুটি উদাহরণের বিপরীতে:

gtag('event', 'login', {'method': 'Google'});
gtag('event', 'share');

এবং

gtag('set', {'method': 'Google'});
gtag('event', 'login');
gtag('event', 'share');

প্রথম উদাহরণে, login ইভেন্টটি 'Google' এর একটি method মান দিয়ে পাস করা হবে এবং share ইভেন্টটি কোনো প্যারামিটার ছাড়াই পাস করা হবে। দ্বিতীয় উদাহরণে, login এবং share উভয়ই 'Google' এর একটি method মান দিয়ে পাস করা হবে।

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'
});

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

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

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

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

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

ক্ষেত্র নাম অনুমোদিত মান
ad_storage 'granted' | 'denied'
analytics_storage 'granted' | 'denied'
wait_for_update যেকোনো ধনাত্মক পূর্ণসংখ্যা

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

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

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

// Set global currency to Euros
gtag('set', { 'currency': 'EUR' });

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

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

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

// Set global currency to Euros
gtag('set', { 'currency': 'EUR' });

// 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>' });