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)

कैंपेन रिपोर्ट से जुड़ी खास बातें.

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

कैंपेन रिपोर्ट एपीआई से मिला रिस्पॉन्स.

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

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 की खास जानकारी देखें.

CampaignReportSpec

कैंपेन रिपोर्ट जनरेट करने से जुड़ी जानकारी. उदाहरण के लिए, CAMPAIGN_ID के आधार पर काटे गए इंप्रेशन और 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

किसी भी स्थानीय जगह के अनुसार टेक्स्ट के लिए इस्तेमाल की जाने वाली भाषा, जैसे कि लागू होने वाले कुछ डाइमेंशन की वैल्यू. भाषा का टैग, आईईटीएफ़ 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 किसी उपयोगकर्ता ने विज्ञापन के साथ कितनी बार इंटरैक्ट किया. इसमें क्लिक और यूज़र ऐक्टिविटी शामिल होती हैं.