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

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

इस रिपोर्ट को सिर्फ़ असाइनोक्रोनस अनुरोध (यानी, Reports.request() तरीके से) से दिखाया जा सकता है.

कॉन्टेंट के कुछ हिस्से का अनुरोध करना

सामान्य Reports.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	डीएस कैंपेन आईडी.	एट्रिब्यूट	ID	हां
campaignStatus	इस आइटम वाले कैंपेन का स्टेटस.	एट्रिब्यूट	Status	हां
adGroup	विज्ञापन समूह का नाम.	एट्रिब्यूट	String	हां
adGroupId	डीएस विज्ञापन ग्रुप का आईडी.	एट्रिब्यूट	ID	हां
adGroupStatus	इस आइटम वाले विज्ञापन ग्रुप का स्टेटस.	एट्रिब्यूट	Status	हां
ad	विज्ञापन का नाम.	एट्रिब्यूट	String	हां
adId	DS विज्ञापन आईडी. 0 की वैल्यू से पता चलता है कि विज्ञापन को एट्रिब्यूट नहीं किया गया है.	एट्रिब्यूट	ID	हां
adEngineId	बाहरी इंजन खाते में मौजूद विज्ञापन का आईडी.	एट्रिब्यूट	ID	हां
isUnattributedAd	इससे पता चलता है कि इस लाइन में मौजूद मेट्रिक, किसी खास विज्ञापन को एट्रिब्यूट नहीं की जा सकतीं. उदाहरण के लिए, किसी ऐसे विज्ञापन के लिए मेट्रिक एट्रिब्यूट नहीं किया जा सकता जिसका फ़ॉर्मैट काम न करता हो या जिसका क्लिक सर्वर यूआरएल गलत हो.	एट्रिब्यूट	Boolean	हां
adHeadline	विज्ञापन की हेडलाइन.	एट्रिब्यूट	String	हां
adHeadline2	विज्ञापन की हेडलाइन 2; यह कुछ इंजन के लिए उपलब्ध नहीं है.	एट्रिब्यूट	String	हां
adHeadline3	विज्ञापन की हेडलाइन 3; यह कुछ इंजन के लिए उपलब्ध नहीं है.	एट्रिब्यूट	String	हां
adDescription1	विज्ञापन के ब्यौरे की पहली लाइन.	एट्रिब्यूट	String	हां
adDescription2	विज्ञापन के ब्यौरे की दूसरी लाइन; यह कुछ इंजन के लिए उपलब्ध नहीं है.	एट्रिब्यूट	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 और 2 को adDisplayUrl के साथ जोड़कर, विज्ञापन में दिखाया जाने वाला यूआरएल बनाया जाता है.	एट्रिब्यूट	String	हां
adPathField2	विज्ञापन के पाथ का दूसरा फ़ील्ड. पाथ फ़ील्ड 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	अलग-अलग एनवायरमेंट में Campaign Manager के लेन-देन से जनरेट होने वाला कुल रेवेन्यू.	मीट्रिक	Money	हां
dfaTransactionsCrossEnv	अलग-अलग एनवायरमेंट में Campaign Manager के लेन-देन की कुल संख्या.	मीट्रिक	Number	हां
dfaWeightedActionsCrossEnv	अलग-अलग एनवायरमेंट में Campaign Manager ऐक्शन का कुल योग.	मीट्रिक	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 ग्रुप के हिसाब से सेगमेंट में बांटता है. हर लाइन और उसकी एग्रीगेट मेट्रिक को कई लाइनों में बांटा जाता है. हर Floodlight ग्रुप के लिए, एक लाइन तक हो सकती है. यह कॉलम, हर पंक्ति के Floodlight ग्रुप का नाम दिखाता है. ध्यान दें कि कुछ मेट्रिक में Floodlight सेगमेंट की वैल्यू नहीं होती हैं. जैसे, क्लिक और विज़िट.	सेगमेंट	String	हां
floodlightGroupId	रिपोर्ट को Floodlight ग्रुप के हिसाब से सेगमेंट में बांटता है. हर लाइन और उसकी एग्रीगेट मेट्रिक को कई लाइनों में बांटा जाता है. हर Floodlight ग्रुप के लिए, एक लाइन तक हो सकती है. यह कॉलम, हर पंक्ति का डीएस Floodlight ग्रुप आईडी दिखाता है. ध्यान दें कि कुछ मेट्रिक में Floodlight सेगमेंट की वैल्यू नहीं होती हैं. जैसे, क्लिक और विज़िट.	सेगमेंट	ID	हां
floodlightGroupTag	रिपोर्ट को Floodlight ग्रुप के हिसाब से सेगमेंट में बांटता है. हर लाइन और उसकी एग्रीगेट मेट्रिक को कई लाइनों में बांटा जाता है. हर Floodlight ग्रुप के लिए, एक लाइन तक हो सकती है. यह कॉलम, हर लाइन का Floodlight ग्रुप टैग दिखाता है. ध्यान दें कि कुछ मेट्रिक में Floodlight सेगमेंट की वैल्यू नहीं होती हैं. जैसे, क्लिक और विज़िट.	सेगमेंट	String	हां
floodlightActivity	Floodlight गतिविधियों के हिसाब से रिपोर्ट को सेगमेंट में बांटता है. हर लाइन और उसकी एग्रीगेट मेट्रिक को कई लाइनों में बांटा जाता है. हर Floodlight गतिविधि के लिए एक लाइन तक हो सकती है. यह कॉलम, हर लाइन की Floodlight गतिविधि का नाम दिखाता है. ध्यान दें कि कुछ मेट्रिक में Floodlight सेगमेंट की वैल्यू नहीं होती हैं. जैसे, क्लिक और विज़िट.	सेगमेंट	String	हां
floodlightActivityId	Floodlight गतिविधियों के हिसाब से रिपोर्ट को सेगमेंट में बांटता है. हर लाइन और उसकी एग्रीगेट मेट्रिक को कई लाइनों में बांटा जाता है. हर Floodlight गतिविधि के लिए एक लाइन तक हो सकती है. यह कॉलम, हर लाइन का डीएस Floodlight ऐक्टिविटी आईडी दिखाता है. ध्यान दें कि कुछ मेट्रिक में Floodlight सेगमेंट की वैल्यू नहीं होती हैं. जैसे, क्लिक और विज़िट.	सेगमेंट	ID	हां
floodlightActivityTag	Floodlight गतिविधियों के हिसाब से रिपोर्ट को सेगमेंट में बांटता है. हर लाइन और उसकी एग्रीगेट मेट्रिक को कई लाइनों में बांटा जाता है. हर Floodlight गतिविधि के लिए एक लाइन तक हो सकती है. यह कॉलम, हर लाइन का Floodlight ऐक्टिविटी टैग दिखाता है. ध्यान दें कि कुछ मेट्रिक में Floodlight सेगमेंट की वैल्यू नहीं होती हैं. जैसे, क्लिक और विज़िट.	सेगमेंट	String	हां