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)
  },
  "discoveryCampaignSettings": {
    object (DiscoveryCampaignSettings)
  },
  "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)
  },
  "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)
  }
  // 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)

캠페인의 상태입니다.

새 캠페인이 추가되면 기본 상태는 '사용'으로 설정됩니다.
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)

여행 캠페인 설정입니다.
discoveryCampaignSettings

object (DiscoveryCampaignSettings)

디스커버리 캠페인의 설정입니다.
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

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

object (FrequencyCapEntry)

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

enum (BrandSafetySuitability)

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

object (VanityPharma)

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

object (SelectiveOptimization)

이 캠페인에 대한 선택적 최적화 설정이며 이 캠페인을 최적화할 수 있는 전환 액션의 집합이 포함됩니다. 이 기능은 AdvertisingChannelType으로 MULTI_CHANNEL을, AdvertisingChannelSubType으로 APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT를 사용하는 앱 캠페인에만 적용됩니다.
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)

출력 전용입니다. 실적 최대화 캠페인으로 업그레이드되는 캠페인에 대한 정보입니다.
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회 노출당비용을 자동으로 최적화하는 입찰 전략입니다.

CampaignPrimaryStatus

가능한 캠페인의 기본 상태를 설명하는 열거형입니다. 캠페인이 제대로 게재되지 않거나 게재되지 않는 이유에 대한 통계를 제공합니다. 캠페인 및 관련 항목에 대한 수정사항이 이 상태에 반영되기까지 시간이 다소 걸릴 수 있습니다.

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

CampaignPrimaryStatusReason

캠페인 기본 상태의 이유를 설명하는 열거형입니다. 캠페인이 제대로 게재되지 않거나 게재되지 않는 이유에 대한 통계를 제공합니다. 이러한 이유는 집계되어 전반적인 캠페인의 기본 상태를 결정합니다.

열거형
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 이 캠페인에 있는 대부분의 애셋 그룹이 검토 대기 중입니다.

CampaignStatus

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

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

CampaignServingStatus

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

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

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

이 값은 응답 전용입니다.
SERVING 게재 중
NONE 없음
ENDED 종료됨
PENDING 대기 중입니다.
SUSPENDED 일시 중지되었습니다.

BiddingStrategySystemStatus

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

열거형
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입니다.

DiscoveryCampaignSettings

디스커버리 캠페인의 설정입니다.

JSON 표현 
{
  "upgradedTargeting": boolean
}
입력란
upgradedTargeting

boolean

변경할 수 없습니다. 이 캠페인에서 업그레이드된 타겟팅 옵션을 사용할지 여부를 지정합니다. 이 필드가 true로 설정되면 표준 캠페인 수준 타겟팅과 달리 광고그룹 수준에서 위치 및 언어 타겟팅을 사용할 수 있습니다. 이 필드의 기본값은 false이며 캠페인을 만들 때만 설정할 수 있습니다.

RealTimeBiddingSetting

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

JSON 표현 
{
  "optIn": boolean
}
입력란
optIn

boolean

캠페인의 실시간 입찰 선택 여부입니다.

NetworkSettings

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

JSON 표현 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
입력란
targetSearchNetwork

boolean

Google 검색 네트워크의 파트너 사이트에 광고를 게재할지 여부입니다. targetGoogleSearch도 true이어야 합니다.
targetContentNetwork

boolean

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

boolean

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

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,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
입력란
feedLabel

string

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

boolean

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

string (int64 format)

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

string (int64 format)

변경할 수 없습니다. 판매자 센터 계정의 ID입니다. 이 필드는 작업을 만드는 데 필요합니다. 쇼핑 캠페인에서는 이 입력란을 변경할 수 없습니다.
salesCountry

string

캠페인에 포함할 제품의 판매 국가입니다. feedLabel 또는 salesCountry 중 하나만 설정할 수 있습니다. 필드는 지우기를 제외하고 변경할 수 없습니다. 이 필드를 지운 후에는 판매 국가를 설정하려면 feedLabel을 사용해야 합니다.
campaignPriority

integer

캠페인의 우선순위입니다. 숫자가 우선순위가 높은 캠페인이 우선순위가 낮은 캠페인보다 우선합니다. 이 필드는 0 이상 2 이하의 값을 가진 쇼핑 캠페인에 필요합니다. 스마트 쇼핑 캠페인의 경우 이 필드는 선택사항이지만 설정된 경우 3과 같아야 합니다.
enableLocal

