Method: accounts.networkReport.generate

প্রদত্ত রিপোর্ট স্পেসিফিকেশনের উপর ভিত্তি করে একটি AdMob নেটওয়ার্ক রিপোর্ট তৈরি করে। সার্ভার-সাইড স্ট্রিমিং RPC এর ফলাফল দেখায়। ফলাফলটি প্রতিক্রিয়ার ক্রমানুসারে দেখানো হয়।

HTTP অনুরোধ

POST https://admob.googleapis.com/v1/{parent=accounts/*}/networkReport:generate

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

পথের পরামিতি

পরামিতি
parent

string

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

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

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

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

object ( NetworkReportSpec )

নেটওয়ার্ক রিপোর্টের স্পেসিফিকেশন।

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

AdMob নেটওয়ার্ক রিপোর্টের স্ট্রিমিং রেসপন্স যেখানে প্রথম রেসপন্সে রিপোর্ট হেডার থাকে, তারপর সারি রেসপন্সের একটি স্ট্রিম থাকে এবং অবশেষে শেষ রেসপন্স মেসেজ হিসেবে একটি ফুটার থাকে।

উদাহরণস্বরূপ:

[{
  "header": {
    "dateRange": {
      "startDate": {"year": 2018, "month": 9, "day": 1},
      "endDate": {"year": 2018, "month": 9, "day": 1}
    },
    "localizationSettings": {
      "currencyCode": "USD",
      "languageCode": "en-US"
    }
  }
},
{
  "row": {
    "dimensionValues": {
      "DATE": {"value": "20180918"},
      "APP": {
        "value": "ca-app-pub-8123415297019784~1001342552",
         displayLabel: "My app name!"
      }
    },
    "metricValues": {
      "ESTIMATED_EARNINGS": {"microsValue": 6500000}
    }
  }
},
{
  "footer": {"matchingRowCount": 1}
}]

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

JSON উপস্থাপনা 
{

  // Union field payload can be only one of the following:
  "header": {
    object (ReportHeader)
  },
  "row": {
    object (ReportRow)
  },
  "footer": {
    object (ReportFooter)
  }
  // End of list of possible types for union field payload.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড payload । প্রতিটি স্ট্রিম রেসপন্স মেসেজে এক ধরণের পেলোড থাকে। payload নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
header

object ( ReportHeader )

রিপোর্ট তৈরির সেটিংস যা রিপোর্টের বিষয়বস্তু বর্ণনা করে, যেমন রিপোর্টের তারিখের পরিসর এবং স্থানীয়করণ সেটিংস।

row

object ( ReportRow )

প্রকৃত প্রতিবেদনের তথ্য।

footer

object ( ReportFooter )

তৈরি করা প্রতিবেদন সম্পর্কে অতিরিক্ত তথ্য, যেমন ডেটা সম্পর্কে সতর্কতা।

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

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

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

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

নেটওয়ার্করিপোর্টস্পেক

AdMob নেটওয়ার্ক রিপোর্ট তৈরির স্পেসিফিকেশন। উদাহরণস্বরূপ, শুধুমাত্র 'মার্কিন যুক্তরাষ্ট্র' এবং 'সিএন' দেশগুলির জন্য ক্লিক এবং আনুমানিক আয় পাওয়ার স্পেসিফিকেশনটি নিম্নলিখিত উদাহরণের মতো দেখতে হতে পারে:

{
  'dateRange': {
    'startDate': {'year': 2021, 'month': 9, 'day': 1},
    'endDate': {'year': 2021, 'month': 9, 'day': 30}
  },
  'dimensions': ['DATE', 'APP', 'COUNTRY'],
  'metrics': ['CLICKS', 'ESTIMATED_EARNINGS'],
  'dimensionFilters': [
    {
      'dimension': 'COUNTRY',
      'matchesAny': {'values': [{'value': 'US', 'value': 'CN'}]}
    }
  ],
  'sortConditions': [
    {'dimension':'APP', order: 'ASCENDING'},
    {'metric':'CLICKS', order: 'DESCENDING'}
  ],
  'localizationSettings': {
    'currencyCode': 'USD',
    'languageCode': 'en-US'
  }
}

আরও ভালোভাবে বোঝার জন্য, আপনি পূর্ববর্তী স্পেসিফিকেশনটিকে নিম্নলিখিত ছদ্ম SQL এর মতো ব্যবহার করতে পারেন:

SELECT DATE, APP, COUNTRY, CLICKS, ESTIMATED_EARNINGS
FROM NETWORK_REPORT
WHERE DATE >= '2021-09-01' AND DATE <= '2021-09-30'
    AND COUNTRY IN ('US', 'CN')
GROUP BY DATE, APP, COUNTRY
ORDER BY APP ASC, CLICKS DESC;
JSON উপস্থাপনা 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "dimensionFilters": [
    {
      object (DimensionFilter)
    }
  ],
  "sortConditions": [
    {
      object (SortCondition)
    }
  ],
  "localizationSettings": {
    object (LocalizationSettings)
  },
  "maxReportRows": integer,
  "timeZone": string
}
ক্ষেত্র
dateRange

