Method: accounts.campaignReport.generate

यह फ़ंक्शन, दी गई खास बातों के आधार पर कैंपेन रिपोर्ट जनरेट करता है.

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

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

वह खाता जिसका इस्तेमाल करके रिपोर्ट जनरेट करनी है उसका संसाधन नाम. उदाहरण: accounts/pub-9876543210987654

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
फ़ील्ड
reportSpec

object (CampaignReportSpec)

कैंपेन रिपोर्ट का स्पेसिफ़िकेशन.

जवाब का मुख्य भाग

Campaign Report API से मिला रिस्पॉन्स.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
फ़ील्ड
rows[]

object (ReportRow)

चुने गए पब्लिशर के कैंपेन की रिपोर्ट का डेटा. एपीआई से ज़्यादा से ज़्यादा 1,00,000 लाइनें दिखेंगी.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.

CampaignReportSpec

कैंपेन रिपोर्ट जनरेट करने के लिए स्पेसिफ़िकेशन. उदाहरण के लिए, 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": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
फ़ील्ड
dateRange

object (DateRange)

वह तारीख की सीमा जिसके लिए रिपोर्ट जनरेट की गई है. ज़्यादा से ज़्यादा 30 दिनों का डेटा देखा जा सकता है.
dimensions[]

enum (Dimension)

रिपोर्ट के डाइमेंशन की सूची. इन डाइमेंशन की वैल्यू के कॉम्बिनेशन से, रिपोर्ट की लाइन तय होती है. अगर कोई डाइमेंशन नहीं दिया जाता है, तो रिपोर्ट में पूरे खाते के लिए, अनुरोध की गई मेट्रिक की एक लाइन दिखती है.
metrics[]

enum (Metric)

रिपोर्ट की मेट्रिक की सूची. किसी रिपोर्ट में कम से कम एक मेट्रिक के बारे में जानकारी देना ज़रूरी है.
languageCode

string

किसी भी स्थानीय भाषा में लिखे गए टेक्स्ट के लिए इस्तेमाल की गई भाषा. जैसे, लागू होने वाली कुछ डाइमेंशन वैल्यू. भाषा का टैग, IETF BCP47 में तय किया गया है. अगर भाषा के कोड की वैल्यू नहीं दी गई है या वह अमान्य है, तो डिफ़ॉल्ट रूप से 'en-US' सेट होता है.

डाइमेंशन

कैंपेन रिपोर्ट के डाइमेंशन.

Enums
DIMENSION_UNSPECIFIED जिस डाइमेंशन के बारे में नहीं बताया गया है उसकी डिफ़ॉल्ट वैल्यू. इस्तेमाल न करें.
DATE YYYYMMDD फ़ॉर्मैट में तारीख (उदाहरण के लिए, "20210701").
CAMPAIGN_ID कैंपेन का यूनीक आईडी. उदाहरण के लिए, "123456789". यह कैंपेन लिस्ट एपीआई से मिले कैंपेन आईडी से मेल खाता है.
CAMPAIGN_NAME अभियान का नाम.
AD_ID विज्ञापन का यूनीक आईडी. उदाहरण के लिए, "123456789".
AD_NAME विज्ञापन का नाम. यह यूनीक नहीं हो सकता.
PLACEMENT_ID जिस ऐप्लिकेशन में विज्ञापन दिखाया गया है उसके लिए, वेंडर का यूनीक आईडी. उदाहरण के लिए, Android के लिए com.goog.bar और iOS ऐप्लिकेशन के लिए 123456789.
PLACEMENT_NAME उस ऐप्लिकेशन का नाम जहां विज्ञापन दिखाया गया है.
PLACEMENT_PLATFORM ऐप्लिकेशन का वह प्लैटफ़ॉर्म जहां विज्ञापन दिखाया जाता है.
COUNTRY टारगेट किए गए देश का नाम.
FORMAT विज्ञापन यूनिट का फ़ॉर्मैट (उदाहरण के लिए, "बैनर", "नेटिव"), विज्ञापन डिलीवरी डाइमेंशन.

मेट्रिक

कैंपेन रिपोर्ट की मेट्रिक.

Enums
METRIC_UNSPECIFIED सेट नहीं किए गए फ़ील्ड के लिए डिफ़ॉल्ट वैल्यू. इस्तेमाल न करें.
IMPRESSIONS उपयोगकर्ता को कोई विज्ञापन कितनी बार दिखाया गया.
CLICKS किसी उपयोगकर्ता ने किसी विज्ञापन पर कितनी बार क्लिक किया.
CLICK_THROUGH_RATE सीटीआर, विज्ञापन को मिलने वाले क्लिक की संख्या को, विज्ञापन दिखाए जाने की संख्या से भाग देने पर मिलने वाली संख्या होती है.
INSTALLS डिवाइसों पर ऐप्लिकेशन डाउनलोड किए जाने की संख्या.
ESTIMATED_COST रेवेन्यू जनरेट करने वाले विज्ञापन के बजाय, कैंपेन से जुड़ा कोई विज्ञापन दिखाने की अनुमानित लागत. यह मुद्रा, कैंपेन के लिए रिपोर्टिंग मुद्रा है.
AVERAGE_CPI हर इंस्टॉल की औसत लागत. इसका मतलब है कि नया उपयोगकर्ता हासिल करने में खर्च की गई औसत रकम. यह मुद्रा, कैंपेन के लिए रिपोर्टिंग मुद्रा है.
INTERACTIONS किसी उपयोगकर्ता ने विज्ञापन से कितनी बार इंटरैक्ट किया. इसमें क्लिक और यूज़र ऐक्टिविटी शामिल होती है.