UCP এজেন্টিক পারফর্ম্যান্স বিশ্লেষণ করুন (Alpha)

Merchant Reports API আপনাকে প্রোগ্রাম্যাটিক্যালি ইউনিভার্সাল কমার্স প্রোটোকল (UCP) চেক-আউট এবং কনভার্সন পারফর্ম্যান্স মেট্রিক্স Google সারফেস জুড়ে পুনরুদ্ধার করতে দেয়, যার মধ্যে Search এবং Gemini-তে AI মোড অন্তর্ভুক্ত। এইসব রিপোর্টে Merchant Center UCP অ্যানালিটিক্স ড্যাশবোর্ডে উপলভ্য একই পারফর্ম্যান্স ইনসাইট প্রদান করা হয়, যা আপনাকে কনভার্সন ফানেল, সম্পূর্ণ করা অর্ডার, কার্ট ট্রান্সফার এবং প্রোডাক্ট-লেভেল এনগেজমেন্ট মনিটর করতে সাহায্য করে।

UCP পারফর্ম্যান্স বিশ্লেষণ করার জন্য রিপোর্টিং সাব-API দুটি ভিউ প্রদান করে:

• UcpAgenticPerformanceView (ucp_agentic_performance_view): তারিখ ও গ্রাহকের দেশ অনুযায়ী অ্যাকাউন্ট-লেভেল কনভার্সন ফানেল, অর্ডার, বাতিল করা ও কার্ট ট্রান্সফার মেট্রিক্সের বিভাগ প্রদান করে।
• UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): তারিখ ও গ্রাহকের দেশ অনুযায়ী প্রোডাক্ট-লেভেল (offer_id) 'কিনুন' বোতামে ক্লিক সংক্রান্ত মেট্রিক প্রদান করে।

শুরু করার আগে

UCP পারফর্ম্যান্স ভিউ কোয়েরি করার আগে, আপনি নিম্নলিখিত প্রয়োজনীয়তা পূরণ করেছেন কিনা তা নিশ্চিত করুন:

• v1alpha এন্ডপয়েন্ট ব্যবহার করুন: আপনার MCQL কোয়েরি v1alpha accounts.reports.search পদ্ধতিতে পাঠান। রিপোর্ট সংক্রান্ত অনুরোধ কার্যকর করার ব্যাপারে বিস্তারিত জানতে, Merchant Reports API শুরু করুন দেখুন।
• যেসব ধরনের অ্যাকাউন্ট কাজ করে: ucp_agentic_performance_view এবং ucp_agentic_product_performance_view উভয়ই লিফ অ্যাকাউন্ট (স্ট্যান্ডঅ্যালোন অ্যাকাউন্ট এবং ব্যক্তিগত সাব-অ্যাকাউন্ট) এবং উন্নত অ্যাকাউন্ট (মাল্টি-ক্লায়েন্ট অ্যাকাউন্ট বা অ্যাগ্রিগেটর অ্যাকাউন্ট) সাপোর্ট করে। বিবরণ ও উদাহরণের জন্য, উন্নত অ্যাকাউন্ট লেভেলে কোয়েরি দেখুন।
• তারিখ ফিল্টার করা আবশ্যক: আপনাকে দুটি ভিউয়ের জন্য প্রতিটি কোয়েরির WHERE ক্লজে date-এর উপর একটি শর্ত নির্দিষ্ট করতে হবে।

অ্যাকাউন্ট-লেভেল UCP পারফর্ম্যান্স বিশ্লেষণ করা

আপনার সামগ্রিক UCP কনভার্সন ফানেল ট্র্যাক করতে ucp_agentic_performance_view ব্যবহার করুন, 'কিনুন' বোতামে ক্লিক করা এবং অ্যাকাউন্ট লিঙ্ক করা থেকে শুরু করে কেনাকাটা সম্পূর্ণ করা এবং কার্ট ট্রান্সফার করা পর্যন্ত।

কারেন্সি ও দামের মেট্রিক

ucp_agentic_performance_view-এ মুদ্রা ও Price মেট্রিক পারফর্ম্যান্স রিপোর্টের মতোই ম্যানেজ করা হয়:

• Price মেট্রিক: নিম্নলিখিত মেট্রিকগুলি একটি Price অবজেক্ট রিটার্ন করে যার মধ্যে amount_micros ভ্যালু এবং currency_code উভয়ই থাকে:
  • purchase_value
  • average_order_value
  • average_purchase_product_value
  • average_cart_value
  • average_cart_product_value
