Method: accounts.mediationReport.generate

यह फ़ंक्शन, रिपोर्ट के लिए तय की गई शर्तों के आधार पर AdMob मीडिएशन रिपोर्ट जनरेट करता है. यह फ़ंक्शन, सर्वर-साइड स्ट्रीमिंग वाले RPC का नतीजा दिखाता है. नतीजा, जवाबों के क्रम में दिखाया जाता है.

एचटीटीपी अनुरोध

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

यह यूआरएल, 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 देखें.

MediationReportSpec

AdMob मीडिएशन रिपोर्ट जनरेट करने के लिए स्पेसिफ़िकेशन. उदाहरण के लिए, अमेरिका और चीन के लिए विज्ञापन सोर्स और ऐप्लिकेशन के हिसाब से, देखे गए ईसीपीएम को स्लाइस करने की खास जानकारी इस उदाहरण की तरह दिख सकती है:

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

इसे बेहतर तरीके से समझने के लिए, ऊपर दिए गए स्पेसिफ़िकेशन को इस तरह के सूडो एसक्यूएल के तौर पर देखा जा सकता है:

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

रिपोर्ट के डेटा की ज़्यादा से ज़्यादा कितनी लाइनें दिखानी हैं. अगर वैल्यू सेट नहीं की जाती है, तो एपीआई ज़्यादा से ज़्यादा पंक्तियां दिखाता है. हालांकि, यह संख्या 1,00,000 से ज़्यादा नहीं हो सकती. स्वीकार की जाने वाली वैल्यू, 1 से 1,00,000 के बीच की होनी चाहिए. 1,00,000 से बड़ी वैल्यू के लिए, गड़बड़ी का मैसेज दिखता है.
timeZone

string

रिपोर्ट का टाइम ज़ोन. यह IANA TZ के नाम की वैल्यू स्वीकार करता है. जैसे, "America/Los_Angeles." अगर कोई समय क्षेत्र तय नहीं किया गया है, तो खाते का डिफ़ॉल्ट समय क्षेत्र लागू होगा. खाता पाने के ऐक्शन से डिफ़ॉल्ट वैल्यू की जांच करें.

चेतावनी: फ़िलहाल, सिर्फ़ "America/Los_Angeles" वैल्यू का इस्तेमाल किया जा सकता है.

डाइमेंशन

मीडिएशन रिपोर्ट के डाइमेंशन. डाइमेंशन, डेटा एट्रिब्यूट होते हैं. इनकी मदद से, आंकड़ों वाले मेज़रमेंट (मेट्रिक) को कुछ एट्रिब्यूट के हिसाब से बांटा या बेहतर बनाया जा सकता है. जैसे, विज्ञापन फ़ॉर्मैट या वह प्लैटफ़ॉर्म जिस पर कोई विज्ञापन देखा गया था.

Enums
DIMENSION_UNSPECIFIED सेट नहीं किए गए फ़ील्ड के लिए डिफ़ॉल्ट वैल्यू. इस्तेमाल न करें.
DATE YYYYMMDD फ़ॉर्मैट में तारीख (उदाहरण के लिए, "20210701"). अनुरोधों में ज़्यादा से ज़्यादा एक टाइम डाइमेंशन तय किया जा सकता है.
MONTH YYYYMM फ़ॉर्मैट में महीना. उदाहरण के लिए, "202107". अनुरोधों में ज़्यादा से ज़्यादा एक टाइम डाइमेंशन तय किया जा सकता है.
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 (default)" को लेबल वैल्यू के तौर पर इस्तेमाल किया जाता है.
COUNTRY विज्ञापन को मिले व्यू/क्लिक की जगह का CLDR देश कोड. उदाहरण के लिए, "US" या "FR". यह एक भौगोलिक डाइमेंशन है.
FORMAT विज्ञापन यूनिट का फ़ॉर्मैट (उदाहरण के लिए, "बैनर", "नेटिव"), विज्ञापन डिलीवरी डाइमेंशन.
PLATFORM ऐप्लिकेशन का मोबाइल ओएस प्लैटफ़ॉर्म (उदाहरण के लिए, "Android" या "iOS").
MOBILE_OS_VERSION मोबाइल ऑपरेटिंग सिस्टम का वर्शन, जैसे कि "iOS 13.5.1".
GMA_SDK_VERSION GMA SDK का वर्शन, जैसे कि "iOS 7.62.0".
APP_VERSION_NAME Android के लिए, ऐप्लिकेशन के वर्शन का नाम, PackageInfo में versionName में मिल सकता है. iOS के लिए, ऐप्लिकेशन के वर्शन का नाम CFBundleShortVersionString में देखा जा सकता है.
SERVING_RESTRICTION विज्ञापन दिखाने के लिए पाबंदी वाला मोड (जैसे, "लोगों की दिलचस्पी के हिसाब से न दिखाए जाने वाले विज्ञापन").

