ভিডিও ক্যাম্পেন

ভিডিও ক্যাম্পেন আপনাকে YouTube এবং Google-এর ভিডিও পার্টনারদের ওয়েবসাইট ও অ্যাপ জুড়ে ভিডিও বিজ্ঞাপন দেখানোর সুবিধা দেয়।

API সংক্রান্ত সীমাবদ্ধতা

Google Ads API মূলত আগে থেকে থাকা ভিডিও ক্যাম্পেন, বিজ্ঞাপন গ্রুপ, বিজ্ঞাপন ও মাপকাঠি ফেচ করা ও রিপোর্ট করার ক্ষেত্রে সাহায্য করে। Google Ads API ব্যবহার করে ভিডিও ক্যাম্পেন তৈরি বা মিউটেট করা যায় না, তবে নিম্নলিখিত ভার্সন-নির্দিষ্ট ব্যতিক্রম ও আচরণ এর মধ্যে পড়ে না:

• VideoResponsiveAdInfo পরিবর্তনযোগ্যতা: v24 থেকে শুরু করে, VideoResponsiveAdInfo অবজেক্ট পরিবর্তনযোগ্য (আগের ভার্সনে, সেগুলি পরিবর্তনযোগ্য নয়)। VideoResponsiveAdInfo তৈরি বা মিউটেট করার সময়, videos, business_name এবং logo_images ফিল্ড প্রয়োজন।
• ব্র্যান্ডের নিরাপত্তা সংক্রান্ত উপযুক্ততা: v24 থেকে শুরু করে, ক্যাম্পেন-লেভেল campaign.video_brand_safety_suitability সরিয়ে দেওয়া হয়েছে। customer.video_brand_safety_suitability ব্যবহার করে অ্যাকাউন্ট লেভেলে ব্র্যান্ডের নিরাপত্তা উপযুক্ততা কোয়েরি করুন।
• ভিডিও ক্যাম্পেন এক্সপেরিমেন্ট: v24 থেকে শুরু করে, experiment.video_experiment কনফিগার করার জন্য উপলভ্য YOUTUBE_CUSTOM ভিডিও ক্যাম্পেন নিয়ে গঠিত এক্সপেরিমেন্ট।

ক্যাম্পেন ম্যানেজমেন্টের বিকল্প

প্রোগ্রাম্যাটিক্যালি ভিডিও ক্যাম্পেন তৈরি বা ম্যানেজ করতে হলে, নিম্নলিখিত বিকল্পগুলি বিবেচনা করুন:

• Google Ads স্ক্রিপ্ট: আপনি Google Ads স্ক্রিপ্ট ব্যবহার করে ভিডিও ক্যাম্পেন ম্যানেজ করতে পারবেন। এটি Google Ads ইন্টারফেসের মধ্যে অটোমেটিক ম্যানেজমেন্টের সুবিধা দেয়।
• ডিমান্ড জেনারেশন ক্যাম্পেন: আপনার লক্ষ্য যদি YouTube সহ Google-এর বিভিন্ন প্রপার্টিতে ভিডিও বিজ্ঞাপন দেখানো হয়, তাহলে Google Ads API-তে ডিমান্ড জেনারেশন ক্যাম্পেন তৈরি ও ম্যানেজ করার সম্পূর্ণ সুবিধা পাবেন।

পারফর্ম্যান্স ডেটা পান

আপনি GoogleAdsService.SearchStream ব্যবহার করে আপনার ভিডিও ক্যাম্পেন, বিজ্ঞাপন গ্রুপ এবং মাপকাঠির জন্য পারফর্ম্যান্স ডেটা পেতে পারেন, এর জন্য আপনাকে campaign.advertising_channel_type = 'VIDEO' ফিল্টার করতে হবে।

মনে রাখবেন: TrueView ভিউ মেট্রিক্সের জন্য metrics.video_trueview_views, metrics.video_trueview_view_rate, এবং metrics.trueview_average_cpv ব্যবহার করুন। v25 থেকে, আপনি segments.ad_sub_format_type (segments.ad_format_type-এর পাশাপাশি) বেছে নিয়ে এড়িয়ে যাওয়ার সুবিধা না থাকা স্ট্রিম-মধ্যস্থ বিজ্ঞাপনকে সময়সীমা অনুযায়ী ভাগ করতে পারবেন, এর সাথে ভিডিও সোশ্যাল এনগেজমেন্ট মেট্রিকও (metrics.youtube_comments, metrics.youtube_likes এবং metrics.youtube_shares) দেখতে পারবেন।

