Method: customers.recommendations.generate

अनुरोध किए गए सिफारिश टाइप के आधार पर सुझाव जनरेट करता है.

दिखने वाली गड़बड़ियों की सूची: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

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

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

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

पाथ पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. सुझाव जनरेट करने वाले ग्राहक का आईडी.

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

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

JSON के काेड में दिखाना
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
फ़ील्ड
recommendationTypes[]

enum (RecommendationType)

ज़रूरी है. जनरेट करने के लिए, ज़रूरी शर्तें पूरी करने वाले recommendationTypes की सूची. अगर अपलोड किया गया मानदंड, सुझाव देने के लिए काफ़ी नहीं है या कैंपेन पहले से ही सुझाई गई स्थिति में है, तो उस टाइप के लिए कोई सुझाव नहीं दिया जाएगा. आम तौर पर, सुझाव के तौर पर उस टाइप के लिए सभी ज़रूरी फ़ील्ड अपलोड किए जाने पर सुझाव दिखाया जाता है. हालांकि, कुछ मामलों में यह जानकारी काफ़ी नहीं होती.

ये सुझाव टाइप काम करते हैं: KEYWORD, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, SITELINK_ASSET, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN

advertisingChannelType

enum (AdvertisingChannelType)

ज़रूरी है. कैंपेन का विज्ञापन चैनल टाइप. सुझाव जनरेट करने के लिए, ये advertisingChannelTypes काम करते हैं: PERFORMANCE_MAX और SEARCH

adGroupInfo[]

object (AdGroupInfo)

ज़रूरी नहीं. मौजूदा विज्ञापन ग्रुप की जानकारी. यह किसी एक AdGroup की जानकारी के साथ काम करता है. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी नहीं है: कीवर्ड

conversionTrackingStatus

enum (ConversionTrackingStatus)

ज़रूरी नहीं. कन्वर्ज़न ट्रैकिंग की मौजूदा स्थिति. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी है: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN

biddingInfo

object (BiddingInfo)

ज़रूरी नहीं. कैंपेन की बिडिंग की मौजूदा जानकारी. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी है: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN

seedInfo

object (SeedInfo)

ज़रूरी नहीं. कीवर्ड के लिए सीड की जानकारी. नीचे दिए गए सिफारिश प्रकारों के लिए यह फ़ील्ड आवश्यक है: KEYWORD

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

RecommendationService.GenerateRecommendations के लिए जवाब देने वाला मैसेज.

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

JSON के काेड में दिखाना
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
फ़ील्ड
recommendations[]

object (Recommendation)

अनुरोध किए गएसुझाव टाइप के सेट में पास किए गए सुझावों से, जनरेट किए गए सुझावों की सूची. अगर आपने जिन recommendationTypes के लिए सुझाव मांगा है उनके लिए सुझाव जनरेट करने के लिए ज़रूरत के मुताबिक डेटा उपलब्ध नहीं है, तो नतीजों के सेट में उस टाइप के लिए कोई सुझाव नहीं होगा.

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

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

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

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

BiddingInfo

कैंपेन की मौजूदा बिडिंग की जानकारी. बिडिंग से जुड़े सिग्नल के लिए एक रैपर उपलब्ध कराता है, जो सुझावों की जानकारी देता है.

JSON के काेड में दिखाना
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
फ़ील्ड
biddingStrategyType

enum (BiddingStrategyType)

बिडिंग की मौजूदा रणनीति. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी है: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN

यूनियन फ़ील्ड bidding_strategy_target_info. बिडिंग_स्ट्रेटजी_टाइप से जुड़ी वैकल्पिक जानकारी. bidding_strategy_target_info इनमें से सिर्फ़ एक हो सकता है:
targetCpaMicros

string (int64 format)

माइक्रो में मौजूदा टारगेट सीपीए. यह वैल्यू, TARGET_CPA या MAXIMIZE_CONVERSIONS टाइप की बिडिंग की रणनीति वाले कैंपेन के लिए अपने-आप भर सकती है.

targetRoas

number

मौजूदा टारगेट आरओएएस. यह TARGET_ROAS या MAXIMIZE_CONVERSION_VALUE की बोली लगाने की रणनीति वाले कैंपेन के लिए भरा जा सकता है.

AdGroupInfo

अभियान के वर्तमान विज्ञापन समूह की जानकारी.

JSON के काेड में दिखाना
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
फ़ील्ड
keywords[]

object (KeywordInfo)

ज़रूरी नहीं. मौजूदा कीवर्ड. अगर adGroupInfo सेट है, तो यह फ़ील्ड इन recommendationTypes के लिए ज़रूरी नहीं है: कीवर्ड

adGroupType

enum (AdGroupType)

ज़रूरी नहीं. विज्ञापन समूह का प्रकार. अगर adGroupInfo सेट है, तो नीचे दिए गएसुझाव टाइप के लिए यह फ़ील्ड ज़रूरी है: KEYWORD

SeedInfo

कीवर्ड सीड और कोई खास यूआरएल, जिससे कीवर्ड जनरेट किए जा सकते हैं.

JSON के काेड में दिखाना
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
फ़ील्ड
keywordSeeds[]

string

ज़रूरी नहीं. आइडिया जनरेट करने के लिए कीवर्ड या वाक्यांश. उदाहरण के लिए: कार या "मेरे आस-पास कार डीलरशिप".

urlSeed

string

आइडिया जनरेट करने के लिए कोई खास यूआरएल, जैसे कि: www.example.com/cars.