रिपोर्ट प्रकार: विज्ञापन

विज्ञापनों की परफ़ॉर्मेंस मेट्रिक और कॉन्फ़िगरेशन एट्रिब्यूट.

इस रिपोर्ट को सिर्फ़ एसिंक्रोनस अनुरोध (report.request() तरीके का इस्तेमाल करके) ही लौटाया जा सकता है.

कोटेशन का अनुरोध करें

नियमित रूप से report.request() अनुरोध का मुख्य हिस्सा भेजें, लेकिन "reportType": "ad" बताएं.

{
...
  "reportType": "ad",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

रिपोर्ट में हर उस कॉलम के लिए columnName डालें जिसके लिए आप रिपोर्ट दिखाना या फ़िल्टर करना चाहते हैं. इसके अलावा, headerText, startDate, और endDate को भी तय किया जा सकता है. ध्यान दें कि कुछ कॉलम फ़िल्टर नहीं किए जा सकते; नीचे दी गई टेबल में "फ़िल्टर करने लायक" देखें.

columnName	ब्यौरा	व्यवहार	टाइप	फ़िल्टर करने लायक
status	विज्ञापन की स्थिति: Active, Paused या Removed. ध्यान दें कि कैंपेन, विज्ञापन ग्रुप, कीवर्ड, और विज्ञापनों की अपनी अलग स्थिति होती है. स्टेटस देखें.	एट्रिब्यूट	Status	हां
engineStatus	बाहरी इंजन खाते में विज्ञापन की अतिरिक्त स्थिति. संभावित स्थितियों में (बाहरी खाते के टाइप के आधार पर) active, eligible, creative deleted, creative approved family safe वगैरह शामिल हैं.	एट्रिब्यूट	String	हां
creationTimestamp	विज्ञापन बनाने के लिए टाइमस्टैंप, ISO 8601 में फ़ॉर्मैट किया गया.	एट्रिब्यूट	Timestamp	हां
lastModifiedTimestamp	विज्ञापन के हाल ही में किए गए बदलाव का टाइमस्टैंप, जिसे ISO 8601 में फ़ॉर्मैट किया गया है.	एट्रिब्यूट	Timestamp	हां
agency	एजेंसी का नाम.	एट्रिब्यूट	String	हां
agencyId	DS एजेंसी आईडी.	एट्रिब्यूट	ID	हां
advertiser	विज्ञापन देने वाले का नाम.	एट्रिब्यूट	String	हां
advertiserId	DS विज्ञापन देने वाले का आईडी.	एट्रिब्यूट	ID	हां
account	इंजन खाते का नाम.	एट्रिब्यूट	String	हां
accountId	DS इंजन खाता आईडी.	एट्रिब्यूट	ID	हां
accountEngineId	बाहरी इंजन खाते में मौजूद खाते का आईडी.	एट्रिब्यूट	String	हां
accountType	इंजन खाता टाइप: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu या Comparison Shopping.	एट्रिब्यूट	Engine type	हां
campaign	कैंपेन का नाम.	एट्रिब्यूट	String	हां
campaignId	DS कैंपेन आईडी.	एट्रिब्यूट	ID	हां
campaignStatus	कैंपेन की स्थिति, जिसमें यह आइटम शामिल है.	एट्रिब्यूट	Status	हां
adGroup	विज्ञापन समूह का नाम.	एट्रिब्यूट	String	हां
adGroupId	DS विज्ञापन समूह आईडी.	एट्रिब्यूट	ID	हां
adGroupStatus	उस विज्ञापन ग्रुप की स्थिति जिसमें यह आइटम शामिल है.	एट्रिब्यूट	Status	हां
ad	विज्ञापन का नाम.	एट्रिब्यूट	String	हां
adId	DS विज्ञापन आईडी. 0 वैल्यू का मतलब है कि विज्ञापन एट्रिब्यूट नहीं किया गया है.	एट्रिब्यूट	ID	हां
adEngineId	बाहरी इंजन खाते में मौजूद विज्ञापन का आईडी.	एट्रिब्यूट	ID	हां
isUnattributedAd	इससे पता चलता है कि इस लाइन में मौजूद मेट्रिक, किसी विज्ञापन के लिए एट्रिब्यूट नहीं किए जा सकते. उदाहरण के लिए, किसी गलत फ़ॉर्मैट या क्लिक सर्वर का यूआरएल गलत होने पर, डीएस को किसी विज्ञापन के लिए मेट्रिक एट्रिब्यूट नहीं करने दिए जा सकते.	एट्रिब्यूट	Boolean	हां
adHeadline	विज्ञापन की हेडलाइन.	एट्रिब्यूट	String	हां
adHeadline2	विज्ञापन की हेडलाइन 2; कुछ इंजन के लिए उपलब्ध नहीं है.	एट्रिब्यूट	String	हां
adHeadline3	विज्ञापन की हेडलाइन 3; कुछ इंजन के लिए उपलब्ध नहीं है.	एट्रिब्यूट	String	हां
adDescription1	विज्ञापन वर्णन पंक्ति 1.	एट्रिब्यूट	String	हां
adDescription2	विज्ञापन विवरण पंक्ति 2; कुछ इंजन के लिए उपलब्ध नहीं है.	एट्रिब्यूट	String	हां
adDisplayUrl	विज्ञापन में शामिल यूआरएल.	एट्रिब्यूट	String	हां
adLandingPage	विज्ञापन का लैंडिंग पेज. लैंडिंग पेज और क्लिक सर्वर के यूआरएल देखें.	एट्रिब्यूट	String	हां
adType	विज्ञापन का टाइप: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text या Expanded dynamic search.	एट्रिब्यूट	Ad type	हां
adPromotionLine	विज्ञापन प्रचार पंक्ति. प्रॉडक्ट विज्ञापन के लिए एक छोटा सा प्रमोशन मैसेज.	एट्रिब्यूट	String	हां
adLabels	इस विज्ञापन को सीधे तौर पर असाइन किए गए लेबल के नाम; इसमें इनहेरिट किए गए लेबल शामिल नहीं हैं.	एट्रिब्यूट	String list	हां
adPathField1	विज्ञापन पाथ फ़ील्ड 1. विज्ञापन में दिखाए गए यूआरएल को बनाने के लिए, पाथ फ़ील्ड 1 और 2 को adDisplayUrl के साथ जोड़ा जाता है.	एट्रिब्यूट	String	हां
adPathField2	विज्ञापन पाथ फ़ील्ड 2. विज्ञापन में दिखाए गए यूआरएल को बनाने के लिए, पाथ फ़ील्ड 1 और 2 को adDisplayUrl के साथ जोड़ा जाता है.	एट्रिब्यूट	String	हां
effectiveLabels	इस विज्ञापन में इनहेरिट किए गए या सीधे तौर पर असाइन किए गए सभी लेबल के नाम.	एट्रिब्यूट	String list	हां
dfaActions	Campaign Manager कार्रवाइयों की कुल संख्या.	मीट्रिक	Integer	हां
dfaRevenue	Campaign Manager लेन-देन से हुई कुल आय.	मीट्रिक	Money	हां
dfaTransactions	Campaign Manager लेन-देन की कुल संख्या.	मीट्रिक	Integer	हां
dfaWeightedActions	Campaign Manager कार्रवाइयों का वेटेड योग.	मीट्रिक	Number	हां
dfaActionsCrossEnv	क्रॉस-परिवेश Campaign Manager कार्रवाइयों की कुल संख्या.	मीट्रिक	Number	हां
dfaRevenueCrossEnv	क्रॉस-एनवायरमेंट कैंपेन मैनेजर के लेन-देन से हुई कुल आय.	मीट्रिक	Money	हां
dfaTransactionsCrossEnv	क्रॉस-एनवायरमेंट कैंपेन मैनेजर के लेन-देन की कुल संख्या.	मीट्रिक	Number	हां
dfaWeightedActionsCrossEnv	क्रॉस-एनवायरमेंट कैंपेन मैनेजर की कार्रवाइयों का कुल योग.	मीट्रिक	Number	हां
avgCpc	हर क्लिक की औसत लागत.	मीट्रिक	Money	हां
avgCpm	हर हज़ार इंप्रेशन की औसत लागत.	मीट्रिक	Money	हां
avgPos	औसत स्थान.	मीट्रिक	Number	हां
clicks	कुल क्लिक.	मीट्रिक	Integer	हां
cost	इंजन खातों को चुकाए गए कुल शुल्क.	मीट्रिक	Money	हां
ctr	क्लिक मिलने की औसत दर.	मीट्रिक	Number	हां
impr	इंप्रेशन की कुल संख्या.	मीट्रिक	Integer	हां
adWordsConversions	वह डेटा जिसे विज्ञापन देने वाले ने, Google Ads कन्वर्ज़न कॉलम में रिपोर्ट करने के लिए सेट अप किया है. Google Ads कन्वर्ज़न ऐक्शन बनाते समय, विज्ञापन देने वाले कन्वर्ज़न रिपोर्टिंग कॉलम में उन कन्वर्ज़न की गिनती करने या न करने का विकल्प चुनते हैं.	मीट्रिक	Number	हां
adWordsConversionValue	Google Ads कन्वर्ज़न की कुल वैल्यू.	मीट्रिक	Number	हां
adWordsViewThroughConversions	Google Ads व्यू-थ्रू कन्वर्ज़न की कुल संख्या.	मीट्रिक	Integer	हां
visits	डीएस विज़िट की कुल संख्या.	मीट्रिक	Integer	हां
date	रिपोर्ट को दिनों के आधार पर सेगमेंट में बांटें; हर लाइन और उसकी कुल मेट्रिक को कई पंक्तियों में बांटा गया है, यानी हर दिन के लिए एक. यह कॉलम हर लाइन की तारीख दिखाता है.	सेगमेंट	Date	हां
monthStart	रिपोर्ट को महीनों के हिसाब से सेगमेंट में बांटें. साथ ही, हर लाइन और उसकी कुल मेट्रिक को, कई पंक्तियों में बांटा गया है, यानी हर महीने के लिए एक. यह कॉलम हर लाइन के महीने का पहला दिन दिखाता है.	सेगमेंट	Date	हां
monthEnd	रिपोर्ट को महीनों के हिसाब से सेगमेंट में बांटें. साथ ही, हर लाइन और उसकी कुल मेट्रिक को, कई पंक्तियों में बांटा गया है, यानी हर महीने के लिए एक. यह कॉलम हर लाइन के महीने का आखिरी दिन दिखाता है.	सेगमेंट	Date	हां
quarterStart	रिपोर्ट को तिमाही के आधार पर सेगमेंट में बांटता है. हर लाइन और उसकी कुल मेट्रिक को कई लाइनों में बांटा जाता है, यानी हर तिमाही के लिए एक लाइन. यह कॉलम हर पंक्ति की तिमाही का पहला दिन दिखाता है.	सेगमेंट	Date	हां
quarterEnd	रिपोर्ट को तिमाही के आधार पर सेगमेंट में बांटता है. हर लाइन और उसकी कुल मेट्रिक को कई लाइनों में बांटा जाता है, यानी हर तिमाही के लिए एक लाइन. यह कॉलम हर पंक्ति की तिमाही का आखिरी दिन दिखाता है.	सेगमेंट	Date	हां
weekStart	रिपोर्ट को हफ़्तों (रविवार से शनिवार) के आधार पर सेगमेंट में बांटता है; हर लाइन और उसकी कुल मेट्रिक कई लाइनों में बंटती हैं, यानी हर हफ़्ते में एक. यह कॉलम हर पंक्ति का पहला दिन (रविवार) दिखाता है.	सेगमेंट	Date	हां
weekEnd	रिपोर्ट को हफ़्तों (रविवार से शनिवार) के आधार पर सेगमेंट में बांटता है; हर लाइन और उसकी कुल मेट्रिक कई लाइनों में बंटती हैं, यानी हर हफ़्ते में एक. यह कॉलम हर पंक्ति का आखिरी दिन (शनिवार) दिखाता है.	सेगमेंट	Date	हां
yearStart	रिपोर्ट को सालों के हिसाब से सेगमेंट में बांटता है. हर लाइन और उसकी कुल मेट्रिक को कई लाइनों में बांटा जाता है, यानी हर साल के लिए एक लाइन. यह कॉलम हर लाइन के साल का पहला दिन दिखाता है.	सेगमेंट	Date	हां
yearEnd	रिपोर्ट को सालों के हिसाब से सेगमेंट में बांटता है. हर लाइन और उसकी कुल मेट्रिक को कई लाइनों में बांटा जाता है, यानी हर साल के लिए एक लाइन. यह कॉलम हर लाइन के साल का आखिरी दिन दिखाता है.	सेगमेंट	Date	हां
deviceSegment	रिपोर्ट को डिवाइस के आधार पर सेगमेंट में बांटता है. हर पंक्ति और उसकी कुल मेट्रिक को कई लाइनों में बांटा जाता है, हर डिवाइस सेगमेंट के लिए एक लाइन तक की होती है. यह कॉलम हर पंक्ति के डिवाइस का सेगमेंट दिखाता है.	सेगमेंट	Device segment	हां
floodlightGroup	यह रिपोर्ट, फ़्लडलाइट ग्रुप के आधार पर रिपोर्ट में सेगमेंट कर दी जाती है. साथ ही, हर लाइन और उसकी कुल मेट्रिक को कई लाइनों में बांट दिया जाता है, और हर फ़्लडलाइट ग्रुप में एक लाइन होती है. यह कॉलम हर लाइन के Floodlight ग्रुप का नाम दिखाता है. ध्यान दें कि कुछ मेट्रिक में, फ़्लडलाइट सेगमेंट की गई वैल्यू नहीं होती हैं, जैसे कि क्लिक और विज़िट.	सेगमेंट	String	हां
floodlightGroupId	यह रिपोर्ट, फ़्लडलाइट ग्रुप के आधार पर रिपोर्ट में सेगमेंट कर दी जाती है. साथ ही, हर लाइन और उसकी कुल मेट्रिक को कई लाइनों में बांट दिया जाता है, और हर फ़्लडलाइट ग्रुप में एक लाइन होती है. यह कॉलम, हर पंक्ति के DS Floodlight ग्रुप का आईडी दिखाता है. ध्यान दें कि कुछ मेट्रिक में, फ़्लडलाइट सेगमेंट की गई वैल्यू नहीं होती हैं, जैसे कि क्लिक और विज़िट.	सेगमेंट	ID	हां
floodlightGroupTag	यह रिपोर्ट, फ़्लडलाइट ग्रुप के आधार पर रिपोर्ट में सेगमेंट कर दी जाती है. साथ ही, हर लाइन और उसकी कुल मेट्रिक को कई लाइनों में बांट दिया जाता है, और हर फ़्लडलाइट ग्रुप में एक लाइन होती है. यह कॉलम हर लाइन के Floodlight ग्रुप का टैग दिखाता है. ध्यान दें कि कुछ मेट्रिक में, फ़्लडलाइट सेगमेंट की गई वैल्यू नहीं होती हैं, जैसे कि क्लिक और विज़िट.	सेगमेंट	String	हां
floodlightActivity	यह रिपोर्ट, फ़्लडलाइट गतिविधियों के आधार पर सेगमेंट में बंट जाती है. हर पंक्ति और उसकी कुल मेट्रिक, कई पंक्तियों में बंट जाती हैं. साथ ही, हर फ़्लडलाइट गतिविधि के लिए एक लाइन में बंट जाती हैं. यह कॉलम हर पंक्ति की Floodlight गतिविधि का नाम दिखाता है. ध्यान दें कि कुछ मेट्रिक में, फ़्लडलाइट सेगमेंट की गई वैल्यू नहीं होती हैं, जैसे कि क्लिक और विज़िट.	सेगमेंट	String	हां
floodlightActivityId	यह रिपोर्ट, फ़्लडलाइट गतिविधियों के आधार पर सेगमेंट में बंट जाती है. हर पंक्ति और उसकी कुल मेट्रिक, कई पंक्तियों में बंट जाती हैं. साथ ही, हर फ़्लडलाइट गतिविधि के लिए एक लाइन में बंट जाती हैं. यह कॉलम, हर पंक्ति के DS फ़्लडलाइट गतिविधि आईडी की जानकारी देता है. ध्यान दें कि कुछ मेट्रिक में, फ़्लडलाइट सेगमेंट की गई वैल्यू नहीं होती हैं, जैसे कि क्लिक और विज़िट.	सेगमेंट	ID	हां
floodlightActivityTag	यह रिपोर्ट, फ़्लडलाइट गतिविधियों के आधार पर सेगमेंट में बंट जाती है. हर पंक्ति और उसकी कुल मेट्रिक, कई पंक्तियों में बंट जाती हैं. साथ ही, हर फ़्लडलाइट गतिविधि के लिए एक लाइन में बंट जाती हैं. यह कॉलम हर पंक्ति के फ़्लडलाइट गतिविधि टैग को दिखाता है. ध्यान दें कि कुछ मेट्रिक में, फ़्लडलाइट सेगमेंट की गई वैल्यू नहीं होती हैं, जैसे कि क्लिक और विज़िट.	सेगमेंट	String	हां