boolean

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

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 입찰은 타겟 설치당비용(CPI)입니다.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST 앱 설치에서 선택된 인앱 전환을 장기적으로 최대화하는 것을 목표로 합니다. CPA 입찰은 타겟 설치당비용(CPI)입니다.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST 앱 설치에서 선택된 인앱 전환을 장기적으로 최대화하는 것을 목표로 합니다. CPA 입찰은 인앱 전환당 타겟 비용입니다. 장기 전환이 아직 발생하지 않았으므로 처음에는 실제 CPA가 타겟 CPA보다 높게 나타날 수 있습니다.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND 모든 전환 가치를 극대화하는 것을 목표로 합니다. 예를 들어 설치 수 + 선택된 인앱 전환을 늘리는 동시에 타겟 광고 투자수익(ROAS)을 달성하거나 초과 달성하는 것이 좋습니다.
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 캠페인의 실험 버전입니다. 기본 캠페인에서 일부 수정사항이 수정되었으며 일부 트래픽이 BASE 캠페인에서 이 실험 캠페인으로 전환되고 있습니다.

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 이 한도는 동영상 광고 조회수에 적용됩니다.

BrandSafetySuitability

3단계 브랜드 안전성 적합성 관리

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EXPANDED_INVENTORY 이 옵션을 사용하면 수익 창출 기준을 충족하는 YouTube 및 동영상 파트너의 모든 인벤토리에 광고를 게재할 수 있습니다. 예를 들어 내용에 욕설이 자주 나오는 코미디나, 다큐멘터리 동영상이나, 과도한 폭력을 보여주는 비디오 게임을 포함하여 동영상 전체에 광고를 최대한 많이 게재하려는 브랜드에 이 옵션이 적합한 선택일 수 있습니다.
STANDARD_INVENTORY 이 옵션을 사용하면 인기 있는 뮤직비디오, 다큐멘터리, 영화 예고편 등 대부분의 브랜드에 적합한 다양한 콘텐츠에 광고를 게재할 수 있습니다. 광고를 게재할 수 있는 콘텐츠는 욕설의 강도나 빈도, 민감한 사건과 같은 주제의 적합성 등 YouTube의 광고주 친화적인 콘텐츠 가이드라인을 기반으로 결정됩니다. 반복되는 과도한 욕설, 심한 성적인 콘텐츠 또는 노골적인 폭력 묘사가 있는 콘텐츠에는 광고가 게재되지 않습니다.
LIMITED_INVENTORY 이 옵션을 사용하면 부적절한 언어 및 성적인 암시에 대해 특히 엄격한 가이드라인이 적용되는 브랜드에 적합하도록 콘텐츠 범위를 축소하여 광고를 게재할 수 있습니다. 이는 YouTube의 광고주 친화적인 콘텐츠 가이드라인에서 다루는 범위를 능가합니다. 이 민감한 카테고리에서 액세스할 수 있는 동영상은 특히 부적절한 언어 및 외설적인 콘텐츠에 대해 강화된 요구사항을 충족합니다. 예를 들어 YouTube에서 가장 인기 있는 뮤직비디오와 YouTube 및 Google 동영상 파트너의 기타 대중 문화 콘텐츠에서 광고가 게재되지 않습니다.

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 tratamientospreventivos)
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

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

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 및 예산 유형.STANDARD를 사용하는 캠페인에서만 지원됩니다.
CONVERSIONS 전환당지불입니다. 이 모드는 AdvertisingChannelType.DISPLAY (AdvertisingChannelSubType.DISPLAY_gmail 제외),BiddingStrategyType.TARGET_CPA 및 예산 유형.FIXED_CPA를 사용하는 캠페인에서만 지원됩니다. 고객도 이 모드를 사용할 수 있어야 합니다. 자세한 내용은 Customer.eligibility_failure_reasons를 참고하세요.
GUEST_STAY 숙박 건당 지불 가격입니다. 이 모드는 AdvertisingChannelType.HOTEL,BiddingStrategyType.COMMISSION 및 예산 유형.STANDARD를 사용하는 캠페인에서만 지원됩니다.

PerformanceMaxUpgrade

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

JSON 표현 
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
입력란
performanceMaxCampaign

string

출력 전용입니다. 캠페인이 업그레이드될 실적 최대화 캠페인을 나타냅니다.
preUpgradeCampaign

string

출력 전용입니다. 기존 캠페인이 실적 최대화 캠페인으로 업그레이드되었음을 나타냅니다.
status

enum (PerformanceMaxUpgradeStatus)

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

PerformanceMaxUpgradeStatus

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

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

ListingType

가능한 목록 유형입니다.

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

수수료

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

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에 도달하려는 기간을 나타내는 기간입니다.

TargetFrequencyTimeUnit

타겟 게재빈도에 도달하려는 기간을 설명하는 열거형입니다.

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