Campaign

캠페인

JSON 표현 
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
필드
resourceName

string

변경할 수 없습니다. 캠페인의 리소스 이름입니다. 캠페인 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaigns/{campaignId}
primaryStatus

enum (CampaignPrimaryStatus)

출력 전용입니다. 캠페인의 기본 상태입니다.

캠페인에서 광고가 게재되지 않거나 최적으로 게재되지 않는 이유에 대한 통계를 제공합니다. 캠페인 및 관련 항목을 수정해도 이 상태에 반영되는 데 다소 시간이 걸릴 수 있습니다.
primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

출력 전용입니다. 캠페인의 기본 상태 이유입니다.

캠페인에서 광고가 게재되지 않거나 최적으로 게재되지 않는 이유에 대한 통계를 제공합니다. 이러한 이유가 집계되어 전체 CampaignPrimaryStatus가 결정됩니다.
status

enum (CampaignStatus)

캠페인의 상태입니다.

새 캠페인을 추가하면 상태가 기본적으로 ENABLED로 설정됩니다.
servingStatus

enum (CampaignServingStatus)

출력 전용입니다. 캠페인의 광고 게재 상태입니다.
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

출력 전용입니다. 캠페인 입찰 전략의 시스템 상태입니다.
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

캠페인의 광고 게재 최적화 상태입니다.
advertisingChannelType

enum (AdvertisingChannelType)

변경할 수 없습니다. 캠페인 내 광고의 기본 게재 타겟입니다. 타겟팅 옵션은 networkSettings에서 미세 조정할 수 있습니다.

이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다.

캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.
advertisingChannelSubType

enum (AdvertisingChannelSubType)

변경할 수 없습니다. advertisingChannelType에 대한 선택적 미세 조정입니다. 상위 채널 유형의 유효한 하위 유형이어야 합니다.

캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.
urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls 또는 mobile_final_urls에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다.
localServicesCampaignSettings

object (LocalServicesCampaignSettings)

지역 서비스 캠페인 관련 설정입니다.
travelCampaignSettings

object (TravelCampaignSettings)

여행 캠페인의 설정
demandGenCampaignSettings

object (DemandGenCampaignSettings)

디맨드젠 캠페인의 설정
videoCampaignSettings

object (VideoCampaignSettings)

동영상 캠페인의 설정
realTimeBiddingSetting

object (RealTimeBiddingSetting)

실시간 입찰 설정: Ad Exchange 네트워크를 타겟팅하는 캠페인에서만 사용할 수 있는 기능입니다.
networkSettings

object (NetworkSettings)

캠페인의 네트워크 설정입니다.
hotelSetting

object (HotelSettingInfo)

변경할 수 없습니다. 캠페인의 호텔 설정입니다.
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

동적 검색 광고 (DSA)를 제어하기 위한 설정입니다.
shoppingSetting

object (ShoppingSetting)

쇼핑 캠페인을 관리하기 위한 설정입니다.
targetingSetting

object (TargetingSetting)

타겟팅 관련 기능의 설정입니다.
geoTargetTypeSetting

object (GeoTargetTypeSetting)

광고 지역 타겟팅 설정입니다.
localCampaignSetting

object (LocalCampaignSetting)

지역 캠페인의 설정입니다.
appCampaignSetting

object (AppCampaignSetting)

앱 캠페인과 관련된 설정입니다.
labels[]

string

출력 전용입니다. 이 캠페인에 연결된 라벨의 리소스 이름입니다.
experimentType

enum (CampaignExperimentType)

출력 전용입니다. 캠페인 유형: 일반, 초안 또는 실험
biddingStrategyType

enum (BiddingStrategyType)

출력 전용입니다. 입찰 전략의 유형입니다.

입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 biddingStrategy 필드를 설정해서 포트폴리오 입찰 전략을 만드는 방식으로 입찰 전략을 만들 수 있습니다.

이 필드는 읽기 전용입니다.
accessibleBiddingStrategy

string

출력 전용입니다. 'biddingStrategy'로 식별된 연결된 포트폴리오 입찰 전략의 제한되지 않은 속성의 읽기 전용 뷰인 AccessibleBiddingStrategy의 리소스 이름입니다. 캠페인에서 포트폴리오 전략을 사용하지 않는 경우 비워 둡니다. 제한되지 않은 전략 속성은 전략이 공유된 모든 고객이 사용할 수 있으며 AccessibleBiddingStrategy 리소스에서 읽을 수 있습니다. 반면 제한된 속성은 전략의 소유자 고객 및 관리자만 사용할 수 있습니다. 제한된 속성은 입찰 전략 리소스에서만 읽을 수 있습니다.
frequencyCaps[]

object (FrequencyCapEntry)

각 사용자에게 이 캠페인의 광고가 표시되는 빈도를 제한하는 목록입니다.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

개별 캠페인 수준의 브랜드 안전성 설정 내 브랜드에 적합한 콘텐츠에 광고를 게재할 인벤토리 유형을 선택할 수 있습니다. https://support.google.com/google-ads/answer/7515513을 참고하세요.
vanityPharma

object (VanityPharma)

브랜드 없는 의약품 광고가 표시되는 방식을 설명합니다.
selectiveOptimization

object (SelectiveOptimization)

이 캠페인에 최적화할 전환 액션 집합을 포함하는 이 캠페인의 선택적 최적화 설정입니다. 이 기능은 MULTI_CHANNEL을 AdvertisingChannelType으로, APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT을 AdvertisingChannelSubType로 사용하는 앱 캠페인에만 적용됩니다.
optimizationGoalSetting

object (OptimizationGoalSetting)

이 캠페인의 최적화 목표 설정으로, 최적화 목표 유형 집합이 포함됩니다.
trackingSetting

object (TrackingSetting)

출력 전용입니다. 추적 정보의 캠페인 수준 설정
paymentMode

enum (PaymentMode)

캠페인의 결제 모드입니다.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

이 캠페인에서 제외해야 하는 확장 소재 필드 유형입니다. 이러한 필드 유형의 애셋 링크는 이 캠페인에서 상위 수준에서 상속되지 않습니다.
excludedParentAssetSetTypes[]

enum (AssetSetType)

