Method: accounts.mediationReport.generate

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

HTTP অনুরোধ

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

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

পথের পরামিতি

পরামিতি
parent

string

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

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

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

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

object ( MediationReportSpec )

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

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

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": {"decimal_value": "1324746"}
    }
  }
},
{
  "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 মধ্যস্থতা প্রতিবেদন তৈরির স্পেসিফিকেশন। উদাহরণস্বরূপ, 'মার্কিন যুক্তরাষ্ট্র' এবং 'সিএন' দেশগুলির জন্য বিজ্ঞাপন উৎস এবং অ্যাপ দ্বারা ECPM স্লাইস করা পর্যবেক্ষণের জন্য স্পেসিফিকেশনটি নিম্নলিখিত উদাহরণের মতো দেখতে হতে পারে:

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

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

SELECT AD_SOURCE, APP, COUNTRY, OBSERVED_ECPM
FROM MEDIATION_REPORT
WHERE DATE >= '2021-09-01' AND DATE <= '2021-09-30'
    AND COUNTRY IN ('US', 'CN')
GROUP BY AD_SOURCE, APP, COUNTRY
ORDER BY APP ASC;
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_SOURCE বিজ্ঞাপন উৎসের অনন্য আইডি (উদাহরণস্বরূপ, "5450213213286189855" এবং লেবেল মান হিসেবে "AdMob Network")।
AD_SOURCE_INSTANCE বিজ্ঞাপন উৎসের উদাহরণের অনন্য আইডি (যেমন, "ca-app-pub-1234:asi:5678" এবং লেবেল মান হিসেবে "AdMob (ডিফল্ট)")।
AD_UNIT বিজ্ঞাপন ইউনিটের অনন্য আইডি (উদাহরণস্বরূপ, "ca-app-pub-1234/8790")। যদি AD_UNIT মাত্রা নির্দিষ্ট করা থাকে, তাহলে APP স্বয়ংক্রিয়ভাবে অন্তর্ভুক্ত হয়ে যায়।
APP মোবাইল অ্যাপ্লিকেশনের অনন্য আইডি (উদাহরণস্বরূপ, "ca-app-pub-1234~1234")।
MEDIATION_GROUP মধ্যস্থতা গোষ্ঠীর অনন্য আইডি (উদাহরণস্বরূপ, "ca-app-pub-1234:mg:1234" এবং লেবেল মান হিসেবে "AdMob (ডিফল্ট)")।
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 অনুরোধের সংখ্যা। মানটি একটি পূর্ণসংখ্যা।
CLICKS একজন ব্যবহারকারী কতবার একটি বিজ্ঞাপনে ক্লিক করেছেন। মানটি একটি পূর্ণসংখ্যা।
ESTIMATED_EARNINGS

AdMob প্রকাশকের আনুমানিক আয়। আয়ের মেট্রিক্সের মুদ্রা ইউনিট (USD, EUR, অথবা অন্যান্য) মুদ্রার স্থানীয়করণ সেটিং দ্বারা নির্ধারিত হয়। পরিমাণটি মাইক্রোতে। উদাহরণস্বরূপ, $6.50 কে 6500000 হিসাবে উপস্থাপন করা হবে।

২০ অক্টোবর, ২০১৯ তারিখের মধ্যস্থতা গোষ্ঠী এবং বিজ্ঞাপন উৎসের উদাহরণ স্তরের জন্য আনুমানিক আয় সমর্থিত। ২০ অক্টোবর, ২০১৯ তারিখের আগের তারিখের জন্য তৃতীয় পক্ষের আনুমানিক আয় ০ দেখাবে।

IMPRESSIONS ব্যবহারকারীদের দেখানো মোট বিজ্ঞাপনের সংখ্যা। মানটি একটি পূর্ণসংখ্যা।
IMPRESSION_CTR ক্লিকের তুলনায় ইম্প্রেশনের অনুপাত। মানটি দ্বিগুণ নির্ভুলতা (আনুমানিক) দশমিক মান।
MATCHED_REQUESTS একটি অনুরোধের প্রতিক্রিয়ায় বিজ্ঞাপনগুলি কতবার ফেরত পাঠানো হয়েছে তার সংখ্যা। মানটি একটি পূর্ণসংখ্যা।
MATCH_RATE মোট বিজ্ঞাপন অনুরোধের সাথে মিলে যাওয়া বিজ্ঞাপন অনুরোধের অনুপাত। মানটি দ্বিগুণ নির্ভুলতা (আনুমানিক) দশমিক মান।
OBSERVED_ECPM

তৃতীয় পক্ষের বিজ্ঞাপন নেটওয়ার্কের আনুমানিক গড় eCPM। উপার্জনের মেট্রিক্সের মুদ্রা ইউনিট (USD, EUR, অথবা অন্যান্য) মুদ্রার স্থানীয়করণ সেটিং দ্বারা নির্ধারিত হয়। পরিমাণটি মাইক্রোতে। উদাহরণস্বরূপ, $2.30 কে 2300000 হিসাবে উপস্থাপন করা হবে।

প্রতি মধ্যস্থতা গোষ্ঠী এবং বিজ্ঞাপন উৎসের উদাহরণ স্তরের জন্য আনুমানিক গড় eCPM ২০ অক্টোবর, ২০১৯ তারিখ থেকে সমর্থিত। ২০ অক্টোবর, ২০১৯ তারিখের আগের তারিখগুলির জন্য তৃতীয় পক্ষের আনুমানিক গড় eCPM ০ দেখাবে।

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

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

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 )

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