বিজ্ঞাপন গ্রুপের পারফর্ম্যান্স

নিম্নলিখিত কোয়েরি ad_group রিসোর্স থেকে ভিডিও ক্যাম্পেন এবং বিজ্ঞাপন গ্রুপ মেট্রিক, যার মধ্যে TrueView ভিডিও ভিউ এবং কোয়ার্টাইল সম্পূর্ণ করার হার অন্তর্ভুক্ত, তা ফিরিয়ে আনে:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

ভিডিও প্লেসমেন্ট ও মাপকাঠি সংক্রান্ত রিপোর্টিং

যেহেতু ad_group_criterion সরাসরি মেট্রিক বা সেগমেন্ট সমর্থন করে না, তাই টার্গেট করা YouTube ভিডিও, YouTube চ্যানেল বা অন্যান্য ম্যানেজ করা প্লেসমেন্টের জন্য পারফর্ম্যান্স মেট্রিক পেতে managed_placement_view-এর মতো ক্রাইটেরিয়া ভিউ রিসোর্স ব্যবহার করুন:

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS

ক্যাম্পেন রিচ ও ফ্রিকোয়েন্সি রিপোর্টিং

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

নিম্নলিখিত অনন্য ব্যবহারকারী মেট্রিক ফ্রিকোয়েন্সি বাকেট জুড়ে দর্শকদের কাছে পৌঁছানোর পরিমাপ করে:

• metrics.unique_users: বেছে নেওয়া তারিখের রেঞ্জের (৯২ দিন পর্যন্ত) মধ্যে অন্তত একবার আপনার বিজ্ঞাপন দেখেছেন এমন অনন্য ব্যক্তির সংখ্যা। এটি সারি জুড়ে অ্যাগ্রিগেট করা যাবে না।
• metrics.unique_users_two_plus থেকে metrics.unique_users_ten_plus: ৩১ দিন পর্যন্ত তারিখের রেঞ্জের জন্য, যথাক্রমে কমপক্ষে ২ থেকে ১০ বার আপনার বিজ্ঞাপন দেখেছেন এমন অনন্য ব্যক্তির সংখ্যা (v26 এবং তার পরের ভার্সনে ২+ থেকে ১০+ সেট সম্পূর্ণ করে metrics.unique_users_six_plus থেকে metrics.unique_users_nine_plus )।
• metrics.average_impression_frequency_per_user: অনুরোধ করা সময়সীমার (৯২ দিন পর্যন্ত) মধ্যে একজন অনন্য ব্যবহারকারী আপনার বিজ্ঞাপন গড়ে যতবার দেখেছেন। এটি সারি জুড়ে অ্যাগ্রিগেট করা যাবে না এবং এর কোনও সহযোগী _info ফিল্ড নেই।

v26 এবং তার পরবর্তী ভার্সনে, প্রতিটি রিচ মেট্রিকের সাথে এই ধরনের একটি মেটাডেটা ফিল্ড থাকে ReachMetricInfo: metrics.unique_users_info এবং metrics.unique_users_two_plus_info থেকে metrics.unique_users_ten_plus_info পর্যন্ত।

Google Ads Query Language (GAQL)-এ, কম্প্যানিয়ন রিচ ফিল্ড হল MESSAGE মেট্রিক যা সরাসরি SELECT ক্লজে বেছে নেওয়া হয় (যেমন, metrics.unique_users_info)। SELECT ক্লজে .reach_metric_states যোগ করবেন না, কারণ GAQL-এ নেস্টেড মেসেজ ফিল্ড বেছে নিলে UNRECOGNIZED_FIELD-এর সাথে ব্যর্থ হয়। পরিবর্তে, metrics.unique_users_info বেছে নিলে একটি ReachMetricInfo মেসেজ রিটার্ন করে যাতে ReachMetricState ধরনের রিপিট করা enum ফিল্ড reach_metric_states থাকে, যা মেট্রিকটি সাপ্রেস করা হয়েছে নাকি সম্পূর্ণ হয়েছে তা বর্ণনা করে।

