- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- CampaignReportSpec
- डाइमेंशन
- मेट्रिक
- उदाहरण
- इसे आज़माएं!
दी गई जानकारी के आधार पर कैंपेन रिपोर्ट जनरेट करता है.
एचटीटीपी अनुरोध
POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
उस खाते के संसाधन का नाम जिसके लिए रिपोर्ट जनरेट करनी है. उदाहरण: accounts/pub-9876543210987654 |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{
"reportSpec": {
object ( |
फ़ील्ड | |
---|---|
reportSpec |
कैंपेन रिपोर्ट से जुड़ी खास बातें. |
जवाब का मुख्य भाग
कैंपेन रिपोर्ट एपीआई से मिला रिस्पॉन्स.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"rows": [
{
object ( |
फ़ील्ड | |
---|---|
rows[] |
चुने गए प्रकाशक से मिला कैंपेन रिपोर्ट डेटा. एपीआई से ज़्यादा से ज़्यादा 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 |
रिपोर्ट जनरेट होने की तारीख की सीमा. इसे ज़्यादा से ज़्यादा 30 दिनों का डेटा मिल सकता है. |
dimensions[] |
रिपोर्ट के डाइमेंशन की सूची. इन डाइमेंशन के वैल्यू कॉम्बिनेशन से रिपोर्ट की लाइन तय होती है. अगर कोई डाइमेंशन तय नहीं किया गया है, तो रिपोर्ट पूरे खाते के लिए अनुरोध की गई मेट्रिक की एक लाइन दिखाती है. |
metrics[] |
रिपोर्ट की मेट्रिक की सूची. किसी रिपोर्ट में कम से कम एक मेट्रिक का इस्तेमाल किया जाना चाहिए. |
languageCode |
किसी भी स्थानीय जगह के अनुसार टेक्स्ट के लिए इस्तेमाल की जाने वाली भाषा, जैसे कि लागू होने वाले कुछ डाइमेंशन की वैल्यू. भाषा का टैग, आईईटीएफ़ 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 |
किसी उपयोगकर्ता ने विज्ञापन के साथ कितनी बार इंटरैक्ट किया. इसमें क्लिक और यूज़र ऐक्टिविटी शामिल होती हैं. |