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)

필수 항목입니다. 생성할 수 있는 추천 유형 목록입니다. 업로드된 기준이 추천을 제공하기에 충분하지 않거나 캠페인이 이미 권장 상태에 있는 경우 해당 유형에는 추천이 반환되지 않습니다. 일반적으로 해당 권장사항 유형에 대한 모든 필수 필드가 업로드되어 있으면 추천이 반환되지만, 여전히 이것으로 충분하지 않은 경우도 있습니다.

추천 생성 시 다음과 같은 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의 정보를 지원합니다. 이 필드는 추천 유형 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)

전달된 요청된 recommendationTypes 세트에서 생성된 추천 목록입니다. 요청된 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)

현재 입찰 전략입니다. 이 필드는 추천 유형(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)

마이크로 단위의 현재 targetCpa 이는 입찰 전략 유형이 TARGET_CPA 또는 MAXIMIZE_CONVERSIONS인 캠페인에 대해 채워질 수 있습니다.
targetRoas

number

현재 타겟 ROAS입니다. 입찰 전략 유형이 TARGET_ROAS 또는 MAXIMIZE_CONVERSION_VALUE인 캠페인에 입력할 수 있습니다.

AdGroupInfo

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

JSON 표현 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
필드
keywords[]

object (KeywordInfo)

선택사항입니다. 현재 키워드 adGroupInfo가 설정된 경우 다음 recommendationTypes에 이 필드는 선택사항입니다. KEYWORD
adGroupType

enum (AdGroupType)

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

SeedInfo

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

JSON 표현 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
필드
keywordSeeds[]

string

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

string

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