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 থেকে সর্বাধিক 100000 সারি ফেরত দেওয়া হবে।

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

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

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

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

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

একটি প্রচারাভিযান প্রতিবেদন তৈরির স্পেসিফিকেশন। উদাহরণ স্বরূপ, CAMPAIGN_ID দ্বারা কাটা ছাপ এবং ক্লিক পাওয়ার স্পেসিফিকেশন নিম্নলিখিত উদাহরণের মত দেখতে পারে:

{
  "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 )

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

dimensions[]

enum ( Dimension )

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

metrics[]

enum ( Metric )

রিপোর্টের মেট্রিক্সের তালিকা। একটি রিপোর্ট অন্তত একটি মেট্রিক নির্দিষ্ট করা আবশ্যক.

languageCode

string

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

মাত্রা

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

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

মেট্রিক

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

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