যখনই কোনও রিচ মেট্রিক দমন করা হয় বা রিটেনশন উইন্ডোর বাইরে থাকে (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION, অথবা DATE_RANGE_BEYOND_RETENTION), Metrics-এ এর optional int64 ফিল্ড আনসেট করা হয় (যা ফিল্ডের উপস্থিতি চেক না করা হলে 0-এ মূল্যায়ন করে), যেখানে LOW_QUALITY এখনও সংখ্যাসূচক মেট্রিক পপুলেট করে।

ReachMetricState enum ভ্যালু থেকে রিচ ডেটার স্ট্যাটাস বোঝা যায়:

• COMPLETE: রিচ মেট্রিক সম্পূর্ণ এবং গোপনীয়তা, কোয়ালিটি বা অন্যান্য সীমার কারণে এটি দমন করা হয়নি।
• PRIVACY_SUPPRESSION: ব্যবহারকারীর গোপনীয়তা সুরক্ষিত রাখতে রিচ ডেটা দেখানো হয়নি (যেমন, দর্শকের সংখ্যা k-অ্যানোনিমিটি থ্রেশহোল্ড পূরণ না করলে)।
• QUALITY_SUPPRESSION: ডেটার কোয়ালিটি সংক্রান্ত প্রয়োজনীয়তার কারণে রিচ ডেটা প্রকাশ করা হয়নি।
• LOW_QUALITY: রিচ মেট্রিক গণনা করা হয়েছে কিন্তু কম কোয়ালিটি হিসেবে ফ্ল্যাগ করা হয়েছে।
• DATE_RANGE_BEYOND_RETENTION: রিচ মেট্রিক উপলভ্য নেই কারণ বেছে নেওয়া তারিখের রেঞ্জ রিচ ডেটার জন্য ৩ বছরের ডেটার রেকর্ড রাখার সময়সীমা অতিক্রম করেছে।

নিম্নলিখিত কোয়েরি ভিডিও ক্যাম্পেনের জন্য রিচ মেট্রিক্স এবং তাদের সাপ্রেশন স্টেট ফিরিয়ে আনে:

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  segments.device,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.average_impression_frequency_per_user,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_three_plus,
  metrics.unique_users_three_plus_info,
  metrics.unique_users_four_plus,
  metrics.unique_users_four_plus_info,
  metrics.unique_users_five_plus,
  metrics.unique_users_five_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_seven_plus,
  metrics.unique_users_seven_plus_info,
  metrics.unique_users_eight_plus,
  metrics.unique_users_eight_plus_info,
  metrics.unique_users_nine_plus,
  metrics.unique_users_nine_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date BETWEEN '2026-01-01' AND '2026-01-31'

মনে রাখবেন: রিচ ও ফ্রিকোয়েন্সি মেট্রিক সারি জুড়ে অ্যাগ্রিগেট করা যাবে না। metrics.unique_users এবং metrics.average_impression_frequency_per_user-এ ৯২ দিন পর্যন্ত তারিখের রেঞ্জ কাজ করে এবং segments.date, segments.device, segments.adjusted_age_range এবং segments.adjusted_gender-এর মাধ্যমে সেগমেন্ট করা যায়, unique_users_*_plus ফ্রিকোয়েন্সি বাকেট মেট্রিক (৩১ দিন পর্যন্ত) এবং সব সহযোগী metrics.unique_users*_info ফিল্ডে শুধুমাত্র segments.date এবং segments.device কাজ করে। এছাড়াও, কম্প্যানিয়ন metrics.unique_users*_info ফিল্ড হল MESSAGE মেট্রিক, যার সাথে filterable: false এবং sortable: false আছে, তাই এগুলি WHERE বা ORDER BY ক্লজে ব্যবহার করা যাবে না। রিপোর্টে সাপ্রেস করা রিচ মেট্রিক ম্যানেজ করার ব্যাপারে আরও জানতে রিচ মেট্রিক সাপ্রেশন ও শূন্য ভ্যালু দেখুন।