BiddingStrategy

입찰 전략을 제어하는 설정입니다. 입찰 전략에 따라 입찰가가 결정됩니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of mutually exclusive fields.
}
필드
필수 항목입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
fixedBid

object (FixedBidStrategy)

고정 입찰가를 사용하는 전략입니다.
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

전체 예산을 지출하면서 실적 목표에 맞게 최적화하도록 입찰가를 자동으로 조정하는 전략입니다.

게재 신청서 수준에서 광고 항목의 markupType을(를) PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM(으)로 설정할 수 없습니다.

또한 게재 신청서에 할당된 performanceGoalType 값에 따라 해당 게재 신청서의 광고 항목에 사용할 수 있는 lineItemType 값이 결정됩니다.

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED에서는 LINE_ITEM_TYPE_DISPLAY_DEFAULT 또는 LINE_ITEM_TYPE_VIDEO_DEFAULT 광고 항목만 허용합니다.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA 및 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN에서는 LINE_ITEM_TYPE_VIDEO_DEFAULT 광고 항목만 허용됩니다.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH에서는 LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP 광고 항목만 허용됩니다.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

지정된 실적 목표를 달성하거나 초과 달성하기 위해 입찰가를 자동으로 조정하는 전략입니다. 광고 항목 항목에만 사용해야 합니다.
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

YouTube 및 파트너 리소스에서 사용하는 입찰 전략입니다.

YouTube + 파트너 광고 항목 또는 광고 그룹 항목에만 사용할 수 있습니다.
demandGenBid

object (DemandGenBiddingStrategy)

디맨드젠 캠페인 리소스에서 사용하는 입찰 전략입니다.

디맨드젠 캠페인 광고 항목 또는 광고 그룹 항목에만 사용할 수 있습니다.
상호 배타적인 필드의 끝입니다.

FixedBidStrategy

고정 입찰가를 사용하는 전략입니다.

JSON 표현 
{
  "bidAmountMicros": string
}
필드
bidAmountMicros

string (int64 format)

고정 입찰가 금액(광고주 통화의 마이크로 단위)입니다. 게재 신청서 항목의 경우 bidAmountMicros를 0으로 설정해야 합니다. 광고 항목 항목의 경우 bidAmountMicros은 지정된 통화의 청구 가능 단위보다 크거나 같고 상한인 1000000000보다 작거나 같아야 합니다.

예를 들어 1500000은 해당 통화의 1.5 표준 단위를 나타냅니다.

MaximizeSpendBidStrategy

전체 예산을 지출하면서 지정된 실적 목표를 최적화하도록 입찰가를 자동으로 조정하는 전략입니다.

JSON 표현 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
필드
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

필수 항목입니다. 전체 예산을 지출하면서 입찰 전략이 최소화하려는 실적 목표의 유형입니다. 이 전략에는 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM이(가) 지원되지 않습니다.
maxAverageCpmBidAmountMicros

string (int64 format)

입찰할 수 있는 최대 평균 CPM입니다(광고주 통화의 마이크로 단위). 지정된 통화의 청구 가능 단위 이상이어야 합니다.

예를 들어 1500000은 해당 통화의 1.5 표준 단위를 나타냅니다.
raiseBidForDeals

boolean

전략에서 거래 가격 하한선을 고려하는지 여부입니다.
customBiddingAlgorithmId

string (int64 format)

이 전략에서 사용하는 맞춤 입찰 알고리즘의 ID입니다. performanceGoalType가 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO로 설정된 경우에만 적용됩니다.

floodlightActivityConfigs에서 식별되지 않은 플러드라이트 활동을 사용하는 맞춤 입찰 알고리즘을 할당하면 오류가 반환됩니다.

BiddingStrategyPerformanceGoalType

입찰 전략의 실적 목표 유형입니다.

열거형
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED 이 버전에서는 유형 값이 지정되지 않았거나 알 수 없습니다.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA 액션당비용입니다.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC 클릭당비용입니다.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM 조회 가능 CPM
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO 맞춤 입찰 알고리즘입니다.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA 조회 완료 및 청취 가능 조회수
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN 조회 시간 10초 초과 조회수
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED 조회 가능 노출수
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH 도달범위 최대화

PerformanceGoalBidStrategy

지정된 실적 목표를 달성하거나 초과 달성하기 위해 입찰가를 자동으로 조정하는 전략입니다.

JSON 표현 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
필드
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

필수 항목입니다. 입찰 전략이 달성하거나 초과 달성하려는 실적 목표의 유형입니다.

광고 항목 수준 사용의 경우 값은 다음 중 하나여야 합니다.

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.
performanceGoalAmountMicros

string (int64 format)

필수 항목입니다. 입찰 전략이 충족하거나 초과하려고 시도하는 실적 목표로, 광고주 통화의 마이크로 단위 또는 광고주 통화를 기반으로 하는 ROAS (광고 투자수익) 값의 마이크로 단위로 표시됩니다. 지정된 통화의 청구 가능 단위 이상이고 상한값 이하여야 합니다. 각 performanceGoalType에는 상한이 있습니다.

  • performanceGoalType가 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA인 경우 상한은 10000.00 USD입니다.
  • performanceGoalType이(가) BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC인 경우 상한은 1, 000.00달러(USD)입니다.
  • performanceGoalType가 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM인 경우 상한은 1, 000.00 USD입니다.
  • performanceGoalType가 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO인 경우 상한은 1000.00이고 하한은 0.01입니다.

예: BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM로 설정하면 입찰가는 사용 가능한 각 노출이 조회 가능할 확률을 기반으로 합니다. 예를 들어 조회 가능 CPM 타겟이 2달러이고 노출 조회가능성이 40% 인 경우 입찰가는 CPM 0.80달러 (2달러의 40%)가 됩니다.