이 캠페인에서 제외해야 하는 확장 소재 세트 유형입니다. 이러한 유형의 애셋 세트 링크는 이 캠페인에서 상위 수준에서 상속받지 않습니다. 위치 그룹 유형 (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, STATIC_LOCATION_GROUP)은 LOCATION_SYNC의 하위 유형입니다. 따라서 이 필드에 LOCATION_SYNC가 설정된 경우 모든 위치 그룹 확장 소재 세트를 이 캠페인에 연결할 수 없으며 모든 위치 광고 확장 (LE) 및 제휴사 위치 광고 확장 (ALE)이 이 캠페인에서 게재되지 않습니다. 현재 LOCATION_SYNC만 지원됩니다.
performanceMaxUpgrade

object (PerformanceMaxUpgrade)

출력 전용입니다. 실적 최대화 캠페인으로 업그레이드되는 캠페인에 대한 정보입니다.
assetAutomationSettings[]

object (AssetAutomationSetting)

각 AssetAutomationType의 선택/선택 해제 상태를 포함합니다. 기본 선택/선택 해제 동작에 관한 자세한 내용은 각 확장 소재 자동화 유형 enum의 문서를 참고하세요.
keywordMatchType

enum (CampaignKeywordMatchType)

캠페인의 키워드 검색 유형입니다. 캠페인의 모든 키워드에 확장검색을 설정하려면 BROAD로 설정합니다.
id

string (int64 format)

출력 전용입니다. 캠페인의 ID입니다.
name

string

캠페인의 이름입니다.

이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다.

null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
trackingUrlTemplate

string

추적 URL을 만들기 위한 URL 템플릿입니다.
audienceSetting

object (AudienceSetting)

변경할 수 없습니다. 잠재고객 관련 기능의 설정입니다.
baseCampaign

string

출력 전용입니다. 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 resourceName와 같습니다.

이 필드는 읽기 전용입니다.
campaignBudget

string

캠페인의 캠페인 예산 리소스 이름입니다.
startDate

string

YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인이 시작된 날입니다.
campaignGroup

string

이 캠페인이 속한 캠페인 그룹의 리소스 이름입니다.
endDate

string

YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인 마지막 날입니다. 생성 시 기본값은 2037-12-30입니다. 즉, 캠페인이 무기한 실행됩니다. 기존 캠페인이 무한정 운영되도록 설정하려면 이 필드를 2037-12-30으로 설정하세요.
finalUrlSuffix

string

병렬 추적으로 게재되는 방문 페이지에 쿼리 매개변수를 추가하는 데 사용되는 접미사입니다.
optimizationScore

number

출력 전용입니다. 캠페인의 최적화 점수입니다.

최적화 점수는 캠페인이 얼마나 좋은 실적을 낼 수 있을지를 추정한 수치입니다. 최적화 점수는 0% (0.0)에서 100% (1.0)까지이며, 100% 는 캠페인이 최대한의 실적을 내고 있음을 나타냅니다. 점수가 없는 캠페인의 경우 이 필드는 null입니다.

https://support.google.com/google-ads/answer/9061546에서 '최적화 점수 정보'를 참고하세요.

이 필드는 읽기 전용입니다.
urlExpansionOptOut

boolean

더 많은 타겟팅 URL로의 URL 확장을 선택 해제했음을 나타냅니다. 선택 해제된 경우 (true) 애셋 그룹의 최종 URL 또는 광고주의 Google 판매자 센터 또는 비즈니스 데이터 피드에 지정된 URL만 타겟팅됩니다. 선택한 경우 (false) 전체 도메인이 타겟팅됩니다. 이 필드는 실적 최대화 캠페인에 대해서만 설정할 수 있으며 기본값은 false입니다.
hotelPropertyAssetSet

string

변경할 수 없습니다. 여행 목표 달성을 위한 실적 최대화 캠페인의 호텔 숙박 시설 세트의 리소스 이름입니다.
listingType

enum (ListingType)

변경할 수 없습니다. 이 캠페인에 게재된 광고의 등록정보 유형입니다. 이 필드는 실적 최대화 캠페인에서만 사용할 수 있습니다.

통합 필드 campaign_bidding_strategy. 캠페인의 입찰 전략입니다.

포트폴리오 (BiddingStrategy 서비스를 통해 생성됨) 또는 캠페인에 삽입된 표준이어야 합니다. campaign_bidding_strategy는 다음 중 하나여야 합니다.
biddingStrategy

string

캠페인에서 사용하는 포트폴리오 입찰 전략의 리소스 이름입니다.
commission

object (Commission)

수수료는 광고주가 전환 가치의 일정 부분을 지불하는 자동 입찰 전략입니다.
manualCpa

object (ManualCpa)

표준 수동 CPA 입찰 전략 광고주가 광고주 지정 액션별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다. 지역 서비스 캠페인에서만 지원됩니다.
manualCpc

object (ManualCpc)

표준 수동 CPC 입찰 전략 사용자가 클릭당 비용을 지불하는 수동 클릭 기반 입찰입니다.
manualCpm

object (ManualCpm)

표준 수동 CPM 입찰 전략 사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다.
manualCpv

object (ManualCpv)

동영상 조회당 구성 가능한 금액을 지불하는 입찰 전략입니다.
maximizeConversions

object (MaximizeConversions)

예산을 지출하면서 전환수를 자동으로 최대화하는 표준 전환수 최대화 입찰 전략입니다.
maximizeConversionValue

object (MaximizeConversionValue)

예산을 지출하면서 수익을 극대화하도록 입찰가를 자동으로 설정하는 표준 전환 가치 극대화 입찰 전략입니다.
targetCpa

object (TargetCpa)

설정된 타겟 CPA로 전환수를 최대한 늘릴 수 있도록 입찰가를 자동으로 설정하는 표준 타겟 CPA 입찰 전략입니다.
targetImpressionShare

object (TargetImpressionShare)

타겟 노출 점유율 입찰 전략 선택한 노출 비율을 달성하도록 입찰가를 설정하는 자동 입찰 전략입니다.
targetRoas

object (TargetRoas)

특정 타겟 광고 투자수익 (ROAS)을 평균화하면서 수익을 자동으로 극대화하는 표준 타겟 ROAS 입찰 전략입니다.
targetSpend

object (TargetSpend)

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 자동으로 설정하는 표준 목표 지출액 입찰 전략입니다.
percentCpc

object (PercentCpc)

입찰가가 특정 상품 또는 서비스의 광고 가격의 일부인 표준 비율 CPC 입찰 전략입니다.
targetCpm

object (TargetCpm)

1,000회 노출당비용을 자동으로 최적화하는 입찰 전략입니다.
fixedCpm

