Method: accounts.campaignReport.generate

প্রদত্ত স্পেসিফিকেশনের উপর ভিত্তি করে প্রচারণা প্রতিবেদন তৈরি করে।

HTTP অনুরোধ

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate

URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পথের পরামিতি

পরামিতি
parent

string

যে অ্যাকাউন্টের জন্য রিপোর্ট তৈরি করতে হবে তার রিসোর্সের নাম। উদাহরণ: accounts/pub-9876543210987654

অনুরোধের মূল অংশ

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON উপস্থাপনা
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
ক্ষেত্র
reportSpec

object ( CampaignReportSpec )

প্রচারাভিযানের প্রতিবেদনের স্পেসিফিকেশন।

প্রতিক্রিয়া মূল অংশ

ক্যাম্পেইন রিপোর্ট API প্রতিক্রিয়া।

যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:

JSON উপস্থাপনা
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
ক্ষেত্র
rows[]

object ( ReportRow )

নির্দিষ্ট প্রকাশকের কাছ থেকে প্রচারাভিযানের প্রতিবেদনের ডেটা। API থেকে সর্বাধিক ১০০০০০ সারি ফেরত পাঠানো হবে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

ক্যাম্পেইনরিপোর্টস্পেক

একটি ক্যাম্পেইন রিপোর্ট তৈরির স্পেসিফিকেশন। উদাহরণস্বরূপ, CAMPAIGN_ID দ্বারা IMPRESSIONS এবং CLICKS স্লাইস করার স্পেসিফিকেশনটি নিম্নলিখিত উদাহরণের মতো দেখতে পারে:

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 12, "day": 1},
    "endDate": {"year": 2021, "month": 12, "day": 30}
  },
  "dimensions": ["CAMPAIGN_ID"],
  "metrics": ["IMPRESSIONS", "CLICKS"],
}
JSON উপস্থাপনা
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
ক্ষেত্র
dateRange

object ( DateRange )

যে তারিখের জন্য প্রতিবেদন তৈরি করা হয়েছে। সর্বোচ্চ সময়সীমা ৩০ দিন।

dimensions[]

enum ( Dimension )

প্রতিবেদনের মাত্রার তালিকা। এই মাত্রাগুলির মান সমন্বয় প্রতিবেদনের সারি নির্ধারণ করে। যদি কোনও মাত্রা নির্দিষ্ট না করা থাকে, তাহলে প্রতিবেদনটি সমগ্র অ্যাকাউন্টের জন্য অনুরোধ করা মেট্রিক্সের একটি সারি প্রদান করে।

metrics[]

enum ( Metric )

প্রতিবেদনের মেট্রিক্সের তালিকা। একটি প্রতিবেদনে কমপক্ষে একটি মেট্রিক উল্লেখ করতে হবে।

languageCode

string

যেকোনো স্থানীয় টেক্সটের জন্য ব্যবহৃত ভাষা, যেমন নির্দিষ্ট প্রযোজ্য মাত্রার মান। ভাষা ট্যাগটি IETF BCP47-এ সংজ্ঞায়িত করা হয়েছে। নির্দিষ্ট না থাকলে বা অবৈধ হলে ডিফল্টভাবে 'en-US' হিসেবে ব্যবহৃত হয়।

মাত্রা

প্রচারণা প্রতিবেদনের মাত্রা।

এনামস
DIMENSION_UNSPECIFIED একটি অনির্দিষ্ট মাত্রার ডিফল্ট মান। ব্যবহার করবেন না।
DATE YYYYMMDD ফর্ম্যাটে একটি তারিখ (উদাহরণস্বরূপ, "20210701")।
CAMPAIGN_ID প্রচারণার অনন্য আইডি, উদাহরণস্বরূপ "১২৩৪৫৬৭৮৯", যা প্রচারণা তালিকা API থেকে প্রচারণা আইডির সাথে সামঞ্জস্যপূর্ণ।
CAMPAIGN_NAME প্রচারণার নাম।
AD_ID বিজ্ঞাপনের অনন্য আইডি, উদাহরণস্বরূপ "১২৩৪৫৬৭৮৯"।
AD_NAME বিজ্ঞাপনের নাম, যা অনন্য নাও হতে পারে।
PLACEMENT_ID যে অ্যাপে বিজ্ঞাপনটি রাখা হয়েছে তার বিক্রেতা-নির্দিষ্ট অনন্য আইডি। উদাহরণস্বরূপ, Android এর জন্য com.goog.bar এবং iOS অ্যাপের জন্য 123456789।
PLACEMENT_NAME যে অ্যাপে বিজ্ঞাপনটি রাখা হয়েছে তার নাম।
PLACEMENT_PLATFORM অ্যাপের প্ল্যাটফর্ম যেখানে বিজ্ঞাপনটি রাখা হয়েছে।
COUNTRY লক্ষ্যবস্তু দেশের নাম।
FORMAT বিজ্ঞাপন ইউনিটের ফর্ম্যাট (যেমন, "ব্যানার", "নেটিভ"), বিজ্ঞাপন ডেলিভারির একটি মাত্রা।

মেট্রিক

প্রচারণা প্রতিবেদনের মেট্রিক্স।

এনামস
METRIC_UNSPECIFIED একটি অনির্ধারিত ক্ষেত্রের জন্য ডিফল্ট মান। ব্যবহার করবেন না।
IMPRESSIONS ব্যবহারকারীকে কতবার একটি বিজ্ঞাপন দেখানো হয়েছে।
CLICKS একজন ব্যবহারকারী কতবার একটি বিজ্ঞাপনে ক্লিক করেছেন।
CLICK_THROUGH_RATE একটি বিজ্ঞাপনে কতবার ক্লিক করা হয়েছে তাকে বিজ্ঞাপনটি দেখানোর সংখ্যা দিয়ে ভাগ করলে।
INSTALLS ডিভাইসে কতবার অ্যাপ ডাউনলোড করা হয়েছে।
ESTIMATED_COST আয় উপার্জনকারী বিজ্ঞাপনের পরিবর্তে একটি প্রচারণার বিজ্ঞাপন পরিবেশনের আনুমানিক খরচ। মুদ্রা হল প্রচারণার প্রতিবেদনকারী মুদ্রা।
AVERAGE_CPI প্রতি ইনস্টলেশনের গড় খরচ। এর অর্থ হল একজন নতুন ব্যবহারকারী অর্জনের জন্য ব্যয় করা গড় পরিমাণ। মুদ্রা হল প্রচারণার প্রতিবেদনকারী মুদ্রা।
INTERACTIONS একজন ব্যবহারকারী কতবার একটি বিজ্ঞাপনের সাথে ইন্টারঅ্যাক্ট করেছেন। এতে ক্লিক এবং এনগেজমেন্ট অন্তর্ভুক্ত।