Method: customers.generateKeywordForecastMetrics

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

इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

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

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

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

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

पैरामीटर
customerId

string

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

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

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

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

object (DateRange)

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

object (CampaignToForecast)

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

string

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

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

[KeywordPlanIdeaService.GenerateKeywordForecastMetrics] का रिस्पॉन्स मैसेज.

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

जेएसओएन के काेड में दिखाना 
{
  "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

टारगेट की जाने वाली भाषाओं के संसाधनों के नामों की सूची. संसाधन का नाम "languageConstants/{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

टारगेट की जाने वाली भौगोलिक जगह के संसाधन का नाम. संसाधन का नाम "geoTargetConstants/{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)

माइक्रो में मैक्स सीपीसी बिड की सीमा तय करना.

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 / कन्वर्ज़न के तौर पर किया जाता है.