• দাম-বহির্ভূত মেট্রিক: নিম্নলিখিত মেট্রিকের সাথে কোনও মুদ্রা যুক্ত নেই:
  • buy_button_clicks
  • accounts_linked
  • account_linking_rate
  • purchase_count
  • cancellations
  • average_purchase_product_count
  • cart_transfers
  • average_cart_product_count

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

কোয়েরি ১: সামগ্রিক ফানেল মেট্রিক (মুদ্রা-নিরপেক্ষ) ফিরিয়ে আনুন

সামগ্রিক কনভার্সন ফানেল, অর্ডার সংখ্যা এবং কার্ট ট্রান্সফার মেট্রিক্স কারেন্সি নির্বিশেষে (কোনও Price ভ্যালু মেট্রিক্স অন্তর্ভুক্ত না করে) পুনরুদ্ধার করতে নিম্নলিখিত কোয়েরি ব্যবহার করুন:

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_rate,
  purchase_count,
  cancellations,
  average_purchase_product_count,
  cart_transfers,
  average_cart_product_count
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

উত্তরে প্রতিটি গ্রাহকের দেশের জন্য এগ্রিগেট করা ফানেল মেট্রিক দেখানো হয়:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3",
        "averagePurchaseProductCount": 1.75,
        "cartTransfers": "52",
        "averageCartProductCount": 2.1
      }
    }
  ]
}

কোয়েরি ২: কেনাকাটা ও কার্ট ভ্যালু মেট্রিক (কারেন্সি অনুযায়ী) ফিরিয়ে আনা

মুদ্রা অনুযায়ী ভাগ করা কেনাকাটার ভ্যালু, গড় অর্ডার ভ্যালু এবং কার্ট ট্রান্সফার ভ্যালু পেতে নিম্নলিখিত কোয়েরি ব্যবহার করুন:

SELECT
  date,
  account_id,
  customer_country_code,
  purchase_count,
  purchase_value,
  average_order_value,
  average_purchase_product_count,
  average_purchase_product_value,
  average_cart_value,
  average_cart_product_value
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20' AND purchase_count > 0

এই রেসপন্স, কেনাকাটা বা কার্ট ভ্যালু মেট্রিক্সে উপস্থিত প্রতিটি মুদ্রার জন্য একটি আলাদা সারি দেখায়:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "purchaseCount": "64",
        "purchaseValue": {
          "amountMicros": "5120000000",
          "currencyCode": "USD"
        },
        "averageOrderValue": {
          "amountMicros": "80000000",
          "currencyCode": "USD"
        },
        "averagePurchaseProductCount": 1.75,
        "averagePurchaseProductValue": {
          "amountMicros": "45714285",
          "currencyCode": "USD"
        },
        "cartTransfers": "52",
        "averageCartValue": {
          "amountMicros": "94500000",
          "currencyCode": "USD"
        },
        "averageCartProductCount": 2.1,
        "averageCartProductValue": {
          "amountMicros": "45000000",
          "currencyCode": "USD"
        }
      }
    }
  ]
}

প্রোডাক্ট-লেভেল UCP পারফর্ম্যান্স বিশ্লেষণ করা

কোন কোন প্রোডাক্টের ক্ষেত্রে Google সারফেস থেকে সরাসরি 'কিনুন' বোতামে ক্লিক করা হয়েছে তা দেখতে ucp_agentic_product_performance_view ব্যবহার করুন।

প্রোডাক্ট অনুযায়ী 'কিনুন' বোতামে করা ক্লিকের সংখ্যা সংক্রান্ত ডেটা ফিরিয়ে আনে

নির্দিষ্ট তারিখের জন্য প্রোডাক্ট-লেভেলে 'কিনুন' বোতামে ক্লিক সংক্রান্ত তথ্য পেতে নিম্নলিখিত কোয়েরি ব্যবহার করুন:

SELECT
  date,
  account_id,
  customer_country_code,
  offer_id,
  title,
  buy_button_clicks
FROM ucp_agentic_product_performance_view
WHERE date = '2026-09-20'

এছাড়াও, BETWEEN ব্যবহার করে তারিখের রেঞ্জ জুড়ে ক্লিক একত্রিত করতে আপনি SELECT ক্লজ থেকে date বাদ দিতে পারেন:

SELECT
  account_id,
  customer_country_code,
  offer_id,
  title,
  buy_button_clicks
FROM ucp_agentic_product_performance_view
WHERE date BETWEEN '2026-09-01' AND '2026-09-20'
ORDER BY buy_button_clicks DESC

প্রতিটি ম্যাচিং অফারের জন্য 'কিনুন' বোতামে ক্লিক করার মোট সংখ্যা রেসপন্সে দেখানো হয়:

