- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- CampaignToForecast
- CriterionBidModifier
- CampaignBiddingStrategy
- ManualCpcBiddingStrategy
- MaximizeClicksBiddingStrategy
- MaximizeConversionsBiddingStrategy
- ForecastAdGroup
- BiddableKeyword
- KeywordForecastMetrics
- इसे आज़माएं!
किसी कैंपेन के लिए, कीवर्ड के अनुमान की मेट्रिक (जैसे, इंप्रेशन, क्लिक, कुल लागत) दिखाता है.
इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
एचटीटीपी अनुरोध
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordForecastMetrics
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
customerId |
ग्राहक का आईडी. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "forecastPeriod": { object ( |
फ़ील्ड | |
---|---|
forecastPeriod |
पूर्वानुमान के लिए तारीख की सीमा. शुरू होने की तारीख, आने वाले समय की होनी चाहिए और खत्म होने की तारीख, आज से एक साल के अंदर की होनी चाहिए. रेफ़रंस के लिए इस्तेमाल किया गया टाइमज़ोन, उस Google Ads खाते का टाइमज़ोन है जो ग्राहक का है. अगर यह नीति सेट नहीं है, तो अगले रविवार से लेकर अगले शनिवार तक की डिफ़ॉल्ट तारीख की सीमा का इस्तेमाल किया जाएगा. |
campaign |
ज़रूरी है. अनुमान के लिए इस्तेमाल किया गया कैंपेन. |
currencyCode |
एक्सचेंज रेट में बदलाव के लिए इस्तेमाल की जाने वाली मुद्रा. डिफ़ॉल्ट रूप से, ग्राहक के खाते में सेट की गई मुद्रा का इस्तेमाल किया जाता है. इस फ़ील्ड को सिर्फ़ तब सेट करें, जब मुद्रा खाते की मुद्रा से अलग हो. मान्य मुद्रा कोड की सूची, https://developers.google.com/google-ads/api/data/codes-formats#currency-codes पर देखी जा सकती है. |
जवाब का मुख्य भाग
[KeywordPlanIdeaService.GenerateKeywordForecastMetrics] का रिस्पॉन्स मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"campaignForecastMetrics": {
object ( |
फ़ील्ड | |
---|---|
campaignForecastMetrics |
कैंपेन के अनुमान के नतीजे. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/adwords
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
CampaignToForecast
कीवर्ड कैंपेन का अनुमान लगाने के लिए कैंपेन.
जेएसओएन के काेड में दिखाना |
---|
{ "languageConstants": [ string ], "geoModifiers": [ { object ( |
फ़ील्ड | |
---|---|
languageConstants[] |
टारगेट की जाने वाली भाषाओं के संसाधनों के नामों की सूची. संसाधन का नाम "languageConstants/{criterionId}" फ़ॉर्मैट में है. भाषा से जुड़े मापदंड कोड की सूची के लिए, https://developers.google.com/google-ads/api/data/codes-formats#languages देखें. |
geoModifiers[] |
लक्षित किए जाने वाले स्थान. जगहें यूनीक होनी चाहिए. |
keywordPlanNetwork |
ज़रूरी है. टारगेटिंग के लिए इस्तेमाल किया जाने वाला नेटवर्क. |
negativeKeywords[] |
अनुमान लगाते समय कैंपेन में इस्तेमाल किए जाने वाले नेगेटिव कीवर्ड की सूची. |
biddingStrategy |
ज़रूरी है. कैंपेन के लिए बिडिंग की रणनीति. |
adGroups[] |
अनुमान लगाने के लिए, नए कैंपेन में मौजूद विज्ञापन ग्रुप. |
conversionRate |
उपयोगकर्ता के मुताबिक तय किया गया अनुमानित कन्वर्ज़न रेट (कन्वर्ज़न की संख्या को कुल क्लिक की संख्या से भाग दिया जाता है). यह वैल्यू, दशमलव वैल्यू के तौर पर दिखाई जाती है. इसलिए, 2% की अनुमानित कन्वर्ज़न दर को 0.02 के तौर पर डाला जाना चाहिए. खाली छोड़ देने पर, अनुमानित कन्वर्ज़न दर का इस्तेमाल किया जाएगा. |
CriterionBidModifier
स्थान मानदंड का बोली संशोधक.
जेएसओएन के काेड में दिखाना |
---|
{ "geoTargetConstant": string, "bidModifier": number } |
फ़ील्ड | |
---|---|
geoTargetConstant |
टारगेट की जाने वाली भौगोलिक जगह के संसाधन का नाम. संसाधन का नाम "geoTargetConstants/{criterionId}" फ़ॉर्मैट में है. |
bidModifier |
criterionId के लिए जोड़ा गया मल्टीप्लायर. अगर यह वैल्यू सेट है, तो इसकी वैल्यू 0 नहीं हो सकती. |
CampaignBiddingStrategy
नए कैंपेन के अनुमानों के लिए, इस्तेमाल की जा सकने वाली बिडिंग की रणनीतियां.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड bidding_strategy . बिडिंग की रणनीतियां. bidding_strategy इनमें से सिर्फ़ एक हो सकती है: |
|
manualCpcBiddingStrategy |
अनुमान लगाने के लिए, मैन्युअल सीपीसी बिडिंग की रणनीति का इस्तेमाल करें. |
maximizeClicksBiddingStrategy |
अनुमान लगाने के लिए, क्लिक बढ़ाने के लिए बिडिंग की रणनीति का इस्तेमाल करें. |
maximizeConversionsBiddingStrategy |
अनुमान लगाने के लिए, कन्वर्ज़न बढ़ाने के लिए बिडिंग की रणनीति का इस्तेमाल करें. |
ManualCpcBiddingStrategy
मैन्युअल सीपीसी बोली लगाने की रणनीति.
जेएसओएन के काेड में दिखाना |
---|
{ "maxCpcBidMicros": string, "dailyBudgetMicros": string } |
फ़ील्ड | |
---|---|
maxCpcBidMicros |
ज़रूरी है. मैन्युअल सीपीसी बिडिंग की रणनीति के लिए, कैंपेन में मौजूद विज्ञापन ग्रुप पर लागू की जाने वाली बिड को माइक्रो में लगाया जाता है. |
dailyBudgetMicros |
माइक्रो में कैंपेन लेवल का बजट. अगर वैल्यू सेट की जाती है, तो कैंपेन में इस्तेमाल की गई स्थानीय मुद्रा के लिए, कम से कम वैल्यू लागू की जाती है. अगर यह फ़ील्ड बहुत कम पर सेट किया गया है, तो सबसे कम वैल्यू दिखाने वाली गड़बड़ी दिखेगी. |
MaximizeClicksBiddingStrategy
क्लिक बढ़ाने की बोली लगाने की रणनीति.
जेएसओएन के काेड में दिखाना |
---|
{ "dailyTargetSpendMicros": string, "maxCpcBidCeilingMicros": string } |
फ़ील्ड | |
---|---|
dailyTargetSpendMicros |
ज़रूरी है. अनुमान के लिए इस्तेमाल होने वाला, माइक्रो में रोज़ का टारगेट खर्च. कैंपेन में इस्तेमाल की जाने वाली स्थानीय मुद्रा के लिए, कम से कम वैल्यू लागू की जाती है. अगर यह फ़ील्ड बहुत कम पर सेट किया गया है, तो सबसे कम वैल्यू दिखाने वाली गड़बड़ी दिखेगी. |
maxCpcBidCeilingMicros |
माइक्रो में मैक्स सीपीसी बिड की सीमा तय करना. |
MaximizeConversionsBiddingStrategy
कन्वर्ज़न के लिए बोली लगाने की रणनीति को बढ़ाएं.
जेएसओएन के काेड में दिखाना |
---|
{ "dailyTargetSpendMicros": string } |
फ़ील्ड | |
---|---|
dailyTargetSpendMicros |
ज़रूरी है. अनुमान के लिए इस्तेमाल होने वाला, माइक्रो में रोज़ का टारगेट खर्च. यह वैल्यू शून्य से ज़्यादा होनी चाहिए. |
ForecastAdGroup
ऐसा विज्ञापन ग्रुप जो अनुमान लगाए जाने वाले कैंपेन का हिस्सा हो.
जेएसओएन के काेड में दिखाना |
---|
{ "biddableKeywords": [ { object ( |
फ़ील्ड | |
---|---|
biddableKeywords[] |
ज़रूरी है. अनुमान लगाते समय विज्ञापन ग्रुप में इस्तेमाल किए जाने वाले, बिडिंग के लायक कीवर्ड की सूची. कम से कम एक कीवर्ड होना ज़रूरी है. |
negativeKeywords[] |
कीवर्ड की जानकारी. आपको कीवर्ड टेक्स्ट और मैच टाइप, दोनों बताने चाहिए. |
maxCpcBidMicros |
अनुमानित ट्रैफ़िक जनरेट करते समय, विज्ञापन ग्रुप के लिए इस्तेमाल की जाने वाली ज़्यादा से ज़्यादा सीपीसी. यह वैल्यू, बिडिंग की रणनीति में सेट किए गए मैक्स सीपीसी वैल्यू को बदल देगी. इस फ़ील्ड को सिर्फ़ उन बिडिंग रणनीतियों के लिए तय करें जिनकी सीपीसी वैल्यू ज़्यादा से ज़्यादा हो. |
BiddableKeyword
बिड करने लायक कीवर्ड, जो किसी विज्ञापन ग्रुप का हिस्सा होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"keyword": {
object ( |
फ़ील्ड | |
---|---|
keyword |
ज़रूरी है. कीवर्ड. टेक्स्ट और मैच टाइप होना चाहिए. |
maxCpcBidMicros |
माइक्रो में एक मैक्स सीपीसी बिड, जो अनुमान सिम्युलेशन में विज्ञापन ग्रुप लेवल की मैक्स सीपीसी बिड को बदल देती है. यह वैल्यू, बिडिंग की रणनीति और विज्ञापन ग्रुप में सेट किए गए मैक्स सीपीसी वैल्यू को बदल देगी. इस फ़ील्ड को सिर्फ़ उन बिडिंग की रणनीतियों के लिए तय करें जिनमें मैक्स सीपीसी वैल्यू का इस्तेमाल किया जा सकता है. |
KeywordForecastMetrics
प्लानलेस कीवर्ड कैंपेन के लिए अनुमान वाली मेट्रिक.
जेएसओएन के काेड में दिखाना |
---|
{ "impressions": number, "clickThroughRate": number, "averageCpcMicros": string, "clicks": number, "costMicros": string, "conversions": number, "conversionRate": number, "averageCpaMicros": string } |
फ़ील्ड | |
---|---|
impressions |
इंप्रेशन की कुल संख्या. |
clickThroughRate |
औसत क्लिक मिलने की दर (सीटीआर). इंप्रेशन > 0 होने पर ही उपलब्ध है. |
averageCpcMicros |
औसत सीपीसी. क्लिक > 0 होने पर ही उपलब्ध है. |
clicks |
क्लिक की कुल संख्या. |
costMicros |
कुल कीमत. |
conversions |
कन्वर्ज़न की अनुमानित संख्या: क्लिक * कन्वर्ज़न रेट. |
conversionRate |
अनुमानित कन्वर्ज़न रेट. |
averageCpaMicros |
हर ग्राहक जोड़ने की औसत लागत का आकलन, priceMicros / कन्वर्ज़न के तौर पर किया जाता है. |