object ( DateRange )

যে তারিখের জন্য প্রতিবেদন তৈরি করা হয়েছে।

dimensions[]

enum ( Dimension )

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

metrics[]

enum ( Metric )

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

dimensionFilters[]

object ( DimensionFilter )

কোন রিপোর্ট সারিগুলি তাদের মাত্রা মানের উপর ভিত্তি করে মেলাতে হবে তা বর্ণনা করে।

sortConditions[]

object ( SortCondition )

রিপোর্টের সারির সাজানোর পদ্ধতি বর্ণনা করে। তালিকার শর্তের ক্রম তার অগ্রাধিকার নির্ধারণ করে; শর্ত যত আগে হবে, তার অগ্রাধিকার তত বেশি হবে। যদি কোনও সাজানোর শর্ত নির্দিষ্ট না থাকে, তাহলে সারির ক্রম অনির্ধারিত থাকে।

localizationSettings

object ( LocalizationSettings )

রিপোর্টের স্থানীয়করণ সেটিংস।

maxReportRows

integer

রিপোর্ট ডেটা সারি সর্বাধিক কতগুলি ফেরত দিতে হবে। যদি মান সেট না করা থাকে, তাহলে API যতটা সম্ভব সারি ফেরত দেবে, সর্বোচ্চ ১০০০০০ পর্যন্ত। গ্রহণযোগ্য মান হল ১-১০০০০০, যার মধ্যে রয়েছে। ১০০০০০ এর চেয়ে বড় মান একটি ত্রুটি ফেরত দেয়।

timeZone

string

একটি রিপোর্ট টাইম জোন। "America/Los_Angeles" এর মতো IANA TZ নামের মান গ্রহণ করে। যদি কোনও টাইম জোন সংজ্ঞায়িত না থাকে, তাহলে অ্যাকাউন্ট ডিফল্ট কার্যকর হয়। অ্যাকাউন্ট পান অ্যাকশনের মাধ্যমে ডিফল্ট মান পরীক্ষা করুন।

সতর্কতা: "আমেরিকা/লস_অ্যাঞ্জেলস" এই মুহূর্তে একমাত্র সমর্থিত মান।

মাত্রা

নেটওয়ার্ক রিপোর্টের মাত্রা। মাত্রা হল ডেটা অ্যাট্রিবিউট যা পরিমাণগত পরিমাপ (মেট্রিক্স) কে নির্দিষ্ট অ্যাট্রিবিউট দ্বারা বিভক্ত বা পরিমার্জিত করে, যেমন বিজ্ঞাপনের ফর্ম্যাট বা প্ল্যাটফর্ম যেখানে একটি বিজ্ঞাপন দেখা হয়েছিল।

