- HTTP অনুরোধ
- পথের পরামিতি
- অনুরোধের মূল অংশ
- প্রতিক্রিয়া মূল অংশ
- অনুমোদনের সুযোগ
- ক্যাম্পেইনরিপোর্টস্পেক
- মাত্রা
- মেট্রিক
- উদাহরণ
- চেষ্টা করে দেখুন!
প্রদত্ত স্পেসিফিকেশনের উপর ভিত্তি করে প্রচারণা প্রতিবেদন তৈরি করে।
HTTP অনুরোধ
POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate
URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পথের পরামিতি
| পরামিতি | |
|---|---|
parent | যে অ্যাকাউন্টের জন্য রিপোর্ট তৈরি করতে হবে তার রিসোর্সের নাম। উদাহরণ: accounts/pub-9876543210987654 |
অনুরোধের মূল অংশ
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| JSON উপস্থাপনা |
|---|
{
"reportSpec": {
object ( |
| ক্ষেত্র | |
|---|---|
reportSpec | প্রচারাভিযানের প্রতিবেদনের স্পেসিফিকেশন। |
প্রতিক্রিয়া মূল অংশ
ক্যাম্পেইন রিপোর্ট API প্রতিক্রিয়া।
যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:
| JSON উপস্থাপনা |
|---|
{
"rows": [
{
object ( |
| ক্ষেত্র | |
|---|---|
rows[] | নির্দিষ্ট প্রকাশকের কাছ থেকে প্রচারাভিযানের প্রতিবেদনের ডেটা। 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[] | প্রতিবেদনের মাত্রার তালিকা। এই মাত্রাগুলির মান সমন্বয় প্রতিবেদনের সারি নির্ধারণ করে। যদি কোনও মাত্রা নির্দিষ্ট না করা থাকে, তাহলে প্রতিবেদনটি সমগ্র অ্যাকাউন্টের জন্য অনুরোধ করা মেট্রিক্সের একটি সারি প্রদান করে। |
metrics[] | প্রতিবেদনের মেট্রিক্সের তালিকা। একটি প্রতিবেদনে কমপক্ষে একটি মেট্রিক উল্লেখ করতে হবে। |
languageCode | যেকোনো স্থানীয় টেক্সটের জন্য ব্যবহৃত ভাষা, যেমন নির্দিষ্ট প্রযোজ্য মাত্রার মান। ভাষা ট্যাগটি 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 | একজন ব্যবহারকারী কতবার একটি বিজ্ঞাপনের সাথে ইন্টারঅ্যাক্ট করেছেন। এতে ক্লিক এবং এনগেজমেন্ট অন্তর্ভুক্ত। |