object (FixedCpm)

고정 CPM이 적용된 수동 입찰 전략입니다.
targetCpv

object (TargetCpv)

설정된 타겟 CPV를 고려하여 실적을 최적화하도록 입찰가를 설정하는 자동 입찰 전략입니다.

CampaignPrimaryStatus

가능한 캠페인 기본 상태를 설명하는 enum입니다. 캠페인에서 광고가 게재되지 않거나 최적화되지 않는 이유에 대한 통계를 제공합니다. 캠페인 및 관련 항목을 수정해도 이 상태에 반영되기까지 다소 시간이 걸릴 수 있습니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ELIGIBLE 캠페인을 게재할 수 있습니다.
PAUSED 사용자가 지정한 캠페인 상태가 일시중지됩니다.
REMOVED 사용자가 지정한 캠페인 상태가 삭제됩니다.
ENDED 사용자가 지정한 이 캠페인의 종료 시간이 지났습니다.
PENDING 캠페인은 향후 게재될 수 있습니다.
MISCONFIGURED 캠페인 또는 연결된 항목에 사용자가 지정한 잘못된 설정이 있습니다.
LIMITED 캠페인 또는 관련 항목이 사용자 지정 설정에 따라 제한됩니다.
LEARNING 자동 입찰 시스템이 캠페인 또는 연결된 항목에 대해 사용자가 지정한 변경사항에 맞게 조정 중입니다.
NOT_ELIGIBLE 캠페인을 게재할 수 없습니다.

CampaignPrimaryStatusReason

캠페인의 기본 상태 이유를 설명하는 enum입니다. 캠페인에서 광고가 게재되지 않거나 최적으로 게재되지 않는 이유에 대한 통계를 제공합니다. 이러한 이유가 집계되어 전체 캠페인 기본 상태가 결정됩니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CAMPAIGN_REMOVED 사용자가 지정한 캠페인 상태가 삭제됩니다.
CAMPAIGN_PAUSED 사용자가 지정한 캠페인 상태가 일시중지됩니다.
CAMPAIGN_PENDING 사용자가 지정한 캠페인 시작 시간이 미래입니다.
CAMPAIGN_ENDED 사용자가 지정한 이 캠페인의 종료 시간이 지났습니다.
CAMPAIGN_DRAFT 캠페인이 초안입니다.
BIDDING_STRATEGY_MISCONFIGURED 입찰 전략에 사용자가 지정한 설정이 잘못되었습니다.
BIDDING_STRATEGY_LIMITED 입찰 전략이 데이터 부족 등 사용자 지정 설정에 의해 제한됩니다.
BIDDING_STRATEGY_LEARNING 자동 입찰 시스템이 사용자가 지정한 입찰 전략 변경사항에 맞게 조정 중입니다.
BIDDING_STRATEGY_CONSTRAINED 캠페인에서 CPA/ROAS 타겟을 조정하여 더 많은 전환 가치를 포착할 수 있습니다.
BUDGET_CONSTRAINED 예산으로 인해 캠페인의 광고 게재가 제한됩니다.
BUDGET_MISCONFIGURED 예산에 사용자가 지정한 설정이 잘못되었습니다.
SEARCH_VOLUME_LIMITED 캠페인이 일부 관련 검색어를 타겟팅하지 않습니다.
AD_GROUPS_PAUSED 사용자가 지정한 광고 그룹 상태가 모두 일시중지됩니다.
NO_AD_GROUPS 이 캠페인에 운영 가능한 광고 그룹이 없습니다.
KEYWORDS_PAUSED 사용자가 지정한 키워드 상태가 모두 일시중지됩니다.
NO_KEYWORDS 이 캠페인에 운영 가능한 키워드가 없습니다.
AD_GROUP_ADS_PAUSED 사용자가 지정한 광고 그룹 광고 상태가 모두 일시중지됩니다.
NO_AD_GROUP_ADS 이 캠페인에 운영 가능한 광고 그룹 광고가 없습니다.
HAS_ADS_LIMITED_BY_POLICY 이 캠페인의 광고 중 하나 이상이 정책에 의해 제한되었습니다.
HAS_ADS_DISAPPROVED 이 캠페인의 광고 중 하나 이상이 비승인되었습니다.
MOST_ADS_UNDER_REVIEW 이 캠페인의 광고 대다수가 검토 대기 중입니다.
MISSING_LEAD_FORM_EXTENSION 캠페인에 리드 양식 목표가 있지만 리드 양식 광고 확장이 없습니다.
MISSING_CALL_EXTENSION 캠페인에 통화 목표가 있지만 전화번호 광고 확장이 없습니다.
LEAD_FORM_EXTENSION_UNDER_REVIEW 리드 양식 광고 확장이 검토 중입니다.
LEAD_FORM_EXTENSION_DISAPPROVED 리드 광고 확장이 비승인되었습니다.
CALL_EXTENSION_UNDER_REVIEW 전화번호 광고 확장이 검토 중입니다.
CALL_EXTENSION_DISAPPROVED 전화번호 광고 확장이 비승인되었습니다.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA 이 캠페인에 운영 가능한 모바일 애플리케이션 광고 그룹 기준이 없습니다.
CAMPAIGN_GROUP_PAUSED 사용자가 지정한 캠페인 그룹 상태가 일시중지됩니다.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED 상위 캠페인 그룹과 연결된 모든 그룹 예산의 사용자가 지정한 시간이 지났습니다.
APP_NOT_RELEASED 이 ACi 캠페인과 연결된 앱이 캠페인의 타겟 국가에서 출시되지 않았습니다.
APP_PARTIALLY_RELEASED 이 ACi 캠페인과 연결된 앱이 캠페인의 대상 국가에서 부분적으로 출시되었습니다.
HAS_ASSET_GROUPS_DISAPPROVED 이 캠페인의 애셋 그룹 중 하나 이상이 비승인되었습니다.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY 이 캠페인의 애셋 그룹 중 하나 이상이 정책에 의해 제한됩니다.
MOST_ASSET_GROUPS_UNDER_REVIEW 이 캠페인의 확장 소재 그룹 대부분이 검토 대기 중입니다.
NO_ASSET_GROUPS 이 캠페인에 요건을 충족하는 확장 소재 그룹이 없습니다.
ASSET_GROUPS_PAUSED 이 캠페인의 모든 애셋 그룹이 일시중지되었습니다.

CampaignStatus

