একটি পৃথক মেনু হিসাবে Google Ads UI-তে উপলব্ধ সেগমেন্টেশন, শুধুমাত্র একটি কোয়েরিতে সঠিক ক্ষেত্র যোগ করে Google Ads API-এ প্রয়োগ করা যেতে পারে। উদাহরণস্বরূপ, একটি ক্যোয়ারীতে segments.device
যোগ করার ফলে, ডিভাইসের প্রতিটি সংমিশ্রণের জন্য একটি সারি সহ একটি প্রতিবেদন এবং FROM
ক্লজে নির্দিষ্ট সংস্থান এবং পরিসংখ্যানগত মানগুলি (ইমপ্রেশন, ক্লিক, রূপান্তর ইত্যাদি) তাদের মধ্যে বিভক্ত হয়৷
Google Ads UI-তে একবারে শুধুমাত্র একটি সেগমেন্ট ব্যবহার করা যেতে পারে, API-এর সাহায্যে আপনি একই কোয়েরিতে একাধিক সেগমেন্ট উল্লেখ করতে পারেন।
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions
FROM campaign
GoogleAdsService.SearchStream
এ এই ক্যোয়ারী পাঠানোর ফলাফল এই JSON স্ট্রিং এর মত দেখতে হবে:
{
"results":[
{
"campaign":{
"resourceName":"customers/1234567890/campaigns/111111111",
"name":"Test campaign",
"status":"ENABLED"
},
"metrics":{
"impressions":"10922"
},
"segments":{
"device":"MOBILE"
}
},
{
"campaign":{
"resourceName":"customers/1234567890/campaigns/111111111",
"name":"Test campaign",
"status":"ENABLED"
},
"metrics":{
"impressions":"28297"
},
"segments":{
"device":"DESKTOP"
}
},
...
]
}
উল্লেখ্য যে উপরের নমুনা ফলাফলে, সম্পদের নাম সহ প্রথম এবং দ্বিতীয় অবজেক্টের বৈশিষ্ট্যগুলি একই। ইমপ্রেশনগুলি ডিভাইস দ্বারা বিভক্ত করা হয় এবং এইভাবে একই প্রচারাভিযানের জন্য দুই বা ততোধিক বস্তু ফেরত দেওয়া যেতে পারে।
অন্তর্নিহিত বিভাজন
প্রতিটি প্রতিবেদন প্রাথমিকভাবে FROM
ধারায় নির্দিষ্ট করা সম্পদ দ্বারা বিভক্ত করা হয়। FROM
ক্লজে রিসোর্সের রিসোর্স_নাম ক্ষেত্রটি ফেরত দেওয়া হয় এবং মেট্রিকগুলি এটি দ্বারা বিভক্ত করা হয়, এমনকি যখন resource_name ক্ষেত্রটি কোয়েরিতে স্পষ্টভাবে অন্তর্ভুক্ত করা হয় না। উদাহরণ স্বরূপ, আপনি যখন FROM
ক্লজে ad_group
রিসোর্স হিসেবে উল্লেখ করেন, তখন ad_group.resource_name
স্বয়ংক্রিয়ভাবে ফিরে আসবে এবং মেট্রিকগুলি ad_group স্তরে এর বিপরীতে বিভক্ত হবে।
তাই এই প্রশ্নের জন্য,
SELECT metrics.impressions
FROM ad_group
আপনি এই মত একটি JSON স্ট্রিং পাবেন:
{
"results":[
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/2222222222"
},
"metrics":{
"impressions":"237"
}
},
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/33333333333"
},
"metrics":{
"impressions":"15"
}
},
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/44444444444"
},
"metrics":{
"impressions":"0"
}
}
]
}
মনে রাখবেন যে adGroup
এর resource_name
ক্ষেত্রটি সর্বদা ফেরত দেওয়া হয় কারণ ad_group
FROM
ক্লজে একটি সংস্থান হিসাবে নির্দিষ্ট করা হয়েছিল।
নির্বাচনযোগ্য সেগমেন্ট ক্ষেত্র
FROM
ধারায় প্রদত্ত সংস্থানের জন্য সমস্ত সেগমেন্ট ক্ষেত্র নির্বাচনযোগ্য নয়। উদাহরণ হিসেবে, আমরা ad_group
রিসোর্স থেকে অনুসন্ধান চালিয়ে যাব। একটি সেগমেন্ট ক্ষেত্র যাতে ad_group রিসোর্স থেকে নির্বাচন করা যায়, সেই ক্ষেত্রটি ad_group-এর Segments
তালিকায় থাকা প্রয়োজন। Segments
তালিকা হল ad_group
রিসোর্সের মেটাডেটা পৃষ্ঠায় উপলব্ধ ফিল্ড টেবিলের হলুদ অংশ।
সেগমেন্ট সম্পদ
কিছু রিসোর্স থেকে নির্বাচন করার সময়, আপনার কাছে FROM
ক্লজে রিসোর্সের ক্ষেত্রগুলির পাশাপাশি তাদের ক্ষেত্রগুলি নির্বাচন করে সম্পর্কিত সংস্থানগুলিতে অন্তর্নিহিতভাবে যোগদান করার বিকল্প থাকতে পারে। এই সম্পর্কিত সংস্থানগুলি FROM
ক্লজের মেটাডেটা পৃষ্ঠায় সংস্থানের Attributed Resources
তালিকায় পাওয়া যেতে পারে। ad_group
রিসোর্সের ক্ষেত্রে, আপনি দেখতে পাবেন যে আপনি campaign
রিসোর্স থেকেও ক্ষেত্র নির্বাচন করতে পারেন। SELECT
ক্লজে কমপক্ষে 1টি ক্ষেত্র সহ যেকোন Attributed Resources
resource_name ক্ষেত্রটি স্বয়ংক্রিয়ভাবে ফেরত দেওয়া হবে, এমনকি যখন resource_name ক্ষেত্রটি ক্যোয়ারীতে স্পষ্টভাবে অন্তর্ভুক্ত করা হয় না।
Attributed Resource
ক্ষেত্র নির্বাচন করার মতো, আপনি Segmenting Resource
ক্ষেত্রগুলিও নির্বাচন করতে পারেন। যদি একটি প্রদত্ত সংস্থানটির মেটাডেটা পৃষ্ঠায় একটি Segmenting Resources
তালিকা থাকে, তাহলে তালিকাভুক্ত সংস্থানগুলির মধ্যে একটি থেকে ক্ষেত্রগুলি নির্বাচন করা হলে সেই Segmenting Resource
ফেরত দেওয়া resource_name দ্বারা কোয়েরিটিকে আরও বিভক্ত করা হবে। একটি উদাহরণ হিসাবে, আপনি দেখতে পাবেন যে campaign
সংস্থানটি campaign_budget
সংস্থানের জন্য একটি Segmenting Resource
হিসাবে তালিকাভুক্ত। ক্যাম্পেইন_বাজেট রিসোর্স থেকে যে কোনো প্রচারাভিযান ক্ষেত্র, যেমন campaign.name
নির্বাচন করা হলে তা শুধুমাত্র Campaign.name ক্ষেত্রটিকেই ফেরত দেবে না, কিন্তু campaign.resource_name
ক্ষেত্রটিকে ফেরত এবং বিভক্ত করার কারণ হবে৷
বিভাগ এবং মেট্রিক্সের মধ্যে নির্বাচনযোগ্যতা
একটি প্রদত্ত সেগমেন্ট ক্ষেত্র অন্য কিছু সেগমেন্ট ক্ষেত্রের সাথে বা কিছু মেট্রিক্স ক্ষেত্রের সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে৷ কোন সেগমেন্ট ক্ষেত্র একে অপরের সাথে সামঞ্জস্যপূর্ণ তা সনাক্ত করতে, আপনি SELECT
ক্লজে সেগমেন্টের selectable_with
তালিকা পর্যালোচনা করতে পারেন।
ad_group
রিসোর্সের ক্ষেত্রে, 50+ উপলভ্য সেগমেন্ট আছে যা আপনি নির্বাচন করতে পারেন। যাইহোক, segments.hotel_check_in_date
এর জন্য selectable_with
তালিকাটি সামঞ্জস্যপূর্ণ সেগমেন্টের অনেক ছোট সেট। এর মানে হল আপনি যদি segments.hotel_check_in_date
ক্ষেত্রটি SELECT
ক্লজে যোগ করেন, তাহলে আপনি এই দুটি তালিকার ছেদকে বেছে নেওয়ার জন্য রেখে যাওয়া উপলব্ধ অংশগুলিকে সীমাবদ্ধ করবেন।
- কিছু সেগমেন্ট যোগ করার সময়, সারাংশের সারির মেট্রিক কমে যেতে পারে
- যখন
segments.keyword.info.match_type
FROM ad_group_ad
সাথে একটি ক্যোয়ারীতে যোগ করা হয়, সেই সেগমেন্টটি ক্যোয়ারীকে বলছে শুধুমাত্র সেই ডেটার সারিগুলি পেতে যাতে কীওয়ার্ড আছে, এবং কোনও কীওয়ার্ডের সাথে যুক্ত নয় এমন কোনও সারি সরিয়ে ফেলতে৷ এই ক্ষেত্রে, মেট্রিকগুলি কম হবে কারণ এটি কোনও নন-কীওয়ার্ড মেট্রিকগুলিকে বাদ দেবে৷
WHERE ক্লজে সেগমেন্টের নিয়ম
যখন একটি সেগমেন্ট WHERE
ক্লজে থাকে, তখন সেটিকে SELECT
ক্লজেও থাকতে হবে। এই নিয়মের ব্যতিক্রম হল নিম্নলিখিত তারিখের বিভাগ, যেগুলিকে মূল তারিখ বিভাগ হিসাবে উল্লেখ করা হয়:
-
segments.date
-
segments.week
-
segments.month
-
segments.quarter
-
segments.year
মূল তারিখ সেগমেন্ট ক্ষেত্রের নিয়ম
বিভাগগুলি segments.date
, segments.week
, segments.month
, segments.quarter
, এবং segments.year
ফাংশন নিম্নরূপ:
এই বিভাগগুলি
SELECT
ক্লজে উপস্থিত না হয়েWHERE
ক্লজে ফিল্টার করা যেতে পারে।যদি এই বিভাগগুলির মধ্যে যেকোনটি
SELECT
ক্লজে থাকে, তবে মূল তারিখের অংশগুলি নিয়ে গঠিত একটি সীমিত তারিখের পরিসর অবশ্যইWHERE
ক্লজে নির্দিষ্ট করতে হবে (তারিখ বিভাগগুলিকেSELECT
তে নির্দিষ্ট করা একই হতে হবে না)।
উদাহরণ
অবৈধ: যেহেতু segments.date SELECT ক্লজে রয়েছে, তাই আপনাকে একটি segments.date , segments.week , segments.month , segments.quarter , বা segments.year এর জন্য WHERE ক্লজে একটি নির্দিষ্ট তারিখের সীমা নির্দিষ্ট করতে হবে। | SELECT campaign.name, metrics.clicks, segments.date FROM campaign |
বৈধ: এই ক্যোয়ারীটি প্রচারাভিযানের নাম এবং তারিখের সীমার মধ্যে সংগৃহীত ক্লিকগুলি প্রদান করে৷ মনে রাখবেন segments.date এর SELECT ক্লজে উপস্থিত হওয়ার প্রয়োজন নেই। | SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
বৈধ: এই ক্যোয়ারীটি তারিখের পরিসরে সমস্ত দিনের জন্য তারিখ দ্বারা বিভক্ত প্রচারাভিযানের নাম এবং ক্লিকগুলি প্রদান করে৷ | SELECT campaign.name, metrics.clicks, segments.date FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
বৈধ: এই ক্যোয়ারীটি তারিখ সীমার সমস্ত দিনের জন্য মাস অনুসারে বিভক্ত প্রচারাভিযানের নাম এবং ক্লিকগুলি প্রদান করে৷ | SELECT campaign.name, metrics.clicks, segments.month FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
বৈধ: এই ক্যোয়ারী বছরের পরিসরের সমস্ত মাসের জন্য ত্রৈমাসিক এবং তারপর মাসে দ্বারা বিভক্ত প্রচারাভিযানের নাম এবং ক্লিকগুলি প্রদান করে৷ | SELECT campaign.name, metrics.clicks, segments.quarter, segments.month FROM campaign WHERE segments.year > 2015 AND segments.year < 2020 |
সার্চ_টার্ম_ভিউ
মনে রাখবেন যে search_term_view
রিসোর্সের জন্য, এটি শুধুমাত্র একটি সার্চ টার্ম নয়, এটির রিসোর্স নামের গঠন দ্বারা প্রতিফলিত হয়, যেটিতে বিজ্ঞাপন গোষ্ঠীও অন্তর্ভুক্ত থাকে। অতএব, আপনি কিছু আপাতদৃষ্টিতে ডুপ্লিকেট সারি পাবেন যেখানে একই সার্চ টার্মগুলি আপনার ফলাফলে প্রদর্শিত হবে যখন বাস্তবে, সারিগুলি একটি ভিন্ন বিজ্ঞাপন গোষ্ঠীর অন্তর্গত হবে:
{
"results":[
{
"searchTermView":{
"resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
"searchTerm":"google photos"
},
"metrics":{
"impressions":"3"
},
"segments":{
"date":"2015-06-15"
}
},
{
"searchTermView":{
"resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
"searchTerm":"google photos"
},
"metrics":{
"impressions":"2"
},
"segments":{
"date":"2015-06-15"
}
}
]
}
যদিও এই উদাহরণে দুটি প্রত্যাবর্তিত বস্তু সদৃশ বলে মনে হচ্ছে, তবে তাদের সংস্থানের নামগুলি আসলে আলাদা, বিশেষ করে "বিজ্ঞাপন গোষ্ঠী" অংশে৷ এর মানে হল যে অনুসন্ধান শব্দটি "গুগল ফটো" একই তারিখে (2015-06-15) দুটি বিজ্ঞাপন গোষ্ঠীতে (আইডি 2222222222
এবং 33333333333
) দায়ী করা হয়েছে৷ সুতরাং, আমরা উপসংহারে পৌঁছাতে পারি যে API উদ্দেশ্য হিসাবে কাজ করেছে এবং এই ক্ষেত্রে সদৃশ বস্তু ফেরত দেয়নি।