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

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

यह रिपोर्ट सिर्फ़ एसिंक्रोनस अनुरोध के ज़रिए ही भेजी जा सकती है. इसका मतलब है कि 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	DS कैंपेन आईडी.	विशेषता	ID	हां
campaignStatus	उस कैंपेन की स्थिति जिसमें यह आइटम है.	विशेषता	Status	हां
adGroup	विज्ञापन समूह का नाम.	विशेषता	String	हां
adGroupId	DS विज्ञापन ग्रुप आईडी.	विशेषता	ID	हां
adGroupStatus	उस विज्ञापन ग्रुप का स्टेटस जिसमें यह आइटम शामिल है.	विशेषता	Status	हां
ad	विज्ञापन का नाम.	विशेषता	String	हां
adId	DS विज्ञापन आईडी. वैल्यू 0 होने का मतलब है कि विज्ञापन को एट्रिब्यूट नहीं किया गया है.	विशेषता	ID	हां
adEngineId	बाहरी इंजन खाते में मौजूद विज्ञापन का आईडी.	विशेषता	ID	हां
isUnattributedAd	इससे पता चलता है कि इस पंक्ति में मौजूद मेट्रिक किसी खास विज्ञापन की वजह से एट्रिब्यूट नहीं हो पा रहे हैं. उदाहरण के लिए, काम न करने वाले फ़ॉर्मैट या गलत क्लिक सर्वर यूआरएल वाला विज्ञापन, DS को किसी विज्ञापन में मेट्रिक एट्रिब्यूट करने से रोक सकता है.	विशेषता	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	क्रॉस-एनवायरमेंट वाले 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	DS विज़िट की कुल संख्या.	मीट्रिक	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 ग्रुप के लिए ज़्यादा से ज़्यादा एक लाइनें होती हैं. यह कॉलम, हर लाइन का DS Floodlight ग्रुप आईडी दिखाता है. ध्यान दें कि कुछ मेट्रिक में क्लिक और विज़िट जैसी Floodlight सेगमेंट की वैल्यू नहीं होती हैं.	सेगमेंट	ID	हां
floodlightGroupTag	Floodlight ग्रुप के हिसाब से रिपोर्ट को सेगमेंट करता है; हर लाइन और उसकी एग्रीगेट मेट्रिक को कई लाइनों में बांटा जाता है. हर Floodlight ग्रुप के लिए ज़्यादा से ज़्यादा एक लाइनें होती हैं. यह कॉलम, हर लाइन का Floodlight ग्रुप टैग दिखाता है. ध्यान दें कि कुछ मेट्रिक में क्लिक और विज़िट जैसी Floodlight सेगमेंट की वैल्यू नहीं होती हैं.	सेगमेंट	String	हां
floodlightActivity	Floodlight गतिविधियों के आधार पर रिपोर्ट को सेगमेंट करता है; हर लाइन और उसकी एग्रीगेट मेट्रिक को कई पंक्तियों में बांटा जाता है. हर Floodlight गतिविधि के लिए ज़्यादा से ज़्यादा एक लाइनें होती हैं. यह कॉलम, हर लाइन की Floodlight गतिविधि का नाम दिखाता है. ध्यान दें कि कुछ मेट्रिक में क्लिक और विज़िट जैसी Floodlight सेगमेंट की वैल्यू नहीं होती हैं.	सेगमेंट	String	हां
floodlightActivityId	Floodlight गतिविधियों के आधार पर रिपोर्ट को सेगमेंट करता है; हर लाइन और उसकी एग्रीगेट मेट्रिक को कई पंक्तियों में बांटा जाता है. हर Floodlight गतिविधि के लिए ज़्यादा से ज़्यादा एक लाइनें होती हैं. यह कॉलम, हर लाइन का DS Floodlight गतिविधि आईडी दिखाता है. ध्यान दें कि कुछ मेट्रिक में क्लिक और विज़िट जैसी Floodlight सेगमेंट की वैल्यू नहीं होती हैं.	सेगमेंट	ID	हां
floodlightActivityTag	Floodlight गतिविधियों के आधार पर रिपोर्ट को सेगमेंट करता है; हर लाइन और उसकी एग्रीगेट मेट्रिक को कई पंक्तियों में बांटा जाता है. हर Floodlight गतिविधि के लिए ज़्यादा से ज़्यादा एक लाइनें होती हैं. यह कॉलम, हर लाइन का Floodlight गतिविधि टैग दिखाता है. ध्यान दें कि कुछ मेट्रिक में क्लिक और विज़िट जैसी Floodlight सेगमेंट की वैल्यू नहीं होती हैं.	सेगमेंट	String	हां