Method: customers.recommendations.generate

بر اساس نوع توصیه های درخواستی، توصیه هایی ایجاد می کند.

فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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 )

ضروری. فهرست توصیه‌های واجد شرایط برای ایجاد. اگر معیارهای آپلود شده برای ارائه یک توصیه کافی نباشد، یا کمپین از قبل در وضعیت توصیه شده باشد، هیچ توصیه ای برای آن نوع بازگردانده نخواهد شد. به طور کلی، اگر تمام فیلدهای مورد نیاز برای آن توصیه نوع آپلود شود، یک توصیه برگردانده می شود، اما مواردی وجود دارد که هنوز کافی نیست.

انواع توصیه‌های زیر برای تولید توصیه‌ها پشتیبانی می‌شوند: KEYWORD، MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGET_CPA، SET_TARGET_CLICKS_OPT_IN، TARGET_INT, TARGET_LINKET, TARGET_LINKET, TARGET_LINKET, TARGET_LINKET, TARGET_INT, TARGET_LINKET, TARGET_IN, TARGET, ROAS_OPT_IN

advertisingChannelType

enum ( AdvertisingChannelType )

ضروری. نوع کانال تبلیغاتی کمپین انواع تبلیغات زیر برای تولید توصیه پشتیبانی می شود: PERFORMANCE_MAX و SEARCH

adGroupInfo[]

object ( AdGroupInfo )

اختیاری. اطلاعات گروه تبلیغات فعلی از اطلاعات یک AdGroup پشتیبانی می کند. این فیلد برای انواع توصیه های زیر اختیاری است: KEYWORD

conversionTrackingStatus

enum ( ConversionTrackingStatus )

اختیاری. وضعیت ردیابی تبدیل فعلی این فیلد برای انواع توصیه‌های زیر ضروری است: MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGET_ROAS، TARGET_INOPT_ROAS، TARGET_INOPT_IN، TARGET_INOPT_AR،

biddingInfo

object ( BiddingInfo )

اختیاری. اطلاعات مناقصه فعلی کمپین. این فیلد برای انواع توصیه‌های زیر ضروری است: MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGET_ROAS، TARGET_INOPT_ROAS، TARGET_INOPT_IN، TARGET_INOPT_AR،

seedInfo

object ( SeedInfo )

اختیاری. اطلاعات بذر برای کلمات کلیدی. این فیلد برای انواع توصیه های زیر ضروری است: KEYWORD

بدن پاسخگو

پیام پاسخ برای RecommendationService.GenerateRecommendations .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
زمینه های
recommendations[]

object ( Recommendation )

فهرست توصیه‌های تولید شده از تصویب‌شده در مجموعه توصیه‌های درخواستی نوع. اگر داده‌های کافی برای ایجاد یک توصیه برای نوع توصیه‌های درخواستی وجود نداشته باشد، مجموعه نتایج حاوی توصیه‌ای برای آن نوع نخواهد بود.

محدوده مجوز

به محدوده 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 )

استراتژی مناقصه فعلی این فیلد برای انواع توصیه‌های زیر ضروری است: MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGET_ROAS، TARGET_INOPT_ROAS، TARGET_INOPT_IN، TARGET_INOPT_AR،

فیلد اتحادیه bidding_strategy_target_info . جزئیات اختیاری مربوط به bidding_strategy_type. bidding_strategy_target_info تنها می تواند یکی از موارد زیر باشد:
targetCpaMicros

string ( int64 format)

targetCpa فعلی در میکرو. این را می توان برای کمپین هایی با نوع استراتژی پیشنهاد قیمت TARGET_CPA یا MAXIMIZE_CONVERSIONS پر کرد.

targetRoas

number

هدف فعلی این را می توان برای کمپین هایی با نوع استراتژی پیشنهاد قیمت TARGET_ROAS یا MAXIMIZE_CONVERSION_VALUE پر کرد.

AdGroupInfo

اطلاعات گروه تبلیغات فعلی کمپین.

نمایندگی JSON
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
زمینه های
keywords[]

object ( KeywordInfo )

اختیاری. کلمات کلیدی فعلی اگر adGroupInfo تنظیم شده باشد، این فیلد برای توصیه های زیر اختیاری است: KEYWORD

adGroupType

enum ( AdGroupType )

اختیاری. AdGroup نوع AdGroup. اگر adGroupInfo تنظیم شده باشد، این فیلد برای نوع توصیه زیر ضروری است: KEYWORD

SeedInfo

یک بذر کلمه کلیدی و یک URL خاص برای تولید کلمات کلیدی.

نمایندگی JSON
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
زمینه های
keywordSeeds[]

string

اختیاری. کلمات یا عبارات کلیدی برای ایجاد ایده از، به عنوان مثال: اتومبیل یا "نمایندگی خودرو در نزدیکی من".

urlSeed

string

یک آدرس اینترنتی خاص برای ایجاد ایده از آن، به عنوان مثال: www.example.com/cars.