캠페인의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 캠페인이 운영 중이며 광고를 게재할 수 있습니다.
PAUSED 사용자가 캠페인을 일시중지했습니다.
REMOVED 캠페인이 삭제되었습니다.

CampaignServingStatus

캠페인의 가능한 게재 상태입니다.

열거형
UNSPECIFIED 지정된 값이 없습니다.
UNKNOWN

이 버전에서는 수신된 값을 알 수 없습니다.

응답 전용 값입니다.
SERVING 제공
NONE 없음
ENDED 종료되었습니다.
PENDING 대기 중입니다.
SUSPENDED 정지되었습니다.

BiddingStrategySystemStatus

BiddingStrategy의 가능한 시스템 상태입니다.

열거형
UNSPECIFIED 예상치 못한 오류가 발생했음을 나타냅니다(예: 입찰 전략 유형을 찾을 수 없거나 상태 정보를 찾을 수 없음).
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 입찰 전략이 활성 상태이며 애드워즈에서 해당 전략에 대해 아무런 문제도 찾지 못했습니다.
LEARNING_NEW 입찰 전략이 최근에 만들어졌거나 최근에 다시 활성화되었기 때문에 학습 중입니다.
LEARNING_SETTING_CHANGE 최근 설정 변경으로 인해 입찰 전략이 학습 중입니다.
LEARNING_BUDGET_CHANGE 최근 예산 변경으로 인해 입찰 전략이 학습 중입니다.
LEARNING_COMPOSITION_CHANGE 최근에 연결된 캠페인, 광고그룹 또는 키워드의 수가 변경되어 입찰 전략이 학습 중입니다.
LEARNING_CONVERSION_TYPE_CHANGE 입찰 전략은 전환 보고와 고객이 최근에 입찰 전략과 관련하여 수정한 전환 유형에 따라 달라집니다.
LEARNING_CONVERSION_SETTING_CHANGE 입찰 전략이 전환 보고에 따라 달라지며 고객이 최근에 전환 설정을 변경했습니다.
LIMITED_BY_CPC_BID_CEILING 입찰 전략은 입찰가 상한으로 제한됩니다.
LIMITED_BY_CPC_BID_FLOOR 입찰 전략은 입찰가 하한선으로 제한됩니다.
LIMITED_BY_DATA 지난 몇 주 동안 전환 트래픽이 충분하지 않아 입찰 전략이 제한되었습니다.
LIMITED_BY_BUDGET 이 입찰 전략의 상당수 키워드가 예산으로 인해 제한됩니다.
LIMITED_BY_LOW_PRIORITY_SPEND 지출의 우선순위가 낮아져 입찰 전략이 목표 지출액에 도달할 수 없습니다.
LIMITED_BY_LOW_QUALITY 이 입찰 전략의 상당수 키워드의 품질평가점수가 낮습니다.
LIMITED_BY_INVENTORY 입찰 전략의 타겟팅 범위가 좁아 예산을 완전히 지출할 수 없습니다.
MISCONFIGURED_ZERO_ELIGIBILITY SSC의 전환 추적 (핑 없음) 또는 리마케팅 목록이 누락되었습니다.
MISCONFIGURED_CONVERSION_TYPES 입찰 전략이 전환 보고에 종속되며 고객에게 이 전략에 대해 보고될 수 있는 전환 유형이 없습니다.
MISCONFIGURED_CONVERSION_SETTINGS 입찰 전략이 전환 보고에 종속되며 고객의 전환 설정이 잘못 구성되었습니다.
MISCONFIGURED_SHARED_BUDGET 입찰 전략에 포함된 캠페인과 예산을 공유하는 입찰 전략 외부의 캠페인이 있습니다.
MISCONFIGURED_STRATEGY_TYPE 캠페인의 전략 유형이 잘못되어 광고가 게재되지 않습니다.
PAUSED 입찰 전략이 활성 상태가 아닙니다. 입찰 전략에 연결된 운영 중인 캠페인, 광고 그룹 또는 키워드가 없거나 또는 입찰 전략에 연결된 활성 예산이 없습니다.
UNAVAILABLE 이 입찰 전략은 현재 상태 보고를 지원하지 않습니다.
MULTIPLE_LEARNING 문제의 기간 동안 이 입찰 전략에 LEARNING_* 시스템 상태가 여러 번 발생했습니다.
MULTIPLE_LIMITED 문제의 기간 동안 이 입찰 전략에 대해 LIMITED_* 시스템 상태가 여러 번 발생했습니다.
MULTIPLE_MISCONFIGURED 문제의 기간 동안 이 입찰 전략에 MISCONFIGURED_* 시스템 상태가 여러 번 발생했습니다.
MULTIPLE 문제의 기간 동안 이 입찰 전략에 여러 시스템 상태가 있었습니다.

AdServingOptimizationStatus

게재 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정된 값이 없습니다.
UNKNOWN

이 버전에서는 수신된 값을 알 수 없습니다.

응답 전용 값입니다.
OPTIMIZE 광고 게재는 캠페인의 CTR을 기반으로 최적화됩니다.
CONVERSION_OPTIMIZE 캠페인의 CTR * 전환수를 기준으로 광고 게재가 최적화됩니다. 캠페인이 전환 최적화 도구 입찰 전략에 포함되어 있지 않으면 기본적으로 '최적화됨'으로 설정됩니다.
ROTATE 광고는 90일 동안 균등하게 로테이션된 후 클릭에 맞게 최적화됩니다.
ROTATE_INDEFINITELY 실적이 낮은 광고를 실적이 높은 광고와 함께 더 균등하게 게재하고 최적화하지 않습니다.
UNAVAILABLE 광고 게재 최적화 상태를 사용할 수 없습니다.

LocalServicesCampaignSettings

LocalServicesCampaign 하위 리소스의 설정입니다.

JSON 표현 
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
필드
categoryBids[]

object (CategoryBid)

MANUAL_CPA 입찰 전략과 연결된 카테고리 수준 입찰가입니다.

CategoryBid

LocalServicesReportingCampaignSettings의 카테고리 입찰가

JSON 표현 
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
필드
categoryId

string

입찰가가 연결될 카테고리입니다. 예를 들면 xcat:service_area_business_plumber입니다.
manualCpaBidMicros

string (int64 format)

카테고리의 수동 CPA 입찰가입니다. 입찰가는 해당 카테고리에 연결된 예약 가격보다 높아야 합니다. 값은 마이크로 단위이며 광고주의 통화로 표시됩니다.

