ইউটিউব বেঞ্চমার্ক, ইউটিউব বেঞ্চমার্ক

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

মূল সক্ষমতা

BenchmarksService এর মাধ্যমে আপনি যা করতে পারেন:

  • পারফরম্যান্স তুলনা করুন : সামগ্রিক শিল্প গড়ের সাথে একজন গ্রাহকের গড় রেট মেট্রিক্স (যেমন CPM, CPV, CTR, এবং ভিউএবিলিটি) মূল্যায়ন করুন।
  • মার্কেট শেয়ার বিশ্লেষণ করুন : শেয়ার অফ ভয়েস (আপেক্ষিক ইম্প্রেশন) এবং শেয়ার অফ স্পেন্ড-এর মাধ্যমে বাজারে একজন গ্রাহকের আপেক্ষিক উপস্থিতি বুঝুন।
  • প্রতিযোগিতামূলক অবস্থান মূল্যায়ন করুন : পার্সেন্টাইল মেট্রিক ব্যবহার করে একজন গ্রাহকের প্রতিযোগিতামূলক অবস্থান পরিমাপ করুন, যা মূল দিকগুলোর ওপর ভিত্তি করে তার কর্মক্ষমতাকে বিভিন্ন প্রতিযোগিতামূলক স্তরে (যেমন মার্কেট লিডার বা প্রতিযোগী ) শ্রেণীবদ্ধ করে।
  • সময় অনুযায়ী বিভাজন করুন : বেঞ্চমার্ক মেট্রিকগুলোকে সাপ্তাহিক, মাসিক বা ত্রৈমাসিক সময়ভিত্তিক ভাগে ভাগ করুন।
  • সমর্থিত বেঞ্চমার্ক ডাইমেনশনগুলো আবিষ্কার করুন : উপলব্ধ তারিখের পরিসর, ভৌগোলিক অবস্থান, বিজ্ঞাপনী পণ্য এবং বেঞ্চমার্কের উৎস (শিল্প খাত বা পণ্য ও পরিষেবার বিভাগ) অনুসন্ধান করুন।

আবিষ্কার পদ্ধতি

বেঞ্চমার্ক মেট্রিক তৈরি করার আগে, আপনার অনুরোধগুলির জন্য বৈধ প্যারামিটার এবং স্কোপিং ক্রাইটেরিয়া পুনরুদ্ধার করতে ডিসকভারি পদ্ধতিগুলি ব্যবহার করুন।

উপলব্ধ তারিখগুলির তালিকা

ListBenchmarksAvailableDates মেথডটি একটি ListBenchmarksAvailableDatesResponse মধ্যে বেঞ্চমার্ক ডেটা সমর্থনকারী ঐতিহাসিক তারিখের পরিসরগুলো ফেরত দেয়।

প্রতিক্রিয়াটি দুটি স্বতন্ত্র তারিখের পরিসর প্রদান করে:

  • supported_dates : সামগ্রিক তারিখের পরিসর যেখানে বেঞ্চমার্ক মেট্রিকগুলো সমর্থিত (অন্তর্ভুক্ত)। বেঞ্চমার্ক অনুরোধগুলো এই পরিসরের মধ্যে থাকা তারিখগুলো কোয়েরি করতে পারে।
  • supported_dates_for_all_metrics ): supported_dates ) একটি উপসেট যা বেঞ্চমার্ক মেট্রিক্সের সম্পূর্ণ সেটকে সমর্থন করে। কিছু নির্দিষ্ট মেট্রিক্স—বিশেষত গ্রাহক শেয়ার মেট্রিক্স ( share_of_voice এবং share_of_spend ) এবং বেঞ্চমার্ক উৎসের গড় হারের মেট্রিক্স—সীমিত ডেটা প্রাপ্যতার কারণে শুধুমাত্র এই তারিখের পরিসরের মধ্যেই পাওয়া যায়। যদি অনুরোধ করা date_range supported_dates_for_all_metrics মধ্যে সম্পূর্ণরূপে না পড়ে, তাহলে এই মেট্রিক্সগুলি প্রতিক্রিয়া থেকে বাদ দেওয়া হয়।

অবস্থানগুলির তালিকা

ListBenchmarksLocations মেথডটি সেইসব ভৌগোলিক অবস্থানের (যেমন দেশ) তালিকা ফেরত দেয়, যেগুলো বেঞ্চমার্ক ডেটা সমর্থন করে।