এনামস
DIMENSION_UNSPECIFIED একটি অনির্ধারিত ক্ষেত্রের জন্য ডিফল্ট মান। ব্যবহার করবেন না।
DATE YYYYMMDD ফর্ম্যাটে একটি তারিখ (উদাহরণস্বরূপ, "20210701")। অনুরোধগুলি সর্বাধিক এক সময়ের মাত্রা নির্দিষ্ট করতে পারে।
MONTH YYYYMM ফর্ম্যাটে এক মাস (উদাহরণস্বরূপ, "২০২১০৭")। অনুরোধগুলি সর্বাধিক এক সময়ের মাত্রা নির্দিষ্ট করতে পারে।
WEEK YYYYMMDD ফর্ম্যাটে সপ্তাহের প্রথম দিনের তারিখ (উদাহরণস্বরূপ, "20210701")। অনুরোধগুলি সর্বাধিক এক সময়ের মাত্রা নির্দিষ্ট করতে পারে।
AD_UNIT বিজ্ঞাপন ইউনিটের অনন্য আইডি (উদাহরণস্বরূপ, "ca-app-pub-1234/1234")। যদি AD_UNIT মাত্রা নির্দিষ্ট করা থাকে, তাহলে APP স্বয়ংক্রিয়ভাবে অন্তর্ভুক্ত হয়ে যায়।
APP মোবাইল অ্যাপ্লিকেশনের অনন্য আইডি (উদাহরণস্বরূপ, "ca-app-pub-1234~1234")।
AD_TYPE

বিজ্ঞাপনের ধরণ (যেমন, "টেক্সট" বা "ছবি"), বিজ্ঞাপন সরবরাহের একটি মাত্রা।

সতর্কতা: মাত্রাটি AD_REQUESTS , MATCH_RATE এবং IMPRESSION_RPM মেট্রিক্সের সাথে বেমানান।

COUNTRY বিজ্ঞাপন দেখা/ক্লিক করা স্থানের CLDR দেশের কোড (উদাহরণস্বরূপ, "মার্কিন" বা "FR")। এটি একটি ভৌগোলিক মাত্রা।
FORMAT বিজ্ঞাপন ইউনিটের ফর্ম্যাট (যেমন, "ব্যানার", "নেটিভ"), বিজ্ঞাপন ডেলিভারির একটি মাত্রা।
PLATFORM অ্যাপের মোবাইল ওএস প্ল্যাটফর্ম (উদাহরণস্বরূপ, "অ্যান্ড্রয়েড" বা "আইওএস")।
MOBILE_OS_VERSION মোবাইল অপারেটিং সিস্টেম সংস্করণ, যেমন "iOS 13.5.1"।
GMA_SDK_VERSION GMA SDK সংস্করণ, যেমন "iOS 7.62.0"।
APP_VERSION_NAME অ্যান্ড্রয়েডের জন্য, অ্যাপ ভার্সনের নাম PackageInfo-এর versionName-এ পাওয়া যাবে। iOS-এর জন্য, অ্যাপ ভার্সনের নাম CFBundleShortVersionString-এ পাওয়া যাবে।
SERVING_RESTRICTION বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধতা মোড (যেমন "অ-ব্যক্তিগতকৃত বিজ্ঞাপন")।

মেট্রিক

নেটওয়ার্ক রিপোর্টের মেট্রিক্স। মেট্রিক্স হল পরিমাণগত পরিমাপ যা প্রকাশক ব্যবসা কেমন পারফর্ম করছে তা নির্দেশ করে। এগুলি পৃথক বিজ্ঞাপন ইভেন্ট থেকে একত্রিত করা হয় এবং রিপোর্টের মাত্রা অনুসারে গোষ্ঠীভুক্ত করা হয়। মেট্রিক মান হয় পূর্ণসংখ্যা, অথবা দশমিক (গোলাকার ছাড়াই)।

এনামস
METRIC_UNSPECIFIED একটি অনির্ধারিত ক্ষেত্রের জন্য ডিফল্ট মান। ব্যবহার করবেন না।
AD_REQUESTS

বিজ্ঞাপনের অনুরোধের সংখ্যা। মানটি একটি পূর্ণসংখ্যা।

সতর্কতা: মেট্রিকটি AD_TYPE মাত্রার সাথে বেমানান।

