Analyze Youtube Affiliate Performance (Alpha)

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

আপনি মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজ (MCQL) ব্যবহার করে ডেডিকেটেড ইউটিউব অ্যাফিলিয়েট ভিউ থেকে মেট্রিক্স এবং ডাইমেনশন নির্বাচন করতে পারেন, যা আপনার কোয়েরিতে টেবিলের মতো কাজ করে।

পূর্বশর্ত

এই নির্দেশিকাটি ব্যবহার করার আগে নিশ্চিত করুন যে:

• এপিআই কল প্রমাণীকরণের জন্য ব্যবহৃত অ্যাকাউন্টটিতে 'পারফরম্যান্স অ্যান্ড ইনসাইটস' রোল রয়েছে, যা পারফরম্যান্স মেট্রিক্সে অ্যাক্সেস প্রদান করে।
• আপনার গুগল মার্চেন্ট সেন্টার অ্যাকাউন্টটি ইউটিউব অ্যাফিলিয়েট প্রোগ্রামে অংশগ্রহণ করে।

আলফা এন্ডপয়েন্টে কোয়েরি করুন

উল্লেখ্য যে, যেহেতু এটি পাবলিক আলফা পর্যায়ে রয়েছে, তাই এন্ডপয়েন্টটি ভিন্ন। ইউটিউব অ্যাফিলিয়েট পারফরম্যান্স ডেটা পেতে, আপনাকে v1alpha এন্ডপয়েন্টে POST রিকোয়েস্ট পাঠাতে হবে। নিচে একটি নমুনা রিকোয়েস্ট দেওয়া হলো:

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

  curl -X POST \
  'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --compressed

নির্মাতার পারফরম্যান্স দেখুন

কোন ইউটিউব ক্রিয়েটররা সবচেয়ে বেশি এনগেজমেন্ট এবং সেলস আনছেন তা বোঝার জন্য, আপনি youtube_creator_performance_view টি কোয়েরি করতে পারেন। এই ভিউটি স্বতন্ত্র ইউটিউব ক্রিয়েটরদের মেট্রিকগুলো একত্রিত করে এবং এতে ক্রিয়েটরের টাইটেল ও চ্যানেল আইডি অন্তর্ভুক্ত থাকে।

এখানে একটি MCQL SELECT স্টেটমেন্টের উদাহরণ দেওয়া হলো, যা ব্যবহার করে আপনি ২০২৫ সালের ১লা মে থেকে ২রা মে-এর মধ্যে বিক্রয়ের ভিত্তিতে সেরা ৩ জন পারফর্মিং ক্রিয়েটরকে খুঁজে বের করতে পারবেন:

SELECT
  title,
  channel_id,
  gross_sales,
  net_sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date >= '2025-05-01' AND date < '2025-05-02'
ORDER BY gross_sales DESC LIMIT 3

এই কোয়েরিটি নির্দিষ্ট তারিখের পরিসরের মধ্যে মোট বিক্রয় মেট্রিকের ভিত্তিতে র‍্যাঙ্ক করা শীর্ষ ৩ জন ক্রিয়েটরের টাইটেল, চ্যানেল আইডি এবং প্রধান পারফরম্যান্স মেট্রিকগুলো সংগ্রহ করে।

বিষয়বস্তু অনুসারে পারফরম্যান্স দেখুন

কোন নির্দিষ্ট ইউটিউব ভিডিওগুলো সবচেয়ে ভালো পারফর্ম করছে তা দেখতে, আপনি youtube_content_performance_view টি কোয়েরি করতে পারেন। এই ভিউটি প্রতিটি ইউটিউব ভিডিওর মেট্রিকস একত্রিত করে এবং এতে ভিডিওর শিরোনাম ও আইডি অন্তর্ভুক্ত থাকে।

১ মে থেকে ২ মে, ২০২৫-এর মধ্যে ভিউ অনুসারে শীর্ষ ৩টি ভিডিও পেতে, accounts.reports.search মেথডে নিম্নলিখিত MCQL স্টেটমেন্টটি পাস করুন:

