GoogleAdsRow

쿼리에서 반환된 행입니다.

JSON 표현
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetCombinationView": {
    object (AdGroupAdAssetCombinationView)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionCustomizer": {
    object (AdGroupCriterionCustomizer)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupCustomizer": {
    object (AdGroupCustomizer)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetTypeView": {
    object (AssetSetTypeView)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingDataExclusion": {
    object (BiddingDataExclusion)
  },
  "biddingSeasonalityAdjustment": {
    object (BiddingSeasonalityAdjustment)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignConversionGoal": {
    object (CampaignConversionGoal)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCustomizer": {
    object (CampaignCustomizer)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignSearchTermInsight": {
    object (CampaignSearchTermInsight)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "conversionGoalCampaignConfig": {
    object (ConversionGoalCampaignConfig)
  },
  "conversionValueRule": {
    object (ConversionValueRule)
  },
  "conversionValueRuleSet": {
    object (ConversionValueRuleSet)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customConversionGoal": {
    object (CustomConversionGoal)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerCustomizer": {
    object (CustomerCustomizer)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerConversionGoal": {
    object (CustomerConversionGoal)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "recommendation": {
    object (Recommendation)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
입력란
accountBudget

object (AccountBudget)

쿼리의 계정 예산입니다.

accountBudgetProposal

object (AccountBudgetProposal)

쿼리에서 참조된 계정 예산 제안입니다.

adGroup

object (AdGroup)

쿼리에서 참조된 광고그룹입니다.

adGroupAd

object (AdGroupAd)

쿼리에서 참조된 광고입니다.

adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

검색어의 광고그룹 광고 애셋 조합 보기입니다.

adGroupAdAssetView

object (AdGroupAdAssetView)

쿼리의 광고그룹 광고 애셋 보기입니다.

adGroupAdLabel

object (AdGroupAdLabel)

쿼리에서 참조된 광고그룹 광고 라벨입니다.

adGroupAsset

object (AdGroupAsset)

쿼리에서 참조된 광고그룹 애셋입니다.

adGroupAssetSet

object (AdGroupAssetSet)

쿼리에서 참조된 광고그룹 애셋 세트입니다.

adGroupAudienceView

object (AdGroupAudienceView)

쿼리에서 참조된 광고그룹 잠재고객 보기입니다.

adGroupBidModifier

object (AdGroupBidModifier)

쿼리에서 참조된 입찰 조정입니다.

adGroupCriterion

object (AdGroupCriterion)

쿼리에서 참조된 기준입니다.

adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

쿼리에서 참조된 광고그룹 기준 맞춤설정 도구입니다.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

쿼리에서 참조된 광고그룹 기준 라벨입니다.

adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

쿼리에서 참조된 광고그룹 기준 시뮬레이션입니다.

adGroupCustomizer

object (AdGroupCustomizer)

쿼리에서 참조된 광고그룹 맞춤설정 도구입니다.

adGroupExtensionSetting

object (AdGroupExtensionSetting)

쿼리에서 참조된 광고그룹 확장 설정입니다.

adGroupFeed

object (AdGroupFeed)

쿼리에서 참조된 광고그룹 피드입니다.

adGroupLabel

object (AdGroupLabel)

쿼리에서 참조된 광고그룹 라벨입니다.

adGroupSimulation

object (AdGroupSimulation)

쿼리에서 참조된 광고그룹 시뮬레이션입니다.

adParameter

object (AdParameter)

쿼리에서 참조된 광고 매개변수입니다.

ageRangeView

object (AgeRangeView)

쿼리에서 참조된 연령대 보기입니다.

adScheduleView

object (AdScheduleView)

쿼리에서 참조된 광고 일정 보기입니다.

domainCategory

object (DomainCategory)

쿼리에서 참조된 도메인 카테고리입니다.

asset

object (Asset)

쿼리에서 참조된 애셋입니다.

assetFieldTypeView

object (AssetFieldTypeView)

쿼리에서 참조된 애셋 필드 유형 뷰입니다.

assetGroupAsset

object (AssetGroupAsset)

쿼리에서 참조된 애셋 그룹 애셋입니다.

assetGroupSignal

object (AssetGroupSignal)

쿼리에서 참조된 애셋 그룹 신호입니다.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

쿼리에서 참조된 애셋 그룹 등록정보 그룹 필터입니다.

assetGroupProductGroupView

object (AssetGroupProductGroupView)

쿼리에서 참조된 애셋 그룹 제품 그룹 보기입니다.

assetGroup

object (AssetGroup)

쿼리에서 참조된 애셋 그룹입니다.

assetSetAsset

object (AssetSetAsset)

쿼리에서 참조된 애셋 세트 애셋입니다.

assetSet

object (AssetSet)

쿼리에서 참조된 애셋 세트입니다.

assetSetTypeView

object (AssetSetTypeView)

쿼리에서 참조된 애셋 세트 유형 보기입니다.

batchJob

object (BatchJob)

쿼리에서 참조되는 일괄 작업입니다.

biddingDataExclusion

object (BiddingDataExclusion)

쿼리에서 참조된 입찰 데이터 제외입니다.

biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

쿼리에서 참조된 입찰 시즌성 조정입니다.

biddingStrategy

object (BiddingStrategy)

쿼리에서 참조된 입찰 전략입니다.

biddingStrategySimulation

object (BiddingStrategySimulation)

쿼리에서 참조된 입찰 전략 시뮬레이션입니다.

billingSetup

object (BillingSetup)

쿼리에서 참조된 결제 설정입니다.

callView

object (CallView)

쿼리에서 참조된 호출 뷰입니다.

campaignBudget

object (CampaignBudget)

쿼리에서 참조된 캠페인 예산입니다.

campaign

object (Campaign)

쿼리에서 참조된 캠페인입니다.

campaignAsset

object (CampaignAsset)

쿼리에서 참조된 캠페인 애셋입니다.

campaignAssetSet

object (CampaignAssetSet)

쿼리에서 참조된 캠페인 애셋 세트입니다.

campaignAudienceView

object (CampaignAudienceView)

쿼리에서 참조된 캠페인 잠재고객 뷰입니다.

campaignBidModifier

object (CampaignBidModifier)

쿼리에서 참조된 캠페인 입찰 조정입니다.

campaignConversionGoal

object (CampaignConversionGoal)

쿼리에서 참조된 CampaignConversionGoal입니다.

campaignCriterion

object (CampaignCriterion)

쿼리에서 참조된 캠페인 기준입니다.

campaignCustomizer

object (CampaignCustomizer)

쿼리에서 참조된 캠페인 맞춤설정 도구입니다.

campaignDraft

object (CampaignDraft)

쿼리에서 참조된 캠페인 초안입니다.

campaignExtensionSetting

object (CampaignExtensionSetting)

쿼리에서 참조된 캠페인 광고 확장 설정입니다.

campaignFeed

object (CampaignFeed)

쿼리에서 참조된 캠페인 피드입니다.

campaignGroup

object (CampaignGroup)

AWQL 쿼리에서 참조된 캠페인 그룹입니다.

campaignLabel

object (CampaignLabel)

쿼리에서 참조된 캠페인 라벨입니다.

campaignSearchTermInsight

object (CampaignSearchTermInsight)

쿼리에서 참조된 캠페인 검색어 통계입니다.

campaignSharedSet

object (CampaignSharedSet)

AWQL 쿼리에서 참조된 캠페인 공유 세트입니다.

campaignSimulation

object (CampaignSimulation)

쿼리에서 참조된 캠페인 시뮬레이션입니다.

carrierConstant

object (CarrierConstant)

쿼리에서 참조된 이동통신사 상수입니다.

changeEvent

object (ChangeEvent)

쿼리에서 참조된 ChangeEvent입니다.

changeStatus

object (ChangeStatus)

쿼리에서 참조된 ChangeStatus입니다.

combinedAudience

object (CombinedAudience)

쿼리에서 참조된 MergedAudience입니다.

audience

object (Audience)

쿼리에서 참조된 잠재고객입니다.

conversionAction

object (ConversionAction)

쿼리에서 참조된 전환 액션입니다.

conversionCustomVariable

object (ConversionCustomVariable)

쿼리에서 참조된 전환 맞춤 변수입니다.

conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

쿼리에서 참조된 ConversionGoalCampaignConfig입니다.

conversionValueRule

object (ConversionValueRule)

쿼리에서 참조된 전환 가치 규칙입니다.

conversionValueRuleSet

object (ConversionValueRuleSet)

쿼리에서 참조된 전환 가치 규칙 세트입니다.

clickView

object (ClickView)

쿼리에서 참조된 ClickView입니다.

currencyConstant

object (CurrencyConstant)

쿼리에서 참조된 통화 상수입니다.

customAudience

object (CustomAudience)

쿼리에서 참조된 CustomAudience입니다.

customConversionGoal

object (CustomConversionGoal)

쿼리에서 참조된 CustomConversionGoal입니다.

customInterest

object (CustomInterest)

쿼리에서 참조된 맞춤 관심분야입니다.

customer

object (Customer)

쿼리에서 참조된 고객입니다.

customerAsset

object (CustomerAsset)

쿼리에서 참조된 고객 애셋입니다.

customerAssetSet

object (CustomerAssetSet)

쿼리에서 참조된 고객 애셋 세트입니다.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

쿼리에서 참조된 액세스 가능한 입찰 전략입니다.

customerCustomizer

object (CustomerCustomizer)

쿼리에서 참조된 고객 맞춤설정 도구입니다.

customerClient

object (CustomerClient)

쿼리에서 참조된 CustomerClient입니다.

customerConversionGoal

object (CustomerConversionGoal)

쿼리에서 참조된 CustomerConversionGoal입니다.

customerExtensionSetting

object (CustomerExtensionSetting)

쿼리에서 참조된 고객 광고 확장 설정입니다.

customerFeed

object (CustomerFeed)

쿼리에서 참조된 고객 피드입니다.

customerLabel

object (CustomerLabel)

쿼리에서 참조된 고객 라벨입니다.

customerNegativeCriterion

object (CustomerNegativeCriterion)

쿼리에서 참조된 고객 제외 기준입니다.

customerSearchTermInsight

object (CustomerSearchTermInsight)

쿼리에서 참조된 고객 검색어 통계입니다.

customerUserAccess

object (CustomerUserAccess)

쿼리에서 참조된 CustomerUserAccess입니다.

customerUserAccessInvitation

object (CustomerUserAccessInvitation)

쿼리에서 참조된 CustomerUserAccessInvitation입니다.

customizerAttribute

object (CustomizerAttribute)

쿼리에서 참조된 맞춤설정 도구 속성입니다.

detailPlacementView

object (DetailPlacementView)

쿼리에서 참조된 세부정보 게재위치 보기입니다.

detailedDemographic

object (DetailedDemographic)

쿼리에서 참조된 상세한 인구통계입니다.

displayKeywordView

object (DisplayKeywordView)

쿼리에서 참조된 디스플레이 키워드 뷰입니다.

distanceView

object (DistanceView)

쿼리에서 참조된 거리 뷰입니다.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

검색어에서 참조된 동적 검색 광고 검색어 보기입니다.

expandedLandingPageView

object (ExpandedLandingPageView)

쿼리에서 참조된 확장 방문 페이지 보기입니다.

extensionFeedItem

object (ExtensionFeedItem)

쿼리에서 참조된 확장 프로그램 피드 항목입니다.

feed

object (Feed)

쿼리에서 참조된 피드입니다.

feedItem

object (FeedItem)

쿼리에서 참조된 피드 항목입니다.

feedItemSet

object (FeedItemSet)

쿼리에서 참조된 피드 항목 세트입니다.

feedItemTarget

object (FeedItemTarget)

쿼리에서 참조된 피드 항목 대상입니다.

feedMapping

object (FeedMapping)

쿼리에서 참조된 피드 매핑입니다.

feedPlaceholderView

object (FeedPlaceholderView)

쿼리에서 참조된 피드 자리표시자 보기입니다.

genderView

object (GenderView)

쿼리에서 참조된 성별 보기입니다.

geoTargetConstant

object (GeoTargetConstant)

쿼리에서 참조된 지역 타겟 상수입니다.

geographicView

object (GeographicView)

쿼리에서 참조된 지리적 뷰입니다.

groupPlacementView

object (GroupPlacementView)

쿼리에서 참조된 그룹 게재위치 보기입니다.

hotelGroupView

object (HotelGroupView)

쿼리에서 참조된 호텔 그룹 보기입니다.

hotelPerformanceView

object (HotelPerformanceView)

쿼리에서 참조된 호텔 실적 뷰입니다.

hotelReconciliation

object (HotelReconciliation)

쿼리에서 참조된 호텔 조정입니다.

incomeRangeView

object (IncomeRangeView)

쿼리에서 참조된 소득 범위 뷰입니다.

keywordView

object (KeywordView)

쿼리에서 참조된 키워드 뷰입니다.

keywordPlan

object (KeywordPlan)

쿼리에서 참조된 키워드 계획

keywordPlanCampaign

object (KeywordPlanCampaign)

쿼리에서 참조된 키워드 계획 캠페인입니다.

keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

쿼리에서 참조된 키워드 계획 캠페인 키워드입니다.

keywordPlanAdGroup

object (KeywordPlanAdGroup)

쿼리에서 참조된 키워드 계획 광고그룹입니다.

keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

쿼리에서 참조된 키워드 계획 광고그룹입니다.

keywordThemeConstant

object (KeywordThemeConstant)

쿼리에서 참조된 키워드 테마 상수입니다.

label

object (Label)

쿼리에서 참조된 라벨입니다.

landingPageView

object (LandingPageView)

쿼리에서 참조된 방문 페이지 보기입니다.

languageConstant

object (LanguageConstant)

쿼리에서 참조되는 언어 상수입니다.

locationView

object (LocationView)

쿼리에서 참조된 위치 뷰입니다.

managedPlacementView

object (ManagedPlacementView)

쿼리에서 참조된 선택 게재위치 보기입니다.

mediaFile

object (MediaFile)

쿼리에서 참조된 미디어 파일입니다.

mobileAppCategoryConstant

object (MobileAppCategoryConstant)

쿼리에서 참조된 모바일 앱 카테고리 상수입니다.

mobileDeviceConstant

object (MobileDeviceConstant)

쿼리에서 참조된 휴대기기 상수입니다.

offlineUserDataJob

object (OfflineUserDataJob)

쿼리에서 참조된 오프라인 사용자 데이터 작업

operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

쿼리에서 참조된 운영체제 버전 상수입니다.

paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

쿼리에서 참조된 유료 자연 검색어 보기입니다.

qualifyingQuestion

object (QualifyingQuestion)

쿼리에서 참조된 자격 확인 질문입니다.

parentalStatusView

object (ParentalStatusView)

쿼리에서 참조된 자녀 유무 상태 보기입니다.

perStoreView

object (PerStoreView)

쿼리에서 참조된 매장별 보기입니다.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

쿼리에서 참조된 제품 입찰 카테고리입니다.

productGroupView

object (ProductGroupView)

쿼리에서 참조된 제품 그룹 보기입니다.

recommendation

object (Recommendation)

쿼리에서 참조된 권장사항입니다.

searchTermView

object (SearchTermView)

쿼리에서 참조된 검색어 보기입니다.

sharedCriterion

object (SharedCriterion)

쿼리에서 참조된 공유 조합입니다.

sharedSet

object (SharedSet)

쿼리에서 참조된 공유 조합입니다.

smartCampaignSetting

object (SmartCampaignSetting)

쿼리에서 참조된 스마트 캠페인 설정입니다.

shoppingPerformanceView

object (ShoppingPerformanceView)

쿼리에서 참조된 쇼핑 실적 보기입니다.

smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

검색어에서 참조된 스마트 캠페인 검색어 보기입니다.

topicView

object (TopicView)

쿼리에서 참조된 주제 뷰입니다.

travelActivityGroupView

object (TravelActivityGroupView)

쿼리에서 참조된 여행 활동 그룹 뷰입니다.

travelActivityPerformanceView

object (TravelActivityPerformanceView)

쿼리에서 참조된 여행 활동 실적 보기입니다.

experiment

object (Experiment)

쿼리에서 참조된 실험입니다.

experimentArm

object (ExperimentArm)

쿼리에서 참조된 실험 부문입니다.

userInterest

object (UserInterest)

쿼리에서 참조된 사용자 관심분야입니다.

lifeEvent

object (LifeEvent)

쿼리에서 참조된 생애 주요 이벤트입니다.

userList

object (UserList)

쿼리에서 참조된 사용자 목록입니다.

userLocationView

object (UserLocationView)

쿼리에서 참조된 사용자 위치 뷰입니다.

remarketingAction

object (RemarketingAction)

쿼리에서 참조된 리마케팅 액션입니다.

topicConstant

object (TopicConstant)

쿼리에서 참조된 주제 상수입니다.

video

object (Video)

쿼리에서 참조된 동영상입니다.

webpageView

object (WebpageView)

쿼리에서 참조된 웹페이지 뷰입니다.

leadFormSubmissionData

object (LeadFormSubmissionData)

쿼리에서 참조된 리드 양식 사용자 제출입니다.

metrics

object (Metrics)

측정항목

segments

object (Segments)

세그먼트

AccountBudget

계정 단위 예산입니다. 여기에는 예산 자체에 대한 정보와 가장 최근에 승인된 예산 변경사항, 승인 대기 중인 제안된 변경사항이 포함됩니다. 승인 대기 중인 제안된 변경사항이 있는 경우 '보류 중인 제안'에서 확인할 수 있습니다. '승인됨_', '조정됨_'으로 시작하는 입력란과 접두사가 없는 입력란 등 예산에 대한 효과적인 세부정보를 확인할 수 있습니다. 일부 유효 세부정보는 사용자가 원래 요청한 것과 다를 수 있으므로 (예: 지출 한도) '제안_', '승인_' 및 '조정됨_' 필드에 병치되어 표시됩니다.

이 리소스는 AccountBudgetSuggestion을 사용하여 변경되었으며 직접 변경할 수 없습니다. 예산에는 대기 중인 제안서가 한 번에 하나만 있을 수 있습니다. 대기 중인 제안서를 통해 읽힙니다.

승인된 후에는 크레딧 조정 등의 조정이 적용될 수 있습니다. 조정으로 인해 '승인됨' 및 '조정됨' 입력란 간에 차이가 발생하며, 이 두 항목이 동일하지 않습니다.

JSON 표현
{
  "resourceName": string,
  "status": enum (AccountBudgetStatus),
  "totalAdjustmentsMicros": string,
  "amountServedMicros": string,
  "pendingProposal": {
    object (PendingAccountBudgetProposal)
  },
  "id": string,
  "billingSetup": string,
  "name": string,
  "proposedStartDateTime": string,
  "approvedStartDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,

  // Union field proposed_end_time can be only one of the following:
  "proposedEndDateTime": string,
  "proposedEndTimeType": enum (TimeType)
  // End of list of possible types for union field proposed_end_time.

  // Union field approved_end_time can be only one of the following:
  "approvedEndDateTime": string,
  "approvedEndTimeType": enum (TimeType)
  // End of list of possible types for union field approved_end_time.

  // Union field proposed_spending_limit can be only one of the following:
  "proposedSpendingLimitMicros": string,
  "proposedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field proposed_spending_limit.

  // Union field approved_spending_limit can be only one of the following:
  "approvedSpendingLimitMicros": string,
  "approvedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field approved_spending_limit.

  // Union field adjusted_spending_limit can be only one of the following:
  "adjustedSpendingLimitMicros": string,
  "adjustedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field adjusted_spending_limit.
}
입력란
resourceName

string

출력 전용입니다. 계정 단위 예산의 리소스 이름입니다. AccountBudget 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum (AccountBudgetStatus)

출력 전용입니다. 이 계정 단위 예산의 상태입니다.

totalAdjustmentsMicros

string (int64 format)

출력 전용입니다. 총 조정 금액입니다.

조정의 예로는 보상 크레딧이 있습니다.

amountServedMicros

string (int64 format)

출력 전용입니다. 게재된 광고의 가치(마이크로 단위)입니다.

여기에는 초과게재 비용이 포함되며, 이 경우 크레딧이 예산에 자동으로 적용될 수 있습니다 (totalAdjustmentsMicros 참조).

pendingProposal

object (PendingAccountBudgetProposal)

출력 전용입니다. 이 예산을 수정하기 위해 대기 중인 제안서입니다(해당하는 경우).

id

string (int64 format)

출력 전용입니다. 계정 단위 예산의 ID입니다.

billingSetup

string

출력 전용입니다. 이 계정 수준 예산과 연결된 결제 설정의 리소스 이름입니다. BillingSetup 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

출력 전용입니다. 계정 단위 예산의 이름입니다.

proposedStartDateTime

string

출력 전용입니다. 계정 단위 예산의 제안된 시작 시간(yyyy-MM-dd HH:mm:ss 형식). NOW의 시작 시간 유형이 제안된 경우 이 유형이 요청 시간입니다.

approvedStartDateTime

string

출력 전용입니다. 계정 단위 예산의 승인된 시작 시간(yyyy-MM-dd HH:mm:ss 형식).

예를 들어 제안된 시작 시간 후에 새 예산이 승인되면 승인된 시작 시간이 승인 시간이 됩니다.

purchaseOrderNumber

string

출력 전용입니다. 구매주문서 번호는 사용자가 월별 인보이스에서 이 예산을 참조하는 데 도움이 되는 값입니다.

notes

string

출력 전용입니다. 예산과 관련된 참고사항입니다.

통합 필드 proposed_end_time. 계정 단위 예산의 제안된 종료 시간입니다. proposed_end_time은 다음 중 하나여야 합니다.
proposedEndDateTime

string

출력 전용입니다. 제안된 종료 시간은 yyyy-MM-dd HH:mm:ss 형식입니다.

proposedEndTimeType

enum (TimeType)

출력 전용입니다. 제안된 종료 시간을 잘 정의된 유형(예: FOREVER)으로 지정합니다.

통합 필드 approved_end_time. 계정 단위 예산의 승인된 종료 시간입니다.

예를 들어 예산의 종료 시간이 업데이트되고 제안된 종료 시간 이후에 제안서가 승인되면 승인된 종료 시간이 승인 시간이 됩니다. approved_end_time는 다음 중 하나여야 합니다.

approvedEndDateTime

string

출력 전용입니다. yyyy-MM-dd HH:mm:ss 형식의 승인된 종료 시간입니다.

approvedEndTimeType

enum (TimeType)

출력 전용입니다. 잘 정의된 유형(예: FOREVER)으로 승인된 종료 시간

통합 필드 proposed_spending_limit. 제안된 지출 한도 proposed_spending_limit은 다음 중 하나여야 합니다.
proposedSpendingLimitMicros

string (int64 format)

출력 전용입니다. 마이크로 단위로 제시된 지출 한도입니다. 100만은 하나의 단위에 해당합니다.

proposedSpendingLimitType

enum (SpendingLimitType)

출력 전용입니다. 잘 정의된 유형으로 제안된 지출 한도(예: INFINITE)

통합 필드 approved_spending_limit. 승인된 지출 한도입니다.

예를 들어 제안이 승인되었을 때 계정에서 이미 지출한 금액이 권장 지출 한도를 초과하면 승인된 지출 한도가 이미 지출된 금액으로 설정됩니다. approved_spending_limit는 다음 중 하나여야 합니다.

approvedSpendingLimitMicros

string (int64 format)

출력 전용입니다. 마이크로 단위로 승인된 지출 한도입니다. 100만은 하나의 단위에 해당합니다. 제안된 지출 한도가 한정되어 있는 경우에만 채워지며 항상 제안된 지출 한도보다 크거나 같습니다.

approvedSpendingLimitType

enum (SpendingLimitType)

출력 전용입니다. 잘 정의된 유형으로 승인된 지출 한도(예: INFINITE) 승인된 지출 한도가 무한정인 경우에만 채워집니다.

통합 필드 adjusted_spending_limit. 조정이 적용된 후의 지출 한도입니다. 조정은 total_adjustments_micros에 저장됩니다.

이 가치는 계정에서 지출할 수 있는 금액에 대한 최종 결정권이 있습니다. adjusted_spending_limit는 다음 중 하나여야 합니다.

adjustedSpendingLimitMicros

string (int64 format)

출력 전용입니다. 마이크로 단위로 조정된 지출 한도입니다. 100만은 하나의 단위에 해당합니다.

승인된 지출 한도가 한정되어 있는 경우 조정된 지출 한도는 이 예산에 적용된 조정 유형에 따라 달라질 수 있습니다.

다양한 유형의 조정은 다음 페이지에 설명되어 있습니다. https://support.google.com/google-ads/answer/1704323

예를 들어 청구 금액을 조정하면 계정에서 사용할 수 있는 금액이 줄어듭니다.

adjustedSpendingLimitType

enum (SpendingLimitType)

출력 전용입니다. 잘 정의된 유형으로 조정된 지출 한도(예: INFINITE) 조정된 지출 한도가 INFINITE인 경우에만 채워집니다. 승인된 지출 한도가 INFINITE인 경우 true입니다.

AccountBudgetStatus

계정 예산의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
PENDING 계정 예산이 승인 대기 중입니다.
APPROVED 계정 예산이 승인되었습니다.
CANCELLED 사용자가 계정 예산을 취소했습니다.

PendingAccountBudgetProposal

계정 단위 예산과 연관된 대기 중인 제안서입니다(해당하는 경우).

JSON 표현
{
  "proposalType": enum (AccountBudgetProposalType),
  "accountBudgetProposal": string,
  "name": string,
  "startDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,
  "creationDateTime": string,

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.

  // Union field spending_limit can be only one of the following:
  "spendingLimitMicros": string,
  "spendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field spending_limit.
}
입력란
proposalType

enum (AccountBudgetProposalType)

출력 전용입니다. 제안의 유형(예: 이 제안과 관련된 예산을 종료하려는 경우 END)입니다.

accountBudgetProposal

string

출력 전용입니다. 제안서의 리소스 이름입니다. AccountBudgetSuggestion 리소스 이름 형식은 다음과 같습니다.

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}

name

string

출력 전용입니다. 계정 단위 예산에 지정할 이름입니다.

startDateTime

string

출력 전용입니다. yyyy-MM-dd HH:mm:ss 형식의 시작 시간입니다.

purchaseOrderNumber

string

출력 전용입니다. 구매주문서 번호는 사용자가 월별 인보이스에서 이 예산을 참조하는 데 도움이 되는 값입니다.

notes

string

출력 전용입니다. 이 예산과 관련된 메모입니다.

creationDateTime

string

출력 전용입니다. 계정 단위 예산 제안이 생성된 시간입니다. yyyy-MM-dd HH:mm:ss 형식으로 지정됩니다.

통합 필드 end_time. 계정 단위 예산의 종료 시간입니다. end_time은 다음 중 하나여야 합니다.
endDateTime

string

출력 전용입니다. yyyy-MM-dd HH:mm:ss 형식의 종료 시간입니다.

endTimeType

enum (TimeType)

출력 전용입니다. 잘 정의된 유형(예: FOREVER)으로 종료 시간

통합 필드 spending_limit. 지출 한도 spending_limit은 다음 중 하나여야 합니다.
spendingLimitMicros

string (int64 format)

출력 전용입니다. 지출 한도(단위: 마이크로)입니다. 100만은 하나의 단위에 해당합니다.

spendingLimitType

enum (SpendingLimitType)

출력 전용입니다. 잘 정의된 유형으로 된 지출 한도(예: INFINITE)

AdGroupAdAssetCombinationView

광고그룹 광고 확장 소재 조합 사용에 대한 보기입니다. 이제 Google에서는 반응형 검색 광고에 대해 AdGroupAdAssetCombinationView만 지원하며, 향후 더 많은 광고 유형을 지원할 예정입니다.

JSON 표현
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
입력란
resourceName

string

출력 전용입니다. 광고그룹 광고 확장 소재 조합 보기의 리소스 이름입니다. 조합 ID는 길이가 128비트로, 상위 64비트는 asset_combination_id_high에 저장되고 하위 64비트는 asset_combination_id_low에 저장됩니다. AdGroupAd 애셋 조합 보기 리소스 이름의 형식은 customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}입니다.

servedAssets[]

object (AssetUsage)

출력 전용입니다. 게재된 애셋.

enabled

boolean

출력 전용입니다. 확장 소재 조합과 최신 광고 버전 간의 상태입니다. true인 경우 애셋 조합이 광고의 최신 버전에 연결됩니다. false인 경우 링크가 한때 존재했지만 삭제되어 더 이상 최신 버전의 광고에 존재하지 않음을 의미합니다.

AssetUsage

애셋의 사용 정보를 포함합니다.

JSON 표현
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
입력란
asset

string

애셋의 리소스 이름입니다.

servedAssetFieldType

enum (ServedAssetFieldType)

애셋의 게재된 필드 유형입니다.

AdGroupAdAssetView

AdGroupAd와 애셋 간의 링크입니다. 현재 Google은 앱 광고 및 반응형 검색 광고용으로 AdGroupAdAssetView만 지원합니다.

JSON 표현
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
입력란
resourceName

string

출력 전용입니다. 광고그룹 광고 확장 소재 보기의 리소스 이름입니다. 광고그룹 광고 애셋 보기 리소스 이름의 형식은 다음과 같습니다 (V4 이전).

customers/{customerId}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

광고그룹 광고 애셋 보기 리소스 이름의 형식은 다음과 같습니다 (V4부터).

customers/{customerId}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

fieldType

enum (AssetFieldType)

출력 전용입니다. 광고에서 애셋이 가지는 역할입니다.

policySummary

object (AdGroupAdAssetPolicySummary)

출력 전용입니다. 광고그룹 광고 확장 소재에 대한 정책 정보입니다.

performanceLabel

enum (AssetPerformanceLabel)

출력 전용입니다. 애셋 연결의 성능입니다.

pinnedField

enum (ServedAssetFieldType)

출력 전용입니다. 고정된 필드입니다.

adGroupAd

string

출력 전용입니다. 확장 소재가 연결된 광고그룹 광고입니다.

asset

string

출력 전용입니다. 광고그룹 광고에 연결된 애셋입니다.

enabled

boolean

출력 전용입니다. 확장 소재와 최신 광고 버전 간의 상태입니다. true인 경우 확장 소재가 광고의 최신 버전에 연결됩니다. false인 경우 링크가 한때 존재했지만 삭제되어 더 이상 최신 버전의 광고에 존재하지 않음을 의미합니다.

AdGroupAdAssetPolicySummary

광고그룹 광고 확장 소재의 정책 정보가 포함됩니다.

JSON 표현
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
입력란
policyTopicEntries[]

object (PolicyTopicEntry)

출력 전용입니다. 광고그룹 광고 확장 소재에 대한 정책 발견 항목의 목록입니다.

reviewStatus

enum (PolicyReviewStatus)

출력 전용입니다. 검토 과정 중 이 광고그룹 광고 확장 소재의 현재 위치입니다.

approvalStatus

enum (PolicyApprovalStatus)

출력 전용입니다. 이 광고그룹 광고 확장 소재의 전반적인 승인 상태로, 개별 정책 주제 항목의 상태를 기준으로 계산됩니다.

AdGroupAudienceView

광고그룹 잠재고객 보기 잠재고객 수준에서 집계된 관심분야 및 디스플레이 네트워크 및 YouTube 네트워크 광고용 리마케팅 목록, 검색 광고용 리마케팅 목록 (RLSA)의 실적 데이터가 포함됩니다.

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 광고그룹 잠재고객 뷰의 리소스 이름입니다. 광고그룹 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

AdGroupCriterionSimulation

광고그룹 기준 시뮬레이션입니다. 지원되는 광고 채널 유형, 기준 유형, 시뮬레이션 유형 및 시뮬레이션 수정 방법의 조합이 아래에 각각 자세히 설명되어 있습니다. V5부터 시작되는 호텔 AdGroupCriterion 시뮬레이션 연산입니다.

  1. 디스플레이 - 키워드 - CPC_BID - UNIFORM
  2. SEARCH - KEYWORD - CPC_BID - UNIFORM
  3. 쇼핑 - LISTING_GROUP - CPC_BID - UNIFORM
  4. 호텔 - LISTING_GROUP - CPC_BID - UNIFORM
  5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 표현
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "percentCpcBidPointList": {
    object (PercentCpcBidSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
입력란
resourceName

string

출력 전용입니다. 광고그룹 기준 시뮬레이션의 리소스 이름입니다. 광고그룹 기준 시뮬레이션 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupCriterionSimulations/{adGroupId}~{criterionId}~{type}~{modificationMethod}~{startDate}~{endDate}

type

enum (SimulationType)

출력 전용입니다. 시뮬레이션이 수정하는 필드입니다.

modificationMethod

enum (SimulationModificationMethod)

출력 전용입니다. 시뮬레이션에서 필드를 수정하는 방법

adGroupId

string (int64 format)

출력 전용입니다. 시뮬레이션의 광고그룹 ID입니다.

criterionId

string (int64 format)

출력 전용입니다. 시뮬레이션의 기준 ID입니다.

startDate

string

출력 전용입니다. 시뮬레이션의 기반이 되는 첫날입니다(YYYY-MM-DD 형식).

endDate

string

출력 전용입니다. 시뮬레이션의 기반이 되는 마지막 날로, YYYY-MM-DD 형식입니다.

통합 필드 point_list. 시뮬레이션 지점의 목록입니다. point_list은 다음 중 하나여야 합니다.
cpcBidPointList

object (CpcBidSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 CPC_BID인 경우 시뮬레이션 지점입니다.

percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 PERCENT_CPC_BID인 경우 시뮬레이션 지점입니다.

SimulationType

시뮬레이션이 수정하는 필드를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CPC_BID 이 시뮬레이션은 CPC 입찰가에 대한 것입니다.
CPV_BID 이 시뮬레이션은 CPV 입찰가에 대한 것입니다.
TARGET_CPA 이 시뮬레이션은 CPA 타겟에 대한 것입니다.
BID_MODIFIER 시뮬레이션은 입찰가 조정을 위한 것입니다.
TARGET_ROAS 이 시뮬레이션은 ROAS 타겟을 위한 것입니다.
PERCENT_CPC_BID 이 시뮬레이션은 비율 CPC 입찰가에 대한 것입니다.
TARGET_IMPRESSION_SHARE 이 시뮬레이션은 노출 점유율 타겟에 대한 것입니다.
BUDGET 예산을 위한 시뮬레이션입니다.

SimulationModificationMethod

시뮬레이션에서 필드를 수정하는 메서드를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
UNIFORM 시뮬레이션의 값은 지정된 리소스의 모든 하위 요소에 균일하게 적용되었습니다. 하위 리소스의 재정의가 적용되지 않았습니다.
DEFAULT 시뮬레이션의 값이 지정된 리소스에 적용되었습니다. 하위 리소스에 대한 재정의가 반영되었으며 예상 트래픽에는 이러한 리소스가 포함되지 않습니다.
SCALING 시뮬레이션의 값은 모두 동일한 계수로 조정되었습니다. 예를 들어, 시뮬레이션된 TargetCpa 캠페인에서 캠페인 타겟과 모든 광고그룹 타겟은 X의 배수로 조정되었습니다.

CpcBidSimulationPointList

CPC_BID 유형 시뮬레이션에 대한 시뮬레이션 포인트를 위한 컨테이너입니다.

JSON 표현
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
입력란
points[]

object (CpcBidSimulationPoint)

일련의 CPC 입찰가에 대한 예상 측정항목

CpcBidSimulationPoint

특정 CPC 입찰가에 대한 예상 측정항목입니다.

JSON 표현
{
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field cpc_simulation_key_value can be only one of the following:
  "cpcBidMicros": string,
  "cpcBidScalingModifier": number
  // End of list of possible types for union field cpc_simulation_key_value.
}
입력란
requiredBudgetAmountMicros

string (int64 format)

광고주가 예상 트래픽을 받기 위해 설정해야 하는 예상 일일 예산(마이크로 단위)입니다.

biddableConversions

number

입찰 가능한 예상 전환수입니다.

biddableConversionsValue

number

입찰 가능한 전환의 총 예상 가치입니다.

clicks

string (int64 format)

예상 클릭수입니다.

costMicros

string (int64 format)

마이크로 단위의 예상 비용입니다.

impressions

string (int64 format)

예상 노출수입니다.

topSlotImpressions

string (int64 format)

예상 상단 슬롯 노출수입니다. 검색 광고 채널 유형만 이 필드를 지원합니다.

통합 필드 cpc_simulation_key_value. SimulationModificationMethod = UNIFORM 또는 DEFAULT이면 cpc_bid_micros가 설정됩니다. SimulationModificationMethod = SCALING이면 cpc_bid_scale_modifier가 설정됩니다. cpc_simulation_key_value은 다음 중 하나여야 합니다.
cpcBidMicros

string (int64 format)

예상 측정항목의 기반이 되는 시뮬레이션된 CPC 입찰가입니다.

cpcBidScalingModifier

number

예상 측정항목의 기반이 되는 시뮬레이션된 확장 수정자입니다. 시뮬레이션된 항목과 관련된 모든 CPC 입찰가는 이 수정자에 의해 조정됩니다.

PercentCpcBidSimulationPointList

PERCENT_CPC_BID 유형 시뮬레이션에 대한 시뮬레이션을 위한 컨테이너입니다.

JSON 표현
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
입력란
points[]

object (PercentCpcBidSimulationPoint)

일련의 퍼센트 CPC 입찰가에 대한 예상 측정항목

PercentCpcBidSimulationPoint

특정 비율 CPC 금액에 대한 예상 측정항목입니다. 호텔 광고 채널 유형만 이 필드를 지원합니다.

JSON 표현
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
입력란
percentCpcBidMicros

string (int64 format)

예상 측정항목의 기반이 되는 시뮬레이션된 CPC 비율입니다. 일부 상품 또는 서비스에 대한 광고 가격의 비율로 표현되는 CPC 비율입니다. 여기에 저장된 값은 1,000,000 * [비율]입니다.

biddableConversions

number

입찰 가능한 예상 전환수입니다.

biddableConversionsValue

number

입찰 가능한 전환의 총 예상 가치(현지 통화)입니다.

clicks

string (int64 format)

예상 클릭수입니다.

costMicros

string (int64 format)

마이크로 단위의 예상 비용입니다.

impressions

string (int64 format)

예상 노출수입니다.

topSlotImpressions

string (int64 format)

예상 상단 슬롯 노출수입니다.

AdGroupSimulation

광고그룹 시뮬레이션입니다. 지원되는 광고 채널 유형, 시뮬레이션 유형 및 시뮬레이션 수정 방법의 조합은 아래에 각각 자세히 설명되어 있습니다.

  1. SEARCH - CPC_BID - DEFAULT
  2. SEARCH - CPC_BID - UNIFORM
  3. 검색 - TARGET_CPA - UNIFORM
  4. 검색 - TARGET_ROAS - UNIFORM
  5. 디스플레이 - CPC_BID - DEFAULT
  6. 디스플레이 - CPC_BID - UNIFORM
  7. 디스플레이 - TARGET_CPA - UNIFORM
JSON 표현
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "cpvBidPointList": {
    object (CpvBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
입력란
resourceName

string

출력 전용입니다. 광고그룹 시뮬레이션의 리소스 이름입니다. 광고그룹 시뮬레이션 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupSimulations/{adGroupId}~{type}~{modificationMethod}~{startDate}~{endDate}

type

enum (SimulationType)

출력 전용입니다. 시뮬레이션이 수정하는 필드입니다.

modificationMethod

enum (SimulationModificationMethod)

출력 전용입니다. 시뮬레이션에서 필드를 수정하는 방법

adGroupId

string (int64 format)

출력 전용입니다. 시뮬레이션의 광고그룹 ID입니다.

startDate

string

출력 전용입니다. 시뮬레이션의 기반이 되는 첫날입니다(YYYY-MM-DD 형식).

endDate

string

출력 전용입니다. 시뮬레이션의 기반이 되는 마지막 날(YYYY-MM-DD 형식)

통합 필드 point_list. 시뮬레이션 지점의 목록입니다. point_list은 다음 중 하나여야 합니다.
cpcBidPointList

object (CpcBidSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 CPC_BID인 경우 시뮬레이션 지점입니다.

cpvBidPointList

object (CpvBidSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 CPV_BID인 경우 시뮬레이션 지점입니다.

targetCpaPointList

object (TargetCpaSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 TARGET_CPA인 경우 시뮬레이션 지점입니다.

targetRoasPointList

object (TargetRoasSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 TARGET_ROAS인 경우 시뮬레이션 지점입니다.

CpvBidSimulationPointList

CPV_BID 유형 시뮬레이션에 대한 시뮬레이션 지점을 위한 컨테이너입니다.

JSON 표현
{
  "points": [
    {
      object (CpvBidSimulationPoint)
    }
  ]
}
입력란
points[]

object (CpvBidSimulationPoint)

일련의 CPV 입찰가에 대한 예상 측정항목입니다.

CpvBidSimulationPoint

특정 CPV 입찰가에 대한 예상 측정항목입니다.

JSON 표현
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
입력란
cpvBidMicros

string (int64 format)

예상 측정항목의 기반이 되는 시뮬레이션된 CPV 입찰가입니다.

costMicros

string (int64 format)

마이크로 단위의 예상 비용입니다.

impressions

string (int64 format)

예상 노출수입니다.

views

string (int64 format)

예상 조회수입니다.

TargetCpaSimulationPointList

TARGET_CPA 유형 시뮬레이션을 위한 시뮬레이션 지점을 위한 컨테이너입니다.

JSON 표현
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
입력란
points[]

object (TargetCpaSimulationPoint)

일련의 타겟 CPA 금액에 대한 예상 측정항목입니다.

TargetCpaSimulationPoint

특정 타겟 CPA 금액에 대한 예상 측정항목입니다.

JSON 표현
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field target_cpa_simulation_key_value can be only one of the
  // following:
  "targetCpaMicros": string,
  "targetCpaScalingModifier": number
  // End of list of possible types for union field
  // target_cpa_simulation_key_value.
}
입력란
requiredBudgetAmountMicros

string (int64 format)

광고주가 예상 트래픽을 받기 위해 설정해야 하는 예상 일일 예산(마이크로 단위)입니다.

appInstalls

number

예상 앱 설치 수입니다.

inAppActions

number

예상 인앱 액션 수입니다.

biddableConversions

number

입찰 가능한 예상 전환수입니다.

biddableConversionsValue

number

입찰 가능한 전환의 총 예상 가치입니다.

clicks

string (int64 format)

예상 클릭수입니다.

costMicros

string (int64 format)

마이크로 단위의 예상 비용입니다.

impressions

string (int64 format)

예상 노출수입니다.

topSlotImpressions

string (int64 format)

예상 상단 슬롯 노출수입니다. 검색 광고 채널 유형만 이 필드를 지원합니다.

통합 필드 target_cpa_simulation_key_value. SimulationModificationMethod = UNIFORM 또는 DEFAULT이면 target_cpa_micros가 설정됩니다. SimulationModificationMethod = SCALING인 경우 target_cpa_scale_modifier가 설정됩니다. target_cpa_simulation_key_value은 다음 중 하나여야 합니다.
targetCpaMicros

string (int64 format)

예상 측정항목의 기반이 되는 시뮬레이션된 타겟 CPA입니다.

targetCpaScalingModifier

number

예상 측정항목의 기반이 되는 시뮬레이션된 확장 수정자입니다. 시뮬레이션된 항목과 관련된 모든 CPA 타겟은 이 수정자에 의해 조정됩니다.

TargetRoasSimulationPointList

TARGET_ROAS 유형 시뮬레이션을 위한 시뮬레이션 지점을 위한 컨테이너입니다.

JSON 표현
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
입력란
points[]

object (TargetRoasSimulationPoint)

일련의 타겟 ROAS 금액에 대한 예상 측정항목

TargetRoasSimulationPoint

특정 타겟 광고 투자수익(ROAS) 금액에 대한 예상 측정항목입니다.

JSON 표현
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
입력란
requiredBudgetAmountMicros

string (int64 format)

광고주가 예상 트래픽을 받기 위해 설정해야 하는 예상 일일 예산(마이크로 단위)입니다.

targetRoas

number

예상 측정항목의 기반이 되는 시뮬레이션된 타겟 ROAS입니다.

biddableConversions

number

입찰 가능한 예상 전환수입니다.

biddableConversionsValue

number

입찰 가능한 전환의 총 예상 가치입니다.

clicks

string (int64 format)

예상 클릭수입니다.

costMicros

string (int64 format)

마이크로 단위의 예상 비용입니다.

impressions

string (int64 format)

예상 노출수입니다.

topSlotImpressions

string (int64 format)

예상 상단 슬롯 노출수입니다. 검색 광고 채널 유형만 이 입력란을 지원합니다.

AgeRangeView

연령대 보기

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 연령대 뷰의 리소스 이름입니다. 연령대 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

AdScheduleView

광고 일정 보기에는 AdSchedule 기준별로 캠페인 실적이 요약되어 있습니다.

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 광고 일정 보기의 리소스 이름입니다. AdSchedule 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adScheduleViews/{campaignId}~{criterionId}

DomainCategory

도메인을 크롤링하여 자동으로 생성된 카테고리입니다. 캠페인에서 DynamicSearchAdsSetting을 사용하는 경우 도메인에 대한 도메인 카테고리가 생성됩니다. 카테고리는 WebpageConditionInfo를 사용하여 타겟팅할 수 있습니다. https://support.google.com/google-ads/answer/2471185를 참고하세요.

JSON 표현
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
입력란
resourceName

string

출력 전용입니다. 도메인 카테고리의 리소스 이름입니다. 도메인 카테고리 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/domainCategories/{campaignId}~{category_base64}~{languageCode}

campaign

string

출력 전용입니다. 이 카테고리가 추천되는 캠페인입니다.

category

string

출력 전용입니다. 웹사이트 도메인의 권장 카테고리입니다. 예를 들어 전자제품에 대한 웹사이트가 있는 경우 '카메라', '텔레비전' 등의 카테고리가 될 수 있습니다.

languageCode

string

출력 전용입니다. 웹사이트의 언어를 지정하는 언어 코드입니다(예: 영어의 경우 'en'). 언어는 동적 검색 광고에 필요한 DynamicSearchAdsSetting에서 지정할 수 있습니다. 이는 Google Ads에서 내 광고를 찾아 광고를 만들고 검색어와 일치시키려는 웹사이트 페이지의 언어입니다.

domain

string

출력 전용입니다. 웹사이트의 도메인입니다. 도메인은 동적 검색 광고에 필요한 DynamicSearchAdsSetting에서 지정할 수 있습니다.

coverageFraction

number

출력 전용입니다. 사이트에서 이 카테고리와 일치하는 페이지의 비율입니다.

categoryRank

string (int64 format)

출력 전용입니다. 카테고리 집합 내에서 이 카테고리의 위치입니다. 숫자가 낮을수록 도메인과 더 잘 일치하는 것을 나타냅니다. null은 권장되지 않음을 나타냅니다.

hasChildren

boolean

출력 전용입니다. 이 카테고리에 하위 카테고리가 있는지 여부를 나타냅니다.

recommendedCpcBidMicros

string (int64 format)

출력 전용입니다. 카테고리의 권장 클릭당비용입니다.

AssetFieldTypeView

애셋 입력란 유형 보기 이 보기는 애셋이 광고 확장으로 사용될 때 각 애셋 필드 유형에 대해 과다 계산되지 않은 측정항목을 보고합니다.

JSON 표현
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
입력란
resourceName

string

출력 전용입니다. 애셋 필드 유형 뷰의 리소스 이름입니다. 애셋 필드 유형 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetFieldTypeViews/{fieldType}

fieldType

enum (AssetFieldType)

출력 전용입니다. 저작물 입력란 유형 보기의 저작물 입력란 유형입니다.

AssetGroupProductGroupView

애셋 그룹 제품 그룹 보기

JSON 표현
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
입력란
resourceName

string

출력 전용입니다. 애셋 그룹 제품 그룹 보기의 리소스 이름입니다. 애셋 그룹 제품 그룹 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetGroupProductGroupViews/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

출력 전용입니다. 등록정보 그룹 필터와 연결된 애셋 그룹입니다.

assetGroupListingGroupFilter

string

출력 전용입니다. 애셋 그룹 등록정보 그룹 필터의 리소스 이름입니다.

AssetSetTypeView

애셋 세트 유형 보기 이 보기는 각 애셋 세트 유형에 대해 과다 집계되지 않은 측정항목을 보고합니다. 하위 애셋 세트 유형은 이 보고서에 포함되지 않습니다. 통계는 상위 애셋 세트 유형 아래에 집계됩니다.

JSON 표현
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
입력란
resourceName

string

출력 전용입니다. 애셋 세트 유형 뷰의 리소스 이름입니다. 애셋 세트 유형 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum (AssetSetType)

출력 전용입니다. 애셋 세트 유형 보기의 애셋 세트 유형입니다.

BiddingStrategySimulation

입찰 전략 시뮬레이션 지원되는 시뮬레이션 유형 및 시뮬레이션 수정 방법의 조합은 아래에 각각 자세히 설명되어 있습니다.

  1. TARGET_CPA - UNIFORM
  2. TARGET_ROAS - UNIFORM
JSON 표현
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
입력란
resourceName

string

출력 전용입니다. 입찰 전략 시뮬레이션의 리소스 이름입니다. 입찰 전략 시뮬레이션 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/biddingStrategySimulations/{biddingStrategyId}~{type}~{modificationMethod}~{startDate}~{endDate}

biddingStrategyId

string (int64 format)

출력 전용입니다. 시뮬레이션의 입찰 전략 공유 조합 ID입니다.

type

enum (SimulationType)

출력 전용입니다. 시뮬레이션이 수정하는 필드입니다.

modificationMethod

enum (SimulationModificationMethod)

출력 전용입니다. 시뮬레이션에서 필드를 수정하는 방법

startDate

string

출력 전용입니다. 시뮬레이션의 기반이 되는 첫날입니다(YYYY-MM-DD 형식).

endDate

string

출력 전용입니다. 시뮬레이션의 기반이 되는 마지막 날(YYYY-MM-DD 형식)

통합 필드 point_list. 시뮬레이션 지점의 목록입니다. point_list은 다음 중 하나여야 합니다.
targetCpaPointList

object (TargetCpaSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 TARGET_CPA인 경우 시뮬레이션 지점입니다.

targetRoasPointList

object (TargetRoasSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 TARGET_ROAS인 경우 시뮬레이션 지점입니다.

CallView

통화 전용 광고 또는 전화번호 광고 확장의 통화 추적 데이터가 포함된 통화 보기

JSON 표현
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
입력란
resourceName

string

출력 전용입니다. 통화 뷰의 리소스 이름입니다. 호출 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/callViews/{call_detail_id}

callerCountryCode

string

출력 전용입니다. 발신자의 국가 코드입니다.

callerAreaCode

string

출력 전용입니다. 발신자의 지역 번호입니다. 통화 시간이 15초 미만인 경우 null입니다.

callDurationSeconds

string (int64 format)

출력 전용입니다. 광고주가 제공한 통화 시간(초)입니다.

startCallDateTime

string

출력 전용입니다. 광고주가 제공한 통화 시작 날짜 시간입니다.

endCallDateTime

string

출력 전용입니다. 광고주가 제공한 통화 종료 날짜/시간입니다.

callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

출력 전용입니다. 통화 추적 표시 위치입니다.

type

enum (CallType)

출력 전용입니다. 통화 유형입니다.

callStatus

enum (GoogleVoiceCallStatus)

출력 전용입니다. 통화 상태입니다.

CallTrackingDisplayLocation

가능한 통화 추적 표시 위치입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD 광고를 통해 걸려온 전화 통화입니다.
LANDING_PAGE 방문 페이지 광고에서 연결된 전화 통화가

CallType

호출이 이루어진 위치의 가능한 속성 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MANUALLY_DIALED 직접 전화를 걸었습니다.

GoogleVoiceCallStatus

Google 음성 통화의 가능한 상태

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MISSED 전화를 받지 않았습니다.
RECEIVED 통화가 수신되었습니다.

CampaignAudienceView

캠페인 잠재고객 뷰 캠페인 및 잠재고객 기준별로 집계된 관심분야 및 디스플레이 네트워크 및 YouTube 네트워크 광고용 리마케팅 목록과 검색 광고용 리마케팅 목록 (RLSA)의 실적 데이터가 포함됩니다. 이 보기에는 캠페인 수준에서 연결된 잠재고객만 포함됩니다.

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 캠페인 잠재고객 뷰의 리소스 이름입니다. 캠페인 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaignAudienceViews/{campaignId}~{criterionId}

CampaignSearchTermInsight

캠페인 검색어 보기 이전 데이터는 2023년 3월부터 이용할 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
입력란
resourceName

string

출력 전용입니다. 캠페인 수준 검색어 통계의 리소스 이름입니다. 캠페인 수준 검색어 통계 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaignSearchTermInsights/{campaignId}~{categoryId}

categoryLabel

string

출력 전용입니다. 검색 카테고리의 라벨입니다. 빈 문자열은 다른 카테고리에 해당하지 않는 검색어에 대한 포괄 카테고리를 나타냅니다.

id

string (int64 format)

출력 전용입니다. 통계의 ID입니다.

campaignId

string (int64 format)

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

CampaignSimulation

캠페인 시뮬레이션입니다. 지원되는 광고 채널 유형, 시뮬레이션 유형 및 시뮬레이션 수정 방법의 조합은 아래에 각각 자세히 설명되어 있습니다.

  • SEARCH - CPC_BID - UNIFORM
  • SEARCH - CPC_BID - 확장
  • 검색 - TARGET_CPA - UNIFORM
  • SEARCH - TARGET_CPA - 확장
  • 검색 - TARGET_ROAS - UNIFORM
  • 검색 - TARGET_IMPRESSION_SHARE - UNIFORM
  • 검색 - 예산 - 유니폼
  • Shopping - 예산 - 유니폼
  • 쇼핑 - TARGET_ROAS - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - 타겟 ROAS - UNIFORM
  • 디스커버리 - TARGET_CPA - 기본값
  • 디스플레이 - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - 예산 - UNIFORM
JSON 표현
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  },
  "targetImpressionSharePointList": {
    object (TargetImpressionShareSimulationPointList)
  },
  "budgetPointList": {
    object (BudgetSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
입력란
resourceName

string

출력 전용입니다. 캠페인 시뮬레이션의 리소스 이름입니다. 캠페인 시뮬레이션 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaignSimulations/{campaignId}~{type}~{modificationMethod}~{startDate}~{endDate}

campaignId

string (int64 format)

출력 전용입니다. 시뮬레이션의 캠페인 ID입니다.

type

enum (SimulationType)

출력 전용입니다. 시뮬레이션이 수정하는 필드입니다.

modificationMethod

enum (SimulationModificationMethod)

출력 전용입니다. 시뮬레이션에서 필드를 수정하는 방법

startDate

string

출력 전용입니다. 시뮬레이션의 기반이 되는 첫날입니다(YYYY-MM-DD 형식).

endDate

string

출력 전용입니다. 시뮬레이션의 기반이 되는 마지막 날(YYYY-MM-DD 형식)

통합 필드 point_list. 시뮬레이션 지점의 목록입니다. point_list은 다음 중 하나여야 합니다.
cpcBidPointList

object (CpcBidSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 CPC_BID인 경우 시뮬레이션 지점입니다.

targetCpaPointList

object (TargetCpaSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 TARGET_CPA인 경우 시뮬레이션 지점입니다.

targetRoasPointList

object (TargetRoasSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 TARGET_ROAS인 경우 시뮬레이션 지점입니다.

targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 TARGET_IMPRESSION_SHARE인 경우 시뮬레이션 포인트입니다.

budgetPointList

object (BudgetSimulationPointList)

출력 전용입니다. 시뮬레이션 유형이 예산인 경우의 시뮬레이션 지점입니다.

TargetImpressionShareSimulationPointList

TARGET_IMPRESSION_SHARE 유형 시뮬레이션의 시뮬레이션 지점을 위한 컨테이너입니다.

JSON 표현
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
입력란
points[]

object (TargetImpressionShareSimulationPoint)

특정 타겟 노출 점유율 값에 대한 예상 측정항목입니다.

TargetImpressionShareSimulationPoint

특정 타겟 노출 점유율 값에 대한 예상 측정항목입니다.

JSON 표현
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
입력란
targetImpressionShareMicros

string (int64 format)

예상 측정항목의 기반이 되는 시뮬레이션된 타겟 노출 점유율 값 (마이크로 단위)입니다. 예를 들어 노출 점유율 10% 는 0.1인 경우 100_000으로 저장됩니다. 이 값은 검증되었으며 100만 개 (100%)를 초과하지 않습니다.

requiredCpcBidCeilingMicros

string (int64 format)

시뮬레이션을 실현하기 위해 광고주가 설정해야 하는 예상 일일 CPC 입찰가 상한(광고주 통화의 마이크로 단위)

requiredBudgetAmountMicros

string (int64 format)

광고주가 예상 트래픽을 받기 위해 설정해야 하는 예상 일일 예산(마이크로 단위)입니다.

biddableConversions

number

입찰 가능한 예상 전환수입니다.

biddableConversionsValue

number

입찰 가능한 전환의 총 예상 가치입니다.

clicks

string (int64 format)

예상 클릭수입니다.

costMicros

string (int64 format)

마이크로 단위의 예상 비용입니다.

impressions

string (int64 format)

예상 노출수입니다.

topSlotImpressions

string (int64 format)

예상 상단 슬롯 노출수입니다. 검색 광고 채널 유형만 이 필드를 지원합니다.

absoluteTopImpressions

string (int64 format)

예상 절대 상단 노출수입니다. 검색 광고 채널 유형만 이 필드를 지원합니다.

BudgetSimulationPointList

예산 유형 시뮬레이션을 위한 시뮬레이션 지점을 위한 컨테이너입니다.

JSON 표현
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
입력란
points[]

object (BudgetSimulationPoint)

일련의 예산 금액에 대한 예상 측정항목입니다.

BudgetSimulationPoint

특정 예산 금액의 예상 측정항목입니다.

JSON 표현
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
입력란
budgetAmountMicros

string (int64 format)

예상 측정항목의 기반이 되는 시뮬레이션 예산입니다.

requiredCpcBidCeilingMicros

string (int64 format)

시뮬레이션을 실현하기 위해 광고주가 설정해야 하는 예상 일일 CPC 입찰가 상한(광고주 통화의 마이크로 단위) 목표 지출액 입찰 전략이 있는 캠페인에서만 이 필드를 지원합니다.

biddableConversions

number

입찰 가능한 예상 전환수입니다.

biddableConversionsValue

number

입찰 가능한 전환의 총 예상 가치입니다.

clicks

string (int64 format)

예상 클릭수입니다.

costMicros

string (int64 format)

마이크로 단위의 예상 비용입니다.

impressions

string (int64 format)

예상 노출수입니다.

topSlotImpressions

string (int64 format)

예상 상단 슬롯 노출수입니다. 검색 광고 채널 유형만 이 필드를 지원합니다.

CarrierConstant

캠페인 타겟팅에 사용할 수 있는 이동통신사 기준입니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
입력란
resourceName

string

출력 전용입니다. 이동통신사 기준의 리소스 이름입니다. 이동통신사 기준 리소스 이름의 형식은 다음과 같습니다.

carrierConstants/{criterionId}

id

string (int64 format)

출력 전용입니다. 이동통신사 기준의 ID입니다.

name

string

출력 전용입니다. 운송업체의 전체 이름(영어)입니다.

countryCode

string

출력 전용입니다. 운송업체가 위치한 국가의 국가 코드입니다(예: 'AR', 'FR' 등).

ChangeEvent

특정 리소스 유형의 반환된 리소스의 세분화된 변경사항을 설명합니다. 지난 30일 동안 UI 또는 API를 통해 변경한 내용이 포함됩니다. 변경된 필드의 이전 값과 새 값이 표시됩니다. ChangeEvent는 새 변경사항을 반영하기 위해 최대 3분 지연될 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string,
  "asset": string
}
입력란
resourceName

string

출력 전용입니다. 변경 이벤트의 리소스 이름입니다. 변경 이벤트 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index}

changeDateTime

string

출력 전용입니다. 이 리소스에서 변경사항이 커밋된 시간입니다.

changeResourceType

enum (ChangeEventResourceType)

출력 전용입니다. 변경된 리소스의 유형입니다. 이전 리소스 및 newResource에 설정될 리소스를 지정합니다.

changeResourceName

string

출력 전용입니다. 이 변경사항이 발생한 Simply 리소스입니다.

clientType

enum (ChangeClientType)

출력 전용입니다. 변경이 이루어진 위치입니다.

userEmail

string

출력 전용입니다. 변경한 사용자의 이메일입니다.

oldResource

object (ChangedResource)

출력 전용입니다. 변경 전의 이전 리소스입니다. 변경된 필드만 채워집니다.

newResource

object (ChangedResource)

출력 전용입니다. 변경 후의 새 리소스입니다. 변경된 필드만 채워집니다.

resourceChangeOperation

enum (ResourceChangeOperation)

출력 전용입니다. 변경된 리소스에 대한 작업입니다.

changedFields

string (FieldMask format)

출력 전용입니다. 반환된 리소스에서 변경된 필드의 목록입니다.

필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: "user.displayName,photo"

campaign

string

출력 전용입니다. 이 변경사항의 영향을 받는 캠페인

adGroup

string

출력 전용입니다. 이 변경의 영향을 받은 광고그룹입니다.

feed

string

출력 전용입니다. 이 변경사항의 영향을 받는 피드

feedItem

string

출력 전용입니다. 이 변경사항의 영향을 받는 피드 항목

asset

string

출력 전용입니다. 이 변경사항의 영향을 받는 저작물입니다.

ChangeEventResourceType

ChangeEvent 리소스에서 지원하는 리소스 유형을 나열하는 열거형입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 분류되지 않은 리소스를 나타냅니다.
AD 광고 리소스 변경.
AD_GROUP AdGroup 리소스 변경입니다.
AD_GROUP_CRITERION AdGroupCriterion 리소스 변경입니다.
CAMPAIGN 캠페인 리소스 변경
CAMPAIGN_BUDGET CampaignBudget 리소스 변경
AD_GROUP_BID_MODIFIER AdGroupBidModifier 리소스 변경사항입니다.
CAMPAIGN_CRITERION CampaignCriterion 리소스 변경입니다.
FEED 피드 리소스 변경
FEED_ITEM FeedItem 리소스 변경사항
CAMPAIGN_FEED CampaignFeed 리소스 변경
AD_GROUP_FEED AdGroupFeed 리소스 변경입니다.
AD_GROUP_AD AdGroupAd 리소스 변경입니다.
ASSET 애셋 리소스 변경.
CUSTOMER_ASSET CustomerAsset 리소스 변경
CAMPAIGN_ASSET CampaignAsset 리소스 변경
AD_GROUP_ASSET AdGroupAsset 리소스 변경사항입니다.
ASSET_SET AssetSet 리소스 변경
ASSET_SET_ASSET AssetSetAsset 리소스 변경.
CAMPAIGN_ASSET_SET CampaignAssetSet 리소스 변경

ChangeClientType

changeEvent 리소스가 생성된 소스입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 분류되지 않은 클라이언트 유형을 나타냅니다.
GOOGLE_ADS_WEB_CLIENT 'ads.google.com'을 통해 변경된 사항 예를 들어 캠페인 관리를 통해 변경된 사항이 있습니다.
GOOGLE_ADS_AUTOMATED_RULE Google Ads 자동 규칙을 통해 변경된 사항.
GOOGLE_ADS_SCRIPTS Google Ads 스크립트를 통해 변경한 사항
GOOGLE_ADS_BULK_UPLOAD Google Ads 일괄 업로드를 통한 변경사항
GOOGLE_ADS_API Google Ads API에 의한 변경사항
GOOGLE_ADS_EDITOR Google Ads 에디터로 변경한 사항 이 값은 자리표시자입니다. API는 이러한 변경사항을 반환하지 않습니다.
GOOGLE_ADS_MOBILE_APP Google Ads 모바일 앱을 통한 변경사항입니다.
GOOGLE_ADS_RECOMMENDATIONS Google Ads 추천을 통한 변경사항입니다.
SEARCH_ADS_360_SYNC Search Ads 360 동기화를 통한 변경사항
SEARCH_ADS_360_POST Search Ads 360 게시물을 통한 변경사항
INTERNAL_TOOL 내부 도구를 통해 변경한 경우 예를 들어 사용자가 캠페인과 같은 항목에 URL 템플릿을 설정하면 SA360 클릭서버 URL로 자동 래핑됩니다.
OTHER 카테고리가 없는 변경사항의 유형(예: Google Ads를 통한 쿠폰 사용으로 인한 변경사항)입니다.

ChangedResource

지원되는 모든 리소스를 표시하는 래퍼 proto입니다. changeResourceType의 리소스만 설정됩니다.

JSON 표현
{
  "ad": {
    object (Ad)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "asset": {
    object (Asset)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  }
}
입력란
ad

object (Ad)

출력 전용입니다. changeResourceType == AD인 경우 설정합니다.

adGroup

object (AdGroup)

출력 전용입니다. changeResourceType == AD_GROUP인 경우 설정합니다.

adGroupCriterion

object (AdGroupCriterion)

출력 전용입니다. changeResourceType == AD_GROUP_CRITERION인 경우 설정합니다.

campaign

object (Campaign)

출력 전용입니다. changeResourceType == CAMPAIGN인 경우 설정됩니다.

campaignBudget

object (CampaignBudget)

출력 전용입니다. changeResourceType == CAMPAIGN_BUDGET인 경우 설정됩니다.

adGroupBidModifier

object (AdGroupBidModifier)

출력 전용입니다. changeResourceType == AD_GROUP_BID_MODIFIER인 경우 설정됩니다.

campaignCriterion

object (CampaignCriterion)

출력 전용입니다. changeResourceType == CAMPAIGN_CRITERION인 경우 설정합니다.

feed

object (Feed)

출력 전용입니다. changeResourceType == FEED이면 설정됩니다.

feedItem

object (FeedItem)

출력 전용입니다. changeResourceType == FEED_ITEM인 경우 설정합니다.

campaignFeed

object (CampaignFeed)

출력 전용입니다. changeResourceType == CAMPAIGN_FEED인 경우 설정합니다.

adGroupFeed

object (AdGroupFeed)

출력 전용입니다. changeResourceType == AD_GROUP_FEED인 경우 설정합니다.

adGroupAd

object (AdGroupAd)

출력 전용입니다. changeResourceType == AD_GROUP_AD인 경우 설정합니다.

asset

object (Asset)

출력 전용입니다. changeResourceType == ASSET인 경우 설정됩니다.

customerAsset

object (CustomerAsset)

출력 전용입니다. changeResourceType == CUSTOMER_ASSET인 경우 설정합니다.

campaignAsset

object (CampaignAsset)

출력 전용입니다. changeResourceType == CAMPAIGN_ASSET인 경우 설정됩니다.

adGroupAsset

object (AdGroupAsset)

출력 전용입니다. changeResourceType == AD_GROUP_ASSET인 경우 설정됩니다.

assetSet

object (AssetSet)

출력 전용입니다. changeResourceType == ASSET_SET인 경우 설정됩니다.

assetSetAsset

object (AssetSetAsset)

출력 전용입니다. changeResourceType == ASSET_SET_ASSET인 경우 설정됩니다.

campaignAssetSet

object (CampaignAssetSet)

출력 전용입니다. changeResourceType == CAMPAIGN_ASSET_SET인 경우 설정됩니다.

ResourceChangeOperation

changeEvent 리소스에서 변경된 리소스에 대한 작업입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 분류되지 않은 작업을 나타냅니다.
CREATE 리소스가 생성되었습니다.
UPDATE 리소스가 수정되었습니다.
REMOVE 리소스가 삭제되었습니다.

ChangeStatus

반환된 리소스의 상태를 설명합니다. ChangeStatus에 새 변경사항이 반영되기까지 최대 3분 지연될 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "resourceType": enum (ChangeStatusResourceType),
  "resourceStatus": enum (ChangeStatusOperation),
  "sharedSet": string,
  "campaignSharedSet": string,
  "asset": string,
  "customerAsset": string,
  "campaignAsset": string,
  "adGroupAsset": string,
  "combinedAudience": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "feed": string,
  "feedItem": string,
  "adGroupFeed": string,
  "campaignFeed": string,
  "adGroupBidModifier": string
}
입력란
resourceName

string

출력 전용입니다. 변경 상태의 리소스 이름입니다. 변경 상태 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/changeStatus/{change_status_id}

resourceType

enum (ChangeStatusResourceType)

출력 전용입니다. 변경된 리소스의 유형을 나타냅니다. 이를 통해 설정할 필드가 결정됩니다. 예를 들어 AD_GROUP의 경우 캠페인 및 adGroup 필드가 설정됩니다.

resourceStatus

enum (ChangeStatusOperation)

출력 전용입니다. 변경된 리소스의 상태를 나타냅니다.

sharedSet

string

출력 전용입니다. 이 변경사항의 영향을 받는 SharedSet

campaignSharedSet

string

출력 전용입니다. 이 변경사항의 영향을 받는 CampaignSharedSet.

asset

string

출력 전용입니다. 이 변경사항의 영향을 받는 저작물입니다.

customerAsset

string

출력 전용입니다. 이 변경사항의 영향을 받는 CustomerAsset입니다.

campaignAsset

string

출력 전용입니다. 이 변경사항의 영향을 받는 CampaignAsset입니다.

adGroupAsset

string

출력 전용입니다. 이 변경의 영향을 받은 AdGroupAsset입니다.

combinedAudience

string

출력 전용입니다. 이번 변경사항의 영향을 받는 MergedAudience입니다.

lastChangeDateTime

string

출력 전용입니다. 이 리소스가 가장 최근에 변경된 시간입니다.

campaign

string

출력 전용입니다. 이 변경사항의 영향을 받는 캠페인

adGroup

string

출력 전용입니다. 이 변경의 영향을 받은 광고그룹입니다.

adGroupAd

string

출력 전용입니다. 이 변경의 영향을 받은 AdGroupAd입니다.

adGroupCriterion

string

출력 전용입니다. 이 변경사항의 영향을 받은 AdGroupCriterion입니다.

campaignCriterion

string

출력 전용입니다. 이번 변경의 영향을 받는 CampaignCriterion

feed

string

출력 전용입니다. 이 변경사항의 영향을 받는 피드

feedItem

string

출력 전용입니다. 이 변경사항의 영향을 받는 피드 항목

adGroupFeed

string

출력 전용입니다. 이 변경사항의 영향을 받은 AdGroupFeed입니다.

campaignFeed

string

출력 전용입니다. 이 변경사항의 영향을 받는 CampaignFeed

adGroupBidModifier

string

출력 전용입니다. 이 변경의 영향을 받는 AdGroupBidModifier입니다.

ChangeStatusResourceType

ChangeStatus 리소스에서 지원하는 리소스 유형을 나열하는 열거형입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 분류되지 않은 리소스를 나타냅니다.
AD_GROUP AdGroup 리소스 변경입니다.
AD_GROUP_AD AdGroupAd 리소스 변경입니다.
AD_GROUP_CRITERION AdGroupCriterion 리소스 변경입니다.
CAMPAIGN 캠페인 리소스 변경
CAMPAIGN_CRITERION CampaignCriterion 리소스 변경입니다.
FEED 피드 리소스 변경
FEED_ITEM FeedItem 리소스 변경사항
AD_GROUP_FEED AdGroupFeed 리소스 변경입니다.
CAMPAIGN_FEED CampaignFeed 리소스 변경
AD_GROUP_BID_MODIFIER AdGroupBidModifier 리소스 변경사항입니다.
SHARED_SET SharedSet 리소스 변경
CAMPAIGN_SHARED_SET CampaignSharedSet 리소스 변경사항.
ASSET 애셋 리소스 변경.
CUSTOMER_ASSET CustomerAsset 리소스 변경
CAMPAIGN_ASSET CampaignAsset 리소스 변경
AD_GROUP_ASSET AdGroupAsset 리소스 변경사항입니다.
COMBINED_AUDIENCE MergedAudience 리소스 변경

ChangeStatusOperation

변경된 리소스의 상태

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 분류되지 않은 리소스를 나타냅니다.
ADDED 리소스가 생성되었습니다.
CHANGED 리소스가 수정되었습니다.
REMOVED 리소스가 삭제되었습니다.

CombinedAudience

다양한 잠재고객을 포함하는 통합된 잠재고객에 관한 리소스를 설명합니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
입력란
resourceName

string

변경할 수 없습니다. 결합된 잠재고객의 리소스 이름입니다. 통합 잠재고객 이름의 형식은 다음과 같습니다.

customers/{customerId}/combinedAudience/{combined_audience_id}

id

string (int64 format)

출력 전용입니다. 결합된 잠재고객의 ID입니다.

status

enum (CombinedAudienceStatus)

출력 전용입니다. 이 통합된 잠재고객의 상태입니다. 통합된 잠재고객이 사용 설정 또는 삭제되었는지 여부를 나타냅니다.

name

string

출력 전용입니다. 결합된 잠재고객의 이름입니다. 모든 통합된 잠재고객에서 고유해야 합니다.

description

string

출력 전용입니다. 이 통합된 잠재고객에 대한 설명입니다.

CombinedAudienceStatus

가능한 결합된 잠재고객 상태 유형을 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 사용 설정 상태 - 통합된 잠재고객이 사용 설정되고 타겟팅할 수 있습니다.
REMOVED 상태 삭제됨 - 통합된 잠재고객은 삭제되며 타겟팅에 사용할 수 없습니다.

ClickView

유효 클릭수와 무효 클릭수를 포함하여 각 클릭 수준에서 집계된 측정항목이 포함된 클릭 보기입니다. 검색 캠페인이 아닌 캠페인의 경우 Metrics.clicks는 유효한 상호작용과 무효 상호작용 수를 나타냅니다. ClickView를 포함한 쿼리에는 결과를 1일로 제한하는 필터가 있어야 하며 요청 시간으로부터 90일까지의 날짜에 대해 요청할 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
입력란
resourceName

string

출력 전용입니다. 클릭 뷰의 리소스 이름입니다. 클릭 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/clickViews/{date (yyyy-MM-dd)}~{gclid}

areaOfInterest

object (ClickLocation)

출력 전용입니다. 노출과 연결된 관심 지역과 일치하는 위치 기준입니다.

locationOfPresence

object (ClickLocation)

출력 전용입니다. 노출과 연결된 현재 위치와 일치하는 위치 기준입니다.

keyword

string

출력 전용입니다. 관련 키워드(있는 경우) 및 클릭이 검색 채널에 해당하는 경우

keywordInfo

object (KeywordInfo)

출력 전용입니다. 연결된 키워드가 있는 경우 키워드에 대한 기본 정보입니다.

gclid

string

출력 전용입니다. Google 클릭 ID입니다.

pageNumber

string (int64 format)

출력 전용입니다. 광고가 게재된 검색결과의 페이지 번호입니다.

adGroupAd

string

출력 전용입니다. 연결된 광고입니다.

campaignLocationTarget

string

출력 전용입니다. 연결된 캠페인 타겟 위치(있는 경우)입니다.

userList

string

출력 전용입니다. 연결된 사용자 목록(있는 경우)입니다.

ClickLocation

클릭과 연결된 위치 기준입니다.

JSON 표현
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
입력란
city

string

노출과 연결된 도시 위치 기준입니다.

country

string

노출과 연결된 국가 위치 기준입니다.

metro

string

노출과 연결된 대도시 위치 기준입니다.

mostSpecific

string

노출과 연결된 가장 구체적인 위치 기준입니다.

region

string

노출과 연결된 지역 위치 기준입니다.

CurrencyConstant

통화 상수입니다.

JSON 표현
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
입력란
resourceName

string

출력 전용입니다. 통화 상수의 리소스 이름입니다. 통화 상수 리소스 이름의 형식은 다음과 같습니다.

currencyConstants/{code}

code

string

출력 전용입니다. ISO 4217 3자리 통화 코드(예: 'USD')입니다.

name

string

출력 전용입니다. 통화의 전체 영어 이름입니다.

symbol

string

출력 전용입니다. 통화를 설명하는 표준 기호입니다(예: 미국 달러는 '$').

billableUnitMicros

string (int64 format)

출력 전용입니다. 이 통화의 청구 가능 단위입니다. 청구 금액은 이 값의 배수여야 합니다.

AccessibleBiddingStrategy

고객이 소유하고 공유하는 입찰 전략 뷰를 나타냅니다.

입찰 전략과 달리 이 리소스에는 이 고객이 소유한 전략 외에도 고객의 관리자가 소유하고 이 고객과 공유된 전략이 포함됩니다. 이 리소스는 측정항목을 제공하지 않으며 입찰전략 속성의 제한된 하위 집합만 노출합니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
입력란
resourceName

string

출력 전용입니다. 액세스할 수 있는 입찰 전략의 리소스 이름입니다. AccessibleBiddingStrategy 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string (int64 format)

출력 전용입니다. 입찰 전략의 ID입니다.

name

string

출력 전용입니다. 입찰 전략의 이름입니다.

type

enum (BiddingStrategyType)

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

ownerCustomerId

string (int64 format)

출력 전용입니다. 입찰 전략을 소유한 고객의 ID입니다.

ownerDescriptiveName

string

출력 전용입니다. 입찰 전략을 소유한 고객의 descriptionName입니다.

통합 필드 scheme. 입찰 스키마입니다.

하나만 설정할 수 있습니다. scheme는 다음 중 하나여야 합니다.

maximizeConversionValue

object (MaximizeConversionValue)

출력 전용입니다. 캠페인의 전환 가치를 최대한 높일 수 있는 방향으로 예산이 지출되도록 도와주는 자동 입찰 전략입니다.

maximizeConversions

object (MaximizeConversions)

출력 전용입니다. 캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되도록 도와주는 자동 입찰 전략입니다.

targetCpa

object (TargetCpa)

출력 전용입니다. 설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

targetImpressionShare

object (TargetImpressionShare)

출력 전용입니다. 선택한 노출수 비율에 맞춰 자동으로 최적화되는 입찰 전략입니다.

targetRoas

object (TargetRoas)

출력 전용입니다. 특정 타겟 광고 투자수익 (ROAS)을 평균화하면서 수익을 극대화할 수 있는 입찰 전략입니다.

targetSpend

object (TargetSpend)

출력 전용입니다. 예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

MaximizeConversionValue

캠페인의 전환 가치를 최대한 높일 수 있는 방향으로 예산이 지출되도록 도와주는 자동 입찰 전략입니다.

JSON 표현
{
  "targetRoas": number
}
입력란
targetRoas

number

출력 전용입니다. 타겟 광고 투자수익 (ROAS) 옵션 설정된 경우 입찰 전략은 타겟 광고 투자수익을 평균화하면서 수익을 극대화합니다. 타겟 광고 투자수익(ROAS)이 높으면 입찰 전략에서 전체 예산을 지출하지 못할 수 있습니다. 타겟 광고 투자수익(ROAS)이 설정되지 않은 경우 입찰 전략은 예산 내에서 최대한 높은 ROAS를 달성하는 것을 목표로 합니다.

MaximizeConversions

캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되도록 도와주는 자동 입찰 전략입니다.

JSON 표현
{
  "targetCpaMicros": string
}
입력란
targetCpaMicros

string (int64 format)

출력 전용입니다. 타겟 전환당비용 (CPA) 옵션입니다. 전환 1회당 지출하고자 하는 평균 금액입니다.

TargetCpa

설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현
{
  "targetCpaMicros": string
}
입력란
targetCpaMicros

string (int64 format)

출력 전용입니다. 평균 CPA 타겟입니다. 이 타겟은 계정의 통화를 기준으로 최소 청구 가능 단위보다 크거나 같아야 합니다.

TargetImpressionShare

검색 광고의 일정 비율이 첫 페이지 (또는 다른 타겟 위치) 상단에 표시되도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
입력란
location

enum (TargetImpressionShareLocation)

출력 전용입니다. 검색결과 페이지의 타겟 위치입니다.

locationFractionMicros

string (int64 format)

타겟 지역에 게재할 광고의 선택된 부분(단위: 마이크로초)입니다. 예를 들어 1% 는 10,000입니다.

cpcBidCeilingMicros

string (int64 format)

출력 전용입니다. 자동 입찰 시스템으로 지정할 수 있는 가장 높은 CPC 입찰가입니다. 광고주가 입력하는 필수 필드이고 상한을 설정하며 로컬 마이크로 단위로 지정됩니다.

TargetRoas

특정 타겟 광고 투자수익 (ROAS)을 유지하면서 수익을 극대화할 수 있는 자동 입찰 전략입니다.

JSON 표현
{
  "targetRoas": number
}
입력란
targetRoas

number

출력 전용입니다. 지출 단위당 선택한 수익(전환 데이터 기준)입니다.

TargetSpend

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
입력란
targetSpendMicros
(deprecated)

string (int64 format)

출력 전용입니다. 클릭수를 최대화할 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. 이 필드는 지원 중단되었으며 더 이상 사용하지 않아야 합니다. 자세한 내용은 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html을 참고하세요.

cpcBidCeilingMicros

string (int64 format)

출력 전용입니다. 입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다.

CustomerClient

지정된 고객과 클라이언트 고객 간의 링크입니다. CustomerClient는 관리자 고객에게만 존재합니다. 관리자뿐만 아니라 모든 직접 및 간접 고객 고객이 포함됩니다.

JSON 표현
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
입력란
resourceName

string

출력 전용입니다. 고객 클라이언트의 리소스 이름입니다. CustomerClient 리소스 이름의 형식은 customers/{customerId}/customerClients/{client_customer_id}입니다.

appliedLabels[]

string

출력 전용입니다. 요청하는 고객이 소유하고 클라이언트 고객에게 적용되는 라벨의 리소스 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

출력 전용입니다. 클라이언트 고객의 상태입니다. 읽기 전용입니다.

clientCustomer

string

출력 전용입니다. 특정 고객에 연결된 클라이언트-고객의 리소스 이름입니다. 읽기 전용입니다.

hidden

boolean

출력 전용입니다. 숨겨진 계정인지 여부를 지정합니다. 읽기 전용입니다.

level

string (int64 format)

출력 전용입니다. 특정 고객과 클라이언트 간의 거리입니다. 자체 링크의 경우 레벨 값은 0이 됩니다. 읽기 전용입니다.

timeZone

string

출력 전용입니다. 클라이언트의 시간대를 나타내는 공통 언어 데이터 저장소(CLDR) 문자열 표현입니다(예: America/Los_Angeles). 읽기 전용입니다.

testAccount

boolean

출력 전용입니다. 클라이언트가 테스트 계정인지 식별합니다. 읽기 전용입니다.

manager

boolean

출력 전용입니다. 클라이언트가 관리자인지 식별합니다. 읽기 전용입니다.

descriptiveName

string

출력 전용입니다. 클라이언트를 설명하는 이름입니다. 읽기 전용입니다.

currencyCode

string

출력 전용입니다. 클라이언트의 통화 코드 (예: 'USD', 'EUR')입니다. 읽기 전용입니다.

id

string (int64 format)

출력 전용입니다. 클라이언트 고객의 ID입니다. 읽기 전용입니다.

CustomerSearchTermInsight

고객 검색어 보기 이전 데이터는 2023년 3월부터 이용할 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
입력란
resourceName

string

출력 전용입니다. 고객 수준 검색어 통계의 리소스 이름입니다. 고객 수준 검색어 통계 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/customerSearchTermInsights/{categoryId}

categoryLabel

string

출력 전용입니다. 검색 카테고리의 라벨입니다. 빈 문자열은 다른 카테고리에 해당하지 않는 검색어에 대한 포괄 카테고리를 나타냅니다.

id

string (int64 format)

출력 전용입니다. 통계의 ID입니다.

DetailPlacementView

광고 그룹 및 URL 또는 YouTube 동영상별로 집계된 측정항목이 포함된 보기입니다.

JSON 표현
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
입력란
resourceName

string

출력 전용입니다. 세부정보 게재위치 뷰의 리소스 이름입니다. 세부정보 게재위치 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/detailPlacementViews/{adGroupId}~{base64_placement}

placementType

enum (PlacementType)

출력 전용입니다. 게재위치의 유형입니다(예: 웹사이트, YouTube 동영상, 모바일 애플리케이션).

placement

string

출력 전용입니다. 세부정보 수준의 자동 게재위치 문자열입니다(예: 웹사이트 URL, 모바일 애플리케이션 ID 또는 YouTube 동영상 ID).

displayName

string

출력 전용입니다. 표시 이름은 웹사이트의 URL 이름, YouTube 동영상의 경우 YouTube 동영상 이름, 모바일 앱의 경우 번역된 모바일 앱 이름입니다.

groupPlacementTargetUrl

string

출력 전용입니다. 그룹 게재위치의 URL(예: 도메인, 앱 스토어의 모바일 애플리케이션 링크, YouTube 채널 URL)입니다.

targetUrl

string

출력 전용입니다. 게재위치의 URL(예: 웹사이트, 앱 스토어의 모바일 애플리케이션 링크, YouTube 동영상 URL)입니다.

PlacementType

피드 매핑에 가능한 게재위치 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
WEBSITE 웹사이트(예: 'www.flowers4sale.com')
MOBILE_APP_CATEGORY 모바일 애플리케이션 카테고리입니다(예: '게임').
MOBILE_APPLICATION 모바일 애플리케이션(예: 'mobileapp::2-com.whatsthewordanswers')
YOUTUBE_VIDEO YouTube 동영상(예: 'youtube.com/video/wtLJPvx7-ys')
YOUTUBE_CHANNEL YouTube 채널(예: 'youtube.com::L8ZULXASCc1I_oaOT0NaOQ')
GOOGLE_PRODUCTS Google에서 소유하고 운영하는 매체입니다(예: 'tv.google.com').

DetailedDemographic

상세한 인구통계: 사용자의 인생에 장기적으로 영향을 미치기 위해 타겟팅하는 특정 관심기반 분야입니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
입력란
resourceName

string

출력 전용입니다. 상세 인구통계의 리소스 이름입니다. 상세한 인구통계 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/detailedDemographics/{detailed_demographic_id}

id

string (int64 format)

출력 전용입니다. 상세 인구통계의 ID입니다.

name

string

출력 전용입니다. 상세 인구통계의 이름입니다. 예: '최고 수준의 학력'

parent

string

출력 전용입니다. 세부정보 인구통계의 상위 항목입니다.

launchedToAll

boolean

출력 전용입니다. 상세 인구통계가 모든 채널 및 언어로 출시되는 경우 참입니다.

availabilities[]

object (CriterionCategoryAvailability)

출력 전용입니다. 상세 인구통계의 사용 가능 여부 정보입니다.

CriterionCategoryAvailability

광고 채널별 카테고리 사용 가능 여부에 대한 정보입니다.

JSON 표현
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
입력란
channel

object (CriterionCategoryChannelAvailability)

카테고리에서 사용할 수 있는 채널 유형 및 하위유형입니다.

locale[]

object (CriterionCategoryLocaleAvailability)

채널 카테고리에 사용할 수 있는 언어입니다.

CriterionCategoryChannelAvailability

광고 채널 유형 및 카테고리를 사용할 수 있는 하위유형에 대한 정보입니다.

JSON 표현
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
입력란
availabilityMode

enum (CriterionCategoryChannelAvailabilityMode)

채널 사용 가능 여부의 형식입니다. ALL_CHANNELS (나머지 필드는 설정되지 않음), CHANNEL_TYPE (광고 채널 유형만 설정되며, 카테고리는 그 아래의 모든 하위 유형에서 사용할 수 있음) 또는 CHANNEL_TYPE_AND_SUBTYPES (advertisingChannelType, advertisingChannelSubType, includeDefaultChannelSubType 모두 설정됨)일 수 있습니다.

advertisingChannelType

enum (AdvertisingChannelType)

카테고리를 사용할 수 있는 채널 유형입니다.

advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

채널 하위유형을 선택할 수 있습니다.

includeDefaultChannelSubType

boolean

기본 채널 하위 유형이 포함되는지 여부입니다. 예를 들어 AdvertisingChannelType이 DISPLAY이고 includeDefaultChannelSubType이 false이면 채널 하위 유형이 설정되지 않은 기본 디스플레이 캠페인이 이 가용성 구성에 포함되지 않는다는 의미입니다.

CriterionCategoryChannelAvailabilityMode

가능한 CriterionCategoryChannelAvailabilityMode를 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ALL_CHANNELS 카테고리는 모든 채널 유형 및 하위유형의 캠페인에서 사용할 수 있습니다.
CHANNEL_TYPE_AND_ALL_SUBTYPES 카테고리는 특정 채널 유형의 캠페인에서 사용할 수 있으며 모든 하위유형도 여기에 포함됩니다.
CHANNEL_TYPE_AND_SUBSET_SUBTYPES 카테고리는 특정 채널 유형 및 하위 유형의 캠페인에서 사용할 수 있습니다.

CriterionCategoryLocaleAvailability

카테고리를 사용할 수 있는 언어에 대한 정보입니다.

JSON 표현
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
입력란
availabilityMode

enum (CriterionCategoryLocaleAvailabilityMode)

사용 가능 언어 형식입니다. LAUNCHED_TO_ALL (국가 및 언어가 모두 비어 있음), COUNTRY (국가만 설정됨), LANGUAGE (언어만 설정됨), COUNTRY_AND_LANGUAGE (국가 및 언어가 모두 설정됨)가 될 수 있습니다.

countryCode

string

카테고리와 연결된 ISO-3166-1 alpha-2 국가 코드입니다.

languageCode

string

카테고리와 연결된 언어의 ISO 639-1 코드입니다.

CriterionCategoryLocaleAvailabilityMode

가능한 CriterionCategoryLocaleAvailabilityMode를 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ALL_LOCALES 이 카테고리는 모든 언어의 캠페인에 사용할 수 있습니다.
COUNTRY_AND_ALL_LANGUAGES 카테고리는 언어에 관계없이 국가 목록에 있는 캠페인에서 사용할 수 있습니다.
LANGUAGE_AND_ALL_COUNTRIES 카테고리는 국가와 관계없이 언어 목록에 있는 캠페인에서 사용할 수 있습니다.
COUNTRY_AND_LANGUAGE 국가/언어 조합 목록에 있는 캠페인에서 카테고리를 사용할 수 있습니다.

DisplayKeywordView

디스플레이 키워드 뷰

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 디스플레이 키워드 뷰의 리소스 이름입니다. 디스플레이 키워드 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/displayKeywordViews/{adGroupId}~{criterionId}

DistanceView

광고주의 추가 위치 정보에서 사용자까지의 거리를 기준으로 집계된 측정항목이 포함된 거리 보기입니다. 각 DistanceBucket에는 해당 거리 내에 있는 모든 노출이 포함되며, 단일 노출은 사용자의 거리를 포함하는 모든 DistanceBucket의 측정항목에 반영됩니다.

JSON 표현
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
입력란
resourceName

string

출력 전용입니다. 거리 뷰의 리소스 이름입니다. 거리 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/distanceViews/1~{distanceBucket}

distanceBucket

enum (DistanceBucket)

출력 전용입니다. 위치 광고 확장으로부터의 사용자 거리 그룹입니다.

metricSystem

boolean

출력 전용입니다. DistanceBucket에서 미터법을 사용하는 경우 true, 그렇지 않으면 false입니다.

DistanceBucket

광고주의 추가 위치 정보에서 사용자의 거리에 대한 거리 버킷입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
WITHIN_700M 사용자가 해당 위치에서 700m 이내에 있었습니다.
WITHIN_1KM 사용자가 위치에서 1km 이내에 있었습니다.
WITHIN_5KM 사용자가 해당 위치에서 5km 이내에 있었습니다.
WITHIN_10KM 사용자가 위치에서 10km 이내에 있었습니다.
WITHIN_15KM 사용자가 해당 위치에서 15km 이내에 있었습니다.
WITHIN_20KM 사용자가 해당 위치에서 20km 이내에 있었습니다.
WITHIN_25KM 사용자가 해당 위치에서 25km 이내에 있었습니다.
WITHIN_30KM 사용자가 해당 위치에서 30km 이내에 있었습니다.
WITHIN_35KM 사용자가 해당 위치에서 35km 이내에 있었습니다.
WITHIN_40KM 사용자가 해당 위치에서 40km 이내에 있었습니다.
WITHIN_45KM 사용자가 해당 위치에서 45km 이내에 있었습니다.
WITHIN_50KM 사용자가 해당 위치에서 50km 이내에 있었습니다.
WITHIN_55KM 사용자가 해당 위치에서 55km 이내에 있었습니다.
WITHIN_60KM 사용자가 해당 위치에서 60km 이내에 있었습니다.
WITHIN_65KM 사용자가 해당 위치에서 65km 이내에 있었습니다.
BEYOND_65KM 사용자가 해당 위치에서 65km를 벗어난 경우
WITHIN_0_7MILES 사용자가 위치에서 1.1km 이내에 있었습니다.
WITHIN_1MILE 사용자가 해당 위치에서 1마일 이내에 있었습니다.
WITHIN_5MILES 사용자가 해당 위치에서 5마일 이내에 있었습니다.
WITHIN_10MILES 사용자가 해당 위치에서 10마일 이내에 있었습니다.
WITHIN_15MILES 사용자가 해당 위치에서 24km 이내에 있었습니다.
WITHIN_20MILES 사용자가 해당 위치에서 32km 이내에 있었습니다.
WITHIN_25MILES 사용자가 해당 위치에서 40km 이내에 있었습니다.
WITHIN_30MILES 사용자가 해당 위치에서 30마일 이내에 있었습니다.
WITHIN_35MILES 사용자가 해당 위치에서 55마일 이내에 있었습니다.
WITHIN_40MILES 사용자가 해당 위치에서 40마일 이내에 있었습니다.
BEYOND_40MILES 사용자가 해당 위치에서 40마일 이상 떨어진 곳에 있었습니다.

DynamicSearchAdsSearchTermView

동적 검색 광고 검색어 보기

JSON 표현
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
입력란
resourceName

string

출력 전용입니다. 동적 검색 광고 검색어 보기의 리소스 이름입니다. 동적 검색 광고 검색어 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

searchTerm

string

출력 전용입니다. 검색어

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

headline

string

출력 전용입니다. 동적 검색 광고의 동적으로 생성된 광고 제목입니다.

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

landingPage

string

출력 전용입니다. 노출 시 동적으로 선택된 방문 페이지 URL입니다.

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

pageUrl

string

출력 전용입니다. 노출에 대해 제공된 페이지 피드 항목의 URL입니다.

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

hasNegativeKeyword

boolean

출력 전용입니다. 검색어가 제외 키워드와 일치하면 true입니다.

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

hasMatchingKeyword

boolean

출력 전용입니다. 검색어가 타겟팅된 키워드에 추가된 경우 true입니다.

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

hasNegativeUrl

boolean

출력 전용입니다. 쿼리가 제외 URL과 일치하면 true입니다.

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

ExpandedLandingPageView

확장 최종 URL 수준에서 측정항목이 집계된 방문 페이지 조회수

JSON 표현
{
  "resourceName": string,
  "expandedFinalUrl": string
}
입력란
resourceName

string

출력 전용입니다. 확장 방문 페이지 보기의 리소스 이름입니다. 확장 방문 페이지 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}

expandedFinalUrl

string

출력 전용입니다. 클릭이 연결되는 최종 URL입니다.

FeedPlaceholderView

피드 자리표시자 보기

JSON 표현
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
입력란
resourceName

string

출력 전용입니다. 피드 자리표시자 뷰의 리소스 이름입니다. 피드 자리표시자 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/feedPlaceholderViews/{placeholderType}

placeholderType

enum (PlaceholderType)

출력 전용입니다. 피드 자리표시자 뷰의 자리표시자 유형입니다.

GenderView

성별 보기 성별 보기 리소스는 추가된 기준이 아닌 효과적인 게재 상태를 반영합니다. 성별 기준이 없는 광고그룹은 기본적으로 모든 성별에 게재되므로 모든 성별이 통계와 함께 표시됩니다.

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 성별 뷰의 리소스 이름입니다. 성별 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/genderViews/{adGroupId}~{criterionId}

GeographicView

지역 뷰

지역 보기에는 국가당 한 열씩, 국가 수준에서 집계된 모든 측정항목이 포함됩니다. 사용자의 실제 물리적 위치 또는 관심 지역의 측정항목을 보고합니다. 다른 분류 기준 필드가 사용되는 경우 국가당 두 개 이상의 행이 표시될 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
입력란
resourceName

string

출력 전용입니다. 지역 뷰의 리소스 이름입니다. 지역 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/geographicViews/{countryCriterionId}~{locationType}

locationType

enum (GeoTargetingType)

출력 전용입니다. 캠페인의 지역 타겟팅 유형입니다.

countryCriterionId

string (int64 format)

출력 전용입니다. 국가의 기준 ID입니다.

GeoTargetingType

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

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
AREA_OF_INTEREST 쿼리하는 동안 사용자가 관심을 두는 위치입니다.
LOCATION_OF_PRESENCE 쿼리를 실행한 사용자의 위치입니다.

GroupPlacementView

그룹 게재위치 뷰

JSON 표현
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "targetUrl": string
}
입력란
resourceName

string

출력 전용입니다. 그룹 게재위치 뷰의 리소스 이름입니다. 그룹 게재위치 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/groupPlacementViews/{adGroupId}~{base64_placement}

placementType

enum (PlacementType)

출력 전용입니다. 게재위치의 유형입니다(예: 웹사이트, YouTube 채널, 모바일 애플리케이션).

placement

string

출력 전용입니다. 그룹 수준의 자동 게재위치 문자열입니다(예: 웹 도메인, 모바일 앱 ID 또는 YouTube 채널 ID).

displayName

string

출력 전용입니다. 웹사이트의 도메인 이름 및 YouTube 채널의 YouTube 채널 이름입니다.

targetUrl

string

출력 전용입니다. 그룹 게재위치의 URL(예: 도메인, 앱 스토어의 모바일 애플리케이션 링크, YouTube 채널 URL)입니다.

HotelGroupView

호텔 그룹 뷰

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 호텔 그룹 뷰의 리소스 이름입니다. 호텔 그룹 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/hotelGroupViews/{adGroupId}~{criterionId}

HotelPerformanceView

호텔 실적 뷰

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 호텔 실적 뷰의 리소스 이름입니다. 호텔 실적 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/hotelPerformanceView

HotelReconciliation

호텔 조정입니다. 여기에는 광고주 기록과 조정할 수 있도록 호텔 예약의 전환 정보가 포함됩니다. 일괄 업로드를 통해 청구하기 전에 이러한 행이 업데이트되거나 취소될 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
입력란
resourceName

string

변경할 수 없습니다. 호텔 조정의 리소스 이름입니다. 호텔 조정 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/hotelReconciliations/{commissionId}

commissionId

string

필수 항목입니다. 출력 전용입니다. 수수료 ID는 해당 예약의 Google ID입니다. 모든 예약 이벤트에는 수수료 ID가 할당되어 숙박을 확인하는 데 도움이 됩니다.

orderId

string

출력 전용입니다. 주문 ID는 전환 추적 태그의 'transaction_id' 매개변수에 제공된 이 예약의 식별자입니다.

campaign

string

출력 전용입니다. 전환과 연결된 캠페인의 리소스 이름입니다.

hotelCenterId

string (int64 format)

출력 전용입니다. 호텔 캠페인의 요금을 제공하는 Hotel Center 계정의 식별자입니다.

hotelId

string

출력 전용입니다. Hotel Center 피드에 제공되는 예약된 숙박 시설의 고유 식별자입니다. 호텔 ID는 전환 추적 태그의 'ID' 매개변수에서 가져옵니다.

checkInDate

string

출력 전용입니다. 예약 시 기록된 체크인 날짜입니다. 조정 시 체크인 날짜가 변경되면 이 열의 원래 날짜가 변경된 날짜로 대체됩니다. 형식은 YYYY-MM-DD입니다.

checkOutDate

string

출력 전용입니다. 예약 시 기록된 체크아웃 날짜입니다. 조정 시 체크인 날짜가 변경되면 이 열의 원래 날짜가 변경된 날짜로 대체됩니다. 형식은 YYYY-MM-DD입니다.

reconciledValueMicros

string (int64 format)

필수 항목입니다. 출력 전용입니다. 조정된 금액은 투숙객이 지불한 최종 예약 금액입니다. 일정 변경이나 객실 업셀링 같은 이유로 원래 예약 금액이 변경되는 경우 조정된 금액이 최종적으로 받는 금액이 됩니다. 예약이 취소된 경우 조정된 금액에는 취소 수수료나 환불 불가능한 숙박에 대한 청구액이 포함됩니다. 값은 기본 단위 통화의 백만분의 1입니다. 예를 들어 $12.35는 12350000으로 나타냅니다. 통화 단위는 고객의 기본 통화를 사용합니다.

billed

boolean

출력 전용입니다. 지정된 예약의 청구 여부입니다. 청구된 후에는 예약을 수정할 수 없습니다.

status

enum (HotelReconciliationStatus)

필수 항목입니다. 출력 전용입니다. 조정 및 청구와 관련된 예약의 현재 상태입니다. 예약은 체크아웃 날짜로부터 45일 이내에 조정되어야 합니다. 45일 이내에 조정되지 않은 모든 예약은 원래 가격으로 청구됩니다.

HotelReconciliationStatus

호텔 예약 조정의 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
RESERVATION_ENABLED 이후 날짜에 대한 예약이거나, 숙박이 진행 중이지만 체크아웃 날짜가 지나지 않았습니다. 활성화된 예약은 조정할 수 없습니다.
RECONCILIATION_NEEDED 체크아웃이 이미 진행되었거나 예약한 날짜가 취소 없이 경과되었습니다. 체크아웃 후 45일 이내에 조정되지 않은 예약은 원래 예약 가격을 기준으로 청구됩니다.
RECONCILED 이 예약은 조정되었습니다. 조정된 예약은 체크아웃 날짜로부터 45일 후에 청구됩니다.
CANCELED 이 예약은 취소됨으로 표시되었습니다. (최소 숙박 일수 규칙 또는 취소 수수료 규정으로 인해) 취소된 숙박 일수가 0보다 큰 경우 체크아웃 날짜로부터 45일 후에 청구됩니다.

IncomeRangeView

소득 범위 보기

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 소득 범위 뷰의 리소스 이름입니다. 소득 범위 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/incomeRangeViews/{adGroupId}~{criterionId}

KeywordView

키워드 뷰

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 키워드 뷰의 리소스 이름입니다. 키워드 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/keywordViews/{adGroupId}~{criterionId}

LandingPageView

확장되지 않은 최종 URL 수준에서 측정항목이 집계된 방문 페이지 조회수

JSON 표현
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
입력란
resourceName

string

출력 전용입니다. 방문 페이지 조회의 리소스 이름입니다. 방문 페이지 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}

unexpandedFinalUrl

string

출력 전용입니다. 광고주가 지정한 최종 도착 URL입니다.

LanguageConstant

언어

JSON 표현
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
입력란
resourceName

string

출력 전용입니다. 언어 상수의 리소스 이름입니다. 언어 상수 리소스 이름의 형식은 다음과 같습니다.

languageConstants/{criterionId}

id

string (int64 format)

출력 전용입니다. 언어 상수의 ID입니다.

code

string

출력 전용입니다. 언어 코드(예: 'en_US', 'en_AU', 'es', 'fr' 등)

name

string

출력 전용입니다. 언어의 전체 이름입니다(예: '영어(미국)', '스페인어' 등).

targetable

boolean

출력 전용입니다. 타겟팅 가능한 언어인지 여부입니다.

LocationView

위치 보기에는 위치 기준별로 캠페인 실적이 요약되어 있습니다. 위치 기준이 설정되지 않은 경우 결과가 반환되지 않습니다. 대신 방문자 위치 데이터에 geoView 또는 userLocationView 를 사용하세요.

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 위치 뷰의 리소스 이름입니다. 위치 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/locationViews/{campaignId}~{criterionId}

ManagedPlacementView

선택 게재위치 보기

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 관리형 게재위치 뷰의 리소스 이름입니다. 선택 게재위치 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/managedPlacementViews/{adGroupId}~{criterionId}

MobileAppCategoryConstant

모바일 애플리케이션 카테고리 상수입니다.

JSON 표현
{
  "resourceName": string,
  "id": integer,
  "name": string
}
입력란
resourceName

string

출력 전용입니다. 모바일 앱 카테고리 상수의 리소스 이름입니다. 모바일 앱 카테고리 상수 리소스 이름의 형식은 다음과 같습니다.

mobileAppCategoryConstants/{mobile_app_category_id}

id

integer

출력 전용입니다. 모바일 앱 카테고리 상수의 ID입니다.

name

string

출력 전용입니다. 모바일 앱 카테고리 이름입니다.

MobileDeviceConstant

휴대기기 상수입니다.

JSON 표현
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
입력란
resourceName

string

출력 전용입니다. 휴대기기 상수의 리소스 이름입니다. 휴대기기 상수 리소스 이름의 형식은 다음과 같습니다.

mobileDeviceConstants/{criterionId}

type

enum (MobileDeviceType)

출력 전용입니다. 휴대기기의 유형입니다.

id

string (int64 format)

출력 전용입니다. 휴대기기 상수의 ID입니다.

name

string

출력 전용입니다. 휴대기기의 이름입니다.

manufacturerName

string

출력 전용입니다. 휴대기기의 제조업체입니다.

operatingSystemName

string

출력 전용입니다. 휴대기기의 운영체제입니다.

MobileDeviceType

휴대기기의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MOBILE 휴대전화
TABLET 태블릿.

OperatingSystemVersionConstant

operatorType에 따라 모바일 운영체제 버전 또는 다양한 버전 사용 가능한 모바일 플랫폼 목록은 https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms에서 확인할 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
입력란
resourceName

string

출력 전용입니다. 운영체제 버전 상수의 리소스 이름입니다. 운영체제 버전 상수 리소스 이름의 형식은 다음과 같습니다.

operatingSystemVersionConstants/{criterionId}

operatorType

enum (OperatingSystemVersionOperatorType)

출력 전용입니다. 이 상수가 단일 버전을 나타내는지 버전 범위를 나타내는지 여부를 결정합니다.

id

string (int64 format)

출력 전용입니다. 운영체제 버전의 ID입니다.

name

string

출력 전용입니다. 운영체제의 이름입니다.

osMajorVersion

integer

출력 전용입니다. OS 메이저 버전 번호입니다.

osMinorVersion

integer

출력 전용입니다. OS 마이너 버전 번호입니다.

OperatingSystemVersionOperatorType

운영체제 버전의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EQUALS_TO 지정된 버전과 동일합니다.
GREATER_THAN_EQUALS_TO 지정된 버전 이상입니다.

PaidOrganicSearchTermView

광고 및 자연 검색 결과 전반에 걸쳐 광고그룹 수준에서 검색어별로 집계된 검색 통계를 제공하는 유료 자연 검색어 보기입니다.

JSON 표현
{
  "resourceName": string,
  "searchTerm": string
}
입력란
resourceName

string

출력 전용입니다. 검색어 뷰의 리소스 이름입니다. 검색어 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/paidOrganicSearchTermViews/{campaignId}~ {adGroupId}~{URL-base64 search term}

searchTerm

string

출력 전용입니다. 검색어입니다.

QualifyingQuestion

리드 양식의 적격성 확인 질문

JSON 표현
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
입력란
resourceName

string

출력 전용입니다. 적격 질문의 리소스 이름입니다.

'qualifyingQuestions/{qualifyingQuestionId}'

qualifyingQuestionId

string (int64 format)

출력 전용입니다. 검증 질문의 ID입니다.

locale

string

출력 전용입니다. 적격성 확인을 위한 질문의 언어입니다.

text

string

출력 전용입니다. 검증 질문

ParentalStatusView

자녀 유무 보기

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 자녀 유무 보기의 리소스 이름입니다. 자녀 유무 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/parentalStatusViews/{adGroupId}~{criterionId}

PerStoreView

매장별 조회수 광고주에게 매장별 노출 도달범위와 오프라인 액션 전환 통계를 제공합니다.

JSON 표현
{
  "resourceName": string,
  "placeId": string
}
입력란
resourceName

string

출력 전용입니다. 매장별 보기의 리소스 이름입니다. 매장별 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/perStoreViews/{placeId}

placeId

string

출력 전용입니다. 매장별 보기의 장소 ID입니다.

ProductBiddingCategoryConstant

제품 입찰 카테고리.

JSON 표현
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
입력란
resourceName

string

출력 전용입니다. 제품 입찰 카테고리의 리소스 이름입니다. 제품 입찰 카테고리 리소스 이름의 형식은 다음과 같습니다.

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

출력 전용입니다. 제품 입찰 카테고리의 수준입니다.

status

enum (ProductBiddingCategoryStatus)

출력 전용입니다. 제품 입찰 카테고리의 상태입니다.

id

string (int64 format)

출력 전용입니다. 제품 입찰 카테고리의 ID입니다.

이 ID는 이 도움말(https://support.google.com/merchants/answer/6324436)에 설명된 google_product_category ID와 동일합니다.

countryCode

string

출력 전용입니다. 제품 입찰 카테고리의 2자리 대문자 국가 코드입니다.

productBiddingCategoryConstantParent

string

출력 전용입니다. 상위 제품 입찰 카테고리의 리소스 이름입니다.

languageCode

string

출력 전용입니다. 제품 입찰 카테고리의 언어 코드입니다.

localizedName

string

출력 전용입니다. languageCode에 따라 현지화된 제품 입찰 카테고리의 표시 값입니다.

ProductBiddingCategoryStatus

제품 입찰 카테고리의 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ACTIVE 카테고리가 활성 상태이며 입찰에 사용할 수 있습니다.
OBSOLETE 더 이상 사용되지 않는 카테고리입니다. 보고 목적으로만 사용됩니다.

ProductGroupView

제품 그룹 보기

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 제품 그룹 뷰의 리소스 이름입니다. 제품 그룹 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/productGroupViews/{adGroupId}~{criterionId}

추천

권장사항입니다.

JSON 표현
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
입력란
resourceName

string

변경할 수 없습니다. 추천의 리소스 이름입니다.

customers/{customerId}/recommendations/{recommendation_id}

type

enum (RecommendationType)

출력 전용입니다. 권장사항 유형

impact

object (RecommendationImpact)

출력 전용입니다. 추천 적용이 계정 실적에 미친 영향

campaigns[]

string

출력 전용입니다. 이 추천의 타겟팅 캠페인입니다.

이 필드는 CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET 추천 유형에 대해 설정됩니다.

campaignBudget

string

출력 전용입니다. 이 추천에서 타겟팅하는 예산입니다. 추천이 단일 캠페인 예산에 영향을 미치는 경우에만 설정됩니다.

이 필드는 CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET 추천 유형에 대해 설정됩니다.

campaign

string

출력 전용입니다. 이 추천의 타겟팅 캠페인입니다.

이 필드는 CALL_EXTENSION_TARGET_PRODUCT_TARGET_AGE_CAMPAIGN, CALLOUT_EXTENSION, CONHANCE_EXTENSION_TARGET_AGE_TARGETING, ROP_TARGET_TARGET_ADDING, ROP_TARGET_PRODUCT_ADDING, CONHANCE_PRODUCT_ADDING , CONOPSH_TARGET_AGE_SIZE , CONOPSH_TARGET_AGE_AGE_BREAK 추천 유형 추천 유형: CALL_EXTENSION, CALLOUT_PRODUCT_ADDING, RAN

adGroup

string

출력 전용입니다. 이 추천으로 타겟팅하는 광고그룹입니다. 이 추천은 단일 광고 그룹에 영향을 미치는 경우에만 설정됩니다.

이 필드는 KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD 추천 유형에 대해 설정됩니다.

dismissed

boolean

출력 전용입니다. 추천을 닫았는지 여부입니다.

통합 필드 recommendation. 추천 세부정보입니다. recommendation은 다음 중 하나여야 합니다.
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

출력 전용입니다. 캠페인 예산 추천입니다.

forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

출력 전용입니다. 예측 캠페인 예산 추천

keywordRecommendation

object (KeywordRecommendation)

출력 전용입니다. 추천 키워드입니다.

textAdRecommendation

object (TextAdRecommendation)

출력 전용입니다. 확장 텍스트 광고 추천을 추가하세요.

targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

출력 전용입니다. 타겟 CPA 선택 추천

maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

출력 전용입니다. 전환수 최대화 사용 설정 추천

enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

출력 전용입니다. 향상된 클릭당비용 선택 추천

searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

출력 전용입니다. 검색 파트너 선택 추천입니다.

maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

출력 전용입니다. MaxClicks 선택 추천

optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

출력 전용입니다. 광고 로테이션 최적화 추천

keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

출력 전용입니다. 키워드 검색 유형 추천입니다.

moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

출력 전용입니다. 사용하지 않는 이동 예산 추천입니다.

targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

출력 전용입니다. 타겟 광고 투자수익(ROAS) 선택 추천

responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

출력 전용입니다. 반응형 검색 광고 추가 추천

marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

출력 전용입니다. 한계 ROI 캠페인 예산 추천입니다.

useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

출력 전용입니다. 확장검색 키워드 추천 사용

responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

출력 전용입니다. 반응형 검색 광고 확장 소재 추천입니다.

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

출력 전용입니다. 스마트 쇼핑 캠페인을 실적 최대화 캠페인 추천으로 업그레이드

responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

출력 전용입니다. 반응형 검색 광고는 광고 효력 추천을 개선합니다.

displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

출력 전용입니다. 디스플레이 네트워크 추가 사용 설정 추천

upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

출력 전용입니다. 지역 캠페인을 실적 최대화 캠페인 추천으로 업그레이드합니다.

raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

출력 전용입니다. 타겟 CPA 입찰가 증액 추천이 너무 낮습니다.

forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

출력 전용입니다. 예측 시 타겟 광고 투자수익(ROAS) 추천 설정

calloutAssetRecommendation

object (CalloutAssetRecommendation)

출력 전용입니다. 콜아웃 확장 소재 추천입니다.

callAssetRecommendation

object (CallAssetRecommendation)

출력 전용입니다. 추천 전화번호 확장 소재입니다.

shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용입니다. 쇼핑 추가 연령대 추천

shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용입니다. 쇼핑 광고 추가 색상 권장사항

shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용입니다. 쇼핑 추가 성별 추천

shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용입니다. 쇼핑 추가 GTIN 추천

shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용입니다. 쇼핑 시 식별자 추가 권장사항

shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용입니다. 쇼핑 광고 크기 권장사항

shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

출력 전용입니다. 쇼핑 캠페인이 캠페인 추천에 제품을 추가합니다.

shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

출력 전용입니다. 쇼핑 수정 비승인 제품 추천입니다.

shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

출력 전용입니다. 쇼핑 타겟은 모든 추천을 제공합니다.

shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

출력 전용입니다. 쇼핑 수정으로 인해 판매자 센터 계정 추천이 정지되었습니다.

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

출력 전용입니다. 쇼핑 수정사항 판매자 센터 계정 정지 경고 추천입니다.

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

출력 전용입니다. 쇼핑 캠페인이 일반 쇼핑 캠페인 혜택을 실적 최대화 캠페인 추천으로 이전했습니다.

dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

출력 전용입니다. Google이 광고 방문 페이지에서 최적의 이미지를 찾아 텍스트 광고를 보완할 수 있도록 계정에 동적 이미지 광고 확장을 사용 설정하라는 추천입니다.

raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

출력 전용입니다. 타겟 CPA를 높이라는 추천입니다.

lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

출력 전용입니다. 타겟 광고 투자수익(ROAS)을 낮추라는 추천입니다.

performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

출력 전용입니다. 실적 최대화 캠페인 선택 추천

improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

출력 전용입니다. 실적 최대화 캠페인의 광고 효력 개선 추천

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

출력 전용입니다. 동적 검색 광고에서 실적 최대화 캠페인으로의 이전 추천

RecommendationType

추천 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CAMPAIGN_BUDGET 현재 예산 제약이 있는 캠페인에 대한 예산 추천 (향후 예산 제약이 예상되는 캠페인에 적용되는 FORECASTING_CAMPAIGN_BUDGET 추천과 반대)
KEYWORD 키워드 추천
TEXT_AD 새 텍스트 광고를 추가하라는 추천사항입니다.
TARGET_CPA_OPT_IN 타겟 CPA 입찰 전략을 사용하도록 캠페인을 업데이트하라는 추천입니다.
MAXIMIZE_CONVERSIONS_OPT_IN 전환수 최대화 입찰 전략을 사용하도록 캠페인을 업데이트하라는 추천입니다.
ENHANCED_CPC_OPT_IN 캠페인에서 향상된 클릭당비용을 사용 설정하기 위한 추천입니다.
SEARCH_PARTNERS_OPT_IN Google 검색 파트너 웹사이트에 캠페인 광고 게재를 시작하라는 추천입니다.
MAXIMIZE_CLICKS_OPT_IN 클릭수 최대화 입찰 전략을 사용하도록 캠페인을 업데이트하라는 추천입니다.
OPTIMIZE_AD_ROTATION 특정 광고그룹에 '최적화' 광고 로테이션 설정을 사용하라는 추천입니다.
KEYWORD_MATCH_TYPE 기존 키워드를 한 가지 검색 유형에서 더 넓은 검색 유형으로 변경하라는 추천입니다.
MOVE_UNUSED_BUDGET 미사용 예산을 한 예산에서 제한된 예산으로 옮기는 것을 추천합니다.
FORECASTING_CAMPAIGN_BUDGET 향후 예산 제약이 예상되는 캠페인에 대한 예산 추천 (현재 예산이 제한된 캠페인에 적용되는 CAMPAIGN_BUDGET 추천과 반대)
TARGET_ROAS_OPT_IN 타겟 광고 투자수익(ROAS) 입찰 전략을 사용하도록 캠페인을 업데이트하라는 추천입니다.
RESPONSIVE_SEARCH_AD 새 반응형 검색 광고를 추가하라는 추천입니다.
MARGINAL_ROI_CAMPAIGN_BUDGET 예산을 조정하여 ROI가 증가할 것으로 예상되는 캠페인에 대한 예산 추천입니다.
USE_BROAD_MATCH_KEYWORD 완전히 자동화된 전환 기반 입찰 캠페인을 위해 확장검색 버전의 키워드를 추가할 것을 권장하는 추천입니다.
RESPONSIVE_SEARCH_AD_ASSET 새 반응형 검색 광고 확장 소재를 추가하라는 추천입니다.
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX 스마트 쇼핑 캠페인을 실적 최대화 캠페인으로 업그레이드하라는 추천입니다.
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH 반응형 검색 광고의 효력을 개선하기 위한 권장사항입니다.
DISPLAY_EXPANSION_OPT_IN 디스플레이 네트워크 추가를 사용하도록 캠페인을 업데이트하라는 추천입니다.
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX 지역 캠페인을 실적 최대화 캠페인으로 업그레이드하라는 추천입니다.
RAISE_TARGET_CPA_BID_TOO_LOW 타겟 CPA가 너무 낮고 전환이 적거나 아예 없는 경우 타겟 CPA를 높이라는 것이 좋습니다. 비동기적으로 적용되며 관련 캠페인에 있는 광고그룹 수에 따라 몇 분 정도 걸릴 수 있습니다.
FORECASTING_SET_TARGET_ROAS 트래픽 증가가 예상되는 시즌 이벤트에 앞서 예산을 증액하고 입찰 전략을 전환 가치 극대화에서 타겟 ROAS로 변경하라는 추천입니다.
CALLOUT_ASSET 캠페인 또는 고객 수준에 콜아웃 확장 소재를 추가하라는 추천입니다.
CALL_ASSET 캠페인 또는 고객 수준에 전화번호 확장 소재를 추가하라는 추천입니다.
SHOPPING_ADD_AGE_GROUP 연령대 누락으로 인해 순위가 낮아진 제품에 연령대 속성을 추가하는 것이 좋습니다.
SHOPPING_ADD_COLOR 색상 누락으로 인해 순위가 낮아진 상품에 색상을 추가하는 것이 좋습니다.
SHOPPING_ADD_GENDER 성별 누락으로 인해 순위가 낮아진 제품에 성별을 추가하는 것이 좋습니다.
SHOPPING_ADD_GTIN GTIN 누락으로 인해 순위가 낮아진 제품에 GTIN (국제거래단품식별코드)을 추가하는 것이 좋습니다.
SHOPPING_ADD_MORE_IDENTIFIERS 식별자 누락으로 인해 순위가 낮아진 상품에 식별자를 더 추가하는 것이 좋습니다.
SHOPPING_ADD_SIZE 사이즈 누락으로 인해 순위가 낮아진 상품에 사이즈를 추가하는 것이 좋습니다.
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN 타겟팅 중인 제품이 없어 게재할 수 없는 캠페인에 대해 고객에게 알리는 추천입니다.
SHOPPING_FIX_DISAPPROVED_PRODUCTS 비승인 제품의 비율이 높은 캠페인에 대해 고객에게 알리는 쇼핑 추천
SHOPPING_TARGET_ALL_OFFERS 모든 혜택을 타겟팅하는 포괄적인 캠페인을 만들라는 추천입니다.
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT 판매자 센터 계정 정지 문제를 해결하기 위한 추천입니다.
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING 판매자 센터 계정 정지 경고 문제를 해결하기 위한 추천입니다.
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX 일반 쇼핑 캠페인에서 타겟팅하는 제품을 기존 실적 최대화 캠페인으로 이전하라는 추천입니다.
DYNAMIC_IMAGE_EXTENSION_OPT_IN Google이 광고 방문 페이지에서 최적의 이미지를 찾아 텍스트 광고를 보완할 수 있도록 계정에 동적 이미지 광고 확장을 사용 설정하라는 추천입니다.
RAISE_TARGET_CPA 과거 전환을 토대로 모델링한 Google 예측을 기반으로 타겟 CPA를 높이라는 추천입니다. 비동기적으로 적용되며 관련 캠페인에 있는 광고그룹 수에 따라 몇 분 정도 걸릴 수 있습니다.
LOWER_TARGET_ROAS 타겟 광고 투자수익(ROAS)을 낮추라는 추천입니다.
PERFORMANCE_MAX_OPT_IN 실적 최대화 캠페인을 사용하라는 추천입니다.
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH 실적 최대화 캠페인의 애셋 그룹 효력을 '매우 좋음' 등급으로 개선하라는 추천입니다.
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX 동적 검색 광고를 실적 최대화 캠페인으로 이전하라는 추천입니다.

RecommendationImpact

권장사항에 설명된 변경의 영향입니다. 일부 추천 유형은 영향 정보가 없을 수도 있습니다.

JSON 표현
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
입력란
baseMetrics

object (RecommendationMetrics)

출력 전용입니다. 추천이 생성된 시점의 기본 측정항목입니다.

potentialMetrics

object (RecommendationMetrics)

출력 전용입니다. 추천을 적용한 경우의 예상 측정항목입니다.

RecommendationMetrics

주별 계정 실적 측정항목 일부 추천 유형의 경우 지난 90일 동안의 평균이 계산되므로 결과가 소수일 수 있습니다.

JSON 표현
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "videoViews": number
}
입력란
impressions

number

출력 전용입니다. 광고 노출수입니다.

clicks

number

출력 전용입니다. 광고 클릭수입니다.

costMicros

string (int64 format)

출력 전용입니다. 계정의 현지 통화로 표시되는 광고 비용 (마이크로 단위)입니다.

conversions

number

출력 전용입니다. 전환수입니다.

videoViews

number

출력 전용입니다. 동영상 광고 캠페인의 동영상 조회수입니다.

CampaignBudgetRecommendation

예산이 제한된 캠페인에 대한 예산 추천입니다.

JSON 표현
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
입력란
budgetOptions[]

object (CampaignBudgetRecommendationOption)

출력 전용입니다. 가능한 예산 금액의 일부 값에 대한 예산 금액 및 관련 예상 효과입니다.

currentBudgetAmountMicros

string (int64 format)

출력 전용입니다. 마이크로 단위의 현재 예산 금액입니다.

recommendedBudgetAmountMicros

string (int64 format)

출력 전용입니다. 마이크로 단위의 권장 예산 금액입니다.

CampaignBudgetRecommendationOption

주어진 예산 금액에 대한 예상 효과입니다.

JSON 표현
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
입력란
impact

object (RecommendationImpact)

출력 전용입니다. 예산을 이 옵션에 지정된 금액으로 변경할 경우 예상되는 영향입니다.

budgetAmountMicros

string (int64 format)

출력 전용입니다. 이 옵션에 대한 예산 금액입니다.

KeywordRecommendation

추천 키워드입니다.

JSON 표현
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
입력란
keyword

object (KeywordInfo)

출력 전용입니다. 추천 키워드입니다.

searchTerms[]

object (SearchTerm)

출력 전용입니다. 이 키워드와 일치하는 검색어의 목록입니다. 여러 키워드에 대해 동일한 검색어가 반복될 수 있습니다.

recommendedCpcBidMicros

string (int64 format)

출력 전용입니다. 권장 CPC (클릭당비용) 입찰가입니다.

SearchTerm

키워드 추천과 관련된 검색어에 대한 정보입니다.

JSON 표현
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
입력란
text

string

출력 전용입니다. 검색어의 텍스트입니다.

estimatedWeeklySearchCount

string (int64 format)

출력 전용입니다. 이 검색어에 대한 주간 예상 이전 검색량입니다.

TextAdRecommendation

텍스트 광고 추천입니다.

JSON 표현
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
입력란
ad

object (Ad)

출력 전용입니다. 추천 광고입니다.

creationDate

string

출력 전용입니다. 추천 광고의 생성 날짜입니다. YYYY-MM-DD 형식(예: 2018-04-17)입니다.

autoApplyDate

string

출력 전용입니다. 날짜는 추천이 자동 적용되는 가장 빠른 날짜입니다(있는 경우). YYYY-MM-DD 형식(예: 2018-04-17)입니다.

TargetCpaOptInRecommendation

타겟 CPA 선택 추천

JSON 표현
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
입력란
options[]

object (TargetCpaOptInRecommendationOption)

출력 전용입니다. 타겟 CPA 전략에 사용 가능한 목표 및 해당 옵션

recommendedTargetCpaMicros

string (int64 format)

출력 전용입니다. 권장되는 평균 CPA 타겟입니다. 필요한 예산 금액과 이 추천을 사용할 때의 영향은 옵션 목록에서 확인하세요.

TargetCpaOptInRecommendationOption

예상 효과가 표시된 타겟 CPA 선택 옵션

JSON 표현
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
입력란
goal

enum (TargetCpaOptInRecommendationGoal)

출력 전용입니다. 이 옵션으로 달성한 목표입니다.

impact

object (RecommendationImpact)

출력 전용입니다. 이 옵션을 선택한 경우의 영향 추정치입니다.

targetCpaMicros

string (int64 format)

출력 전용입니다. 평균 CPA 타겟입니다.

requiredCampaignBudgetAmountMicros

string (int64 format)

출력 전용입니다. 타겟 CPA를 달성하는 데 필요한 최소 캠페인 예산(현지 통화 기준)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다.

TargetCpaOptInRecommendationGoal

TargetCpaOptIn 추천의 목표

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SAME_COST 동일한 비용을 유지하기 위해 타겟 CPA를 설정하는 것이 좋습니다.
SAME_CONVERSIONS 전환수를 동일하게 유지하기 위해 타겟 CPA를 설정하라는 추천입니다.
SAME_CPA CPA를 동일하게 유지하도록 타겟 CPA를 설정하라는 추천사항입니다.
CLOSEST_CPA 타겟 CPA를 실제 CPA (지난 28일 동안 계산됨)에 최대한 가깝지만 이보다 낮은 값으로 설정하라는 권장사항입니다.

MaximizeConversionsOptInRecommendation

전환수 최대화 사용 설정 추천

JSON 표현
{
  "recommendedBudgetAmountMicros": string
}
입력란
recommendedBudgetAmountMicros

string (int64 format)

출력 전용입니다. 권장 새 예산 금액입니다.

EnhancedCpcOptInRecommendation

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

향상된 클릭당비용 선택 추천

SearchPartnersOptInRecommendation

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

검색 파트너 선택 추천입니다.

MaximizeClicksOptInRecommendation

클릭수 최대화 사용 설정 추천

JSON 표현
{
  "recommendedBudgetAmountMicros": string
}
입력란
recommendedBudgetAmountMicros

string (int64 format)

출력 전용입니다. 권장 새 예산 금액입니다. 현재 예산이 너무 높은 경우에만 설정합니다.

OptimizeAdRotationRecommendation

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

광고 로테이션 최적화 추천

KeywordMatchTypeRecommendation

키워드 검색 유형 추천입니다.

JSON 표현
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
입력란
keyword

object (KeywordInfo)

출력 전용입니다. 검색 유형이 더 광범위해야 하는 기존 키워드입니다.

recommendedMatchType

enum (KeywordMatchType)

출력 전용입니다. 권장되는 새 검색 유형입니다.

MoveUnusedBudgetRecommendation

사용하지 않는 이동 예산 추천입니다.

JSON 표현
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
입력란
budgetRecommendation

object (CampaignBudgetRecommendation)

출력 전용입니다. 제한된 예산을 증액하기 위한 추천입니다.

excessCampaignBudget

string

출력 전용입니다. 초과 예산의 resourceName입니다.

TargetRoasOptInRecommendation

타겟 광고 투자수익(ROAS) 선택 추천

JSON 표현
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
입력란
recommendedTargetRoas

number

출력 전용입니다. 권장 타겟 ROAS (지출 단위당 수익)입니다. 값은 0.01 이상 1000.0 이하입니다.

requiredCampaignBudgetAmountMicros

string (int64 format)

출력 전용입니다. 타겟 광고 투자수익(ROAS)을 달성하는 데 필요한 계정의 현지 통화로 표시되는 최소 캠페인 예산입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다.

ResponsiveSearchAdRecommendation

반응형 검색 광고 추가 추천

JSON 표현
{
  "ad": {
    object (Ad)
  }
}
입력란
ad

object (Ad)

출력 전용입니다. 추천 광고입니다.

UseBroadMatchKeywordRecommendation

확장검색 키워드 추천 사용

JSON 표현
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
입력란
keyword[]

object (KeywordInfo)

출력 전용입니다. 확장검색으로 확장할 키워드 샘플입니다.

suggestedKeywordsCount

string (int64 format)

출력 전용입니다. 캠페인에서 확장검색으로 확장할 총 키워드 수입니다.

campaignKeywordsCount

string (int64 format)

출력 전용입니다. 캠페인에 있는 총 키워드 수입니다.

campaignUsesSharedBudget

boolean

출력 전용입니다. 연결된 캠페인이 공유 예산을 사용하는지 여부입니다.

requiredCampaignBudgetAmountMicros

string (int64 format)

출력 전용입니다. 추천을 적용한 후 예산 제약 상태가 되지 않도록 권장 예산입니다.

ResponsiveSearchAdAssetRecommendation

반응형 검색 광고 확장 소재 추가 추천

JSON 표현
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
입력란
currentAd

object (Ad)

출력 전용입니다. 업데이트할 현재 광고입니다.

recommendedAssets

object (Ad)

출력 전용입니다. 추천 애셋입니다. 이 입력란은 새 광고 제목 및 설명으로만 채워지며 그 외의 경우에는 비어 있습니다.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

스마트 쇼핑 캠페인을 실적 최대화 캠페인 추천으로 업그레이드

JSON 표현
{
  "merchantId": string,
  "salesCountryCode": string
}
입력란
merchantId

string (int64 format)

출력 전용입니다. 판매자 센터 계정의 ID입니다.

salesCountryCode

string

출력 전용입니다. 판매자 인벤토리의 제품을 포함해야 하는 국가입니다.

ResponsiveSearchAdImproveAdStrengthRecommendation

반응형 검색 광고는 광고 효력 추천을 개선합니다.

JSON 표현
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
입력란
currentAd

object (Ad)

출력 전용입니다. 업데이트할 현재 광고입니다.

recommendedAd

object (Ad)

출력 전용입니다. 업데이트된 광고

DisplayExpansionOptInRecommendation

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

디스플레이 네트워크 추가 사용 설정 추천

UpgradeLocalCampaignToPerformanceMaxRecommendation

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

지역 캠페인을 실적 최대화 캠페인으로 업그레이드 추천

RaiseTargetCpaBidTooLowRecommendation

타겟 CPA 입찰가 증액 추천이 너무 낮습니다.

JSON 표현
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
입력란
recommendedTargetMultiplier

number

출력 전용입니다. 1.0보다 큰 숫자는 타겟 CPA의 증액 권장 수준을 나타냅니다.

averageTargetCpaMicros

string (int64 format)

출력 전용입니다. 캠페인의 현재 평균 타겟 CPA로, 고객 현지 통화의 마이크로(micro)입니다.

ForecastingSetTargetRoasRecommendation

예측 시 타겟 광고 투자수익(ROAS) 추천 설정

JSON 표현
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
입력란
recommendedTargetRoas

number

출력 전용입니다. 권장 타겟 ROAS (지출 단위당 수익)입니다. 값은 0.01 이상 1000.0 이하입니다.

campaignBudget

object (CampaignBudget)

출력 전용입니다. 캠페인 예산입니다.

CampaignBudget

다양한 예산 추천 유형에서 캠페인 예산이 공유됨

JSON 표현
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
입력란
currentAmountMicros

string (int64 format)

출력 전용입니다. 현재 예산 금액입니다.

recommendedNewAmountMicros

string (int64 format)

출력 전용입니다. 권장 예산 금액입니다.

newStartDate

string

출력 전용입니다. 새 예산이 사용되기 시작하는 날짜입니다. 이 필드는 FORECASTING_SET_TARGET_ROAS YYYY-MM-DD 형식(예: 2018-04-17) 추천 유형에 설정됩니다.

CalloutAssetRecommendation

콜아웃 확장 소재 추천입니다.

JSON 표현
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
입력란
recommendedCampaignCalloutAssets[]

object (Asset)

출력 전용입니다. 캠페인 수준에서 새 콜아웃 광고 확장 확장 소재가 추천되었습니다.

recommendedCustomerCalloutAssets[]

object (Asset)

출력 전용입니다. 고객 수준에서 권장되는 새 콜아웃 광고 확장 확장 소재입니다.

SitelinkAssetRecommendation

사이트링크 확장 소재 추천입니다.

JSON 표현
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
입력란

CallAssetRecommendation

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

추천 전화번호 확장 소재입니다.

ShoppingOfferAttributeRecommendation

속성이 누락되어 순위가 낮아진 제품에 속성을 추가하라는 쇼핑 추천입니다.

JSON 표현
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
입력란
merchant

object (MerchantInfo)

출력 전용입니다. 판매자 센터 계정의 세부정보입니다.

feedLabel

string

출력 전용입니다. 캠페인 피드 라벨입니다.

offersCount

string (int64 format)

출력 전용입니다. 게재 가능한 온라인 상품 수입니다.

demotedOffersCount

string (int64 format)

출력 전용입니다. 누락된 속성으로 인해 순위가 낮아지고 게재 가능한 온라인 상품의 수입니다. 자세한 내용은 판매자 센터를 방문하세요.

MerchantInfo

판매자 센터 계정 세부정보입니다.

JSON 표현
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
입력란
id

string (int64 format)

출력 전용입니다. 판매자 센터 계정 ID입니다.

name

string

출력 전용입니다. 판매자 센터 계정의 이름입니다.

multiClient

boolean

출력 전용입니다. 판매자 센터 계정이 멀티 클라이언트 계정 (MCA)인지 여부

ShoppingAddProductsToCampaignRecommendation

쇼핑 캠페인 인벤토리에 제품을 추가하기 위한 쇼핑 추천입니다.

JSON 표현
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
입력란
merchant

object (MerchantInfo)

출력 전용입니다. 판매자 센터 계정의 세부정보입니다.

feedLabel

string

출력 전용입니다. 캠페인의 피드 라벨입니다.

reason

enum (Reason)

출력 전용입니다. 캠페인에 연결된 제품이 없는 이유입니다.

이유

쇼핑 캠페인에서 제품 0개를 타겟팅하게 하는 문제

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS 판매자 센터 계정에 제출된 제품이 없습니다.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED 판매자 센터 계정의 피드에 제출된 제품이 없습니다.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN Google Ads 계정에 제품이 포함되지 않도록 하는 활성 캠페인 필터가 있습니다.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN 사용 가능한 모든 제품이 캠페인의 타겟팅 대상에서 명시적으로 제외되었습니다.

ShoppingFixDisapprovedProductsRecommendation

쇼핑 캠페인 인벤토리에서 비승인된 제품을 수정하기 위한 쇼핑 추천입니다.

JSON 표현
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
입력란
merchant

object (MerchantInfo)

출력 전용입니다. 판매자 센터 계정의 세부정보입니다.

feedLabel

string

출력 전용입니다. 캠페인의 피드 라벨입니다.

productsCount

string (int64 format)

출력 전용입니다. 캠페인의 제품 수입니다.

disapprovedProductsCount

string (int64 format)

출력 전용입니다. 비승인된 캠페인의 제품 수입니다.

ShoppingTargetAllOffersRecommendation

모든 혜택을 타겟팅하는 포괄적 캠페인을 만들기 위한 쇼핑 추천

JSON 표현
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
입력란
merchant

object (MerchantInfo)

출력 전용입니다. 판매자 센터 계정의 세부정보입니다.

untargetedOffersCount

string (int64 format)

출력 전용입니다. 타겟팅되지 않은 제품의 수입니다.

feedLabel

string

출력 전용입니다. 쿠폰 피드 라벨입니다.

ShoppingMerchantCenterAccountSuspensionRecommendation

판매자 센터 계정 정지 문제를 해결하기 위한 쇼핑 추천입니다.

JSON 표현
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
입력란
merchant

object (MerchantInfo)

출력 전용입니다. 판매자 센터 계정의 세부정보입니다.

feedLabel

string

출력 전용입니다. 정지된 캠페인의 피드 라벨입니다.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

일반 쇼핑 캠페인 타겟팅 혜택을 실적 최대화 캠페인으로 이전하라는 쇼핑 추천입니다.

JSON 표현
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
입력란
merchant

object (MerchantInfo)

출력 전용입니다. 판매자 센터 계정의 세부정보입니다.

feedLabel

string

출력 전용입니다. 이 추천을 공유하는 캠페인에서 타겟팅하는 상품의 피드 라벨입니다.

DynamicImageExtensionOptInRecommendation

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

Google이 광고 방문 페이지에서 최적의 이미지를 찾아 텍스트 광고를 보완할 수 있도록 계정에 동적 이미지 광고 확장을 사용 설정하라는 추천입니다.

RaiseTargetCpaRecommendation

타겟 CPA를 높이라는 추천입니다.

JSON 표현
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
입력란
targetAdjustment

object (TargetAdjustmentInfo)

출력 전용입니다. 권장 타겟 조정을 설명하는 관련 정보입니다.

appBiddingGoal

enum (AppBiddingGoal)

출력 전용입니다. 입찰 전략에서 최적화해야 하는 목표를 나타냅니다. 앱 캠페인에만 채워집니다.

TargetAdjustmentInfo

타겟 조정 추천에 대한 정보입니다.

JSON 표현
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
입력란
recommendedTargetMultiplier

number

출력 전용입니다. 타겟의 조정을 권장한 값입니다.

currentAverageTargetMicros

string (int64 format)

출력 전용입니다. 이 추천으로 타겟팅된 캠페인 또는 포트폴리오의 현재 평균 타겟입니다.

sharedSet

string

출력 전용입니다. 타겟이 정의된 포트폴리오 입찰 전략의 공유 조합 리소스 이름입니다. 추천이 포트폴리오 수준인 경우에만 채워집니다.

AppBiddingGoal

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

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전의 API에서 알 수 없는 값을 나타냅니다.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME 앱 캠페인의 입찰 전략은 앱 설치수를 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME 앱 캠페인의 입찰 전략은 선택한 인앱 전환수 최대화를 목표로 해야 합니다.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE 앱 캠페인의 입찰 전략은 모든 전환 가치, 즉 설치 및 선택된 인앱 전환의 가치를 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION 앱 캠페인의 입찰 전략은 타겟 인앱 전환당비용을 달성하거나 초과 달성하면서 선택한 인앱 전환수만 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND 앱 캠페인의 입찰 전략은 타겟 광고 투자수익(ROAS)을 달성하거나 초과 달성하면서 모든 전환 가치, 즉 설치 및 선택된 인앱 전환을 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI 이 앱 캠페인 입찰 전략은 광고주가 제공한 타겟 설치당비용(CPI) 없이 앱 설치를 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME 앱 캠페인에서 이 입찰 전략은 앱의 사전 등록을 극대화하는 것을 목표로 해야 합니다.

LowerTargetRoasRecommendation

타겟 광고 투자수익(ROAS)을 낮추라는 추천입니다.

JSON 표현
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
입력란
targetAdjustment

object (TargetAdjustmentInfo)

출력 전용입니다. 권장 타겟 조정을 설명하는 관련 정보입니다.

PerformanceMaxOptInRecommendation

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

실적 최대화 캠페인 선택 추천

ImprovePerformanceMaxAdStrengthRecommendation

실적 최대화 캠페인의 애셋 그룹 효력을 '매우 좋음' 등급으로 개선하라는 추천입니다.

JSON 표현
{
  "assetGroup": string
}
입력란
assetGroup

string

출력 전용입니다. 애셋 그룹 리소스 이름입니다.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

동적 검색 광고에서 실적 최대화 캠페인으로의 이전 추천

JSON 표현
{
  "applyLink": string
}
입력란

SearchTermView

광고그룹 수준에서 검색어별로 집계된 측정항목이 표시되는 검색어 보기

JSON 표현
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
입력란
resourceName

string

출력 전용입니다. 검색어 뷰의 리소스 이름입니다. 검색어 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}

status

enum (SearchTermTargetingStatus)

출력 전용입니다. 검색어가 현재 타겟팅된 키워드인지 아니면 제외된 키워드인지를 나타냅니다.

searchTerm

string

출력 전용입니다. 검색어입니다.

adGroup

string

출력 전용입니다. 검색어가 게재된 광고그룹입니다.

SearchTermTargetingStatus

검색어가 타겟팅된 키워드인지 아니면 제외된 키워드인지를 나타냅니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ADDED 검색어가 타겟팅된 키워드에 추가됩니다.
EXCLUDED 검색어가 제외 키워드와 일치합니다.
ADDED_EXCLUDED 검색어가 추가되고 제외되었습니다.
NONE 검색어가 타겟팅되거나 제외되지 않았습니다.

ShoppingPerformanceView

쇼핑 실적 보기 여러 제품 측정기준 수준에서 집계된 쇼핑 캠페인 통계를 제공합니다. 브랜드, 카테고리, 맞춤 속성, 제품 상태, 제품 유형 등 판매자 센터의 제품 측정기준 값에는 해당 이벤트가 기록된 날짜 및 시간을 기준으로 각 측정기준의 상태가 반영됩니다.

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 쇼핑 실적 뷰의 리소스 이름입니다. 쇼핑 실적 보기 리소스 이름의 형식은 customers/{customerId}/shoppingPerformanceView입니다.

SmartCampaignSearchTermView

스마트 캠페인 검색어 보기

JSON 표현
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
입력란
resourceName

string

출력 전용입니다. 스마트 캠페인 검색어 뷰의 리소스 이름입니다. 스마트 캠페인 검색어 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}

searchTerm

string

출력 전용입니다. 검색어입니다.

campaign

string

출력 전용입니다. 검색어가 게재된 스마트 캠페인입니다.

TopicView

주제 뷰

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 주제 뷰의 리소스 이름입니다. 주제 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/topicViews/{adGroupId}~{criterionId}

TravelActivityGroupView

여행 활동 그룹 뷰

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 여행 활동 그룹 뷰의 리소스 이름입니다. 여행 활동 그룹 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/travelActivityGroupViews/{adGroupId}~{criterionId}

TravelActivityPerformanceView

여행 활동 실적 뷰

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 여행 활동 실적 뷰의 리소스 이름입니다. 여행 활동 실적 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/travelActivityPerformanceView

UserInterest

사용자 관심분야: 타겟팅할 특정 관심기반 분야입니다.

JSON 표현
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
입력란
resourceName

string

출력 전용입니다. 사용자 관심분야의 리소스 이름입니다. 사용자 관심분야 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/userInterests/{userInterestId}

taxonomyType

enum (UserInterestTaxonomyType)

출력 전용입니다. 사용자 관심분야의 분류 유형입니다.

availabilities[]

object (CriterionCategoryAvailability)

출력 전용입니다. 사용자 관심분야의 사용 가능 여부 정보입니다.

userInterestId

string (int64 format)

출력 전용입니다. 사용자 관심분야의 ID입니다.

name

string

출력 전용입니다. 사용자 관심분야의 이름입니다.

userInterestParent

string

출력 전용입니다. 사용자 관심분야의 상위 항목입니다.

launchedToAll

boolean

출력 전용입니다. 사용자 관심분야가 모든 채널 및 언어로 시작되면 참입니다.

UserInterestTaxonomyType

가능한 UserInterestTaxonomyTypes를 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AFFINITY 이 사용자 관심분야에 대한 관심분야입니다.
IN_MARKET 이 사용자 관심분야에 해당하는 시장입니다.
MOBILE_APP_INSTALL_USER 지정된 카테고리의 애플리케이션을 설치한 것으로 알려진 사용자입니다.
VERTICAL_GEO 관심 기반 카테고리의 지리적 위치입니다.
NEW_SMART_PHONE_USER 신규 스마트폰 사용자에 대한 사용자 관심분야 기준입니다.

LifeEvent

생애 주요 이벤트: 인생의 중요한 순간에 있는 사용자에게 도달하기 위해 타겟팅하는 특정 관심기반 카테고리입니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
입력란
resourceName

string

출력 전용입니다. 생애 주요 이벤트의 리소스 이름입니다. 생애 주요 이벤트 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/lifeEvents/{lifeEventId}

id

string (int64 format)

출력 전용입니다. 생애 주요 이벤트의 ID입니다.

name

string

출력 전용입니다. 생애 주요 이벤트의 이름(예: '최근 이사')

parent

string

출력 전용입니다. LifeEvent의 상위입니다.

launchedToAll

boolean

출력 전용입니다. 생애 주요 이벤트가 모든 채널 및 언어로 시작되는 경우 true입니다.

availabilities[]

object (CriterionCategoryAvailability)

출력 전용입니다. 생애 주요 이벤트의 사용 가능 여부 정보입니다.

UserLocationView

사용자 위치 뷰

사용자 위치 보기에는 국가당 한 열씩, 국가 수준에서 집계된 모든 측정항목이 포함됩니다. 타겟 지역 또는 타겟팅되지 않은 위치별로 사용자의 실제 물리적 위치에 대한 측정항목을 보고합니다. 다른 분류 기준 필드가 사용되는 경우 국가당 두 개 이상의 행이 표시될 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
입력란
resourceName

string

출력 전용입니다. 사용자 위치 뷰의 리소스 이름입니다. UserLocation 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

출력 전용입니다. 국가의 기준 ID입니다.

targetingLocation

boolean

출력 전용입니다. 위치가 타겟팅되었는지 여부를 나타냅니다.

TopicConstant

주제를 사용하여 게재위치가 속한 카테고리 (예: '애완동물 및 동물/애완동물/개')를 기준으로 Google 디스플레이 네트워크의 게재위치를 타겟팅하거나 제외할 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
입력란
resourceName

string

출력 전용입니다. 주제 상수의 리소스 이름입니다. 주제 상수 리소스 이름의 형식은 다음과 같습니다.

topicConstants/{topic_id}

path[]

string

출력 전용입니다. 타겟팅하거나 제외할 카테고리입니다. 배열의 각 후속 요소는 보다 구체적인 하위 카테고리를 설명합니다. 예를 들어 {"Pets & Animals", "Pets", "Dogs"} 는 "애완동물 및 동물/애완동물/개" 카테고리를 나타냅니다. 사용 가능한 주제 카테고리 목록: https://developers.google.com/google-ads/api/reference/data/verticals

id

string (int64 format)

출력 전용입니다. 주제의 ID입니다.

topicConstantParent

string

출력 전용입니다. 주제 상수의 상위 요소의 리소스 이름입니다.

동영상

동영상

JSON 표현
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
입력란
resourceName

string

출력 전용입니다. 동영상의 리소스 이름입니다. 동영상 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/videos/{videoId}

id

string

출력 전용입니다. 동영상의 ID입니다.

channelId

string

출력 전용입니다. 동영상의 소유자 채널 ID입니다.

durationMillis

string (int64 format)

출력 전용입니다. 동영상 재생 시간(밀리초)입니다.

title

string

출력 전용입니다. 동영상 제목입니다.

WebpageView

웹페이지 뷰입니다.

JSON 표현
{
  "resourceName": string
}
입력란
resourceName

string

출력 전용입니다. 웹페이지 뷰의 리소스 이름입니다. 웹페이지 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

LeadFormSubmissionData

리드 양식 제출의 데이터입니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
입력란
resourceName

string

출력 전용입니다. 리드 양식 제출 데이터의 리소스 이름입니다. 리드 양식 제출 데이터 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

출력 전용입니다. 이 리드 양식 제출의 ID입니다.

asset

string

출력 전용입니다. 제출된 리드 양식과 연결된 확장 소재입니다.

campaign

string

출력 전용입니다. 제출된 리드 양식과 연결된 캠페인입니다.

leadFormSubmissionFields[]

object (LeadFormSubmissionField)

출력 전용입니다. 리드 양식과 연결된 제출 데이터입니다.

customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

출력 전용입니다. 맞춤 리드 양식과 연결된 제출 데이터입니다.

adGroup

string

출력 전용입니다. 제출된 리드 양식과 연결된 광고그룹입니다.

adGroupAd

string

출력 전용입니다. 제출된 리드 양식과 연결된 AdGroupAd입니다.

gclid

string

출력 전용입니다. 제출된 리드 양식과 연결된 Google 클릭 ID입니다.

submissionDateTime

string

출력 전용입니다. 리드 양식이 제출된 날짜와 시간입니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00').

LeadFormSubmissionField

제출된 리드 양식의 필드입니다.

JSON 표현
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
입력란
fieldType

enum (LeadFormFieldUserInputType)

출력 전용입니다. 리드 양식 필드의 필드 유형입니다.

fieldValue

string

출력 전용입니다. 리드 양식 필드의 필드 값입니다.

CustomLeadFormSubmissionField

제출된 맞춤 질문의 입력란

JSON 표현
{
  "questionText": string,
  "fieldValue": string
}
입력란
questionText

string

출력 전용입니다. 맞춤 질문의 질문 텍스트입니다. 최대 300자(영문 기준)까지 입력할 수 있습니다.

fieldValue

string

출력 전용입니다. 맞춤 질문 응답의 입력란 값입니다. 최대 문자 수는 70자(영문 기준)입니다.

측정항목

측정항목 데이터

JSON 표현
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number
}
입력란
allConversionsValueByConversionDate

number

모든 전환의 가치입니다. 날짜와 함께 이 열을 선택하면 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 대한 자세한 내용은 https://support.google.com/google-ads/answer/9549009에서 확인할 수 있습니다.

allConversionsByConversionDate

number

총 전환수입니다. 여기에는 includeInConversionsMetric 값과 상관없이 모든 전환이 포함됩니다. 날짜와 함께 이 열을 선택하면 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 대한 자세한 내용은 https://support.google.com/google-ads/answer/9549009에서 확인할 수 있습니다.

conversionsValueByConversionDate

number

전환의 가치입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다. 날짜와 함께 이 열을 선택하면 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 대한 자세한 내용은 https://support.google.com/google-ads/answer/9549009에서 확인할 수 있습니다.

conversionsByConversionDate

number

전환이 발생한 횟수입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다. 날짜와 함께 이 열을 선택하면 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 대한 자세한 내용은 https://support.google.com/google-ads/answer/9549009에서 확인할 수 있습니다.

historicalCreativeQualityScore

enum (QualityScoreBucket)

광고 소재의 이전 품질평가점수입니다.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

이전 방문 페이지 만족도의 품질

historicalSearchPredictedCtr

enum (QualityScoreBucket)

이전 검색의 예상 클릭률 (CTR)입니다.

interactionEventTypes[]

enum (InteractionEventType)

유료 및 무료 상호작용의 유형입니다.

skAdNetworkConversions

string (int64 format)

iOS Store Kit 광고 네트워크 전환의 횟수입니다.

publisherPurchasedClicks

string (int64 format)

게시자가 소유하지 않은 속성에서 발생한 클릭수(게시자가 비용을 지불했거나 인센티브를 제공하는 활동을 통해 확보한 트래픽)

publisherOrganicClicks

string (int64 format)

게시자가 비용을 지불하지 않았거나 인센티브를 제공하는 활동을 통해 확보하지 않은 속성에서 발생한 클릭

publisherUnknownClicks

string (int64 format)

'게시자 구매' 또는 '자연 검색'으로 식별되지 않는 트래픽에서 발생한 클릭수

absoluteTopImpressionPercentage

number

검색 절대 상단 노출 점유율은 가장 눈에 잘 띄는 검색 위치에 표시되는 검색 광고 노출수의 비율입니다.

activeViewCpm

number

조회 가능 노출의 평균 비용 (activeViewImpressions)입니다.

activeViewCtr

number

측정 가능 Active View 클릭수를 조회 가능 Active View 노출수로 나눈 값입니다.

이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다.

activeViewImpressions

string (int64 format)

디스플레이 네트워크 사이트에 광고가 조회할 수 있도록 게재된 횟수를 나타냅니다.

activeViewMeasurability

number

게재된 노출수 대비 Active View로 측정할 수 있는 노출수의 비율입니다.

activeViewMeasurableCostMicros

string (int64 format)

Active View로 측정할 수 있었던 노출수에 대한 비용입니다.

activeViewMeasurableImpressions

string (int64 format)

광고가 조회 가능한 게재위치에 게재된 횟수입니다.

activeViewViewability

number

Active View 활성 사이트 (측정 가능 노출)에 광고가 게재된 횟수와 조회 가능했던 (조회 가능 노출) 횟수의 비율입니다.

allConversionsFromInteractionsRate

number

조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다.

allConversionsValue

number

모든 전환의 가치입니다.

allNewCustomerLifetimeValue

number

모든 신규 고객의 평생 전환 가치입니다. 계정 수준 또는 캠페인 수준에서 고객 획득 목표를 설정한 경우 입찰 가능 전환과 비입찰 가능 전환 모두에 대해 신규 고객으로부터 발생하는 추가 전환 가치가 여기에 포함됩니다. 캠페인에서 고객 획득 목표를 채택하고 '신규 고객에 대해 더 높은 입찰가 설정'을 선택한 경우 해당 값은 'allConversionsValue'에 포함됩니다. 자세한 내용은 https://support.google.com/google-ads/answer/12080169를 참고하세요.

allConversions

number

총 전환수입니다. 여기에는 includeInConversionsMetric 값과 상관없이 모든 전환이 포함됩니다.

allConversionsValuePerCost

number

모든 전환의 가치를 광고 상호작용 (예: 텍스트 광고 클릭, 동영상 광고 조회)의 총 비용으로 나눈 값입니다.

allConversionsFromClickToCall

number

광고 클릭 도중 또는 이후에 매장에 연락하기 위해 '통화' 버튼을 클릭한 횟수입니다. 통화 연결 여부나 통화 시간은 포함되지 않습니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromDirections

number

광고를 클릭한 후에 매장으로 이동하기 위해 '경로 검색' 버튼을 클릭한 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromInteractionsValuePerInteraction

number

상호작용에서 발생한 모든 전환의 가치를 총 상호작용 수로 나눈 값입니다.

allConversionsFromMenu

number

광고를 클릭한 후에 매장의 메뉴를 보기 위해 링크를 클릭한 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromOrder

number

광고를 클릭한 후에 매장에서 주문한 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromOtherEngagement

number

광고를 클릭한 후에 발생한 기타 전환 (예: 매장에 대한 리뷰 게시, 매장 위치 저장) 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromStoreVisit

number

광고를 클릭한 후 매장을 방문한 것으로 예상되는 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromStoreWebsite

number

광고를 클릭한 후에 매장의 URL로 연결된 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

auctionInsightSearchAbsoluteTopImpressionPercentage

number

이 측정항목은 입찰 통계 보고서의 일부이며 검색결과 페이지에서 다른 광고주의 광고가 가장 눈에 잘 띄는 위치에 게재된 빈도를 알려줍니다. 이 비율은 페이지에 게재된 입찰에서만 계산됩니다.

이 측정항목은 공개적으로 제공되지 않습니다.

auctionInsightSearchImpressionShare

number

이 측정항목은 입찰 통계 보고서의 일부이며, 광고주의 광고가 게재될 수 있었던 총 노출수 대비 다른 참여자가 획득한 노출수의 비율을 알려줍니다. 0.1 미만의 값은 0.0999로 보고됩니다.

이 측정항목은 공개적으로 제공되지 않습니다.

auctionInsightSearchOutrankingShare

number

이 측정항목은 입찰 통계 보고서에 포함되며, 내 광고가 입찰할 수 있었던 총 노출수 대비 내 광고가 입찰의 다른 참여자보다 높은 순위 (위에 표시)를 이룬 노출수의 비율을 알려줍니다. 0.1 미만의 값은 0.0999로 보고됩니다.

이 측정항목은 공개적으로 제공되지 않습니다.

auctionInsightSearchOverlapRate

number

이 측정항목은 입찰 통계 보고서에 포함되며 광고주의 광고가 노출될 때 또 다른 광고주의 광고에는 얼마나 자주 노출되었는지를 알려줍니다.

이 측정항목은 공개적으로 제공되지 않습니다.

auctionInsightSearchPositionAboveRate

number

이 측정항목은 입찰 통계 보고서의 일부이며, 한 페이지에 두 광고주의 광고가 모두 게재됨에 다른 광고주의 광고가 자신의 광고보다 더 높은 순위에 게재되는 빈도입니다.

이 측정항목은 공개적으로 제공되지 않습니다.

auctionInsightSearchTopImpressionPercentage

number

이 측정항목은 입찰 통계 보고서에 포함되며, 다른 광고주의 광고가 상위 자연 검색 결과에 인접해 게재된 빈도를 알려줍니다. 이 비율은 페이지에 게재된 입찰에서만 계산됩니다.

이 측정항목은 공개적으로 제공되지 않습니다.

averageCost

number

상호작용당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다.

averageCpc

number

모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.

averageCpe

number

광고 참여에 대해 광고주가 지불하는 평균 금액입니다. 이 금액은 모든 광고 참여의 총 비용을 총 광고 참여 수로 나눈 값입니다.

averageCpm

number

평균 CPM(1,000회 노출당비용)입니다.

averageCpv

number

광고에 발생하는 조회당 광고주가 지불하는 평균 금액입니다. 평균 CPV는 전체 광고 조회수에 대한 총 비용을 조회수로 나눈 값입니다.

averagePageViews

number

세션당 조회한 평균 페이지 수입니다.

averageTimeOnSite

number

모든 세션의 총 시간 (초) / 세션 수 Google 애널리틱스에서 가져옴

benchmarkAverageMaxCpc

number

다른 광고주가 유사 제품에 어떻게 입찰하고 있는지를 보여주는 지표입니다.

biddableAppInstallConversions

number

앱 설치 수입니다.

biddableAppPostInstallConversions

number

인앱 액션 수

benchmarkCtr

number

광고를 본 사용자가 광고를 클릭하는 빈도를 기준으로 유사한 제품에 대한 다른 광고주의 쇼핑 광고 실적을 표시합니다.

bounceRate

number

사용자가 사이트의 한 페이지만 방문한 클릭수의 비율입니다. Google 애널리틱스에서 가져옴

clicks

string (int64 format)

클릭수입니다.

combinedClicks

string (int64 format)

무료 검색결과에서 광고 또는 사이트 등록정보를 클릭한 횟수입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참조하세요.

combinedClicksPerQuery

number

무료 검색결과에서 광고 또는 사이트 등록정보를 클릭한 횟수 (combinedClicks)를 결합 검색어 수로 나눈 값입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참조하세요.

combinedQueries

string (int64 format)

사이트의 페이지를 무료 검색결과에 표시했거나 텍스트 광고 중 하나를 게재한 검색 횟수입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참조하세요.

contentBudgetLostImpressionShare

number

디스플레이 네트워크에 광고가 게재될 수 있었으나 예산 부족으로 인해 게재되지 못한 횟수의 비율입니다. 참고: 콘텐츠 예산 상실 노출 점유율은 0~0.9로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

contentImpressionShare

number

디스플레이 네트워크에서 발생 가능한 예상 노출수 대비 실제 발생한 노출수의 비율입니다. 참고: 콘텐츠 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

conversionLastReceivedRequestDateTime

string

이 전환 액션의 전환 태그가 마지막으로 실행되고 Google Ads에 표시된 날짜/시간입니다. 이 실행 이벤트는 기여 가능한 전환의 결과가 아닐 수 있습니다 (예: 이전에 적절한 광고주의 광고를 클릭하지 않은 브라우저에서 태그가 실행되었기 때문). 날짜/시간은 고객의 시간대로 표시됩니다.

conversionLastConversionDate

string

이 전환 액션에 대한 가장 최근의 전환 날짜입니다. 날짜는 고객의 시간대입니다.

contentRankLostImpressionShare

number

디스플레이 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 콘텐츠 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

conversionsFromInteractionsRate

number

상호작용에서 발생한 전환수를 광고 상호작용 (예: 텍스트 광고 클릭, 동영상 광고 조회) 수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

conversionsValue

number

전환의 가치입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

newCustomerLifetimeValue

number

신규 고객의 평생 전환 가치입니다. 계정 수준 또는 캠페인 수준에서 고객 획득 목표를 설정한 경우 입찰 가능한 전환에 대해 신규 고객으로부터 발생하는 추가 전환 가치가 여기에 포함됩니다. 캠페인에서 고객 획득 목표를 채택하고 '신규 고객에 대해 더 높은 입찰가 설정'을 선택한 경우 이 값이 최적화를 위해 'conversionsValue'에 포함됩니다. 자세한 내용은 https://support.google.com/google-ads/answer/12080169를 참고하세요.

conversionsValuePerCost

number

전환 가치를 광고 상호작용의 비용으로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

conversionsFromInteractionsValuePerInteraction

number

상호작용의 전환 가치를 광고 상호작용 횟수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

conversions

number

전환이 발생한 횟수입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

costMicros

string (int64 format)

일정 기간에 발생한 클릭당비용(CPC)과 1,000회 노출당비용(CPM)의 합계입니다.

costPerAllConversions

number

광고 상호작용 비용을 모든 전환수로 나눈 값입니다.

costPerConversion

number

광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

costPerCurrentModelAttributedConversion

number

광고 상호작용 비용을 현재 모델 기여 전환수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

crossDeviceConversions

number

고객이 한 기기에서 Google Ads 광고를 클릭한 후 다른 기기나 브라우저에서 전환하는 경우를 말합니다. 교차 기기 전환이 이미 allConversions에 포함되어 있습니다.

ctr

number

광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.

currentModelAttributedConversions

number

현재 선택한 기여 분석 모델에서 이전 전환 데이터가 어떻게 표시되는지 보여줍니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

currentModelAttributedConversionsFromInteractionsRate

number

현재 모델에서는 상호작용에서 발생한 기여 전환수를 광고 상호작용 (예: 텍스트 광고 클릭, 동영상 광고 조회) 수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

상호작용에서 발생한 현재 모델 기여 전환수를 광고 상호작용 수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

currentModelAttributedConversionsValue

number

현재 모델 기여 전환의 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

currentModelAttributedConversionsValuePerCost

number

현재 모델 기여 전환의 가치를 광고 상호작용의 비용으로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

engagementRate

number

사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다.

engagements

string (int64 format)

참여 수입니다. 참여는 사용자가 라이트박스 광고를 확장할 때 발생합니다. 향후에는 다른 광고 유형도 참여도 통계를 지원할 수 있습니다.

hotelAverageLeadValueMicros

number

클릭수를 기반으로 한 평균 리드 가치입니다.

hotelCommissionRateMicros

string (int64 format)

마이크로 단위의 수수료 입찰률입니다. 수수료 20% 는 200,000으로 표시됩니다.

hotelExpectedCommissionCost

number

예상 수수료 비용입니다. 수수료 값에 Hotel_commission_rate를 광고주 통화로 곱하여 얻은 결과입니다.

hotelPriceDifferencePercentage

number

신고한 호텔 광고주가 제공하는 가격과 경쟁 광고주가 제공하는 최저가 간의 평균 가격 차이입니다.

hotelEligibleImpressions

string (int64 format)

호텔 파트너가 피드 실적에 대해 발생했을 수 있었던 노출수입니다.

historicalQualityScore

string (int64 format)

이전 품질평가점수입니다.

gmailForwards

string (int64 format)

광고가 메시지로 다른 사용자에게 전달된 횟수입니다.

gmailSaves

string (int64 format)

사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다.

gmailSecondaryClicks

string (int64 format)

Gmail 광고의 확장된 상태에서 방문 페이지로 연결되는 클릭수입니다.

impressionsFromStoreReach

string (int64 format)

매장의 위치 기반 광고가 게재된 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

impressions

string (int64 format)

Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.

interactionRate

number

사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고 게재 횟수로 나눈 값입니다.

interactions

string (int64 format)

상호작용 수입니다. 상호작용이란 텍스트 및 쇼핑 광고의 경우 광고 형식 클릭, 동영상 광고의 경우 조회수 등과 관련된 기본 사용자 액션을 말합니다.

invalidClickRate

number

보고 기간 동안 필터링된 총 클릭수 (필터링된 클릭수 + 필터링되지 않은 클릭수)에서 필터링된 클릭수의 비율입니다.

invalidClicks

string (int64 format)

Google에서 불법으로 간주하여 비용을 청구하지 않는 클릭수입니다.

messageChats

string (int64 format)

메시지 추적이 가능한 클릭 투 메시지 노출에 대해 시작된 메시지 채팅 수입니다.

messageImpressions

string (int64 format)

메시지 추적이 가능했던 클릭 투 메시지 노출수입니다.

messageChatRate

number

시작된 메시지 채팅 수 (messageChats)를 메시지 노출수 (messageImpressions)로 나눈 값입니다. 메시지 옵션이 제공되고 메시지 추적이 사용 설정된 상태로 광고 노출에서 사용자가 메시지 채팅을 시작한 비율입니다. 이 비율은 특정 메시지 노출에 대해 1.0보다 클 수 있습니다.

mobileFriendlyClicksPercentage

number

모바일 친화적인 페이지로 연결되는 모바일 클릭의 비율입니다.

optimizationScoreUplift

number

모든 추천의 총 최적화 점수 상승치입니다.

optimizationScoreUrl

string

Google Ads 웹 인터페이스의 최적화 점수 페이지 URL입니다. 이 측정항목은 customer 또는 campaign에서 선택할 수 있으며 segments.recommendation_type로 분류할 수 있습니다. 예를 들어 SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer는 고유한 각 (customer,recommendType) 조합의 URL을 반환합니다.

organicClicks

string (int64 format)

특정 검색에 의해 표시된 자연 검색결과에서 웹사이트의 검색결과를 클릭한 횟수입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참조하세요.

organicClicksPerQuery

number

무료 검색결과에서 사용자가 사이트 등록정보를 클릭한 횟수 (organicClicks)를 사이트의 페이지를 검색결과로 표시한 총 검색 수 (자연 검색)로 나눈 값입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참조하세요.

organicImpressions

string (int64 format)

무료 검색결과에 표시되는 사이트의 등록정보 수입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참조하세요.

organicImpressionsPerQuery

number

사이트의 페이지가 무료 검색결과에 표시된 횟수 (자연노출수)를 무료 검색결과 (자연 검색)에서 해당 사이트의 목록을 검색결과로 표시한 검색 횟수로 나눈 값입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참조하세요.

organicQueries

string (int64 format)

무료 검색결과에 사이트 목록을 표시한 총 검색 수입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참조하세요.

percentNewVisitors

number

내 사이트를 방문한 적이 없는 사용자의 최초 세션의 비율입니다. Google 애널리틱스에서 가져옴

phoneCalls

string (int64 format)

오프라인 전화 통화 수입니다.

phoneImpressions

string (int64 format)

오프라인 전화 노출수입니다.

phoneThroughRate

number

연결된 통화수 (phoneCalls)를 전화번호가 표시된 횟수 (phoneImpressions)로 나눈 값입니다.

relativeCtr

number

클릭률 (CTR)을 광고를 게재한 모든 웹사이트의 모든 광고주의 평균 클릭률로 나눈 값입니다. 디스플레이 네트워크 사이트에서 동일한 사이트에 게재되는 다른 광고의 실적과 비교하여 귀하의 광고 실적을 측정합니다.

searchAbsoluteTopImpressionShare

number

가장 눈에 띄는 쇼핑 위치에 표시되는 고객의 쇼핑 광고 또는 검색 광고 노출수의 비율입니다. 자세한 내용은 https://support.google.com/google-ads/answer/7501826을 참고하세요. 0.1 미만의 값은 0.0999로 보고됩니다.

searchBudgetLostAbsoluteTopImpressionShare

number

예산 부족으로 인해 검색결과 최상위 광고 중 자신의 광고가 첫 번째 광고로 게재되지 않은 빈도를 추정하는 수치입니다. 참고: 검색 예산 상실 절대 상단 노출 점유율은 0에서 0.9로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchBudgetLostImpressionShare

number

광고가 검색 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 검색 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchBudgetLostTopImpressionShare

number

예산 부족으로 인해 상위 자연 검색결과 옆에 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산 상실 상단 노출 점유율은 0~0.9로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchClickShare

number

검색 네트워크에서 발생한 클릭수를 발생 가능한 예상 클릭수로 나눈 값입니다. 참고: 검색 클릭 점유율은 0.1에서 1 사이의 값으로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

searchExactMatchImpressionShare

number

얻은 노출수를 키워드 검색 유형과 관계없이 키워드와 정확히 일치하거나 키워드와 매우 유사한 검색어에 대해 검색 네트워크에서 발생할 수 있었던 예상 노출수로 나눈 값입니다. 참고: 검색 일치검색 노출 점유율은 0.1에서 1 사이로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

searchImpressionShare

number

검색 네트워크에서 발생 가능한 예상 노출수 대비 실제 발생한 노출수의 비율입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

searchRankLostAbsoluteTopImpressionShare

number

광고 순위가 낮아 검색결과의 최상위 광고 중 자신의 광고가 첫 번째 광고로 게재되지 않은 빈도를 추정하는 수치입니다. 참고: 검색 순위 상실 절대 상단 노출 점유율은 0에서 0.9로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchRankLostImpressionShare

number

검색 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 검색 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchRankLostTopImpressionShare

number

광고 순위가 낮아 상위 자연 검색결과 옆에 광고가 게재되지 않은 빈도를 추정하는 수치입니다. 참고: 검색 순위 상실 상단 노출 점유율은 0에서 0.9 사이의 값으로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchTopImpressionShare

number

최상위 광고에서 발생할 수 있었던 예상 노출수 대비 상위 광고에서 발생한 노출수입니다. 참고: 검색 상단 노출 점유율은 0.1에서 1 사이의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

상단 광고는 일반적으로 상단 자연 검색 결과 위에 게재되지만, 일부 검색어의 경우에는 상단 자연 검색 결과 아래에 게재될 수 있습니다.

searchVolume

object (SearchVolumeRange)

검색어 통계 카테고리의 검색량 범위입니다.

speedScore

string (int64 format)

모바일 광고 클릭 후 페이지 로드 속도를 측정한 값입니다. 점수는 1부터 10까지이며 10이 가장 빠릅니다.

averageTargetCpaMicros

string (int64 format)

평균 타겟 CPA, 또는 사용할 수 없는 경우 설정되지 않음 (예: 포트폴리오 입찰 전략 또는 tCPA가 아닌 캠페인에서 트래픽이 발생한 캠페인)

averageTargetRoas

number

평균 타겟 광고 투자수익(ROAS)이며, 사용할 수 없는 경우 설정되지 않습니다(예: 포트폴리오 입찰 전략 또는 타겟 ROAS가 아닌 캠페인에서 트래픽이 발생한 캠페인).

topImpressionPercentage

number

상위 자연 검색결과 옆에 표시되는 광고 노출수의 비율입니다.

validAcceleratedMobilePagesClicksPercentage

number

유효한 AMP 페이지에 도달하는 Accelerated Mobile Pages (AMP) 방문 페이지로 연결되는 광고 클릭의 비율입니다.

valuePerAllConversions

number

모든 전환의 가치를 전체 전환수로 나눈 값입니다.

valuePerAllConversionsByConversionDate

number

모든 전환의 가치를 전체 전환수로 나눈 값입니다. 날짜와 함께 이 열을 선택하면 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 대한 자세한 내용은 https://support.google.com/google-ads/answer/9549009에서 확인할 수 있습니다.

valuePerConversion

number

전환 가치를 전환수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

valuePerConversionsByConversionDate

number

전환 가치를 전환수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다. 날짜와 함께 이 열을 선택하면 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 대한 자세한 내용은 https://support.google.com/google-ads/answer/9549009에서 확인할 수 있습니다.

valuePerCurrentModelAttributedConversion

number

현재 모델 기여 전환수를 전환수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

videoQuartileP100Rate

number

시청자가 전체 동영상을 시청한 노출수의 비율입니다.

videoQuartileP25Rate

number

시청자가 동영상의 25% 를 본 노출수의 비율입니다.

videoQuartileP50Rate

number

시청자가 동영상의 50% 를 본 노출수의 비율입니다.

videoQuartileP75Rate

number

시청자가 동영상의 75% 를 본 노출수의 비율입니다.

videoViewRate

number

TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 디스플레이 광고의 미리보기 이미지 노출수 포함)로 나눈 값입니다.

videoViews

string (int64 format)

동영상 광고가 조회된 횟수입니다.

viewThroughConversions

string (int64 format)

총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용(예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.

allConversionsFromLocationAssetClickToCall

number

청구 가능한 광고 이벤트 (클릭 또는 노출) 후에 위치 표시 경로에서 통화 버튼이 클릭된 횟수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

allConversionsFromLocationAssetDirections

number

청구 가능한 광고 이벤트 (클릭 또는 노출) 후에 위치 표시 경로에서 발생한 운전 경로 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

allConversionsFromLocationAssetMenu

number

청구 가능한 광고 이벤트 (클릭 또는 노출) 후에 위치 표시 경로에서 메뉴 링크가 클릭된 횟수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

allConversionsFromLocationAssetOrder

number

청구 가능한 광고 이벤트 (클릭 또는 노출) 후에 위치 표시 경로에서 주문 클릭수가 발생한 횟수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

allConversionsFromLocationAssetOtherEngagement

number

청구 가능한 광고 이벤트 (클릭 또는 노출) 후에 위치 표시 경로에서 발생하는 기타 유형의 오프라인 액션 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

allConversionsFromLocationAssetStoreVisits

number

청구 가능한 광고 이벤트 (클릭 또는 노출) 후 매장의 예상 방문수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

allConversionsFromLocationAssetWebsite

number

청구 가능한 광고 이벤트 (클릭 또는 노출) 후에 위치 표시 경로에서의 웹사이트 URL 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

매장 위치가 표시되었거나 해당 위치가 타겟팅에 사용된 노출수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

viewThroughConversionsFromLocationAssetClickToCall

number

노출 후 위치 표면의 통화 버튼 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

viewThroughConversionsFromLocationAssetDirections

number

노출 후 위치 표면에서 발생한 운전 경로 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

viewThroughConversionsFromLocationAssetMenu

number

노출 후 위치 표면의 메뉴 링크 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

viewThroughConversionsFromLocationAssetOrder

number

노출 후 위치 플랫폼에서 발생한 주문 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

viewThroughConversionsFromLocationAssetOtherEngagement

number

노출 후 위치 표면에서 발생한 다른 유형의 오프라인 액션 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

viewThroughConversionsFromLocationAssetStoreVisits

number

노출 후 매장의 예상 방문수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

viewThroughConversionsFromLocationAssetWebsite

number

노출 후 위치 플랫폼에서의 웹사이트 URL 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.

InteractionEventType

가능한 결제 가능 상호작용 및 무료 상호작용의 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CLICK 클릭하여 사이트로 이동하세요. 대부분의 경우 이러한 상호작용은 외부 위치, 일반적으로 광고주의 방문 페이지로 연결됩니다. 또한 클릭 이벤트의 기본 InteractionEventType입니다.
ENGAGEMENT 인플레이스 광고에 참여하려는 사용자의 표현입니다.
VIDEO_VIEW 사용자가 동영상 광고를 조회했습니다.
NONE 광고 전환 이벤트의 기본 InteractionEventType입니다. 이 속성은 광고 전환 행에 무료 상호작용 (예: 광고 전환)이 '홍보'되어야 하고 핵심 측정항목의 일부로 보고되어야 한다고 표시하지 않은 경우 사용됩니다. 이는 단순히 다른 (광고) 전환입니다.

SearchVolumeRange

검색량 범위입니다. 실제 검색량이 이 범위 내에 있습니다.

JSON 표현
{
  "min": string,
  "max": string
}
입력란
min

string (int64 format)

검색량의 하한값입니다.

max

string (int64 format)

검색량의 상한값입니다.

세그먼트

세그먼트 전용 필드

JSON 표현
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
입력란
adDestinationType

enum (AdDestinationType)

광고 도착 페이지 유형입니다.

adNetworkType

enum (AdNetworkType)

광고 네트워크 유형입니다.

budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

예산 캠페인 연결 상태입니다.

clickType

enum (ClickType)

클릭 유형을 선택합니다.

conversionActionCategory

enum (ConversionActionCategory)

전환 액션 카테고리입니다.

conversionAttributionEventType

enum (ConversionAttributionEventType)

전환 기여 분석 이벤트 유형입니다.

conversionLagBucket

enum (ConversionLagBucket)

노출과 전환 사이의 일수를 나타내는 열거형 값입니다.

conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

노출과 전환 사이의 일수 또는 노출과 전환에 대한 조정 사이의 일수를 나타내는 열거형 값입니다.

dayOfWeek

enum (DayOfWeek)

요일(예: MONDAY)

device

enum (Device)

측정항목이 적용되는 기기입니다.

externalConversionSource

enum (ExternalConversionSource)

외부 전환 소스

hotelCheckInDayOfWeek

enum (DayOfWeek)

호텔 체크인 요일입니다.

hotelDateSelectionType

enum (HotelDateSelectionType)

호텔 날짜 선택 유형입니다.

hotelRateType

enum (HotelRateType)

호텔 요금 유형입니다.

hotelPriceBucket

enum (HotelPriceBucket)

호텔 가격 버킷입니다.

keyword

object (Keyword)

키워드 기준입니다.

monthOfYear

enum (MonthOfYear)

월(예: 1월)

placeholderType

enum (PlaceholderType)

자리표시자 유형입니다. 피드 항목 측정항목에만 사용됩니다.

productChannel

enum (ProductChannel)

제품의 채널입니다.

productChannelExclusivity

enum (ProductChannelExclusivity)

제품의 단일 채널 판매 여부입니다.

productCondition

enum (ProductCondition)

제품 상태입니다.

recommendationType

enum (RecommendationType)

추천 유형입니다.

searchEngineResultsPageType

enum (SearchEngineResultsPageType)

검색엔진 결과 페이지의 유형입니다.

searchTermMatchType

enum (SearchTermMatchType)

유사 광고를 포함하여 광고를 트리거한 키워드의 검색 유형입니다.

slot

enum (Slot)

광고의 게재순위입니다.

conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

적용된 전환 가치 규칙의 기본 측정기준입니다. NO_RULE_APPLIED는 가치 규칙이 적용되지 않은 전환의 기록된 총 가치를 나타냅니다. '원본'은 가치 규칙이 적용된 전환의 원래 가치를 보여줍니다. GEO_LOCATION, DEVICE, AUDIENCE는 가치 규칙이 적용된 후의 순 조정을 보여줍니다.

skAdNetworkUserType

enum (SkAdNetworkUserType)

iOS 스토어 키트 광고 네트워크 사용자 유형입니다.

skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

iOS 스토어 키트 광고 네트워크 광고 이벤트 유형입니다.

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS 스토어 키트 광고 네트워크 저작자 표시 크레딧

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

이는 사용자가 신규 고객인지 재구매 고객인지에 따라 전환을 분류하기 위한 것입니다. 이 세분화는 일반적으로 고객 획득 목표의 영향을 측정하는 데 사용됩니다.

activityAccountId

string (int64 format)

활동 계정 ID입니다.

activityRating

string (int64 format)

활동 평점

externalActivityId

string

광고주가 제공한 활동 ID입니다.

adGroup

string

광고그룹의 리소스 이름입니다.

assetGroup

string

애셋 그룹의 리소스 이름입니다.

auctionInsightDomain

string

입찰 통계 보고서에 포함된 참여자의 도메인 (표시 URL)입니다.

campaign

string

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

conversionAction

string

전환 액션의 리소스 이름입니다.

conversionActionName

string

전환 액션 이름입니다.

conversionAdjustment

boolean

이렇게 하면 기존 전환 및 전환 가치와 전환이 조정된 경우 델타를 기준으로 전환 열이 분류됩니다. 거짓 행에는 원래 명시된 데이터가 있고, 참 행에는 현재 데이터와 원래 명시된 데이터 사이의 델타가 있습니다. 두 가지를 더하면 조정 후 데이터가 산출됩니다.

date

string

측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17).

geoTargetAirport

string

공항을 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetCanton

string

주를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetCity

string

도시를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetCountry

string

국가를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetCounty

string

카운티를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetDistrict

string

구역을 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetMetro

string

대도시를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetMostSpecificLocation

string

가장 구체적인 위치를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetPostalCode

string

우편번호를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetProvince

string

주를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetRegion

string

지역을 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetState

string

상태를 나타내는 지역 타겟 상수의 리소스 이름입니다.

hotelBookingWindowDays

string (int64 format)

호텔 예약 기간(일)입니다.

hotelCenterId

string (int64 format)

Hotel Center ID

hotelCheckInDate

string

호텔 체크인 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.

hotelCity

string

호텔 도시입니다.

hotelClass

integer

호텔 등급입니다.

hotelCountry

string

호텔 소재 국가

hotelLengthOfStay

integer

호텔 숙박 기간입니다.

hotelRateRuleId

string

호텔 요금 규칙 ID입니다.

hotelState

string

호텔 주/도입니다.

hour

integer

0과 23 사이의 숫자입니다(0과 23 사이의 숫자).

interactionOnThisExtension

boolean

피드 항목 측정항목에만 사용됩니다. 상호작용 측정항목이 피드 항목 자체에서 발생했는지 아니면 다른 광고 확장이나 광고 단위에서 발생했는지를 나타냅니다.

month

string

월(1일의 일자)로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.

partnerHotelId

string

파트너 호텔 ID입니다.

productAggregatorId

string (int64 format)

제품의 애그리게이터 ID입니다.

productBiddingCategoryLevel1

string

제품의 입찰 카테고리(수준 1)입니다.

productBiddingCategoryLevel2

string

제품의 입찰 카테고리(수준 2)입니다.

productBiddingCategoryLevel3

string

제품의 입찰 카테고리(수준 3)입니다.

productBiddingCategoryLevel4

string

제품의 입찰 카테고리(수준 4)입니다.

productBiddingCategoryLevel5

string

제품의 입찰 카테고리(수준 5)입니다.

productBrand

string

제품의 브랜드입니다.

productCountry

string

제품 판매 국가에 대한 지역 타겟 상수의 리소스 이름입니다.

productCustomAttribute0

string

제품의 맞춤 속성 0입니다.

productCustomAttribute1

string

제품의 커스텀 속성 1입니다.

productCustomAttribute2

string

제품의 맞춤 속성 2입니다.

productCustomAttribute3

string

제품의 맞춤 속성 3입니다.

productCustomAttribute4

string

제품의 맞춤 속성 4입니다.

productFeedLabel

string

제품의 피드 라벨입니다.

productItemId

string

제품의 상품 ID입니다.

productLanguage

string

제품 언어에 대한 언어 상수의 리소스 이름입니다.

productMerchantId

string (int64 format)

제품의 판매자 ID입니다.

productStoreId

string

제품의 판매점 ID입니다.

productTitle

string

제품의 이름입니다.

productTypeL1

string

제품 유형(수준 1)입니다.

productTypeL2

string

제품 유형(수준 2)입니다.

productTypeL3

string

제품 유형(수준 3)입니다.

productTypeL4

string

제품 유형(수준 4)입니다.

productTypeL5

string

제품 유형(수준 5)입니다.

quarter

string

분기의 첫날 날짜로 표시되는 분기입니다. 분기에 역년을 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작합니다. yyyy-MM-dd 형식으로 지정됩니다.

searchSubcategory

string

검색어 하위 카테고리입니다. 빈 문자열은 다른 하위 카테고리에 해당하지 않는 검색어에 대한 포괄적인 하위 카테고리를 나타냅니다.

searchTerm

string

검색어

webpage

string

웹페이지 기준을 나타내는 광고그룹 기준의 리소스 이름입니다.

week

string

월요일부터 일요일까지로 정의되는 주이며 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.

year

integer

yyyy 형식으로 된 연도입니다.

skAdNetworkConversionValue

string (int64 format)

iOS Store Kit 광고 네트워크 전환 가치입니다. Null 값은 이 세그먼트(예: iOS 외 캠페인)를 적용할 수 없음을 의미합니다.

skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

iOS 스토어 키트 광고 네트워크 설치를 유도한 광고가 게재된 앱입니다. Null 값은 이 세그먼트가 적용되지 않거나(예: iOS가 아닌 캠페인) Apple에서 전송한 포스트백에 없었음을 의미합니다.

assetInteractionTarget

object (AssetInteractionTarget)

CustomerAsset, CampaignAsset, AdGroupAsset 측정항목과만 함께 사용하세요. 상호작용 측정항목이 애셋 자체에서 발생했는지 아니면 다른 애셋 또는 광고 단위에서 발생했는지를 나타냅니다. 상호작용 (예: 클릭수)은 함께 게재될 때 게재된 광고의 모든 부분 (예: 광고 자체 및 사이트링크와 같은 기타 구성요소)에서 집계됩니다. shortcutsOnThisAsset이 true이면 해당 특정 확장 소재에 대한 상호작용이 있고 상호작용이 false이면 이 특정 확장 소재가 아니라 이 확장 소재가 함께 게재되는 광고의 다른 부분에서 상호작용이 발생했다는 의미입니다.

AdDestinationType

Google Ads 도착 페이지 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
NOT_APPLICABLE 광고에서 사용자를 다른 도착 페이지로 유도할 의도가 없는 광고
WEBSITE 웹사이트
APP_STORE iOS App Store 또는 Play 스토어
PHONE_CALL 다이얼러 통화
MAP_DIRECTIONS 지도 앱
LOCATION_LISTING 위치 전용 페이지
MESSAGE 문자 메시지
LEAD_FORM 리드 생성 양식
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS 키를 알 수 없는 전환의 광고 도착 페이지

AdNetworkType

Google Ads 네트워크 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
SEARCH Google 검색
SEARCH_PARTNERS 검색 파트너
CONTENT (디스플레이 네트워크용)
YOUTUBE_WATCH YouTube 동영상
MIXED 교차 네트워크.

BudgetCampaignAssociationStatus

budgetCampaignAssociationStatus 세그먼트입니다.

JSON 표현
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
입력란
status

enum (BudgetCampaignAssociationStatus)

예산 캠페인 연결 상태입니다.

campaign

string

캠페인 리소스 이름입니다.

BudgetCampaignAssociationStatus

예산과 캠페인 간의 연결의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 캠페인에서 현재 예산을 사용 중입니다.
REMOVED 캠페인에서 더 이상 예산을 사용하지 않습니다.

ClickType

Google Ads 클릭 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
BREADCRUMBS 탐색경로
BROADBAND_PLAN 광대역 계획.
CALL_TRACKING 직접 걸려온 전화 통화
CALLS 전화 통화를 클릭합니다.
CLICK_ON_ENGAGEMENT_AD 참여 광고를 클릭합니다.
GET_DIRECTIONS 운전경로를 탭합니다.
LOCATION_EXPANSION 위치 세부정보를 가져옵니다.
LOCATION_FORMAT_CALL 전화 걸기.
LOCATION_FORMAT_DIRECTIONS 경로를 선택합니다.
LOCATION_FORMAT_IMAGE 이미지
LOCATION_FORMAT_LANDING_PAGE 방문 페이지로 이동합니다.
LOCATION_FORMAT_MAP 지도.
LOCATION_FORMAT_STORE_INFO 매장 정보로 이동합니다.
LOCATION_FORMAT_TEXT 텍스트.
MOBILE_CALL_TRACKING 휴대전화 통화
OFFER_PRINTS 쿠폰을 인쇄합니다.
OTHER 기타.
PRODUCT_EXTENSION_CLICKS 제품 플러스박스 특전
PRODUCT_LISTING_AD_CLICKS 쇼핑 - 제품 - 온라인.
STORE_LOCATOR 주변 위치를 표시합니다.
URL_CLICKS 광고 제목.
VIDEO_APP_STORE_CLICKS 앱 스토어
VIDEO_CALL_TO_ACTION_CLICKS 클릭 유도문안 오버레이
VIDEO_CARD_ACTION_HEADLINE_CLICKS 카드
VIDEO_END_CAP_CLICKS 엔드 캡.
VIDEO_WEBSITE_CLICKS 웹사이트.
WIRELESS_PLAN 무선 요금제
PRODUCT_LISTING_AD_LOCAL 쇼핑 - 제품 - 오프라인
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL 쇼핑 - 제품 - 멀티채널 오프라인
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE 쇼핑 - 제품 - 멀티채널 온라인.
PRODUCT_LISTING_ADS_COUPON 쇼핑 - 제품 - 쿠폰
PRODUCT_LISTING_AD_TRANSACTABLE 쇼핑 - 제품 - Google에서 판매
PROMOTION_EXTENSION 프로모션 광고 확장
HOTEL_PRICE 호텔 가격입니다.
PRICE_EXTENSION 가격 광고 확장
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION Google에서 호텔 예약 시 객실 선택
SHOPPING_COMPARISON_LISTING 쇼핑 - 비교 등록정보
CROSS_NETWORK 교차 네트워크. 실적 최대화 캠페인 및 디스커버리 캠페인에서

ConversionAttributionEventType

기여한 전환의 이벤트 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서 알 수 없는 값을 나타냅니다.
IMPRESSION 노출이 전환에 기여한 경우
INTERACTION 상호작용이 전환에 기여한 것으로 간주됩니다.

ConversionLagBucket

노출과 전환 사이의 일수를 나타내는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
LESS_THAN_ONE_DAY 전환 지연시간 버킷은 0~1일입니다. 0일은 포함되지만 1일은 포함되지 않습니다.
ONE_TO_TWO_DAYS 전환 지연시간 버킷을 1~2일 사이로 1일은 포함되지만 2일은 포함되지 않습니다.
TWO_TO_THREE_DAYS 전환 지연시간 버킷을 2~3일 사이로 설정합니다. 2일은 포함되지만 3일은 포함되지 않습니다.
THREE_TO_FOUR_DAYS 전환 지연시간 버킷을 3~4일로 변경 3일은 포함되지만 4일은 포함되지 않습니다.
FOUR_TO_FIVE_DAYS 전환 지연시간 버킷을 4~5일로 변경 4일은 포함되지만 5일은 포함되지 않습니다.
FIVE_TO_SIX_DAYS 전환 지연시간 버킷을 5~6일로 설정 5일이 포함되고 6일이 포함되지 않습니다.
SIX_TO_SEVEN_DAYS 전환 지연시간 버킷을 6~7일로 변경 6일은 포함되지만 7일은 포함되지 않습니다.
SEVEN_TO_EIGHT_DAYS 전환 지연시간 버킷을 7일에서 8일로 설정했습니다. 7일은 포함되지만 8일은 포함되지 않습니다.
EIGHT_TO_NINE_DAYS 전환 지연시간 버킷은 8~9일입니다. 8일은 포함되지만 9일은 포함되지 않습니다.
NINE_TO_TEN_DAYS 전환 지연시간 버킷을 9~10일로 변경 9일은 포함되지만 10일은 포함되지 않습니다.
TEN_TO_ELEVEN_DAYS 전환 지연시간 버킷을 10일에서 11일로 변경 10일이 포함되고 11일이 포함되지 않습니다.
ELEVEN_TO_TWELVE_DAYS 전환 지연시간 버킷을 11일에서 12일로 설정했습니다. 11일은 포함되지만 12일은 포함되지 않습니다.
TWELVE_TO_THIRTEEN_DAYS 전환 지연시간 버킷을 12일에서 13일로 설정했습니다. 12일은 포함되지만 13일은 포함되지 않습니다.
THIRTEEN_TO_FOURTEEN_DAYS 전환 지연시간 버킷을 13일에서 14일로 설정했습니다. 13일은 포함되지만 14일은 포함되지 않습니다.
FOURTEEN_TO_TWENTY_ONE_DAYS 전환 지연시간 버킷을 14일에서 21일로 설정했습니다. 14일은 포함되지만 21일은 포함되지 않습니다.
TWENTY_ONE_TO_THIRTY_DAYS 전환 지연시간 버킷을 21~30일로 변경 21일은 포함되지만 30일은 포함되지 않습니다.
THIRTY_TO_FORTY_FIVE_DAYS 전환 지연시간 버킷을 30~45일로 변경 30일은 포함되지만 45일은 포함되지 않습니다.
FORTY_FIVE_TO_SIXTY_DAYS 전환 지연시간 버킷을 45일에서 60일로 변경 45일은 포함되지만 60일은 포함되지 않습니다.
SIXTY_TO_NINETY_DAYS 전환 지연시간 버킷을 60일에서 90일로 변경 60일은 포함되지만 90일은 포함되지 않습니다.

ConversionOrAdjustmentLagBucket

노출과 전환 사이의 일수 또는 노출과 전환에 대한 조정 사이의 일수를 나타내는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CONVERSION_LESS_THAN_ONE_DAY 전환 지연시간 버킷은 0~1일입니다. 0일은 포함되지만 1일은 포함되지 않습니다.
CONVERSION_ONE_TO_TWO_DAYS 전환 지연시간 버킷을 1~2일 사이로 1일은 포함되지만 2일은 포함되지 않습니다.
CONVERSION_TWO_TO_THREE_DAYS 전환 지연시간 버킷을 2~3일 사이로 설정합니다. 2일은 포함되지만 3일은 포함되지 않습니다.
CONVERSION_THREE_TO_FOUR_DAYS 전환 지연시간 버킷을 3~4일로 변경 3일은 포함되지만 4일은 포함되지 않습니다.
CONVERSION_FOUR_TO_FIVE_DAYS 전환 지연시간 버킷을 4~5일로 변경 4일은 포함되지만 5일은 포함되지 않습니다.
CONVERSION_FIVE_TO_SIX_DAYS 전환 지연시간 버킷을 5~6일로 설정 5일이 포함되고 6일이 포함되지 않습니다.
CONVERSION_SIX_TO_SEVEN_DAYS 전환 지연시간 버킷을 6~7일로 변경 6일은 포함되지만 7일은 포함되지 않습니다.
CONVERSION_SEVEN_TO_EIGHT_DAYS 전환 지연시간 버킷을 7일에서 8일로 설정했습니다. 7일은 포함되지만 8일은 포함되지 않습니다.
CONVERSION_EIGHT_TO_NINE_DAYS 전환 지연시간 버킷은 8~9일입니다. 8일은 포함되지만 9일은 포함되지 않습니다.
CONVERSION_NINE_TO_TEN_DAYS 전환 지연시간 버킷을 9~10일로 변경 9일은 포함되지만 10일은 포함되지 않습니다.
CONVERSION_TEN_TO_ELEVEN_DAYS 전환 지연시간 버킷을 10일에서 11일로 변경 10일이 포함되고 11일이 포함되지 않습니다.
CONVERSION_ELEVEN_TO_TWELVE_DAYS 전환 지연시간 버킷을 11일에서 12일로 설정했습니다. 11일은 포함되지만 12일은 포함되지 않습니다.
CONVERSION_TWELVE_TO_THIRTEEN_DAYS 전환 지연시간 버킷을 12일에서 13일로 설정했습니다. 12일은 포함되지만 13일은 포함되지 않습니다.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS 전환 지연시간 버킷을 13일에서 14일로 설정했습니다. 13일은 포함되지만 14일은 포함되지 않습니다.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS 전환 지연시간 버킷을 14일에서 21일로 설정했습니다. 14일은 포함되지만 21일은 포함되지 않습니다.
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS 전환 지연시간 버킷을 21~30일로 변경 21일은 포함되지만 30일은 포함되지 않습니다.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS 전환 지연시간 버킷을 30~45일로 변경 30일은 포함되지만 45일은 포함되지 않습니다.
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS 전환 지연시간 버킷을 45일에서 60일로 변경 45일은 포함되지만 60일은 포함되지 않습니다.
CONVERSION_SIXTY_TO_NINETY_DAYS 전환 지연시간 버킷을 60일에서 90일로 변경 60일은 포함되지만 90일은 포함되지 않습니다.
ADJUSTMENT_LESS_THAN_ONE_DAY 전환 조정 지연시간 버킷은 0~1일입니다. 0일은 포함되지만 1일은 포함되지 않습니다.
ADJUSTMENT_ONE_TO_TWO_DAYS 전환 조정 지연시간 버킷은 1~2일입니다. 1일은 포함되지만 2일은 포함되지 않습니다.
ADJUSTMENT_TWO_TO_THREE_DAYS 전환 조정 지연시간 버킷은 2~3일입니다. 2일은 포함되지만 3일은 포함되지 않습니다.
ADJUSTMENT_THREE_TO_FOUR_DAYS 전환 조정 지연시간 버킷은 3~4일입니다. 3일은 포함되지만 4일은 포함되지 않습니다.
ADJUSTMENT_FOUR_TO_FIVE_DAYS 전환 조정 지연시간 버킷은 4~5일입니다. 4일은 포함되지만 5일은 포함되지 않습니다.
ADJUSTMENT_FIVE_TO_SIX_DAYS 전환 조정 지연시간 버킷은 5~6일입니다. 5일이 포함되고 6일이 포함되지 않습니다.
ADJUSTMENT_SIX_TO_SEVEN_DAYS 전환 조정 지연시간 버킷은 6~7일입니다. 6일은 포함되지만 7일은 포함되지 않습니다.
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS 전환 조정 지연시간 버킷은 7~8일입니다. 7일은 포함되지만 8일은 포함되지 않습니다.
ADJUSTMENT_EIGHT_TO_NINE_DAYS 전환 조정 지연시간 버킷은 8~9일입니다. 8일은 포함되지만 9일은 포함되지 않습니다.
ADJUSTMENT_NINE_TO_TEN_DAYS 전환 조정 지연시간 버킷은 9~10일입니다. 9일은 포함되지만 10일은 포함되지 않습니다.
ADJUSTMENT_TEN_TO_ELEVEN_DAYS 전환 조정 지연시간 버킷은 10~11일입니다. 10일이 포함되고 11일이 포함되지 않습니다.
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS 전환 조정 지연시간 버킷은 11~12일입니다. 11일은 포함되지만 12일은 포함되지 않습니다.
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS 전환 조정 지연시간 버킷을 12일에서 13일로 설정했습니다. 12일은 포함되지만 13일은 포함되지 않습니다.
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS 전환 조정 지연시간 버킷은 13~14일입니다. 13일은 포함되지만 14일은 포함되지 않습니다.
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS 전환 조정 지연시간 버킷을 14일에서 21일로 설정했습니다. 14일은 포함되지만 21일은 포함되지 않습니다.
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS 전환 조정 지연시간 버킷은 21~30일입니다. 21일은 포함되지만 30일은 포함되지 않습니다.
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS 전환 조정 지연시간 버킷은 30~45일입니다. 30일은 포함되지만 45일은 포함되지 않습니다.
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS 전환 조정 지연시간 버킷은 45~60일입니다. 45일은 포함되지만 60일은 포함되지 않습니다.
ADJUSTMENT_SIXTY_TO_NINETY_DAYS 전환 조정 지연시간 버킷은 60~90일입니다. 60일은 포함되지만 90일은 포함되지 않습니다.
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS 전환 조정 지연시간 버킷은 90~145일입니다. 90일은 포함되지만 145일은 포함되지 않습니다.
CONVERSION_UNKNOWN 전환 지연시간 버킷은 알 수 없습니다. Google Ads에서 전환 지연시간 버킷을 사용할 수 있게 된 날짜 이전의 날짜입니다.
ADJUSTMENT_UNKNOWN 전환 조정 지연시간 버킷은 알 수 없습니다. Google Ads에서 전환 조정 지연시간 버킷을 사용할 수 있게 된 이전 날짜입니다.

ExternalConversionSource

ConversionAction과 연결된 외부 전환 소스입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서 알 수 없는 값을 나타냅니다.
WEBPAGE 사용자가 광고를 본 후 특정 웹페이지로 이동할 때 발생하는 전환. Google Ads UI에서 '웹사이트'로 표시됩니다.
ANALYTICS 연결된 Google 애널리틱스 목표 또는 거래에서 발생한 전환으로, Google Ads UI에 '애널리틱스'로 표시됩니다.
UPLOAD ConversionUploadService를 통해 업로드된 웹사이트 전환. Google Ads UI에 '클릭에서 가져오기'로 표시됩니다.
AD_CALL_METRICS 사용자가 광고에서 직접 전화번호 광고 확장을 클릭할 때 발생하는 전환. Google Ads UI에서 '광고에서 연결된 통화'로 표시됩니다.
WEBSITE_CALL_METRICS 사용자가 광고를 클릭한 후 광고주의 웹사이트에서 설치된 자바스크립트에 의해 동적으로 생성된 전화번호로 전화를 걸 때 발생하는 전환입니다. Google Ads UI에서는 '웹사이트에서 연결된 통화'로 표시됩니다.
STORE_VISITS 사용자가 Google 광고를 클릭한 후 광고주의 소매점을 방문할 때 발생하는 전환. Google Ads UI에 '매장 방문'으로 표시됩니다.
ANDROID_IN_APP 사용자가 Android 앱에서 구매와 같은 인앱 액션을 취할 때 발생하는 전환입니다. Google Ads UI에서는 'Android 인앱 액션'으로 표시됩니다.
IOS_IN_APP iOS 앱에서 구매와 같은 인앱 액션을 사용자가 취할 때 발생하는 전환입니다. Google Ads UI에서는 'iOS 인앱 액션'으로 표시됩니다.
IOS_FIRST_OPEN 사용자가 iOS 앱을 처음으로 열 때 발생하는 전환으로, Google Ads UI에 'iOS 앱 설치 (처음 열 때)'로 표시됩니다.
APP_UNSPECIFIED AppPlatform이 제공되지 않은 기존 앱 전환으로, Google Ads UI에서 '모바일 앱'으로 표시됩니다.
ANDROID_FIRST_OPEN 사용자가 Android 앱을 처음으로 열 때 발생하는 전환으로, Google Ads UI에 'Android 앱 설치 (처음 열 때)'로 표시됩니다.
UPLOAD_CALLS ConversionUploadService를 통해 업로드되는 통화 전환이며 Google Ads UI에 '통화에서 가져오기'로 표시됩니다.
FIREBASE 연결된 Firebase 이벤트에서 발생한 전환입니다. Google Ads UI에 'Firebase'로 표시됩니다.
CLICK_TO_CALL 사용자가 휴대전화 번호를 클릭할 때 발생하는 전환. Google Ads UI에서 '전화번호 클릭수'로 표시됩니다.
SALESFORCE Salesforce에서 발생한 전환이며 Google Ads UI에 'Salesforce.com'으로 표시됩니다.
STORE_SALES_CRM CRM에서 기록한 오프라인 매장 구매에서 발생한 전환이며, Google Ads UI에 '매장 판매 (데이터 파트너)'로 표시됩니다.
STORE_SALES_PAYMENT_NETWORK 결제 네트워크의 오프라인 매장 구매에서 발생한 전환. Google Ads UI에서 '매장 판매 (결제 네트워크)'로 표시됩니다.
GOOGLE_PLAY 코드 없는 Google Play 전환. Google Ads UI에 'Google Play'로 표시됩니다.
THIRD_PARTY_APP_ANALYTICS 연결된 서드 파티 앱 애널리틱스 이벤트에서 발생한 전환으로, Google Ads UI에 '서드 파티 앱 애널리틱스'로 표시됩니다.
GOOGLE_ATTRIBUTION Google Attribution에서 제어하는 전환
STORE_SALES_DIRECT_UPLOAD 퍼스트 파티 또는 서드 파티 판매자 데이터 업로드에 기반한 매장 판매 전환 Google Ads UI에 '매장 판매 (직접 업로드)'로 표시됩니다.
STORE_SALES 퍼스트 파티 또는 서드 파티 판매자 데이터 업로드 및/또는 결제 네트워크의 카드를 사용한 오프라인 매장 구매를 기반으로 한 매장 판매 전환 Google Ads UI에 '매장 판매'로 표시됩니다.
SEARCH_ADS_360 Search Ads 360 플러드라이트 데이터에서 가져온 전환입니다.
GOOGLE_HOSTED 광고와 상호작용한 후 Google 제품 및 서비스에서 오프라인 액션을 추적하는 전환입니다.
FLOODLIGHT 플러드라이트 태그에서 보고된 전환수입니다.
ANALYTICS_SEARCH_ADS_360 Google 애널리틱스에서 Search Ads 360 전용으로 집계되는 전환입니다. Google Ads UI에 애널리틱스 (SA360)로 표시됩니다.
FIREBASE_SEARCH_ADS_360 Search Ads 360에 연결된 Firebase 이벤트에서 발생하는 전환입니다.
DISPLAY_AND_VIDEO_360_FLOODLIGHT DV360용 플러드라이트에서 보고된 전환입니다.

HotelRateType

가능한 호텔 요금 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
UNAVAILABLE 요금 유형 정보가 없습니다.
PUBLIC_RATE 누구나 이용 가능한 요금입니다.
QUALIFIED_RATE 멤버십 프로그램 요금이 사용 가능하며 공개 요금 제공과 같은 기본 요건을 충족해야 합니다. UI 처리에서 공개 요금에 취소선이 표시되며 사용자에게 할인이 제공됨을 나타냅니다. 특별 요금에 대한 자세한 내용은 https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates 페이지를 참고하세요.
PRIVATE_RATE 일부 자격 기준(예: 모든 로그인한 사용자, 모바일 사용자의 20%, 캐나다의 모든 모바일 사용자 등)을 충족하는 사용자에게 제공되는 요금입니다.

HotelPriceBucket

가능한 호텔 가격 버킷을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
LOWEST_UNIQUE 단독으로 최저가로 즐기세요. 파트너의 가격이 최저가이며 이 가격의 변동 폭이 작은 파트너는 없습니다.
LOWEST_TIED 최저가로 제공됩니다. 파트너가 최저가에 약간의 변동이 있는 경우
NOT_LOWEST 최저가는 아닙니다. 파트너가 최저 가격의 변동폭이 크지 않습니다.
ONLY_PARTNER_SHOWN 파트너만 표시되었습니다.

키워드

키워드 기준 세그먼트입니다.

JSON 표현
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
입력란
info

object (KeywordInfo)

키워드 정보

adGroupCriterion

string

AdGroupCriterion 리소스 이름입니다.

SearchEngineResultsPageType

검색엔진 결과 페이지의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ADS_ONLY 검색엔진 결과 페이지에는 광고만 포함되어 있었습니다.
ORGANIC_ONLY 검색엔진 결과 페이지에는 자연 검색결과만 포함되었습니다.
ADS_AND_ORGANIC 광고와 자연 검색결과 모두 검색엔진 결과 페이지에 포함되었습니다.

SearchTermMatchType

변형을 포함하여 광고를 트리거하는 키워드에 대해 가능한 검색 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BROAD 확장검색
EXACT 완전 일치
PHRASE 구문검색
NEAR_EXACT 일치검색 (유사 검색어)
NEAR_PHRASE 구문검색 (유사 검색어)

슬롯

광고의 가능한 위치를 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
SEARCH_SIDE Google 검색: 측면
SEARCH_TOP Google 검색: 상단
SEARCH_OTHER Google 검색: 기타
CONTENT XXXX [Google에서의 직책] 입니다.
SEARCH_PARTNER_TOP 검색 파트너: 상단
SEARCH_PARTNER_OTHER 검색 파트너: 기타
MIXED 교차 네트워크.

ConversionValueRulePrimaryDimension

전환 가치 규칙 통계의 기본 측정기준을 식별합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
NO_RULE_APPLIED 가치 규칙을 사용 설정한 후 무가치 규칙이 적용된 전환의 경우
ORIGINAL 가치 규칙 적용 전환의 경우: 기존 통계입니다.
NEW_VS_RETURNING_USER 신규 또는 재구매 고객 조건이 충족되는 경우
GEO_LOCATION 쿼리 시간 지리적 위치 조건이 충족되는 경우
DEVICE 쿼리 시간 탐색 기기 조건이 충족되는 경우
AUDIENCE 쿼리 시간 잠재고객 조건이 충족되는 경우
MULTIPLE 여러 규칙이 적용되는 경우

SkAdNetworkUserType

SkAdNetwork 사용자 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
UNAVAILABLE 포스트백에 값이 없거나 다른 이유로 이 데이터가 없습니다.
NEW_INSTALLER 사용자가 앱을 처음으로 설치했습니다.
REINSTALLER 사용자가 이전에 앱을 설치했습니다.

SkAdNetworkAdEventType

SkAdNetwork 광고 이벤트 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
UNAVAILABLE 포스트백에 값이 없거나 다른 이유로 이 데이터가 없습니다.
INTERACTION 사용자가 광고와 상호작용했습니다.
VIEW 사용자가 광고를 봤습니다.

SkAdNetworkSourceApp

SkAdNetworkSourceApp 세그먼트

JSON 표현
{
  "skAdNetworkSourceAppId": string
}
입력란
skAdNetworkSourceAppId

string

iOS 스토어 키트 광고 네트워크 설치를 유도한 광고가 게재된 앱 ID입니다.

SkAdNetworkAttributionCredit

SkAdNetwork 기여 분석 크레딧을 나열합니다.

열거형
UNSPECIFIED 기본값 이 값은 null과 동일합니다.
UNKNOWN 이 API 버전에서 알 수 없는 값입니다. true enum 값은 이 API 버전에서 반환될 수 없거나 아직 지원되지 않습니다.
UNAVAILABLE 포스트백에 값이 없거나 다른 이유로 이 데이터가 없습니다.
WON 광고 기여 분석을 얻은 광고 네트워크는 Google이었습니다.
CONTRIBUTED Google이 기여 요건을 충족하지만 낙찰받지 못했습니다.

AssetInteractionTarget

AssetInteractionTarget 세그먼트입니다.

JSON 표현
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
입력란
asset

string

애셋 리소스 이름입니다.

interactionOnThisAsset

boolean

CustomerAsset, CampaignAsset, AdGroupAsset 측정항목과만 함께 사용하세요. 상호작용 측정항목이 애셋 자체에서 발생했는지 아니면 다른 애셋 또는 광고 단위에서 발생했는지를 나타냅니다.

ConvertingUserPriorEngagementTypeAndLtvBucket

전환하는 사용자의 이전 참여 유형 및 평생 가치 버킷을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
NEW 전환 사용자가 광고주에게 처음 발생합니다.
RETURNING 전환 중인 사용자가 광고주로 돌아오고 있습니다. 재방문의 정의는 두 번째 매장 방문과 두 번째 온라인 구매 같은 전환 유형에 따라 다릅니다.
NEW_AND_HIGH_LTV 전환 사용자는 광고주에게 처음 발생하며 평생 가치가 높습니다.