TravelCampaignSettings

여행 캠페인의 설정

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

string (int64 format)

변경할 수 없습니다. 여행 캠페인과 연결된 여행 계정 ID입니다.

DemandGenCampaignSettings

디맨드젠 캠페인의 설정

JSON 표현 
{
  "upgradedTargeting": boolean
}
필드
upgradedTargeting

boolean

변경할 수 없습니다. 이 캠페인에서 업그레이드된 타겟팅 옵션을 사용할지 지정합니다. 이 필드를 true로 설정하면 표준 캠페인 수준 타겟팅이 아닌 광고 그룹 수준에서 위치 및 언어 타겟팅을 사용할 수 있습니다. 이 필드는 기본적으로 false로 설정되며 캠페인을 만들 때만 설정할 수 있습니다.

VideoCampaignSettings

동영상 캠페인의 설정

JSON 표현 
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
필드
videoAdInventoryControl

object (VideoAdInventoryControl)

도달범위 캠페인의 반응형 광고 컨테이너에 대한 인벤토리 관리

VideoAdInventoryControl

반응형 광고 컨테이너를 사용하는 캠페인의 경우 인벤토리 제어를 통해 광고가 게재될 인벤토리를 결정합니다. 이는 TARGET_CPM 및 FIXED_CPM 입찰 전략이 적용된 캠페인에만 적용됩니다.

JSON 표현 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
필드
allowInStream

boolean

인스트림 동영상 광고에 VideoResponsiveAds를 사용할 수 있는지 확인합니다.
allowInFeed

boolean

인피드 동영상 광고에 VideoResponsiveAds를 사용할 수 있는지 확인합니다.
allowShorts

boolean

VideoResponsiveAds를 Shorts 형식으로 사용할 수 있는지 확인합니다.

RealTimeBiddingSetting

실시간 입찰 설정: Ad Exchange 네트워크를 타겟팅하는 캠페인에서만 사용할 수 있는 기능입니다.

JSON 표현 
{
  "optIn": boolean
}
필드
optIn

boolean

캠페인에서 실시간 입찰을 선택했는지 여부입니다.

NetworkSettings

캠페인의 네트워크 설정입니다.

JSON 표현 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
필드
targetSearchNetwork

boolean

광고가 Google 검색 네트워크의 파트너 사이트에 게재되는지 여부입니다 (targetGoogleSearch가 true여야 함).
targetContentNetwork

boolean

광고가 Google 디스플레이 네트워크의 지정된 게재위치에 게재되는지 여부입니다. 게재위치는 게재위치 기준을 사용하여 지정됩니다.
targetPartnerSearchNetwork

boolean

광고가 Google 파트너 네트워크에 게재되는지 여부입니다. 이 기능은 일부 Google 파트너 계정에서만 사용할 수 있습니다.
targetYoutube

boolean

광고가 YouTube에 게재되는지 여부입니다.
targetGoogleTvNetwork

boolean

광고가 Google TV 네트워크에 게재되는지 여부입니다.

HotelSettingInfo

호텔 광고의 캠페인 수준 설정

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

string (int64 format)

변경할 수 없습니다. 연결된 Hotel Center 계정

DynamicSearchAdsSetting

동적 검색 광고 (DSA)를 제어하기 위한 설정입니다.

JSON 표현 
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
필드
domainName

string

필수 항목입니다. 이 설정이 나타내는 인터넷 도메인 이름입니다(예: 'google.com' 또는 'www.google.com').
languageCode

string

필수 항목입니다. 도메인의 언어를 지정하는 언어 코드입니다(예: 'en').
feeds[]

string

캠페인과 연결된 페이지 피드 확장 소재의 리소스 이름 목록입니다.
useSuppliedUrlsOnly

boolean

캠페인에서 광고주가 제공한 URL만 사용하는지 여부입니다.

ShoppingSetting

쇼핑 캠페인의 설정입니다. 캠페인에서 광고할 수 있는 제품 범위와 이 캠페인이 다른 쇼핑 캠페인과 상호작용하는 방식을 정의합니다.

JSON 표현 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
필드
feedLabel

string

캠페인에 포함할 제품의 피드 라벨입니다. feedLabel 또는 sales_country 중 하나만 설정할 수 있습니다. sales_country 대신 사용되는 경우 feedLabel 필드는 동일한 형식의 국가 코드(예: 'XX')를 허용합니다. 그 외의 경우 Google 판매자 센터의 피드 라벨에 사용되는 문자열이 될 수 있습니다.
useVehicleInventory

boolean

변경할 수 없습니다. 차량 등록정보 인벤토리를 타겟팅할지 여부입니다. 이 필드는 스마트 쇼핑 캠페인에서만 지원됩니다. 실적 최대화 캠페인에서 차량 등록정보 인벤토리를 설정하려면 대신 listingType를 사용하세요.
advertisingPartnerIds[]

string (int64 format)

변경할 수 없습니다. 캠페인 내에서 협력하는 광고 파트너의 광고 계정 ID입니다.
merchantId

string (int64 format)

판매자 센터 계정의 ID입니다. 이 필드는 생성 작업에 필요합니다. 쇼핑 캠페인의 경우 이 필드는 변경할 수 없습니다.
campaignPriority

integer

캠페인의 우선순위입니다. 우선순위가 더 높은 캠페인이 우선순위가 더 낮은 캠페인보다 우선 적용됩니다. 이 필드는 쇼핑 캠페인에 필수이며 값은 0~2 사이입니다(양 끝값 포함). 이 필드는 스마트 쇼핑 캠페인에서 선택사항이지만 설정된 경우 3과 같아야 합니다.
enableLocal

boolean

오프라인 제품을 포함할지 여부입니다.
disableProductFeed

boolean

선택사항인 제품 피드를 사용 중지합니다. 이 필드는 현재 디맨드젠 캠페인에서만 지원됩니다. 이 기능에 대해 자세히 알아보려면 https://support.google.com/google-ads/answer/13721750을 참고하세요.

AudienceSetting

잠재고객 타겟팅 설정

JSON 표현 
{
  "useAudienceGrouped": boolean
}
필드
useAudienceGrouped

boolean

변경할 수 없습니다. 이 값이 true이면 이 캠페인에서 잠재고객 타겟팅에 잠재고객 리소스를 사용합니다. false인 경우 이 캠페인에서 잠재고객 세그먼트 기준을 대신 사용할 수 있습니다.

