ওভারভিউ

রিপোর্টিং API

রিপোর্টিং এপিআই একজন বণিককে তাদের কর্মক্ষমতা ডেটার সাথে বণিক কেন্দ্রের ক্যোয়ারী ল্যাঙ্গুয়েজের মাধ্যমে প্রোগ্রাম্যাটিকভাবে জড়িত হতে দেয়। এটি বণিক কেন্দ্রে সরাসরি কাস্টম রিপোর্ট তৈরি করার ক্ষমতার মতো। রিপোর্টিং API এর নিম্নলিখিত সুবিধা রয়েছে:

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

এপিআই ব্যবহারকারীরা সার্চ কল রেসপন্সে কোন পারফরম্যান্স ডেটা পুনরুদ্ধার করতে চান তা নির্দিষ্ট করতে পারেন, যেমন:

  • মেট্রিক্স ফেরত দিতে হবে (উদাহরণস্বরূপ: ক্লিক, ইমপ্রেশন)
  • যে মাত্রায় ডেটা সেগমেন্ট করতে হবে (উদাহরণস্বরূপ: OfferId, তারিখ)
  • শর্ত যা পূরণ করতে হবে (উদাহরণস্বরূপ: ক্লিক > 100)

Reporting API ক্যোয়ারী ভাষা Search ব্যবহার করে পারফরম্যান্স মেট্রিক্স (ক্লিক, ইমপ্রেশন) এর জন্য কেনাকাটার জন্য সামগ্রী API-কে জিজ্ঞাসা করতে পারে, সম্ভবত বিভিন্ন মাত্রা (প্রোগ্রাম এবং তারিখের মতো রিপোর্ট করা ইভেন্ট অ্যাট্রিবিউট এবং ব্র্যান্ড, বিভাগ ইত্যাদির মতো পণ্য বৈশিষ্ট্য) দ্বারা বিভক্ত। Reports পরিষেবার পদ্ধতি।

Reports পরিষেবাতে একটি ক্যোয়ারী থেকে ফলাফল হল ReportRow দৃষ্টান্তগুলির একটি তালিকা, প্রতিটি ReportRow আপনার ক্যোয়ারীতে নির্দিষ্ট করা সেগমেন্টগুলির জন্য অনুরোধ করা মেট্রিক্সের মানগুলিকে প্রতিনিধিত্ব করে৷ যদি কোনো সেগমেন্ট নির্দিষ্ট করা না থাকে, তাহলে সমস্ত সেগমেন্ট জুড়ে একত্রিত মেট্রিক সহ একটি একক সারি দেওয়া হয়। অন্যথায়, যদি মেট্রিক্সের পাশাপাশি কোনো সেগমেন্টের অনুরোধ করা হয়, তাহলে প্রতিক্রিয়া প্রতিটি অনন্য সেগমেন্ট টিপলের জন্য একটি সারি দেখায়। একক প্রশ্নে একাধিক সেগমেন্ট এবং একাধিক মেট্রিক নির্বাচন করা সম্ভব।

মেট্রিক্সের জন্য ক্যোয়ারী

আপনি যে মেট্রিক্স (ক্লিক, ইম্প্রেশন, CTR, ইত্যাদি) এর জন্য প্রশ্ন করতে পারেন যা আপনি ফেরত দিতে চান। রিপোর্ট পরিষেবার জন্য আপনাকে অবশ্যই তারিখের পরিসরে একটি ফিল্টার যোগ করতে হবে। নীচের নমুনা ক্যোয়ারীটি একটি একক সারি প্রদান করে: একটি তারিখ ব্যাপ্তির যোগ করা শর্তের মধ্যে ক্লিকের মোট পরিমাণ।

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

নমুনা প্রতিক্রিয়া

নীচের JSON কোডের নমুনা প্রতিক্রিয়া দেখায় যে কীভাবে এই বণিক 1লা ডিসেম্বর, 2020 এবং 21শে ডিসেম্বর, 2020-এর মধ্যে তাদের সমস্ত গন্তব্য জুড়ে তাদের সমস্ত পণ্য জুড়ে 4,440টি ক্লিক একসাথে করেছে।

{"results": [
    {
      "metrics": {
        "clicks": "4,440"
      }
    }
]}

সেগমেন্টের জন্য ক্যোয়ারী

মেট্রিক্সের পাশাপাশি, আপনি বিভাগগুলির জন্যও অনুসন্ধান করতে পারেন, যা একটি পণ্যের একটি বৈশিষ্ট্য ( offer_id , brand , category , ইত্যাদি) বা রিপোর্ট করা ইভেন্টের একটি বৈশিষ্ট্য ( date , program ) হতে পারে। একটি রিপোর্ট করা ইভেন্ট হল একটি পণ্যের জন্য একটি ছাপ বা ক্লিক৷

বিভাগগুলি এসকিউএল-এ একটি GROUP BY এর অনুরূপভাবে কাজ করে। বিভাগগুলি নির্বাচিত মেট্রিকগুলিকে বিভক্ত করে, SELECT ক্লজে প্রতিটি সেগমেন্ট দ্বারা গোষ্ঠীবদ্ধ করে৷ নীচের নমুনা ক্যোয়ারীটি প্রতিদিন ক্লিকগুলি প্রদান করে, একটি তারিখ সীমার যোগ করা শর্তের মধ্যে ক্লিকের দ্বারা ক্রমানুসারে। শুধুমাত্র সারি যেখানে অন্তত একটি অনুরোধ করা মেট্রিক নন-জিরো ফেরত দেওয়া হবে।

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

নমুনা প্রতিক্রিয়া

নীচের JSON কোডের নমুনা প্রতিক্রিয়া দেখায় যে কীভাবে এই বণিক 1লা ডিসেম্বর, 2020-এ তাদের সমস্ত গন্তব্যে তাদের সমস্ত পণ্য জুড়ে 1,546 ক্লিক করেছে এবং 2রা ডিসেম্বর, 2020-এ তাদের সমস্ত গন্তব্যে তাদের সমস্ত পণ্য জুড়ে 829টি ক্লিক করেছে। এর জন্য কোনও বস্তু ফেরত দেওয়া হবে না। 3রা ডিসেম্বর, 2020 যেহেতু ওই দিন বণিকের কোনো ক্লিক ছিল না।

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}