প্রতিক্রিয়ার প্রতিটি BenchmarksLocation এ অন্তর্ভুক্ত রয়েছে:

  • location_name : ইংরেজিতে স্থানের অনন্য নাম (উদাহরণস্বরূপ, "United States" )।
  • location_type : গুগল অ্যাডস এপিআই-তে target_type সাথে সঙ্গতিপূর্ণ অবস্থানের ধরণ (উদাহরণস্বরূপ, "Country" )।
  • location_info : একটি LocationInfo অবজেক্ট, যাতে ভৌগোলিক লক্ষ্য ধ্রুবকটি থাকে (যেমন geo_target_constant: "geoTargetConstants/2840" )।

পণ্যের তালিকা

ListBenchmarksProducts মেথডটি বেঞ্চমার্কিংয়ের জন্য উপলব্ধ পণ্য এবং বিপণন উদ্দেশ্যগুলোর তালিকা ফেরত দেয়।

প্রতিটি BenchmarksProductMetadata এন্ট্রিতে অন্তর্ভুক্ত থাকে:

  • product_name : পণ্যের ব্যবহার-বান্ধব নাম।
  • product_code : পণ্যের অনন্য শনাক্তকারী স্ট্রিং, যা একটি ProductFilter তৈরি করার সময় ব্যবহৃত হয়।
  • marketing_objective : সংশ্লিষ্ট বিপণনের উদ্দেশ্য ( BenchmarksMarketingObjective ):
    • AWARENESS : ব্র্যান্ড বা পণ্য সম্পর্কে সচেতনতা বৃদ্ধির উদ্দেশ্যে পরিচালিত প্রচার অভিযান।
    • CONSIDERATION : সম্ভাব্য গ্রাহকদের ব্র্যান্ড বা পণ্যগুলো বিবেচনা করতে উৎসাহিত করার উদ্দেশ্যে পরিকল্পিত প্রচারণা।
    • ACTION : একটি নির্দিষ্ট রূপান্তর কার্যক্রম চালনা করার জন্য পরিকল্পিত প্রচারাভিযান।

বেঞ্চমার্কের উৎসগুলির তালিকা দিন

ListBenchmarksSources মেথডটি উপলব্ধ বেঞ্চমার্ক সোর্সগুলো পুনরুদ্ধার করে। BenchmarksSourceType ব্যবহার করে পুনরুদ্ধার করার জন্য সোর্সের প্রকার নির্দিষ্ট করুন:

  • INDUSTRY_VERTICAL : শিল্প খণ্ডের শ্রেণিবিভাগ (উদাহরণস্বরূপ, "প্রযুক্তি" বা "অর্থ" )।
  • CATEGORY : পণ্য ও পরিষেবার ক্যাটাগরি (উদাহরণস্বরূপ, "/পোশাক/বস্ত্র" )। সমস্ত বিজ্ঞাপনদাতাদের সাথে তুলনা করার সময় বেঞ্চমার্কিংয়ের পরিধি নির্ধারণ করতে ক্যাটাগরিগুলোকে ফিল্টার হিসেবে ব্যবহার করা যেতে পারে।

প্রতিক্রিয়াটি BenchmarksSourceMetadata অবজেক্টের একটি তালিকা ফেরত দেয়, যার মধ্যে নিম্নলিখিতগুলির যেকোনো একটি থাকে:

  • IndustryVerticalInfo : এতে industry_vertical_name , industry_vertical_id , এবং parent_industry_vertical_id (যদি প্রযোজ্য হয়) থাকে।
  • CategoryInfo : এতে category_name , category_id , এবং category_path (সম্পূর্ণ ক্যাটাগরি স্তরবিন্যাস) থাকে।

বেঞ্চমার্ক মেট্রিক তৈরি করুন

কোনো গ্রাহকের ইউটিউব বিজ্ঞাপনের মেট্রিকসকে ইন্ডাস্ট্রির বেঞ্চমার্কের সাথে তুলনা করতে GenerateBenchmarksMetrics কল করুন।

অনুরোধের পরামিতি

