Method: customers.generateKeywordForecastMetrics

यह फ़ंक्शन किसी कैंपेन के कीवर्ड के अनुमान की मेट्रिक, जैसे कि इंप्रेशन, क्लिक, और कुल लागत दिखाता है.

थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

एचटीटीपी अनुरोध

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
customerId

string

ग्राहक का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
फ़ील्ड
forecastPeriod

object (DateRange)

अनुमान के लिए तारीख की सीमा. शुरू होने की तारीख भविष्य की होनी चाहिए और खत्म होने की तारीख आज से 1 साल के अंदर की होनी चाहिए. इस्तेमाल किया गया रेफ़रंस टाइमज़ोन, ग्राहक से जुड़े Google Ads खाते में से एक है. अगर यह नीति सेट नहीं है, तो अगले रविवार से लेकर अगले शनिवार तक की डिफ़ॉल्ट तारीख की सीमा का इस्तेमाल किया जाएगा.
campaign

object (CampaignToForecast)

ज़रूरी है. अनुमान के लिए इस्तेमाल किया गया कैंपेन.
currencyCode

string

एक्सचेंज रेट को बदलने के लिए इस्तेमाल की जाने वाली मुद्रा. डिफ़ॉल्ट रूप से, ग्राहक के खाते की मुद्रा का इस्तेमाल किया जाता है. इस फ़ील्ड को सिर्फ़ तब सेट करें, जब मुद्रा, खाते की मुद्रा से अलग हो. मान्य मुद्रा कोड की सूची, https://developers.google.com/google-ads/api/data/codes-formats#currency-codes पर देखी जा सकती है.

जवाब का मुख्य भाग

[KeywordPlanIdeaService.generateKeyword कर्सर मेट्रिक] के लिए रिस्पॉन्स मैसेज.

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

जेएसओएन के काेड में दिखाना 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
फ़ील्ड
campaignForecastMetrics

object (KeywordForecastMetrics)

कैंपेन के अनुमान के नतीजे.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/adwords

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

CampaignToForecast

कीवर्ड कैंपेन का अनुमान लगाने के लिए कैंपेन.

जेएसओएन के काेड में दिखाना 
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
फ़ील्ड
languageConstants[]

string

टारगेट की जाने वाली भाषाओं के संसाधनों के नामों की सूची. संसाधन का नाम "language एपीआईs/{criterionId}" फ़ॉर्मैट में है. भाषा के मानदंड कोड की सूची के लिए, https://developers.google.com/google-ads/api/data/codes-formats#languages देखें.
geoModifiers[]

object (CriterionBidModifier)

टारगेट करने के लिए जगहें. जगहें यूनीक होनी चाहिए.
keywordPlanNetwork

enum (KeywordPlanNetwork)

ज़रूरी है. टारगेटिंग के लिए इस्तेमाल किया जाने वाला नेटवर्क.
negativeKeywords[]

object (KeywordInfo)

अनुमान लगाते समय कैंपेन में इस्तेमाल किए जाने वाले नेगेटिव कीवर्ड की सूची.
biddingStrategy

object (CampaignBiddingStrategy)

ज़रूरी है. कैंपेन के लिए बिडिंग की रणनीति.
adGroups[]

object (ForecastAdGroup)

अनुमान लगाने के लिए, नए कैंपेन में विज्ञापन ग्रुप.
conversionRate

number

उपयोगकर्ता के हिसाब से तय किया गया अनुमानित कन्वर्ज़न रेट (कन्वर्ज़न की संख्या को कुल क्लिक की संख्या से भाग देने पर). यह वैल्यू दशमलव वैल्यू के तौर पर दिखाई जाती है. इसलिए, 2% की अनुमानित कन्वर्ज़न दर को 0.02 के तौर पर डालना चाहिए. खाली छोड़ देने पर, अनुमानित कन्वर्ज़न दर का इस्तेमाल किया जाएगा.

CriterionBidModifier

स्थान मानदंड बोली संशोधक.

जेएसओएन के काेड में दिखाना 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
फ़ील्ड
geoTargetConstant

string

टारगेट की जाने वाली भौगोलिक जगह के संसाधन का नाम. संसाधन का नाम "geoTargetTargets/{criterionId}" फ़ॉर्मैट में है.
bidModifier

number

criterionId के लिए जोड़ा गया मल्टीप्लायर. अगर यह वैल्यू सेट है, तो 0 नहीं हो सकती.

CampaignBiddingStrategy

कैंपेन के नए अनुमानों के लिए, बिडिंग की ऐसी रणनीतियां जो काम करती हैं.

जेएसओएन के काेड में दिखाना 
{

  // Union field bidding_strategy can be only one of the following:
  "manualCpcBiddingStrategy": {
    object (ManualCpcBiddingStrategy)
  },
  "maximizeClicksBiddingStrategy": {
    object (MaximizeClicksBiddingStrategy)
  },
  "maximizeConversionsBiddingStrategy": {
    object (MaximizeConversionsBiddingStrategy)
  }
  // End of list of possible types for union field bidding_strategy.
}
फ़ील्ड
यूनियन फ़ील्ड bidding_strategy. बिडिंग की रणनीतियां. bidding_strategy इनमें से सिर्फ़ एक हो सकता है:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

अनुमान लगाने के लिए, मैन्युअल सीपीसी बिडिंग की रणनीति का इस्तेमाल करें.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

अनुमान लगाने के लिए, क्लिक बढ़ाने के लिए बिडिंग की रणनीति का इस्तेमाल करें.
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

अनुमान लगाने के लिए, कन्वर्ज़न बढ़ाने के लिए बिडिंग की रणनीति का इस्तेमाल करें.