CLICKS একজন ব্যবহারকারী কতবার একটি বিজ্ঞাপনে ক্লিক করেছেন। মানটি একটি পূর্ণসংখ্যা।
ESTIMATED_EARNINGS AdMob প্রকাশকের আনুমানিক আয়। আয়ের মেট্রিক্সের মুদ্রা ইউনিট (USD, EUR, অথবা অন্যান্য) মুদ্রার স্থানীয়করণ সেটিং দ্বারা নির্ধারিত হয়। পরিমাণটি মাইক্রোতে। উদাহরণস্বরূপ, $6.50 কে 6500000 হিসাবে উপস্থাপন করা হবে।
IMPRESSIONS ব্যবহারকারীদের দেখানো মোট বিজ্ঞাপনের সংখ্যা। মানটি একটি পূর্ণসংখ্যা।
IMPRESSION_CTR ক্লিকের তুলনায় ইম্প্রেশনের অনুপাত। মানটি দ্বিগুণ নির্ভুলতা (আনুমানিক) দশমিক মান।
IMPRESSION_RPM

প্রতি হাজার বিজ্ঞাপন ইম্প্রেশনের আনুমানিক আয়। মানটি মাইক্রোতে। উদাহরণস্বরূপ, $১.০৩ কে ১০৩০০০০ হিসাবে উপস্থাপন করা হবে। AdMob UI-তে eCPM এর সমতুল্য।

সতর্কতা: মেট্রিকটি AD_TYPE মাত্রার সাথে বেমানান।

MATCHED_REQUESTS একটি অনুরোধের প্রতিক্রিয়ায় বিজ্ঞাপনগুলি কতবার ফেরত পাঠানো হয়েছে তার সংখ্যা। মানটি একটি পূর্ণসংখ্যা।
MATCH_RATE

মোট বিজ্ঞাপন অনুরোধের সাথে মিলে যাওয়া বিজ্ঞাপন অনুরোধের অনুপাত। মানটি দ্বিগুণ নির্ভুলতা (আনুমানিক) দশমিক মান।

সতর্কতা: মেট্রিকটি AD_TYPE মাত্রার সাথে বেমানান।

SHOW_RATE প্রদর্শিত বিজ্ঞাপনের অনুপাত, যে বিজ্ঞাপনগুলি ফেরত পাঠানো হয় তার তুলনায়, ইম্প্রেশন / মিলিত অনুরোধ হিসাবে সংজ্ঞায়িত। মানটি একটি দ্বিগুণ নির্ভুলতা (আনুমানিক) দশমিক মান।

ডাইমেনশন ফিল্টার

কোন রিপোর্ট সারিগুলি তাদের মাত্রা মানের উপর ভিত্তি করে মেলাতে হবে তা বর্ণনা করে।

JSON উপস্থাপনা 
{
  "dimension": enum (Dimension),

  // Union field operator can be only one of the following:
  "matchesAny": {
    object (StringList)
  }
  // End of list of possible types for union field operator.
}
ক্ষেত্র
dimension

enum ( Dimension )

নির্দিষ্ট মাত্রায় ফিল্টার মানদণ্ড প্রয়োগ করে।

ইউনিয়ন ফিল্ড operator । ফিল্টার অপারেটর প্রয়োগ করতে হবে। operator নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
matchesAny

object ( StringList )

যদি নির্দিষ্ট মাত্রার জন্য একটি সারির মান এই শর্তে নির্দিষ্ট করা মানের যেকোনো একটিতে থাকে, তাহলে এটি একটি সারির সাথে মিলিত হয়।

সাজানোর অবস্থা

একটি মাত্রা বা মেট্রিকের উপর প্রয়োগ করার জন্য সাজানোর দিক।

JSON উপস্থাপনা 
{
  "order": enum (SortOrder),

  // Union field sort_on can be only one of the following:
  "dimension": enum (Dimension),
  "metric": enum (Metric)
  // End of list of possible types for union field sort_on.
}
ক্ষেত্র
order

enum ( SortOrder )

মাত্রা বা মেট্রিকের সাজানোর ক্রম।

Union ফিল্ড sort_on । কোন মানগুলিতে সাজানো হবে তা চিহ্নিত করে। sort_on নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
dimension

enum ( Dimension )

নির্দিষ্ট মাত্রা অনুসারে সাজান।

metric

enum ( Metric )

নির্দিষ্ট মেট্রিক অনুসারে সাজান।