একটি GenerateBenchmarksMetricsRequest বিশ্লেষণের পরিধি নির্ধারণ করে। ন্যূনতমপক্ষে, আপনাকে অবশ্যই একটি ক্লায়েন্ট customer_id , ভৌগোলিক location , একটি benchmarks_source (যেমন একটি নির্দিষ্ট শিল্প খাত বা category_filter দ্বারা নির্ধারিত সমস্ত বিজ্ঞাপনদাতা), এবং একটি product_filter উল্লেখ করতে হবে। আপনি ঐচ্ছিকভাবে একটি date_range প্রদান করতে পারেন, একটি breakdown_definition ব্যবহার করে মেট্রিকগুলোকে গ্রুপ করতে পারেন, একটি currency_code উল্লেখ করতে পারেন, অথবা supplemental_data মাধ্যমে PERCENTILE_DATA মতো অতিরিক্ত ফিচারের জন্য অনুরোধ করতে পারেন।

প্যারামিটারের সম্পূর্ণ সংজ্ঞা ও প্রয়োজনীয়তার জন্য, GenerateBenchmarksMetricsRequest রেফারেন্স ডকুমেন্টেশনটি দেখুন।

তারিখের বিভাজন

আপনি BenchmarksTimeGranularity ব্যবহার করে breakdown_definition.date_breakdown সেট করার মাধ্যমে মেট্রিকগুলোকে গ্রুপ করতে পারেন:

  • WEEK : সপ্তাহ অনুযায়ী মেট্রিকসমূহ একত্রিত করে। date_range অবশ্যই রবিবারে শুরু হয়ে শনিবারে শেষ হতে হবে (উল্লেখ্য যে, এটি ISO 8601 থেকে ভিন্ন)।
  • MONTH : মাস অনুযায়ী মেট্রিকগুলো একত্রিত করে। date_range অবশ্যই মাসের প্রথম দিন থেকে শুরু হয়ে মাসের শেষ দিনে শেষ হতে হবে।
  • QUARTER : ক্যালেন্ডার ত্রৈমাসিক অনুসারে মেট্রিকসমূহ একত্রিত করে। date_range অবশ্যই ত্রৈমাসিকের প্রথম দিন থেকে শুরু হয়ে ত্রৈমাসিকের শেষ দিনে শেষ হতে হবে।

প্রতিক্রিয়া মেট্রিক্স

GenerateBenchmarksMetricsResponse ফেরত দেয়:

  • customer_metrics : গ্রাহকের ইউটিউব বিজ্ঞাপনের পারফরম্যান্সের মেট্রিকস, যার মধ্যে রয়েছে average_rate_metrics , share_metrics , aggregate_metrics , এবং percentile_metrics ।
  • average_benchmarks_metrics : নির্বাচিত বেঞ্চমার্ক উৎস জুড়ে সমষ্টিগত হার মেট্রিক্স ( RateMetrics )।
  • breakdown_metrics : breakdown_definition এ সংজ্ঞায়িত বিভাজন অনুসারে বিভক্ত মেট্রিকগুলোর একটি তালিকা।

ফিল্ডের সম্পূর্ণ বিবরণের জন্য, GenerateBenchmarksMetricsResponse রেফারেন্স ডকুমেন্টেশন দেখুন।

শতাংশ মেট্রিক্স

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

পূর্বশর্ত

পার্সেন্টাইল মেট্রিক্স পুনরুদ্ধার করতে, আপনার অনুরোধকে অবশ্যই নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:

  1. বেঞ্চমার্কের উৎস : benchmarks_source অবশ্যই all_advertisers = true নির্বাচন করতে হবে।
  2. ক্যাটাগরি ফিল্টার : category_filter অবশ্যই প্রদান করতে হবে, যাতে ListBenchmarksSources থেকে সংগৃহীত এক বা একাধিক বৈধ category_ids থাকবে।
  3. অতিরিক্ত ডেটা : আপনাকে অবশ্যই GenerateBenchmarksMetricsRequest এর supplemental_data ফিল্ডে PERCENTILE_DATA যোগ করতে হবে।

শতাংশ স্তর

