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 استفاده می کند.

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

پارامترها
customer Id

string

مورد نیاز. شناسه توصیه‌های مشتری.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
فیلدها
recommendation Types[]

enum ( RecommendationType )

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

انواع توصیه‌های زیر برای تولید توصیه‌ها پشتیبانی می‌شوند: KEYWORD، MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGETSI_OPT, TARGET_ROPT_AS، _ROAS_OPT_IN

advertising Channel Type

enum ( AdvertisingChannelType )

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

ad Group Info[]

object ( AdGroupInfo )

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

conversion Tracking Status

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،

bidding Info

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،

seed Info

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.
}
فیلدها
bidding Strategy Type

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 تنها می تواند یکی از موارد زیر باشد:
target Cpa Micros

string ( int64 format)

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

target Roas

number

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

AdGroupInfo

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

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

object ( KeywordInfo )

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

ad Group Type

enum ( AdGroupType )

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

SeedInfo

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

نمایندگی JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
فیلدها
keyword Seeds[]

string

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

url Seed

string

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