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

গুগল ট্যাগ (gtag.js) এপিআই-তে gtag() নামে একটিমাত্র ফাংশন রয়েছে, যার সিনট্যাক্সটি নিম্নরূপ:

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

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

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

প্যারামিটার স্কোপ

আপনি প্যারামিটারের মানগুলিকে স্বতন্ত্র ইভেন্টে, একটি নির্দিষ্ট <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 স্কোপের প্যারামিটারের চেয়ে অগ্রাধিকার পাবে, এবং config প্যারামিটারগুলো set ব্যবহার করে গ্লোবালি স্কোপ করা প্যারামিটারগুলোর চেয়ে অগ্রাধিকার পাবে।

// 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

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

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

<TARGET_ID> হলো একটি ট্যাগ আইডি যা শনাক্ত করে gtag.js কোথায় ইভেন্টের ডেটা পাঠাবে। এটি একটি গন্তব্য হতে পারে, যেমন একটি গুগল অ্যানালিটিক্স প্রপার্টি বা একটি গুগল অ্যাডস অ্যাকাউন্ট, অথবা এটি এমন একটি গুগল ট্যাগও হতে পারে যার একাধিক গন্তব্য রয়েছে। <additional_config_info> হলো এক বা একাধিক প্যারামিটার-ভ্যালু পেয়ার।

এই উদাহরণটি একটি গুগল অ্যাডস অ্যাকাউন্টে ডেটা পাঠানোর জন্য একটি ট্যাগ কনফিগার করে:

gtag('config', 'TAG_ID');

যেখানে "TAG_ID" হলো গুগল ট্যাগের ট্যাগ আইডি ।

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

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

get

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

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

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

ফিল্ডের নামটি হতে পারে gtag('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

সেট কমান্ড আপনাকে এমন প্যারামিটার নির্ধারণ করতে দেয় যা পৃষ্ঠার প্রতিটি পরবর্তী ইভেন্টের সাথে যুক্ত থাকবে।

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

উদাহরণস্বরূপ, আপনি ক্যাম্পেইনের প্যারামিটারগুলো শেয়ার করতে পারেন, যাতে একই পেজের একাধিক ট্যাগ থেকে সেগুলো অ্যাক্সেস করা যায়।

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

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 কমান্ডটি app_name এবং screen_name এই দুটি প্যারামিটার সহ প্রস্তাবিত screen_view ইভেন্টটি চালু করে।

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

consent

সম্মতি নির্ধারণ করতে consent কমান্ডটি ব্যবহার করুন।

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

এই প্যারামিটারগুলো যে আচরণ নির্ধারণ করে, সে সম্পর্কে আরও তথ্যের জন্য হেল্প সেন্টারে ‘consent’ দেখুন।

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

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