GeoTargetTypeSetting

광고 지역 타겟팅과 관련된 설정 모음을 나타냅니다.

JSON 표현 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
필드
positiveGeoTargetType

enum (PositiveGeoTargetType)

이 특정 캠페인에서 포지티브 지역 타겟팅에 사용되는 설정입니다.
negativeGeoTargetType

enum (NegativeGeoTargetType)

이 특정 캠페인의 제외 지역 타겟팅에 사용되는 설정입니다.

PositiveGeoTargetType

가능한 긍정적인 지역 타겟 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 값을 알 수 없습니다.
PRESENCE_OR_INTEREST 사용자가 광고주의 타겟팅 위치에 있거나 해당 위치에 관심을 보이는 경우 광고가 트리거되도록 지정합니다.
SEARCH_INTEREST 사용자가 광고주의 타겟팅된 위치를 검색하면 광고가 트리거된다고 지정합니다. 이 기능은 검색 및 일반 쇼핑 캠페인에서만 사용할 수 있습니다.
PRESENCE 사용자가 광고주의 타겟 지역을 방문 중이거나 자주 방문하는 경우 광고가 트리거됨을 지정합니다.

NegativeGeoTargetType

가능한 제외 지역 타겟 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 값을 알 수 없습니다.
PRESENCE_OR_INTEREST 사용자가 광고주의 제외 위치에 있거나 제외 위치에 관심을 보이는 경우 광고가 표시되지 않도록 지정합니다.
PRESENCE 광고주가 제외한 위치에 있는 사용자에게는 광고가 표시되지 않도록 지정합니다.

LocalCampaignSetting

지역 캠페인의 캠페인 설정

JSON 표현 
{
  "locationSourceType": enum (LocationSourceType)
}
필드
locationSourceType

enum (LocationSourceType)

이 오프라인 캠페인의 위치 소스 유형입니다.

LocationSourceType

가능한 위치 소스 유형입니다.

열거형
UNSPECIFIED 지정된 값이 없습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
GOOGLE_MY_BUSINESS 고객의 연결된 비즈니스 프로필과 연결된 위치입니다.
AFFILIATE 제휴 (체인) 매장 위치 예를 들어 Best Buy 매장 위치가 있습니다.

AppCampaignSetting

앱 캠페인의 캠페인 수준 설정

JSON 표현 
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
필드
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

이 앱 캠페인의 입찰 전략이 최적화해야 하는 목표를 나타냅니다.
appStore

enum (AppCampaignAppStore)

변경할 수 없습니다. 이 특정 앱을 배포하는 애플리케이션 스토어입니다.
appId

string

변경할 수 없습니다. 모바일 애플리케이션을 고유하게 식별하는 문자열입니다.

AppCampaignBiddingStrategyGoalType

앱 캠페인 입찰 전략의 목표 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST 앱 설치수를 최대화하는 것을 목표로 합니다. cpa 입찰가는 타겟 설치당비용입니다.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST 앱 설치에서 선택한 인앱 전환의 장기적인 수를 최대화하는 것을 목표로 합니다. cpa 입찰가는 타겟 설치당비용입니다.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST 앱 설치에서 선택한 인앱 전환의 장기적인 수를 최대화하는 것을 목표로 합니다. cpa 입찰가는 인앱 전환당 타겟 비용입니다. 장기 전환이 아직 발생하지 않았기 때문에 처음에는 실제 CPA가 타겟 CPA보다 높게 보일 수 있습니다.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND 타겟 광고 투자수익을 달성하거나 초과하면서 설치 + 선택한 인앱 전환 등 모든 전환 가치를 극대화하는 것을 목표로 합니다.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME 앱의 사전 등록을 최대화하는 것을 목표로 합니다.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST 타겟 설치당비용 없이 앱 설치를 극대화하는 것을 목표로 합니다.

AppCampaignAppStore

앱 캠페인 앱 스토어를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
APPLE_APP_STORE Apple App Store
GOOGLE_APP_STORE Google Play

CampaignExperimentType

이 캠페인이 일반 캠페인, 초안 캠페인 또는 실험 캠페인인지 나타냅니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BASE 일반 캠페인입니다.
DRAFT 캠페인의 초안 버전입니다. 기본 캠페인에서 일부 수정사항이 적용되었지만 측정항목을 게재하거나 누적하지는 않습니다.
EXPERIMENT 캠페인의 실험 버전입니다. 기본 캠페인에서 일부 수정사항이 적용되었으며, 트래픽의 일부가 기본 캠페인에서 이 실험 캠페인으로 전환되고 있습니다.

FrequencyCapEntry

특정 기간 동안 사용자에게 광고 (또는 일부 광고 집합)를 게재할 수 있는 최대 횟수를 지정하는 규칙입니다.

JSON 표현 
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
필드
key

object (FrequencyCapKey)

특정 최대 게재빈도의 키입니다. 동일한 키를 사용하는 최대 게재빈도는 하나만 있을 수 있습니다.
cap

integer

이 한도에 따라 기간 동안 허용되는 최대 이벤트 수입니다.

FrequencyCapKey

최대 게재빈도의 키로 사용되는 필드 그룹입니다. 동일한 키를 사용하는 최대 게재빈도는 하나여야 합니다.

JSON 표현 
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
필드
level

enum (FrequencyCapLevel)

한도를 적용할 수준입니다 (예: 광고 그룹 광고, 광고 그룹). 한도는 이 수준의 모든 항목에 적용됩니다.
eventType

enum (FrequencyCapEventType)

한도가 적용되는 이벤트 유형 (예: 노출)입니다.
timeUnit

enum (FrequencyCapTimeUnit)

최대 게재빈도가 정의되는 시간 단위입니다 (예: 일, 주).
timeLength

integer

한도가 지속되는 시간 단위 수입니다.

FrequencyCapLevel

한도가 적용될 수준입니다 (예: 광고 그룹 광고, 광고 그룹). 이 수준의 모든 리소스에 한도가 적용됩니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD_GROUP_AD 게재빈도 한도는 광고 그룹 광고 수준에서 적용됩니다.
AD_GROUP 게재빈도 한도는 광고 그룹 수준에서 적용됩니다.
CAMPAIGN 한도는 캠페인 수준에서 적용됩니다.

FrequencyCapEventType

