Method: customers.recommendations.generate

요청된 추천 유형을 기반으로 추천을 생성합니다.

발생한 오류 목록: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 추천을 생성하는 고객의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

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_ROAS, SITELINK_ASSET, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
advertisingChannelType

enum (AdvertisingChannelType)

필수 항목입니다. 캠페인의 광고 채널 유형입니다. 추천 생성에 지원되는 AdvertisingChannelTypes는 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_CPA_OPT_IN, TARGET_ROAS_OPT_IN
biddingInfo

object (BiddingInfo)

선택사항입니다. 캠페인의 현재 입찰 정보입니다. 이 필드는 다음 추천 유형에 필요합니다. 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)

요청된 추천 유형 집합의 전달된 집합에서 생성된 추천의 목록입니다. 요청된 추천 유형에 대한 추천을 생성하기에 충분한 데이터가 없는 경우 결과 세트에 해당 유형의 추천이 포함되지 않습니다.

승인 범위

다음 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_CPA_OPT_IN, TARGET_ROAS_OPT_IN
통합 필드 bidding_strategy_target_info. bid_strategy_type과 관련된 선택적 세부정보입니다. bidding_strategy_target_info은 다음 중 하나여야 합니다.
targetCpaMicros

string (int64 format)

마이크로 단위의 현재 타겟 CPA입니다. 이 값은 입찰 전략 유형이 TARGET_CPA 또는 MAXIMIZE_CONVERSIONS인 캠페인의 경우 입력될 수 있습니다.
targetRoas

number

현재 targetRoas입니다. 이 값은 입찰 전략 유형이 TARGET_ROAS 또는 MAXIMIZE_CONVERSION_VALUE인 캠페인에 대해 입력될 수 있습니다.

AdGroupInfo

캠페인의 현재 광고그룹 정보입니다.

JSON 표현 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
입력란
keywords[]

object (KeywordInfo)

선택사항입니다. 현재 키워드 adGroupInfo가 설정된 경우 추천 유형의 경우 이 필드는 선택사항입니다. KEYWORD
adGroupType

enum (AdGroupType)

선택사항입니다. 광고그룹의 광고그룹 유형입니다. adGroupInfo가 설정된 경우 추천 유형 KEYWORD에 이 필드가 필요합니다.

SeedInfo

키워드를 생성할 키워드 시드 및 특정 URL입니다.

JSON 표현 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
입력란
keywordSeeds[]

string

선택사항입니다. 아이디어를 생성할 키워드나 문구(예: 자동차 또는 '내 주변 자동차 대리점')
urlSeed

string

아이디어를 생성할 특정 URL(예: www.example.com/cars)