{
  "results": [
    {
      "ucpAgenticProductPerformanceView": {
        "accountId": "123456789",
        "customerCountryCode": "US",
        "offerId": "sku-10042",
        "title": "Lightweight Running Shoes - Blue / Size 10",
        "buyButtonClicks": "38"
      }
    }
  ]
}

উন্নত অ্যাকাউন্ট লেভেলে কোয়েরি

আপনি ucp_agentic_performance_view এবং ucp_agentic_product_performance_view, দুটিতেই কোয়েরি করতে পারবেন। এর জন্য আপনাকে accounts.reports.search অনুরোধের parent প্যারামিটারে একটি উন্নত অ্যাকাউন্ট (মাল্টি-ক্লায়েন্ট অ্যাকাউন্ট বা এগ্রিগেটর অ্যাকাউন্ট) উল্লেখ করতে হবে, যেমন accounts/{advanced_account_id}।

দুটি ভিউতেই, account_id কলামে সবসময় লিফ Merchant Center অ্যাকাউন্ট আইডি (উন্নত অ্যাকাউন্টের অধীনে কোয়েরি করার সময় ব্যক্তিগত সাব-অ্যাকাউন্ট আইডি অথবা সিঙ্গল অ্যাকাউন্টে কোয়েরি করার সময় সিঙ্গল অ্যাকাউন্ট আইডি) থাকে। উন্নত অ্যাকাউন্ট লেভেলে কোয়েরি করার সময়, আপনি SELECT ক্লজে account_id অন্তর্ভুক্ত করছেন কিনা তা নির্ধারণ করে যে কীভাবে মেট্রিকগুলি গ্রুপ করা হয়েছে:

• account_id বাদ দিন (উন্নত অ্যাকাউন্ট লেভেলে একত্রিত করা হয়েছে): account_id বেছে না নিলে, উন্নত অ্যাকাউন্টের অন্তর্গত সব সাব-অ্যাকাউন্ট জুড়ে রেসপন্স একত্রিত মেট্রিক্স দেখায়।
• account_id বেছে নিন (সাব-অ্যাকাউন্ট অনুযায়ী ভাগ করা): account_id বেছে নেওয়া হলে, উত্তরে লিফ account_id অনুযায়ী পরিসংখ্যান ভাগ করা হয় এবং উন্নত অ্যাকাউন্টের অধীনে প্রতিটি সাব-অ্যাকাউন্টের জন্য আলাদা সারি দেখানো হয়।

উন্নত অ্যাকাউন্ট জুড়ে এগ্রিগেটেড মেট্রিক ফিরিয়ে আনুন

উন্নত অ্যাকাউন্ট লেভেলে রোল-আপ করা মোট UCP ফানেল মেট্রিক ফিরিয়ে আনতে, parent রিসোর্স হিসেবে আপনার উন্নত অ্যাকাউন্ট আইডি ব্যবহার করে অনুরোধ পাঠান এবং SELECT ক্লজ থেকে account_id বাদ দিন:

SELECT
  date,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_rate,
  purchase_count,
  cancellations
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

উন্নত অ্যাকাউন্টের সব সাব-অ্যাকাউন্ট জুড়ে তারিখ ও গ্রাহকের দেশ অনুযায়ী উত্তরে একটিই একত্রিত সারি দেখানো হয়:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "customerCountryCode": "US",
        "buyButtonClicks": "730",
        "accountsLinked": "140",
        "accountLinkingRate": 0.65,
        "purchaseCount": "110",
        "cancellations": "5"
      }
    }
  ]
}

সাব-অ্যাকাউন্ট অনুযায়ী মেট্রিক পান

উন্নত অ্যাকাউন্টে কোয়েরি করার সময় সাব-অ্যাকাউন্ট অনুযায়ী ফলাফল আলাদা করতে, SELECT ক্লজে account_id অন্তর্ভুক্ত করুন:

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_rate,
  purchase_count,
  cancellations
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

যেহেতু account_id-এ সবসময় লিফ অ্যাকাউন্ট আইডি থাকে, তাই রেসপন্স উন্নত অ্যাকাউন্টের অধীনে থাকা প্রতিটি সাব-অ্যাকাউন্টের জন্য একটি আলাদা সারি দেখায়:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3"
      }
    },
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "987654321",
        "customerCountryCode": "US",
        "buyButtonClicks": "310",
        "accountsLinked": "55",
        "accountLinkingRate": 0.61,
        "purchaseCount": "46",
        "cancellations": "2"
      }
    }
  ]
}