SELECT
  title,
  video_id,
  gross_sales,
  net_sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_content_performance_view
WHERE date >= '2025-05-01' AND date < '2025-05-02'
ORDER BY views DESC LIMIT 3

এই কোয়েরিটি নির্দিষ্ট তারিখের পরিসরের মধ্যে মোট views সংখ্যার ভিত্তিতে র‍্যাঙ্ক করা শীর্ষ ৩টি ভিডিওর শিরোনাম, ভিডিও আইডি এবং মূল মেট্রিকগুলো পুনরুদ্ধার করে।

সর্বাধিক এনগেজমেন্ট সহ ট্যাগযুক্ত পণ্যগুলি দেখুন

কোন ট্যাগ করা পণ্যগুলিতে সবচেয়ে বেশি এনগেজমেন্ট এবং বিক্রি হয়েছে তা বুঝতে, আপনি youtube_product_tagged_stats_view কোয়েরি করতে পারেন। এই ভিউটি প্রতিটি ট্যাগ করা পণ্যের শিরোনাম এবং অফার আইডি সহ মেট্রিকগুলো একত্রিত করে দেখায়।

২০২৬ সালের ২০শে জানুয়ারী থেকে ২১শে জানুয়ারীর মধ্যে ভিউয়ের ভিত্তিতে শীর্ষ ১০টি পণ্য পেতে আপনি ব্যবহার করতে পারেন এমন একটি MCQL SELECT স্টেটমেন্টের উদাহরণ নিচে দেওয়া হলো:

SELECT
  title,
  offer_id,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_tagged_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY views DESC LIMIT 10

এই কোয়েরিটি নির্দিষ্ট তারিখের পরিসরে মোট views সংখ্যার ভিত্তিতে র‍্যাঙ্ক করা শীর্ষ ১০টি পণ্যের শিরোনাম, ট্যাগ করা ভিডিওর সংখ্যা এবং মূল মেট্রিকগুলো পুনরুদ্ধার করে।

সর্বাধিক বিক্রিত পণ্যগুলি দেখুন

কোন পণ্যগুলোর বিক্রি সবচেয়ে বেশি তা বুঝতে, আপনি youtube_product_sold_stats_view কোয়েরি করতে পারেন।

২০২৬ সালের ২০শে জানুয়ারী থেকে ২১শে জানুয়ারীর মধ্যে মোট বিক্রয়ের ভিত্তিতে র‍্যাঙ্ক করা শীর্ষ ১০টি পণ্য পেতে আপনি এই MCQL SELECT স্টেটমেন্টের উদাহরণটি ব্যবহার করতে পারেন:

SELECT
  title,
  offer_id,
  gross_sales,
  net_sales,
  commissions,
  orders
FROM youtube_product_sold_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY gross_sales DESC LIMIT 10

এই কোয়েরিটি নির্দিষ্ট তারিখের পরিসরের মধ্যে মোট বিক্রয়ের ভিত্তিতে শীর্ষ ১০টি পণ্যের বিক্রয় ডেটা, কমিশন এবং মূল মেট্রিকগুলো পুনরুদ্ধার করে।

গুরুত্বপূর্ণ বিবেচ্য বিষয়

• তারিখ : রিপোর্টিং পিরিয়ড নির্দিষ্ট করতে সর্বদা WHERE ক্লজ ব্যবহার করে date অনুযায়ী আপনার কোয়েরি ফিল্টার করুন। তারিখগুলো YYYY-MM-DD ফরম্যাটে থাকে।
• লেটেন্সি : কোয়েরির লেটেন্সি অনুরোধ করা ডেটার পরিমাণের উপর নির্ভর করে। যেসব কোয়েরিতে বড় ডেটাসেট থাকে, সেগুলোতে বেশি সময় লাগে এবং এর ফলে টাইমআউট হতে পারে।