한도가 적용되는 이벤트 유형 (예: 노출)입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
IMPRESSION 광고 노출수에 한도가 적용됩니다.
VIDEO_VIEW 동영상 광고 조회수에 한도가 적용됩니다.

VanityPharma

브랜드 없는 의약품 광고가 표시되는 방식을 설명합니다.

JSON 표현 
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
필드
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

허위 의약품 URL의 표시 모드입니다.
vanityPharmaText

enum (VanityPharmaText)

웹사이트 설명이 허위 의약품 URL의 선택된 표시 모드인 경우 텍스트 광고의 표시 URL에 표시되는 텍스트입니다.

VanityPharmaDisplayUrlMode

허위 의약품 URL의 가능한 표시 모드를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MANUFACTURER_WEBSITE_URL 허위 의약품 URL을 제조업체 웹사이트 URL로 대체합니다.
WEBSITE_DESCRIPTION 허위 의약품 URL을 웹사이트 설명으로 대체합니다.

VanityPharmaText

가능한 텍스트를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
PRESCRIPTION_TREATMENT_WEBSITE_EN 웹사이트 콘텐츠가 영어인 처방 치료 웹사이트
PRESCRIPTION_TREATMENT_WEBSITE_ES 웹사이트 콘텐츠가 스페인어 (Sitio de tratamientos con receta)인 처방 치료 웹사이트
PRESCRIPTION_DEVICE_WEBSITE_EN 웹사이트 콘텐츠가 영어인 처방 기기 웹사이트
PRESCRIPTION_DEVICE_WEBSITE_ES 웹사이트 콘텐츠가 스페인어 (Sitio de dispositivos con receta)인 처방 기기 웹사이트
MEDICAL_DEVICE_WEBSITE_EN 웹사이트 콘텐츠가 영어인 의료 기기 웹사이트
MEDICAL_DEVICE_WEBSITE_ES 웹사이트 콘텐츠가 스페인어 (Sitio de dispositivos médicos)인 의료 기기 웹사이트
PREVENTATIVE_TREATMENT_WEBSITE_EN 웹사이트 콘텐츠가 영어인 예방 치료 웹사이트
PREVENTATIVE_TREATMENT_WEBSITE_ES 웹사이트 콘텐츠가 스페인어 (Sitio de tratamientos preventivos)인 예방 치료 웹사이트
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN 웹사이트 콘텐츠가 영어인 처방 피임약 웹사이트
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES 웹사이트 콘텐츠가 스페인어 (Sitio de anticonceptivos con receta)인 처방 피임약 웹사이트
PRESCRIPTION_VACCINE_WEBSITE_EN 웹사이트 콘텐츠가 영어인 처방 백신 웹사이트
PRESCRIPTION_VACCINE_WEBSITE_ES 웹사이트 콘텐츠가 스페인어 (Sitio de vacunas con receta)인 처방 백신 웹사이트

SelectiveOptimization

이 캠페인에 최적화할 전환 액션 집합을 포함하는 이 캠페인의 선택적 최적화 설정입니다. 이 기능은 MULTI_CHANNEL을 AdvertisingChannelType으로, APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT을 AdvertisingChannelSubType으로 사용하는 앱 캠페인에만 적용됩니다.

JSON 표현 
{
  "conversionActions": [
    string
  ]
}
필드
conversionActions[]

string

이 캠페인을 최적화하기 위해 선택된 전환 액션의 리소스 이름 집합입니다.

OptimizationGoalSetting

이 캠페인의 최적화 목표 설정으로, 최적화 목표 유형 집합이 포함됩니다.

JSON 표현 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
필드
optimizationGoalTypes[]

enum (OptimizationGoalType)

최적화 목표 유형 목록입니다.

OptimizationGoalType

최적화 목표 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값으로만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CALL_CLICKS 통화 클릭에 맞게 최적화합니다. 통화 클릭 전환은 사용자가 광고를 본 후 '통화'를 선택하여 매장에 연락한 횟수입니다.
DRIVING_DIRECTIONS 운전 경로에 맞게 최적화합니다. 경로 검색 전환은 사용자가 광고를 본 후 '경로 검색'을 선택하여 매장으로 이동한 횟수입니다.
APP_PRE_REGISTRATION 사전 등록에 최적화합니다. 사전 등록 전환은 앱이 출시될 때 알림을 받기 위해 사전 등록한 사용자 수입니다.

TrackingSetting

추적 정보에 대한 캠페인 수준 설정

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

string

출력 전용입니다. 동적 추적에 사용되는 URL입니다.

PaymentMode

가능한 결제 수단을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CLICKS 상호작용당 비용
CONVERSION_VALUE 전환당 가치에 따라 비용을 지불합니다. 이 모드는 AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION, BudgetType.STANDARD가 있는 캠페인에서만 지원됩니다.
CONVERSIONS 전환당 비용 지불 이 모드는 AdvertisingChannelType.DISPLAY (AdvertisingChannelSubType.DISPLAY_GMAIL 제외), BiddingStrategyType.TARGET_CPA, BudgetType.FIXED_CPA가 있는 캠페인에서만 지원됩니다. 또한 고객이 이 모드를 사용할 수 있어야 합니다. 자세한 내용은 Customer.eligibility_failure_reasons를 참고하세요.
GUEST_STAY 투숙객 숙박당 지불 금액입니다. 이 모드는 AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION, BudgetType.STANDARD가 있는 캠페인에서만 지원됩니다.

PerformanceMaxUpgrade

실적 최대화 캠페인으로 업그레이드되는 캠페인에 대한 정보입니다.

JSON 표현 
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
필드
performanceMaxCampaign

string

출력 전용입니다. 캠페인이 업그레이드된 실적 최대화 캠페인의 리소스 이름입니다.
preUpgradeCampaign

string

출력 전용입니다. 실적 최대화 캠페인으로 업그레이드된 기존 캠페인의 리소스 이름입니다.
status

enum (PerformanceMaxUpgradeStatus)

출력 전용입니다. 실적 최대화 캠페인으로 업그레이드하도록 요청된 캠페인의 업그레이드 상태입니다.

PerformanceMaxUpgradeStatus

캠페인의 실적 최대화 업그레이드 상태 enum입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
UPGRADE_IN_PROGRESS 실적 최대화 캠페인으로 업그레이드가 진행 중입니다.
UPGRADE_COMPLETE 실적 최대화 캠페인으로 업그레이드가 완료되었습니다.
UPGRADE_FAILED 실적 최대화 캠페인으로 업그레이드하지 못했습니다. 캠페인은 업그레이드가 시도되기 전과 동일하게 계속 게재됩니다.
UPGRADE_ELIGIBLE 캠페인을 실적 최대화 캠페인으로 업그레이드할 수 있습니다.