ManualCpcBiddingStrategy

मैन्युअल सीपीसी बिडिंग की रणनीति.

जेएसओएन के काेड में दिखाना 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
फ़ील्ड
maxCpcBidMicros

string (int64 format)

ज़रूरी है. मैन्युअल सीपीसी बिडिंग की रणनीति के लिए, कैंपेन में विज्ञापन ग्रुप पर लागू की जाने वाली बिड.
dailyBudgetMicros

string (int64 format)

माइक्रो में कैंपेन स्तर का बजट. अगर कैंपेन में इस्तेमाल की जाने वाली स्थानीय मुद्रा के लिए कम से कम वैल्यू सेट की जाती है, तो उसे लागू किया जा सकता है. अगर यह फ़ील्ड बहुत कम पर सेट किया गया है, तो सबसे कम वैल्यू दिखाने वाली गड़बड़ी होगी.

MaximizeClicksBiddingStrategy

क्लिक बढ़ाने की बोली लगाने की रणनीति.

जेएसओएन के काेड में दिखाना 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
फ़ील्ड
dailyTargetSpendMicros

string (int64 format)

ज़रूरी है. अनुमान के लिए इस्तेमाल किए जाने के लिए, माइक्रो में रोज़ का टारगेट खर्च. कैंपेन में इस्तेमाल की जाने वाली स्थानीय मुद्रा के लिए, एक कम से कम वैल्यू लागू की जाती है. अगर यह फ़ील्ड बहुत कम पर सेट किया गया है, तो सबसे कम वैल्यू दिखाने वाली गड़बड़ी होगी.
maxCpcBidCeilingMicros

string (int64 format)

माइक्रो में अधिकतम CPC बोलियों का उपयोग करना.

MaximizeConversionsBiddingStrategy

कन्वर्ज़न बोली लगाने की रणनीति बढ़ाएं.

जेएसओएन के काेड में दिखाना 
{
  "dailyTargetSpendMicros": string
}
फ़ील्ड
dailyTargetSpendMicros

string (int64 format)

ज़रूरी है. अनुमान के लिए इस्तेमाल किए जाने के लिए, माइक्रो में रोज़ का टारगेट खर्च. यह वैल्यू शून्य से ज़्यादा होनी चाहिए.

ForecastAdGroup

ऐसा विज्ञापन ग्रुप जो अनुमान लगाए जाने वाले कैंपेन का हिस्सा है.

जेएसओएन के काेड में दिखाना 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
फ़ील्ड
biddableKeywords[]

object (BiddableKeyword)

ज़रूरी है. अनुमान लगाते समय विज्ञापन ग्रुप में इस्तेमाल किए जाने वाले, बिडिंग के लायक कीवर्ड की सूची. कम से कम एक कीवर्ड होना चाहिए.
negativeKeywords[]

object (KeywordInfo)

कीवर्ड की जानकारी. आपको कीवर्ड टेक्स्ट और मैच टाइप, दोनों बताने चाहिए.
maxCpcBidMicros

string (int64 format)

अनुमानित ट्रैफ़िक जनरेट करते समय, विज्ञापन ग्रुप के लिए इस्तेमाल की जाने वाली ज़्यादा से ज़्यादा सीपीसी. यह वैल्यू, बिडिंग की रणनीति में सेट की गई मैक्स सीपीसी वैल्यू को बदल देगी. इस फ़ील्ड को सिर्फ़ उन बिडिंग रणनीतियों के लिए तय करें जिनकी सीपीसी वैल्यू ज़्यादा से ज़्यादा होती है.

BiddableKeyword

बिड करने लायक कीवर्ड, जो किसी विज्ञापन ग्रुप का हिस्सा होता है.

जेएसओएन के काेड में दिखाना 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
फ़ील्ड
keyword

object (KeywordInfo)

ज़रूरी है. कीवर्ड. इसमें टेक्स्ट और मैच टाइप होना चाहिए.
maxCpcBidMicros

string (int64 format)

माइक्रो में मौजूद मैक्स सीपीसी बिड, जो अनुमान सिम्युलेशन में विज्ञापन ग्रुप लेवल की मैक्स सीपीसी बिड को बदल देती है. यह वैल्यू, बिडिंग की रणनीति और विज्ञापन ग्रुप में सेट की गई मैक्स सीपीसी वैल्यू को बदल देगी. इस फ़ील्ड को सिर्फ़ उन बिडिंग रणनीतियों के लिए तय करें जो मैक्स सीपीसी वैल्यू के साथ काम करती हों.

KeywordForecastMetrics

प्लानलेस कीवर्ड कैंपेन के लिए अनुमान की मेट्रिक.

जेएसओएन के काेड में दिखाना 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
फ़ील्ड
impressions

number

इंप्रेशन की कुल संख्या.
clickThroughRate

number

क्लिक मिलने की औसत दर (सीटीआर). इंप्रेशन > 0 होने पर ही उपलब्ध है.
averageCpcMicros

string (int64 format)

औसत सीपीसी. क्लिक > 0 होने पर ही उपलब्ध होता है.
clicks

number

क्लिक की कुल संख्या.
costMicros

string (int64 format)

कुल कीमत.
conversions

number

कन्वर्ज़न की अनुमानित संख्या: क्लिक * कन्वर्ज़न रेट.
conversionRate

number

अनुमानित कन्वर्ज़न रेट.
averageCpaMicros

string (int64 format)

हर ग्राहक जोड़ने की औसत लागत की गिनती, priceMicros / कन्वर्ज़न से की जाती है.