예를 들어 1500000은 통화 또는 ROAS 값의 1.5 표준 단위를 나타냅니다.
maxAverageCpmBidAmountMicros

string (int64 format)

입찰할 수 있는 최대 평균 CPM입니다(광고주 통화의 마이크로 단위). 지정된 통화의 청구 가능 단위 이상이어야 합니다. performanceGoalType가 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM로 설정된 경우에는 적용되지 않습니다.

예를 들어 1500000은 해당 통화의 1.5 표준 단위를 나타냅니다.
customBiddingAlgorithmId

string (int64 format)

이 전략에서 사용하는 맞춤 입찰 알고리즘의 ID입니다. performanceGoalType가 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO로 설정된 경우에만 적용됩니다.

floodlightActivityConfigs에서 식별되지 않은 플러드라이트 활동을 사용하는 맞춤 입찰 알고리즘을 할당하면 오류가 반환됩니다.

YoutubeAndPartnersBiddingStrategy

YouTube 및 파트너 리소스의 입찰 전략을 제어하는 설정입니다.

JSON 표현 
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
필드
type

enum (YoutubeAndPartnersBiddingStrategyType)

입찰 전략의 유형입니다.
value

string (int64 format)

입찰 전략에서 사용하는 값입니다.

입찰 전략이 광고 항목 수준에서 할당된 경우 이 필드는 다음 전략 유형에만 적용됩니다.

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

입찰 전략이 광고 그룹 수준에서 할당된 경우 이 필드는 다음 전략 유형에만 적용됩니다.

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

해당 전략을 사용하지 않는 경우 이 필드의 값은 0입니다.
adGroupEffectiveTargetCpaValue

string (int64 format)

출력 전용입니다. 광고 그룹의 유효 타겟 CPA입니다(광고주 통화의 마이크로 단위).
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

출력 전용입니다. 광고 그룹의 유효 타겟 CPA 값의 소스입니다.

YoutubeAndPartnersBiddingStrategyType

YouTube 및 파트너 리소스에 사용할 수 있는 입찰 전략 유형입니다.

열거형
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED 유형이 지정되지 않았거나 알 수 없습니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV 동영상 조회당 구성 가능한 금액을 지불하는 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM 노출당 구성 가능한 금액을 지불하는 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA 비용 대비 전환수를 자동으로 최적화하는 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM 노출당 구성 가능한 금액을 지불하는 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM 노출당 고정 금액을 지불하는 YouTube 빠른 예약 광고 항목의 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT 최대 광고효과를 달성하도록 입찰가를 설정하는 자동 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS 일일 예산에 따라 전환수를 자동으로 최대화하는 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV 동영상 조회당비용을 자동으로 최적화하는 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS 특정 타겟 광고 투자수익 (tROAS)을 평균으로 유지하면서 수익을 자동으로 극대화하는 입찰 전략입니다.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE 예산을 지출하면서 수익을 극대화하도록 입찰가를 자동으로 설정하는 입찰 전략입니다.

BiddingSource

입찰가 소스입니다.

열거형
BIDDING_SOURCE_UNSPECIFIED 입찰 소스가 지정되지 않았거나 알 수 없습니다.
BIDDING_SOURCE_LINE_ITEM 입찰가는 광고 항목에서 상속됩니다.
BIDDING_SOURCE_AD_GROUP 입찰가는 광고 그룹에서 정의됩니다.

DemandGenBiddingStrategy

디맨드젠 캠페인 리소스의 입찰 전략을 제어하는 설정입니다.

JSON 표현 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
필드
type

enum (DemandGenBiddingStrategyType)

선택사항입니다. 입찰 전략의 유형입니다.

광고 항목에 할당된 경우에만 설정할 수 있습니다. 광고 그룹은 광고 항목에서 이 값을 상속합니다.
value

string (int64 format)

선택사항입니다. 입찰 전략에서 사용하는 값입니다. 광고 항목 또는 광고 그룹에 할당할 때 설정할 수 있습니다. 이 필드는 다음 전략 유형에만 적용됩니다.

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

이 필드의 값은 광고주 통화의 마이크로 단위 또는 ROAS 값입니다. 예를 들어 1000000은 해당 통화의 표준 단위 1.0 또는 ROAS 값 100% 를 나타냅니다. 해당 전략을 사용하지 않는 경우 이 필드의 값은 0입니다.
effectiveBiddingValue

string (int64 format)

출력 전용입니다. 입찰 전략에서 효과적으로 사용하는 값입니다. 이 필드는 설정된 경우 value와 동일합니다. value가 설정되지 않고 전략이 광고 그룹에 할당된 경우 이 필드는 광고 항목의 입찰 전략에서 상속됩니다.

type가 DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA 또는 DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS가 아니면 이 필드는 0입니다.
effectiveBiddingValueSource

enum (BiddingSource)

출력 전용입니다. 유효 입찰가 값의 소스입니다.

DemandGenBiddingStrategyType

디맨드젠 캠페인 리소스에 사용할 수 있는 입찰 전략 유형입니다.

열거형
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED 유형이 지정되지 않았거나 알 수 없습니다.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA 비용 대비 전환수를 자동으로 최적화하는 입찰 전략입니다.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS 평균 타겟 광고 투자수익 (tROAS)을 유지하면서 수익을 자동으로 극대화하는 입찰 전략입니다.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS 전환수를 자동으로 최대화하는 입찰 전략
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE 예산을 지출하면서 수익을 자동으로 극대화하는 입찰 전략입니다.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS 지정된 예산 내에서 클릭수를 자동으로 최대화하는 입찰 전략입니다.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC 클릭당비용을 자동으로 최적화하는 입찰 전략입니다.