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

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

gtag(<command>, <command parameters>);
  • <command> হলো নিম্নলিখিত কমান্ডগুলোর মধ্যে একটি:
  • <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('config', <TARGET_ID>, ...) কমান্ডের মধ্যে থাকা <TARGET_ID> হলো একটি ট্যাগ আইডি, যা শনাক্ত করে gtag.js কোথায় ইভেন্টের ডেটা পাঠাবে। এটি একটি গন্তব্য হতে পারে, যেমন একটি গুগল অ্যানালিটিক্স প্রপার্টি, একটি গুগল অ্যাডস অ্যাকাউন্ট, একটি ফ্ল্যাডলাইট কনফিগারেশন, অথবা এমন একটি গুগল ট্যাগ যার একাধিক গন্তব্য রয়েছে।

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

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

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

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

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

<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)
যুক্তি প্রকার উদাহরণ বর্ণনা
<লক্ষ্য> string জি-XXXXXXXXXX

যেখান থেকে মানগুলি সংগ্রহ করতে হবে সেই লক্ষ্যবস্তু।

<ক্ষেত্রের নাম> ক্ষেত্রের নাম ক্লায়েন্ট_আইডি যে ফিল্ডটি পেতে হবে তার নাম।
কলব্যাক Function (field) => console.log(field)

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

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

ফিল্ডের নামটি হতে পারে 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 কমান্ডটি ব্যবহার করুন। 

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

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

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

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

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