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

Google ট্যাগ (gtag.js) API-তে একটিই ফাংশন, gtag(), থাকে, যার সিনট্যাক্স হল:

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

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

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

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

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

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

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

<TARGET_ID> সম্পর্কে গুরুত্বপূর্ণ পয়েন্ট:

  • gtag('config', <TARGET_ID>, ...) কমান্ডে <TARGET_ID> হল একটি ট্যাগ আইডি যা শনাক্ত করে যে gtag.js-এর কোথায় ইভেন্ট ডেটা পাঠানো উচিত। এটি Google Analytics প্রপার্টি, Google Ads অ্যাকাউন্ট, Floodlight কনফিগারেশন বা একাধিক ডেস্টিনেশন আছে এমন Google ট্যাগের মতো কোনও ডেস্টিনেশন হতে পারে।

  • ট্যাগ আইডি—যেমন GT-XXXXXX, G-XXXXXX বা AW-YYYYYY—হল আপনার Google ট্যাগের একটি শনাক্তকারী। Google ট্যাগ লোড করতে, আপনি এই আইডি আপনার ওয়েবসাইট কোডে যোগ করেন।

  • একাধিক গন্তব্যে ডেটা পাঠানোর জন্য একটি Google ট্যাগ (ট্যাগ আইডি দ্বারা শনাক্ত করা হয়) কনফিগার করা যেতে পারে। যদিও কিছু ট্যাগ আইডি ডেস্টিনেশন আইডির মতো দেখতে হতে পারে, যেমন Google Analytics প্রপার্টির জন্য G-XXXXXX বা Google Ads অ্যাকাউন্টের জন্য AW-YYYYYY, config কমান্ডে <TARGET_ID> বলতে পৃষ্ঠায় লোড হওয়া Google ট্যাগের নির্দিষ্ট ইনস্ট্যান্সকে বোঝায়।

  • gtag('config', ...) কমান্ডটি নির্দিষ্ট <TARGET_ID>-এর সাথে যুক্ত Google ট্যাগের আচরণ কনফিগার করে। স্ক্রিপ্ট src-এ অন্তর্ভুক্ত ট্যাগ আইডি সাধারণত Google ট্যাগ লোড করলেও, আপনি gtag('config') কমান্ডে আপনার অ্যাকাউন্টের সাথে যুক্ত যেকোনও সঠিক ট্যাগ আইডি ব্যবহার করতে পারবেন।

  • একটি Google ট্যাগের সাথে একাধিক ট্যাগ আইডি যুক্ত থাকতে পারে, সাধারণত ট্যাগ মার্জ করার কারণে এটি হয়। Google ট্যাগ লোড করার জন্য স্ক্রিপ্ট src প্যারামিটারে এইসব সংশ্লিষ্ট আইডির যেকোনও একটি ব্যবহার করা যেতে পারে।

  • আপনি একাধিক গন্তব্যে ডেটা পাঠালে বা একাধিক ট্যাগ ব্যবহার করলে, স্ক্রিপ্ট src-এ একটি ট্যাগ আইডি সহ শুধুমাত্র একটি Google ট্যাগ স্নিপেট যোগ করলেই হবে। তারপর আপনি প্রতিটি অতিরিক্ত ট্যাগ আইডি বা গন্তব্যের জন্য একটি gtag('config') কমান্ড অন্তর্ভুক্ত করেন।

<additional_config_info> হল এক বা একাধিক প্যারামিটার-ভ্যালু পেয়ার।

এই উদাহরণে Google Ads অ্যাকাউন্টে ডেটা পাঠানোর জন্য ট্যাগ কনফিগার করা হয়েছে:

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)
আর্গুমেন্ট ধরন উদাহরণ বিবরণ
<target> string G-XXXXXXXXXX

যে টার্গেট থেকে ভ্যালু ফেচ করতে হবে।
<field_name> FieldName client_id যে ফিল্ড পেতে চান তার নাম।
কলব্যাক Function (field) => console.log(field)

একটি ফাংশন যা অনুরোধ করা ফিল্ডের সাথে বা undefined যদি এটি সেট না করা থাকে তাহলে চালু করা হবে।

FieldName

ফিল্ডের নাম, gtag('set') কমান্ডের মাধ্যমে সেট করা কাস্টম ফিল্ডের নাম অথবা নিম্নলিখিত ভ্যালুর মধ্যে যেকোনও একটি হতে পারে:

ফিল্ডের নাম যেসব টার্গেটে কাজ করে
client_id
  • Google Analytics 4
session_id
  • Google Analytics 4
session_number
  • Google Analytics 4
gclid
  • Google Ads
  • Floodlight

উদাহরণ

Promise-এ ভ্যালু পাওয়া 

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

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

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

যেমন, আপনি ক্যাম্পেন প্যারামিটার শেয়ার করতে পারেন যাতে একই পৃষ্ঠায় একাধিক ট্যাগ সেগুলি অ্যাক্সেস করতে পারে।

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

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

সম্মতি কনফিগার করতে 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 যেকোনও পজিটিভ ইন্টিজার সম্মতি আপডেট কলের জন্য অপেক্ষা করতে মিলিসেকেন্ডে সময় সেট করে।