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

পরীক্ষামূলক: এই ফিচারটি আলফা (পরীক্ষামূলক) পর্যায়ে রয়েছে এবং এতে পরিবর্তন আসতে পারে।

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

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

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

শুরু করার আগে

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

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

অ্যাকাউন্ট-স্তরের ইউসিপি কর্মক্ষমতা বিশ্লেষণ করুন

বাই বাটনে ক্লিক এবং অ্যাকাউন্ট লিঙ্কিং থেকে শুরু করে সম্পন্ন হওয়া কেনাকাটা এবং কার্ট ট্রান্সফার পর্যন্ত আপনার সামগ্রিক 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

গুরুত্বপূর্ণ: Price ভ্যালু মেট্রিক্সের সাথে একই কোয়েরিতে ফানেল বা কাউন্ট মেট্রিক্স (যেমন buy_button_clicks ) অন্তর্ভুক্ত করলে, ফেরত আসা সারিগুলো কারেন্সি অনুযায়ী আলাদা হয়ে যায়। যেহেতু buy_button_clicks মতো মেট্রিক্সের নিজস্ব কোনো কারেন্সি থাকে না, তাই এগুলোকে Price মেট্রিক্সের সাথে একত্রিত করলে পারচেজ ভ্যালু ছাড়া সারিগুলো বিভক্ত বা বাদ পড়ে যেতে পারে। এটি এড়াতে এবং সঠিক মোট পরিমাণ পেতে, দুটি পৃথক কোয়েরি চালান:

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'

দ্রষ্টব্য: যেহেতু average_cart_value একটি Price মেট্রিক এবং এর সাথে একটি currency_code যুক্ত আছে, তাই এটিকে আপনার সামগ্রিক ফানেল কোয়েরি থেকে বাদ দিন এবং এর পরিবর্তে আপনার purchase ও cart value কোয়েরিতে অন্তর্ভুক্ত করুন।

এই প্রতিক্রিয়াটি প্রতিটি গ্রাহক দেশের জন্য সমষ্টিগত ফানেল মেট্রিক্স প্রদান করে:

{
  "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 কর্মক্ষমতা বিশ্লেষণ করুন

গুগলের বিভিন্ন পৃষ্ঠা থেকে সরাসরি কোন কোন নির্দিষ্ট পণ্যের জন্য 'বাই বাটন' ক্লিক আসে, তা দেখতে 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"
      }
    }
  ]
}