সেগমেন্টেশন

একটি পৃথক মেনু হিসাবে 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 > '2024-01-01'
  AND segments.date < '2024-02-01'
বৈধ: এই ক্যোয়ারীটি তারিখের পরিসরে সমস্ত দিনের জন্য তারিখ দ্বারা বিভক্ত প্রচারাভিযানের নাম এবং ক্লিকগুলি প্রদান করে৷ 
SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'
বৈধ: এই ক্যোয়ারীটি তারিখ সীমার সমস্ত দিনের জন্য মাস অনুসারে বিভক্ত প্রচারাভিযানের নাম এবং ক্লিকগুলি প্রদান করে৷ 
SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'
বৈধ: এই ক্যোয়ারী বছরের পরিসরের সমস্ত মাসের জন্য ত্রৈমাসিক এবং তারপর মাসে দ্বারা বিভক্ত প্রচারাভিযানের নাম এবং ক্লিকগুলি প্রদান করে৷ 
SELECT
  campaign.name,
  metrics.clicks,
  segments.quarter,
  segments.month
FROM campaign
WHERE segments.year > 2019
  AND segments.year < 2024

সার্চ_টার্ম_ভিউ

মনে রাখবেন যে search_term_view রিসোর্সের জন্য, এটি শুধুমাত্র একটি সার্চ টার্ম নয়, এটির রিসোর্স নামের গঠন দ্বারা প্রতিফলিত হয়, যেটিতে বিজ্ঞাপন গোষ্ঠীও অন্তর্ভুক্ত থাকে। অতএব, আপনি কিছু আপাতদৃষ্টিতে ডুপ্লিকেট সারি পাবেন যেখানে একই সার্চ টার্মগুলি আপনার ফলাফলে প্রদর্শিত হবে যখন বাস্তবে, সারিগুলি একটি ভিন্ন বিজ্ঞাপন গোষ্ঠীর অন্তর্গত হবে: 

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2024-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2024-06-15"
      }
    }
  ]
}

যদিও এই উদাহরণে দুটি প্রত্যাবর্তিত বস্তু সদৃশ বলে মনে হচ্ছে, তবে তাদের সংস্থানের নামগুলি আসলে আলাদা, বিশেষ করে "বিজ্ঞাপন গোষ্ঠী" অংশে৷ এর অর্থ হল "গুগল ফটো" অনুসন্ধান শব্দটি একই তারিখে (2024-06-15) দুটি বিজ্ঞাপন গোষ্ঠীতে (আইডি 2222222222 এবং 33333333333 ) দায়ী করা হয়েছে৷ সুতরাং, আমরা উপসংহারে পৌঁছাতে পারি যে API উদ্দেশ্য হিসাবে কাজ করেছে এবং এই ক্ষেত্রে সদৃশ বস্তু ফেরত দেয়নি।

পূর্ববর্তী
মানদণ্ড মেট্রিক্স
পরবর্তী
জিরো মেট্রিক্স