मेट्रिक

मीडिएशन रिपोर्ट की मेट्रिक. मेट्रिक, क्वांटिटेटिव मेज़रमेंट (ऐसी जानकारी जिसे अंकों में मापा या लिखा जा सकता है) होते हैं. इनसे पता चलता है कि पब्लिशर का कारोबार कैसा परफ़ॉर्म कर रहा है. इन्हें अलग-अलग विज्ञापन इवेंट से इकट्ठा किया जाता है और रिपोर्ट डाइमेंशन के हिसाब से ग्रुप किया जाता है. मेट्रिक वैल्यू, पूर्णांक या दशमलव (बिना राउंड किए) होती है.

Enums
METRIC_UNSPECIFIED सेट नहीं किए गए फ़ील्ड के लिए डिफ़ॉल्ट वैल्यू. इस्तेमाल न करें.
AD_REQUESTS अनुरोधों की संख्या. यह वैल्यू एक पूर्णांक है.
CLICKS किसी उपयोगकर्ता ने किसी विज्ञापन पर कितनी बार क्लिक किया. यह वैल्यू एक पूर्णांक है.
ESTIMATED_EARNINGS

AdMob पब्लिशर की अनुमानित आमदनी. कमाई की मेट्रिक की मुद्रा इकाई (USD, EUR या अन्य) को मुद्रा के लिए स्थानीय भाषा की सेटिंग के हिसाब से तय किया जाता है. यह रकम माइक्रो में होती है. उदाहरण के लिए, 6.50 डॉलर को 6500000 के तौर पर दिखाया जाएगा.

हर मीडिएशन ग्रुप और हर विज्ञापन सोर्स के इंस्टेंस लेवल के लिए, अनुमानित आय की जानकारी 20 अक्टूबर, 2019 से उपलब्ध है. तीसरे पक्ष से होने वाली अनुमानित आमदनी, 20 अक्टूबर, 2019 से पहले की तारीखों के लिए 0 दिखेगी.
IMPRESSIONS उपयोगकर्ताओं को दिखाए गए विज्ञापनों की कुल संख्या. यह वैल्यू एक पूर्णांक है.
IMPRESSION_CTR इंप्रेशन की तुलना में क्लिक का अनुपात. यह वैल्यू, डबल प्रिसिशन (लगभग) वाली दशमलव वैल्यू होती है.
MATCHED_REQUESTS किसी अनुरोध के जवाब में, विज्ञापन कितनी बार दिखाए गए. यह वैल्यू एक पूर्णांक है.
MATCH_RATE यह कुल विज्ञापन अनुरोधों में से, मैच किए गए विज्ञापन अनुरोधों का अनुपात होता है. यह वैल्यू, डबल प्रिसिशन (लगभग) वाली दशमलव वैल्यू होती है.
OBSERVED_ECPM

तीसरे पक्ष की विज्ञापन नेटवर्क कंपनी का अनुमानित औसत ईसीपीएम. कमाई की मेट्रिक की मुद्रा इकाई (USD, EUR या अन्य) को मुद्रा के लिए स्थानीय भाषा की सेटिंग के हिसाब से तय किया जाता है. यह रकम माइक्रो में होती है. उदाहरण के लिए, 2.30 डॉलर को 2300000 के तौर पर दिखाया जाएगा.

हर मीडिएशन ग्रुप और हर विज्ञापन सोर्स के इंस्टेंस लेवल के लिए, अनुमानित औसत ईसीपीएम की सुविधा 20 अक्टूबर, 2019 से उपलब्ध है. तीसरे पक्ष के अनुमानित औसत ईसीपीएम की वैल्यू, 20 अक्टूबर, 2019 से पहले की तारीखों के लिए 0 दिखेगी.

DimensionFilter

इससे पता चलता है कि डाइमेंशन वैल्यू के आधार पर, रिपोर्ट की किन लाइनों को मैच करना है.

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)

अगर किसी लाइन के लिए, तय किए गए डाइमेंशन की वैल्यू, इस शर्त में दी गई वैल्यू में से कोई एक है, तो यह शर्त मैच होती है.

SortCondition

डाइमेंशन या मेट्रिक पर लागू होने वाला क्रम से लगाने का तरीका.

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)

चुनी गई मेट्रिक के हिसाब से क्रम में लगाएं.