इस पेज का अनुवाद Cloud Translation API से किया गया है.

विज्ञापनों की गतिविधि की रिपोर्ट का ऐल्फ़ा एपीआई

चेतावनी: विज्ञापन गतिविधि रिपोर्ट के ऐल्फ़ा वर्शन में शामिल होने के लिए धन्यवाद. कॉन्टेंट बनाने Ads ऐक्टिविटी रिपोर्ट का ऐल्फ़ा वर्शन से बाहर निकलने का कोई प्लान नहीं है और यह अब काम नहीं करती. कृपया मीडिएशन रिपोर्ट एपीआई का इस्तेमाल करें आज़माएं. ऐल्फ़ा के स्टेबिलिटी कंस्ट्रेंट के बारे में ज़्यादा जानें चैनल.

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

Ads Activity Report API, मीडिएशन से बेहतर सुविधाएं देती है नीचे दी गई टेबल की तरह, रिपोर्ट एपीआई और Network Report API का इस्तेमाल करें:

	नेटवर्क रिपोर्ट एपीआई	मीडिएशन रिपोर्ट एपीआई	Ads ऐक्टिविटी रिपोर्ट एपीआई
नेटवर्क की परफ़ॉर्मेंस	✅	✅	✅
वॉटरफ़ॉल परफ़ॉर्मेंस		✅	✅
बिडिंग की परफ़ॉर्मेंस			✅
मीडिएशन A/B एक्सपेरिमेंट की परफ़ॉर्मेंस			✅
हर घंटे की रिपोर्टिंग			✅
रिपोर्ट का साइज़	1 लाख	1 लाख	5 लाख

मेट्रिक, डाइमेंशन, और डाइमेंशन फ़िल्टर

इन मेट्रिक को Ads Activity Report API में जोड़ा गया है: इसके अलावा, Network Report API में मौजूद कई मेट्रिक और मीडिएशन रिपोर्ट एपीआई.

मेट्रिक	ब्यौरा
BID_REQUEST	बिडिंग में हिस्सा लेने वाले विज्ञापन स्रोत के लिए किए गए अनुरोधों की संख्या.
BIDS_IN_AUCTION	नीलामी में हिस्सा लेने वाले विज्ञापन सोर्स की ओर से सबमिट की गई बिड की संख्या.
WINNING_BIDS	किसी नीलामी में जीतने वाली बिड की संख्या.

Google Ads Activity Report API में, नीचे दिए गए नए डाइमेंशन शामिल किए गए हैं.

डाइमेंशन	ब्यौरा
WEEK	हफ़्ते के पहले दिन की तारीख (भाषा के हिसाब से स्थानीय भाषा सेटिंग में बताया गया कोड) YYYYMMDD फ़ॉर्मैट में दें (इसके लिए उदाहरण के लिए, "20210701"). अनुरोध में DATE, WEEK या MONTH में से सिर्फ़ एक के बारे में बताया जा सकता है समय डाइमेंशन.
HOUR	पीएसटी समय में, घंटे के घंटे को HH फ़ॉर्मैट में सेट किया जाता है. उदाहरण के लिए, "05" सुबह 5 बजे पीएसटी के लिए, "13" 1pm पीएसटी के लिए. DATE डाइमेंशन भी अनुरोध में बताया जाना चाहिए. ऐप्लिकेशन Hour डाइमेंशन के बारे में बताने पर, ज़्यादा से ज़्यादा 28 दिनों का डेटा दिखता है. तारीख की सीमा के शुरू होने की ऐसी तारीखें जो मौजूदा तारीख से 28 दिन पहले से ज़्यादा की हों कोई गड़बड़ी दिखाएं.
MEDIATION_AB_TEST (प्रयोग का नाम)	मीडिएशन की सुविधा के A/B टेस्ट के हिसाब से परफ़ॉर्मेंस देखें. यह जानकारी देना ज़रूरी है का उपयोग करें.
MEDIATION_AB_TEST_VARIANT (वैरिएंट A, वैरिएंट B)	मीडिएशन के A/B टेस्ट के वैरिएंट के हिसाब से परफ़ॉर्मेंस देखें.

ध्यान दें: विज्ञापनों की गतिविधि की रिपोर्ट में मौजूद सभी डाइमेंशन, डाइमेंशन के तौर पर काम करते हैं फ़िल्टर. _NAME और _ID सफ़िक्स वाली वैल्यू के लिए, _ID सफ़िक्स यह है फ़िल्टर वैल्यू का इस्तेमाल किया जा सकता है. विज्ञापन यूनिट को फ़िल्टर करने के लिए, AD_UNIT_ID का इस्तेमाल करें डाइमेंशन को डाइमेंशन फ़िल्टर के तौर पर चुनें.

