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 ওভারভিউ দেখুন।

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

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

{
  '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 যতটা সম্ভব সারি দেয়, 100000 পর্যন্ত। গ্রহণযোগ্য মান হল 1-100000, অন্তর্ভুক্ত। 100000 এর থেকে বড় মান একটি ত্রুটি প্রদান করে।

timeZone

string

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

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

মাত্রা

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

এনামস
DIMENSION_UNSPECIFIED একটি আনসেট ক্ষেত্রের জন্য ডিফল্ট মান। ব্যবহার করবেন না.
DATE YYYYMMDD ফর্ম্যাটে একটি তারিখ (উদাহরণস্বরূপ, "20210701")। অনুরোধ সর্বাধিক এক সময়ের মাত্রা নির্দিষ্ট করতে পারেন.
MONTH YYYYMM ফর্ম্যাটে একটি মাস (উদাহরণস্বরূপ, "202107")। অনুরোধ সর্বাধিক এক সময়ের মাত্রা নির্দিষ্ট করতে পারেন.
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 দেশের কোড (উদাহরণস্বরূপ, "US" বা "FR")। এটি একটি ভূগোল মাত্রা।
FORMAT বিজ্ঞাপন ইউনিটের ফর্ম্যাট (উদাহরণস্বরূপ, "ব্যানার", "নেটিভ"), একটি বিজ্ঞাপন বিতরণের মাত্রা।
PLATFORM অ্যাপের মোবাইল OS প্ল্যাটফর্ম (উদাহরণস্বরূপ, "Android" বা "iOS")।
MOBILE_OS_VERSION মোবাইল অপারেটিং সিস্টেম সংস্করণ, যেমন "iOS 13.5.1"।
GMA_SDK_VERSION GMA SDK সংস্করণ, যেমন "iOS 7.62.0"।
APP_VERSION_NAME অ্যান্ড্রয়েডের জন্য, প্যাকেজইনফোতে সংস্করণের নামটিতে অ্যাপ সংস্করণের নাম পাওয়া যাবে। iOS-এর জন্য, অ্যাপ সংস্করণের নাম CFBundleShortVersionString-এ পাওয়া যাবে।
SERVING_RESTRICTION বিজ্ঞাপন পরিবেশনের জন্য বিধিনিষেধ মোড (যেমন "ব্যক্তিগত বিজ্ঞাপন নয়")।

মেট্রিক

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

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

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

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

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

প্রতি হাজার বিজ্ঞাপন ইম্প্রেশনে আনুমানিক আয়। মান মাইক্রোতে আছে। উদাহরণস্বরূপ, $1.03 1030000 হিসাবে উপস্থাপন করা হবে। 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 )

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

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

enum ( Dimension )

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

metric

enum ( Metric )

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