ListingType

가능한 등록정보 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
VEHICLES 이 캠페인은 차량 광고를 게재합니다.

AssetAutomationSetting

애셋 자동화 설정에 AssetAutomationType 쌍과 애셋 자동화 선택/선택 해제 상태가 포함됨

JSON 표현 
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
필드
assetAutomationType

enum (AssetAutomationType)

광고주가 선택/선택 해제하려는 확장 소재 자동화 유형입니다.
assetAutomationStatus

enum (AssetAutomationStatus)

확장 소재 자동화 유형의 선택/선택 해제 상태입니다.

AssetAutomationType

확장 소재 자동화 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값으로만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
TEXT_ASSET_AUTOMATION 텍스트 확장 소재 자동화에는 광고 제목과 내용 입력란이 포함됩니다. 기본적으로 광고주는 실적 최대화 캠페인을 선택하고 검색을 선택 해제합니다.

AssetAutomationStatus

확장 소재 자동화의 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값으로만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
OPTED_IN 선택하면 확장 소재 자동화 유형을 생성하고 게재할 수 있습니다.
OPTED_OUT 선택 해제하면 애셋 자동화 유형의 생성 및 게재가 중지됩니다.

CampaignKeywordMatchType

캠페인의 키워드 검색 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정된 값이 없습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BROAD 캠페인 수준 확장검색

수수료

수수료는 광고주가 전환 가치의 일정 부분을 지불하는 자동 입찰 전략입니다.

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

string (int64 format)

수수료율은 광고주에게 청구되는 전환 가치의 비율을 정의합니다. 수수료율 x는 (x * 1,000,000)으로 이 필드에 전달되어야 합니다. 예를 들어 106,000은 수수료율 0.106 (10.6%)을 나타냅니다.

ManualCpa

이 유형에는 필드가 없습니다.

광고주가 광고주 지정 액션별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다.

ManualCpc

사용자가 클릭당 비용을 지불하는 수동 클릭 기반 입찰입니다.

JSON 표현 
{
  "enhancedCpcEnabled": boolean
}
필드
enhancedCpcEnabled

boolean

전환 최적화 도구 데이터를 기반으로 입찰가를 개선할지 여부입니다.

ManualCpm

이 유형에는 필드가 없습니다.

사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다.

ManualCpv

이 유형에는 필드가 없습니다.

사용자가 동영상 조회당 비용을 지불하는 조회수 기반 입찰입니다.

PercentCpc

입찰가가 특정 상품 또는 서비스의 광고된 가격의 일부인 입찰 전략입니다.

JSON 표현 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
필드
cpcBidCeilingMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 광고주가 입력하는 선택사항 필드이며 로컬 마이크로 단위로 지정됩니다. 참고: 0 값은 bid_ceiling이 정의되지 않은 것과 동일한 방식으로 해석됩니다.
enhancedCpcEnabled

boolean

전환 가능성에 따라 각 입찰의 입찰가를 상향 또는 하향 조정합니다. 개별 입찰가는 cpcBidCeilingMicros를 초과할 수 있지만 캠페인의 평균 입찰가는 초과해서는 안 됩니다.

TargetCpm

타겟 CPM (1,000회 노출당비용)은 설정한 타겟 CPM을 기준으로 실적을 최적화하도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현 
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
필드
통합 필드 goal. 입찰 목표와 관련된 추가 정보입니다. goal은 다음 중 하나여야 합니다.
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

타겟 게재빈도 입찰 목표 세부정보

TargetCpmTargetFrequencyGoal

타겟 게재빈도 입찰 목표 세부정보

JSON 표현 
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
필드
targetCount

string (int64 format)

단일 사용자에게 도달하려는 횟수를 나타내는 타겟 게재빈도 수입니다.
timeUnit

enum (TargetFrequencyTimeUnit)

지정된 targetCount에 도달하려는 기간을 나타내는 시간 간격입니다.

고정 CPM

고정 CPM (1,000회 노출당비용) 입찰 전략 고정 CPM이 적용된 수동 입찰 전략입니다.

JSON 표현 
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
필드
goal

enum (FixedCpmGoal)

고정 CPM 입찰 목표가 설정되었습니다. 정확한 입찰 최적화 매개변수를 결정합니다.
통합 필드 goal_info. 입찰 목표와 관련된 추가 정보입니다. goal_info은 다음 중 하나여야 합니다.
targetFrequencyInfo

object (FixedCpmTargetFrequencyGoalInfo)

타겟 게재빈도 입찰 목표 세부정보

FixedCpmGoal

고정 CPM 입찰 전략의 목표를 설명하는 enum입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
REACH 이 캠페인의 광고를 본 사용자 수인 도달범위를 최대화합니다.
TARGET_FREQUENCY 타겟 게재빈도 CPM 입찰자 요청된 게재빈도로 단일 사용자에게 도달하도록 입찰을 최적화합니다.

FixedCpmTargetFrequencyGoalInfo

고정 CPM 입찰 전략의 타겟 게재빈도 입찰 목표 세부정보 입찰 전략의 목표가 TARGET_FREQUENCY인 경우에만 관련이 있습니다.

JSON 표현 
{
  "targetCount": string,
  "timeUnit": enum (FixedCpmTargetFrequencyTimeUnit)
}
필드
targetCount

string (int64 format)

타겟 게재빈도 수는 광고주가 단일 사용자를 타겟팅하기 위해 광고를 게재하려는 횟수를 나타냅니다.
timeUnit

enum (FixedCpmTargetFrequencyTimeUnit)

지정된 targetCount에 도달하려는 기간을 나타내는 시간 간격입니다.

FixedCpmTargetFrequencyTimeUnit

고정 CPM 입찰 전략을 사용할 때 타겟 게재빈도를 충족하도록 입찰이 최적화되는 기간을 설명하는 enum입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MONTHLY 30일 내에 타겟 게재빈도에 도달하도록 입찰을 최적화합니다.

TargetCpv

이 유형에는 필드가 없습니다.

타겟 CPV (조회당비용) 입찰 전략 설정된 타겟 CPV를 고려하여 실적을 최적화하도록 입찰가를 설정하는 자동 입찰 전략입니다.