একজন গ্রাহকের পারফরম্যান্সকে BenchmarksCustomerPercentileTier enum ভ্যালুগুলোর মধ্যে একটিতে শ্রেণীবদ্ধ করা হয় (যা নিম্ন স্তরের জন্য DEVELOPING থেকে শুরু করে শীর্ষ-পারফর্মিং বিজ্ঞাপনদাতাদের জন্য MARKET_LEADER পর্যন্ত বিস্তৃত)। প্রতিটি স্তর এবং এর পার্সেন্টাইল সীমানার বিবরণের জন্য, BenchmarksCustomerPercentileTier রেফারেন্স ডকুমেন্টেশন দেখুন।

উদাহরণ অনুরোধ

নিম্নলিখিত উদাহরণটি একটি REST JSON অনুরোধ পেলোড প্রদর্শন করে, যা একজন ব্যবহারকারীর জন্য পার্সেন্টাইল স্তর সহ বেঞ্চমার্ক মেট্রিক্স তৈরি করে, যেখানে তিনি /Apparel/Clothing ক্যাটাগরিতে বিজ্ঞাপন চালানো অন্যান্য বিজ্ঞাপনদাতাদের সাথে তার গ্রাহকের ইউটিউব বিজ্ঞাপনের পারফরম্যান্সের তুলনা করেন:

{
  "customer_id": "1234567890",
  "location": {
    "geo_target_constant": "geoTargetConstants/2840"
  },
  "benchmarks_source": {
    "all_advertisers": true
  },
  "category_filter": {
    "category_ids": ["10176"]
  },
  "product_filter": {
    "marketing_objective_list": {
      "marketing_objectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplemental_data": [
    "PERCENTILE_DATA"
  ]
}

অনুরোধ করা অতিরিক্ত পার্সেন্টাইল ডেটা সহ প্রতিক্রিয়া:

{
  "customer_metrics": {
    "average_rate_metrics": {
      "average_cpm": 5.42,
      "click_through_rate": 0.0185
    },
    "share_metrics": {
      "share_of_voice": 0.0345,
      "share_of_spend": 0.0410
    },
    "aggregate_metrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentile_metrics": {
      "cost_percentile_tier": "STRONG_COMPETITOR",
      "impressions_percentile_tier": "STRONG_COMPETITOR",
      "clicks_percentile_tier": "MARKET_LEADER",
      "video_trueview_views_percentile_tier": "COMPETITOR",
      "viewable_impressions_percentile_tier": "STRONG_COMPETITOR",
      "interactions_percentile_tier": "MARKET_LEADER",
      "engagements_percentile_tier": "COMPETITOR"
    }
  },
  "average_benchmarks_metrics": {
    "average_rate_metrics": {
      "average_cpm": 6.15,
      "click_through_rate": 0.0142
    }
  }
}

ত্রুটি পরিচালনা

BenchmarksService কল করার সময়, আপনি BenchmarksError এ বেঞ্চমার্ক কোয়েরি-সম্পর্কিত নির্দিষ্ট ত্রুটির সম্মুখীন হতে পারেন:

  • MAX_QUERY_COMPLEXITY_EXCEEDED : অনুরোধকৃত ইনপুটগুলির সংমিশ্রণ প্রক্রিয়াকরণের জন্য খুব জটিল। কোয়েরির জটিলতা কমাতে:
    • আরও সুনির্দিষ্ট বা সূক্ষ্ম বেঞ্চমার্ক উৎস বা বিভাগ ফিল্টার নির্বাচন করুন।
    • অনুরোধকৃত date_range সংক্ষিপ্ত করুন।
    • product_filter এ পণ্যের সংখ্যা কমান।
  • NO_METRICS_FOUND : অনুরোধকৃত ইনপুটগুলোর সমন্বয়ের জন্য কোনো মেট্রিক্স খুঁজে পাওয়া যায়নি (উদাহরণস্বরূপ, একটি নির্দিষ্ট অবস্থান এবং তারিখের পরিসরের মধ্যে একটি বিশেষ ক্যাটাগরি যেখানে কোনো বিজ্ঞাপনদাতা ক্যাম্পেইন চালায়নি)। ক্যাটাগরি, অবস্থান, তারিখের পরিসর বা প্রোডাক্টগুলো পরিবর্তন করে দেখুন।

সাধারণ API ত্রুটি পরিচালনা এবং সর্বোত্তম অনুশীলন সম্পর্কে জানতে, ত্রুটি পরিচালনা নির্দেশিকাটি দেখুন।

পূর্ববর্তী
YouTube নির্মাতার অন্তর্দৃষ্টি