मीडिएशन रिपोर्ट एपीआई में डाइमेंशन का नाम	Ads Activity Report API में डाइमेंशन का नाम	ब्यौरा
AD_UNIT¹	AD_UNIT_ID	विज्ञापन यूनिट का यूनीक आईडी, जैसे कि "123456789".
AD_UNIT¹	AD_UNIT_NAME	विज्ञापन यूनिट का नाम.
ऐप्लिकेशन¹	APP_ID	मोबाइल ऐप्लिकेशन का यूनीक आईडी (उदाहरण के लिए, "1234567890").
ऐप्लिकेशन¹	APP_NAME	ऐप्लिकेशन का नाम.
AD_SOURCE¹	AD_SOURCE_ID	विज्ञापन स्रोत का यूनीक आईडी (उदाहरण के लिए, "1234567890123456789".
AD_SOURCE¹	AD_SOURCE_NAME	विज्ञापन सोर्स का नाम (उदाहरण के लिए, "AdMob नेटवर्क").
AD_SOURCE_INSTANCE¹	AD_SOURCE_INSTANCE_ID	विज्ञापन स्रोत के इंस्टेंस का यूनीक आईडी (उदाहरण के लिए, "123456789012").
AD_SOURCE_INSTANCE¹	AD_SOURCE_INSTANCE_NAME	विज्ञापन सोर्स के इंस्टेंस का नाम (उदाहरण के लिए, "AdMob (डिफ़ॉल्ट)").
MEDIATION_GROUP¹	MEDIATION_GROUP_ID	मीडिएशन ग्रुप का यूनीक आईडी (उदाहरण के लिए, "1234567890").
MEDIATION_GROUP¹	MEDIATION_GROUP_NAME	मीडिएशन ग्रुप का यूनीक आईडी. उदाहरण के लिए, "AdMob (डिफ़ॉल्ट)".

¹: ज़्यादा जानकारी के लिए, Scalars देखें.

इन डाइमेंशन का फ़ॉर्मैट अपडेट है.

मीडिएशन रिपोर्ट एपीआई में डाइमेंशन का नाम	मीडिएशन रिपोर्ट एपीआई में जानकारी	Ads Activity Report API में जानकारी
ESTIMATED_EARNINGS	AdMob प्रकाशक की अनुमानित आय. मुद्रा की इकाई (USD, यूरो या अन्य) मेट्रिक में, देश/इलाके के हिसाब से मुद्रा की सेटिंग. राशि माइक्रो में है. उदाहरण के लिए, 6.50 डॉलर 65,00,000 के तौर पर दिखाया जाता है. हर मीडिएशन ग्रुप और हर विज्ञापन सोर्स इंस्टेंस लेवल पर अनुमानित आमदनी 20 अक्टूबर, 2019 से काम कर रहे हैं. तीसरे पक्ष की अनुमानित आमदनी 20 अक्टूबर, 2019 से पहले की तारीखों के लिए 0 दिखाएं.	AdMob प्रकाशक की अनुमानित आय. मुद्रा की इकाई (USD, यूरो या अन्य) मेट्रिक में, देश/इलाके के हिसाब से मुद्रा की सेटिंग.
OBSERVED_ECPM	तीसरे पक्ष की विज्ञापन नेटवर्क कंपनी का अनुमानित औसत eCPM. मुद्रा इकाई कमाई करने से जुड़ी मेट्रिक (डॉलर, यूरो या अन्य) को स्थानीय भाषा के अनुसार तय किया जाता है मुद्रा की सेटिंग. राशि माइक्रो में है. उदाहरण के लिए, 2.30 डॉलर 23,00,000 के तौर पर दिखाया जाता है. हर मीडिएशन ग्रुप और हर विज्ञापन सोर्स के इंस्टेंस लेवल के लिए अनुमानित औसत eCPM यह सुविधा 20 अक्टूबर, 2019 से काम कर रही है. तृतीय-पक्ष अनुमानित औसत eCPM, 20 अक्टूबर, 2019 से पहले की तारीखों के लिए 0 दिखेगा.	सभी विज्ञापनों के लिए औसत eCPM. इसकी मुद्रा इकाई (USD, EUR या अन्य) कमाई की मेट्रिक, मुद्रा के लिए स्थानीय भाषा की सेटिंग से तय की जाती हैं. हर मीडिएशन ग्रुप और विज्ञापन सोर्स के इंस्टेंस लेवल के हिसाब से औसत eCPM, 20 अक्टूबर, 2019 से काम कर रहे हैं. OBSERVED_ECPM, तारीखों के लिए 0 दिखाएगा 20 अक्टूबर, 2019 से पहले की है.

Scalars

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

मीडिएशन रिपोर्ट एपीआई और नेटवर्क रिपोर्ट एपीआई में प्रभावित डाइमेंशन:

AD_UNIT
APP
AD_SOURCE
AD_SOURCE_INSTANCE
MEDIATION_GROUP

सैंपल रिपोर्ट रिस्पॉन्स डेटा
मीडिएशन / नेटवर्क एपीआई डाइमेंशन फ़ॉर्मैट	"AD_UNIT": { "value":"ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY", "displayLabel": "Test ad unit name" }
एएआर एपीआई डाइमेंशन फ़ॉर्मैट	"AD_UNIT_NAME": "Test ad unit name", "AD_UNIT_ID": "ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY"

हर घंटे की रिपोर्ट

अब AdMob API में, हर घंटे के हिसाब से परफ़ॉर्मेंस देखी जा सकती है. प्रति घंटा रिपोर्टिंग है 28 दिनों तक उपलब्ध रहता है.

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

रिपोर्ट का बड़ा साइज़

Ads Activity Report API की मदद से, 5,00,000 लाइनें फिर से पाई जा सकती हैं. इसके लिए ज़्यादा जानकारी के लिए, कोटेशन गाइड देखें.

अनुरोध करें

अनुरोध करने के लिए, यह तरीका अपनाएं.

कर्ल (कमांड लाइन)

कर्ल का इस्तेमाल करने वाले अनुरोध

क्लाइंट सीक्रेट फ़ाइल लोड करें और अनुमति देने वाले क्रेडेंशियल जनरेट करें.

पहली बार इस चरण को पूरा करने पर आपसे अनुमति देने का अनुरोध दिखेगा. स्वीकार करने से पहले, पक्का करें कि आपने आपने किसी ऐसे Google खाते से साइन इन किया हो जिसके पास AdMob API का ऐक्सेस हो. आपका ऐप्लिकेशन को इनमें से जो भी कंपनी की तरफ़ से डेटा ऐक्सेस करने की अनुमति होगी खाते में अभी लॉग इन किया गया है.

हमारा सुझाव है कि पुष्टि करने और अनुमति देने के लिए, oauth2l, एक आसान कमांड-लाइन टूल है Google OAuth 2.0 के साथ काम करता है. oauth2l इंस्टॉल करें और निर्देश नीचे दिया गया है, path_to_credentials_json को पाथ से बदला जा रहा है को credentials.json फ़ाइल में डाउनलोड करें जिसे आप अपनी क्लाउड ऐप्लिकेशन पर चलता है. पहली बार चलाने के लिए, आदेश आपको OAuth 2.0 के ऑथराइज़ेशन फ़्लो की सेटिंग. बाद में चलने वाले चरण, टोकन को रीफ़्रेश करते हैं स्वचालित रूप से.
```
~/go/bin/oauth2l header --json path_to_credentials_json \
        https://www.googleapis.com/auth/admob.readonly
```

Ads ऐक्टिविटी रिपोर्ट जनरेट करें.

curl -X POST https://admob.googleapis.com/v1alpha/accounts/pub-XXXXXXXXXXXXXXXX/adsActivityReport:generate \
     -H "Content-Type: application/json" \
     -H "$(~/go/bin/oauth2l header --json path_to_credentials_json https://www.googleapis.com/auth/admob.readonly)"  --data @- << EOF
      {
        "report_spec": {
        "date_range": {
          "start_date": {"year": 2023, "month": 1, "day": 1},
          "end_date": {"year": 2023, "month": 1, "day": 2}
        },
        "dimensions": ["DATE", "HOUR", "MEDIATION_AB_TEST", "VARIANT", "AD_SOURCE_ID", "AD_SOURCE_NAME"],
        "metrics": ["CLICKS", "BID_REQUEST","WINNING_BIDS", "IMPRESSIONS", "ESTIMATED_EARNINGS" ],
        "dimension_filters": [{"dimension": "COUNTRY", "matches_any": {"values": ["US"]}}],
        "sort_conditions": [{"metric":"CLICKS", "order": "DESCENDING"}],
        "localization_settings": {"currency_code": "USD", "language_code": "en-US"}
        }
      }
EOF

रिस्पॉन्स का उदाहरण:

{
"rows": [
  {
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant A"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 0
      },
      "BID_REQUEST": {
        "integerValue": "27"
      },
      "WINNING_BIDS": {
        "doubleValue": 0.1111111111111111
      },
      "IMPRESSIONS": {
        "integerValue": "2"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0
      }
    }
  },
{
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant B"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 1
      },
      "BID_REQUEST": {
        "integerValue": "6"
      },
      "WINNING_BIDS": {
        "doubleValue": 1
      },
      "IMPRESSIONS": {
        "integerValue": "3"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0.000427519
      }
    }
  }
]}