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)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "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)
  },
  "campaignLifecycleGoal": {
    object (CampaignLifecycleGoal)
  },
  "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)
  },
  "customerLifecycleGoal": {
    object (CustomerLifecycleGoal)
  },
  "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)
  },
  "localServicesVerificationArtifact": {
    object (LocalServicesVerificationArtifact)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineConversionUploadClientSummary": {
    object (OfflineConversionUploadClientSummary)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productCategoryConstant": {
    object (ProductCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "productLinkInvitation": {
    object (ProductLinkInvitation)
  },
  "recommendation": {
    object (Recommendation)
  },
  "recommendationSubscription": {
    object (RecommendationSubscription)
  },
  "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)
  },
  "localServicesLead": {
    object (LocalServicesLead)
  },
  "localServicesLeadConversation": {
    object (LocalServicesLeadConversation)
  },
  "androidPrivacySharedKeyGoogleAdGroup": {
    object (AndroidPrivacySharedKeyGoogleAdGroup)
  },
  "androidPrivacySharedKeyGoogleCampaign": {
    object (AndroidPrivacySharedKeyGoogleCampaign)
  },
  "androidPrivacySharedKeyGoogleNetworkType": {
    object (AndroidPrivacySharedKeyGoogleNetworkType)
  },
  "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)

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

object (AssetGroupTopCombinationView)

쿼리에서 참조된 애셋 그룹 상단 조합 보기입니다.
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)

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

object (CampaignLifecycleGoal)

쿼리에서 참조된 캠페인 수명 주기 목표입니다.
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)

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

object (CustomerLifecycleGoal)

쿼리에서 참조된 고객 수명 주기 목표입니다.
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)

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

object (LocalServicesVerificationArtifact)

쿼리에서 참조된 지역 서비스 인증 아티팩트입니다.
mobileAppCategoryConstant

object (MobileAppCategoryConstant)

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

object (MobileDeviceConstant)

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

object (OfflineConversionUploadClientSummary)

오프라인 전환 업로드 클라이언트 요약입니다.
offlineUserDataJob

object (OfflineUserDataJob)

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

object (OperatingSystemVersionConstant)

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

object (PaidOrganicSearchTermView)

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

object (QualifyingQuestion)

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

object (ParentalStatusView)

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

object (PerStoreView)

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

object (ProductCategoryConstant)

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

object (ProductGroupView)

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

object (Recommendation)

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

object (RecommendationSubscription)

쿼리에서 참조된 추천 구독입니다.
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)

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

object (LocalServicesLead)

쿼리에서 참조된 지역 서비스 리드입니다.
localServicesLeadConversation

object (LocalServicesLeadConversation)

쿼리에서 참조된 지역 서비스 리드 대화입니다.
androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

쿼리에서 참조된 Android 개인 정보 보호 공유 키 Google 광고그룹입니다.
androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

쿼리에서 참조된 Android 개인 정보 보호 공유 키 Google 캠페인입니다.
androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

쿼리에서 참조된 Android 개인 정보 보호 공유 키 Google 네트워크 유형입니다.
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),
  "source": enum (AssetSource),
  "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)

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

enum (AssetSource)

출력 전용입니다. 광고그룹 광고 확장 소재의 소스입니다.
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,
  "interactions": 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)

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

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

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

AssetGroupTopCombinationView

광고그룹 광고 확장 소재 조합 사용에 대한 보기입니다.

JSON 표현 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
입력란
resourceName

string

출력 전용입니다. 애셋 그룹 상단 조합 보기의 리소스 이름입니다. AssetGroup 상위 조합 보기 리소스 이름의 형식은 다음과 같습니다. "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

출력 전용입니다. 함께 게재된 애셋의 상위 조합입니다.

AssetGroupAssetCombinationData

애셋 그룹 애셋 조합 데이터

JSON 표현 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
입력란
assetCombinationServedAssets[]

object (AssetUsage)

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

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,
  "interactions": 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)

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

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를 통한 쿠폰 사용으로 인한 변경사항)입니다.
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION 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}

MediaFile

미디어 파일입니다.

JSON 표현 
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
입력란
resourceName

string

변경할 수 없습니다. 미디어 파일의 리소스 이름입니다. 미디어 파일 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/mediaFiles/{media_file_id}
type

enum (MediaType)

변경할 수 없습니다. 미디어 파일의 유형입니다.
mimeType

enum (MimeType)

출력 전용입니다. 미디어 파일의 MIME 형식입니다.
id

string (int64 format)

출력 전용입니다. 미디어 파일의 ID입니다.
sourceUrl

string

변경할 수 없습니다. 원본 미디어 파일을 다운로드한 출처의 URL 또는 파일 이름입니다. AUDIO 및 IMAGE 유형의 미디어에만 사용됩니다.
name

string

변경할 수 없습니다. 미디어 파일의 이름입니다. 이름은 이전에 업로드된 미디어를 클라이언트가 식별하는 데 사용될 수 있습니다.
fileSize

string (int64 format)

출력 전용입니다. 미디어 파일의 크기(바이트)입니다.
통합 필드 mediatype. 미디어 파일의 특정 유형입니다. mediatype은 다음 중 하나여야 합니다.
image

object (MediaImage)

변경할 수 없습니다. 이미지를 캡슐화합니다.
mediaBundle

object (MediaBundle)

변경할 수 없습니다. 콘텐츠에 HTML5 애셋이 포함된 ZIP 보관 미디어입니다.
audio

object (MediaAudio)

출력 전용입니다. 오디오를 캡슐화합니다.
video

object (MediaVideo)

변경할 수 없습니다. 동영상을 캡슐화합니다.

MediaType

미디어 유형입니다.

열거형
UNSPECIFIED 미디어 유형이 지정되지 않았습니다.
UNKNOWN

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

이 값은 응답 전용입니다.
IMAGE 이미지 광고에 사용되는 정적 이미지입니다.
ICON 지도 광고에 사용되는 작은 이미지입니다.
MEDIA_BUNDLE 템플릿 광고의 필드에서 사용되는 ZIP 파일입니다.
AUDIO 오디오 파일입니다.
VIDEO 동영상 파일입니다.
DYNAMIC_IMAGE 애니메이션 GIF 등의 애니메이션 이미지

MediaImage

이미지를 캡슐화합니다.

JSON 표현 
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
입력란
data

string (bytes format)

변경할 수 없습니다. RAW 이미지 데이터입니다.

base64 인코딩 문자열입니다.
fullSizeImageUrl

string

출력 전용입니다. 이미지의 원본 크기 버전 URL입니다.
previewSizeImageUrl

string

출력 전용입니다. 이미지의 미리보기 크기 버전에 대한 URL입니다.

MediaBundle

콘텐츠에 HTML5 애셋이 포함된 ZIP 보관 미디어를 나타냅니다.

JSON 표현 
{
  "data": string,
  "url": string
}
입력란
data

string (bytes format)

변경할 수 없습니다. 압축된 원시 데이터입니다.

base64 인코딩 문자열입니다.
url

string

출력 전용입니다. 업로드된 압축된 데이터에 액세스하는 URL입니다. 예: https://tpc.googlesyndication.com/simgad/123 이 입력란은 읽기 전용입니다.

MediaAudio

오디오를 캡슐화합니다.

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

string (int64 format)

출력 전용입니다. 오디오 길이(밀리초)입니다.

MediaVideo

동영상을 캡슐화합니다.

JSON 표현 
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
입력란
adDurationMillis

string (int64 format)

출력 전용입니다. 동영상의 길이(밀리초)입니다.
youtubeVideoId

string

변경할 수 없습니다. YouTube 동영상 ID (YouTube URL에 표시됨)입니다. 접두사 'https://www.youtube.com/watch?v='를 이 ID에 추가하면 동영상의 YouTube 스트리밍 URL을 가져올 수 있습니다.
advertisingIdCode

string

출력 전용입니다. 미국 광고 대행사 협회에서 정의한 본 동영상에 대한 광고 디지털 식별 코드로, 주로 TV 광고에 사용됩니다.
isciCode

string

출력 전용입니다. 이 동영상의 Industry Standard Commercial Identifier 코드로 주로 TV 광고에 사용됩니다.

LocalServicesVerificationArtifact

지역 서비스 확인 리소스입니다.

JSON 표현 
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesVerificationArtifactStatus),
  "artifactType": enum (LocalServicesVerificationArtifactType),
  "id": string,

  // Union field artifact_data can be only one of the following:
  "backgroundCheckVerificationArtifact": {
    object (BackgroundCheckVerificationArtifact)
  },
  "insuranceVerificationArtifact": {
    object (InsuranceVerificationArtifact)
  },
  "licenseVerificationArtifact": {
    object (LicenseVerificationArtifact)
  }
  // End of list of possible types for union field artifact_data.
}
입력란
resourceName

string

변경할 수 없습니다. 지역 서비스 인증의 리소스 이름입니다. 지역 서비스 인증 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}
creationDateTime

string

출력 전용입니다. 이 인증 아티팩트가 생성된 시점의 타임스탬프입니다. 형식은 Google Ads 계정 시간대의 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'
status

enum (LocalServicesVerificationArtifactStatus)

출력 전용입니다. 인증 아티팩트의 상태입니다.
artifactType

enum (LocalServicesVerificationArtifactType)

출력 전용입니다. 인증 아티팩트의 유형입니다.
id

string (int64 format)

출력 전용입니다. 인증 아티팩트의 ID입니다.
통합 필드 artifact_data. 인증 정보의 유형입니다. artifact_data는 다음 중 하나여야 합니다.
backgroundCheckVerificationArtifact

object (BackgroundCheckVerificationArtifact)

출력 전용입니다. 백그라운드 확인 인증 아티팩트
insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

출력 전용입니다. 보험 확인 아티팩트.
licenseVerificationArtifact

object (LicenseVerificationArtifact)

출력 전용입니다. 라이선스 확인 아티팩트.

LocalServicesVerificationArtifactStatus

지역 서비스 인증 아티팩트의 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
PASSED 아티팩트가 인증을 통과했습니다.
FAILED 아티팩트 인증에 실패했습니다.
PENDING 아티팩트를 인증하는 중입니다.
NO_SUBMISSION 아티팩트가 인증되기 전에 사용자가 정보를 업로드해야 합니다.
CANCELLED 사용자가 아티팩트를 취소했습니다.

LocalServicesVerificationArtifactType

가능한 지역 서비스 인증 아티팩트의 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BACKGROUND_CHECK 백그라운드 확인 확인 아티팩트.
INSURANCE 보험 인증 아티팩트.
LICENSE 라이선스 확인 아티팩트

BackgroundCheckVerificationArtifact

로컬 서비스 백그라운드 확인 관련 정보를 보유하는 프로토콜입니다.

JSON 표현 
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
입력란
caseUrl

string

출력 전용입니다. 백그라운드 케이스에 액세스하는 URL입니다.
finalAdjudicationDateTime

string

출력 전용입니다. 이 백그라운드 확인 케이스 결과가 판정된 시점의 타임스탬프입니다. 형식은 Google Ads 계정 시간대의 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'

InsuranceVerificationArtifact

지역 서비스 보험과 관련된 정보를 보유하는 프로토콜입니다.

JSON 표현 
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
입력란
amountMicros

string (int64 format)

출력 전용입니다. 보험 금액. 보험 문서에 언급된 통화의 '마이크로'로 측정됩니다.
rejectionReason

enum (LocalServicesInsuranceRejectionReason)

출력 전용입니다. 보험 서류의 거부 사유입니다.
insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

출력 전용입니다. 업로드된 보험 서류에 대한 정보가 포함된 읽기 전용 필드입니다.

LocalServicesInsuranceRejectionReason

지역 서비스 보험 인증 아티팩트의 가능한 거부 이유를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BUSINESS_NAME_MISMATCH 업체 이름이 지역 서비스 광고의 업체 이름과 일치하지 않습니다.
INSURANCE_AMOUNT_INSUFFICIENT 보험 금액이 지역 + 카테고리 ID 조합에 대한 법적 요약 문서에 표시된 요건을 충족하지 않습니다.
EXPIRED 보험 서류가 만료되었습니다.
NO_SIGNATURE 보험 서류에 서명이 없습니다.
NO_POLICY_NUMBER 보험 문서에 보험증권 번호가 누락되었습니다.
NO_COMMERCIAL_GENERAL_LIABILITY 상업적 일반 책임(CGL) 상자가 보험 서류에 표시되어 있지 않습니다.
EDITABLE_FORMAT 보험 문서는 수정 가능한 형식입니다.
CATEGORY_MISMATCH 보험 문서에서 특정 카테고리의 보험에는 적용되지 않습니다.
MISSING_EXPIRATION_DATE 보험 서류에 만료일이 누락되었습니다.
POOR_QUALITY 보험 서류의 품질이 좋지 않음 - 이미지가 흐리거나 읽을 수 없음 등
POTENTIALLY_EDITED 보험 문서가 수정된 것으로 의심됩니다.
WRONG_DOCUMENT_TYPE 보험 서류는 허용되지 않습니다. 예를 들어 보험 제안서가 있지만 누락된 보장 내용은 인정되지 않습니다.
NON_FINAL 보험 서류는 최종 서류가 아닙니다.
OTHER 보험 문서에 명시적으로 나열되지 않은 또 다른 결함이 있습니다.

LocalServicesDocumentReadOnly

읽기 전용 액세스 가능한 데이터가 포함된 지역 서비스 문서

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

string

이미 업로드된 지역 서비스 문서에 액세스하는 URL입니다.

LicenseVerificationArtifact

로컬 서비스 라이선스와 관련된 정보를 보유한 프로토콜입니다.

JSON 표현 
{
  "licenseType": string,
  "licenseNumber": string,
  "licenseeFirstName": string,
  "licenseeLastName": string,
  "rejectionReason": enum (LocalServicesLicenseRejectionReason),
  "licenseDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
입력란
licenseType

string

출력 전용입니다. 라이선스 유형 / 이름
licenseNumber

string

출력 전용입니다. 면허 번호.
licenseeFirstName

string

출력 전용입니다. 라이선스 수혜자의 이름
licenseeLastName

string

출력 전용입니다. 라이선스 수혜자의 성입니다.
rejectionReason

enum (LocalServicesLicenseRejectionReason)

출력 전용입니다. 라이선스 거부 사유입니다.
licenseDocumentReadonly

object (LocalServicesDocumentReadOnly)

출력 전용입니다. 업로드된 라이선스 서류에 대한 정보가 포함된 읽기 전용 입력란입니다.

LocalServicesLicenseRejectionReason

로컬 서비스 라이선스 인증 아티팩트의 가능한 거부 이유를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BUSINESS_NAME_MISMATCH 업체 이름이 지역 서비스 광고의 업체 이름과 일치하지 않습니다.
UNAUTHORIZED 라이선스가 승인되지 않았거나 취소되었습니다.
EXPIRED 라이선스가 만료되었습니다.
POOR_QUALITY 라이선스 품질이 낮음 - 이미지가 흐리거나 읽을 수 없음 등
UNVERIFIABLE 합법적인 이미지가 아니므로 라이선스를 확인할 수 없습니다.
WRONG_DOCUMENT_OR_ID 라이선스가 요청된 문서 유형이 아니거나 잘못된 ID를 포함하고 있습니다.
OTHER 라이선스에 명시적으로 나열되지 않은 다른 결함이 있습니다.

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 태블릿.

OfflineConversionUploadClientSummary

오프라인 전환 업로드 클라이언트 요약입니다.

JSON 표현 
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
입력란
resourceName

string

출력 전용입니다. 오프라인 전환 업로드 클라이언트 요약의 리소스 이름입니다. 오프라인 전환 업로드 클라이언트 요약 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/offlineConversionUploadClientSummaries/{client}
client

enum (OfflineEventUploadClient)

출력 전용입니다. 업로드 이벤트의 클라이언트 유형입니다.
status

enum (OfflineConversionDiagnosticStatus)

출력 전용입니다. 오프라인 전환 고객 요약의 전반적인 상태입니다. 상태는 가장 최근 날짜를 기준으로 생성되며 업로드 통계가 표시됩니다.
totalEventCount

string (int64 format)

출력 전용입니다. 업로드된 총 이벤트 수입니다.
successfulEventCount

string (int64 format)

출력 전용입니다. 업로드된 총 이벤트 수입니다.
successRate

number

출력 전용입니다. 성공률입니다.
lastUploadDateTime

string

출력 전용입니다. 최신 업로드 배치의 날짜입니다. 형식은 'yyyy-mm-dd hh:mm:ss'이며 Google Ads 계정의 시간대를 사용합니다.
dailySummaries[]

object (OfflineConversionSummary)

출력 전용입니다. 지난 N일별 기록 통계 요약입니다.
jobSummaries[]

object (OfflineConversionSummary)

출력 전용입니다. 마지막 N개 작업별 기록 통계 요약입니다.
alerts[]

object (OfflineConversionAlert)

출력 전용입니다. 각 오류 코드의 세부정보입니다. 알림은 업로드 통계가 있는 가장 최근 날짜를 기준으로 생성됩니다.

OfflineEventUploadClient

클라이언트의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
GOOGLE_ADS_API Google Ads API입니다.
GOOGLE_ADS_WEB_CLIENT Google Ads UI, SFTP 등 여러 소스를 포함할 수 있는 Google Ads 웹 클라이언트
ADS_DATA_CONNECTOR 연결 플랫폼입니다.

OfflineConversionDiagnosticStatus

오프라인 처리 설정의 가능한 상태

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EXCELLENT 오프라인 데이터 수집 설정이 활성 상태이며 다운스트림 처리에 최적화되어 있습니다.
GOOD 오프라인 처리 설정이 활성 상태이지만, 추가로 개선할 수 있는 부분이 있습니다. 알림을 확인합니다.
NEEDS_ATTENTION 오프라인 처리 설정이 활성 상태이지만, 주의가 필요한 오류가 있습니다. 알림을 확인합니다.
NO_RECENT_UPLOAD 오프라인 처리 설정에서 지난 28일 동안 데이터를 받지 못했습니다. 문제가 있을 수 있습니다.

OfflineConversionSummary

업로드 날짜 또는 작업별로 그룹화된 이전 업로드 요약입니다.

JSON 표현 
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
입력란
successfulCount

string (int64 format)

출력 전용입니다. 성공한 이벤트의 총 개수입니다.
failedCount

string (int64 format)

출력 전용입니다. 실패한 이벤트의 총 개수입니다.
통합 필드 dimension_key. 요약용 측정기준 키입니다. dimension_key은 다음 중 하나여야 합니다.
jobId

string (int64 format)

출력 전용입니다. 마지막 N개 작업의 측정기준 키
uploadDate

string

출력 전용입니다. 지난 N일 동안의 측정기준 키입니다.

OfflineConversionAlert

오프라인 전환 고객 요약 알림입니다.

JSON 표현 
{
  "error": {
    object (OfflineConversionError)
  },
  "errorPercentage": number
}
입력란
error

object (OfflineConversionError)

출력 전용입니다. 오프라인 전환 클라이언트 알림에 대한 오류입니다.
errorPercentage

number

출력 전용입니다. 오류율로, 이 필드의 범위는 [0, 1.0]이어야 합니다.

OfflineConversionError

오프라인 전환 클라이언트 요약에 발생할 수 있는 오류입니다.

JSON 표현 
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
입력란
통합 필드 error_code. 설명에 오류가 있습니다. error_code은 다음 중 하나여야 합니다.
collectionSizeError

enum (CollectionSizeError)

출력 전용입니다. 컬렉션 크기 오류입니다.
conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

출력 전용입니다. 전환 조정 업로드 오류입니다.
conversionUploadError

enum (ConversionUploadError)

출력 전용입니다. 전환 업로드 오류입니다.
dateError

enum (DateError)

출력 전용입니다. 날짜 오류입니다.
distinctError

enum (DistinctError)

출력 전용입니다. 확실한 오류입니다.
fieldError

enum (FieldError)

출력 전용입니다. 입력란에 오류가 있습니다.
mutateError

enum (MutateError)

출력 전용입니다. 변형 오류입니다.
notAllowlistedError

enum (NotAllowlistedError)

출력 전용입니다. 허용 목록에 없는 오류입니다.
stringFormatError

enum (StringFormatError)

출력 전용입니다. 문자열 형식 오류입니다.
stringLengthError

enum (StringLengthError)

출력 전용입니다. 문자열 길이 오류입니다.

CollectionSizeError

가능한 컬렉션 크기 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
TOO_FEW 너무 적습니다.
TOO_MANY 너무 많습니다.

ConversionAdjustmentUploadError

발생할 수 있는 전환 조정 업로드 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
TOO_RECENT_CONVERSION_ACTION 방금 생성된 전환 액션으로는 이벤트를 가져올 수 없습니다. 6시간 후에 가져오기를 다시 시도하세요.
CONVERSION_ALREADY_RETRACTED 전환이 이미 철회되었습니다. 조정이 처리되지 않았습니다.
CONVERSION_NOT_FOUND 이 전환 액션 및 전환 식별자의 전환을 찾을 수 없습니다. 전환 식별자가 올바른 전환 액션과 연결되어 있는지 확인한 후 다시 시도해 주세요.
CONVERSION_EXPIRED 54일 이전에 발생한 전환은 조정할 수 없습니다.
ADJUSTMENT_PRECEDES_CONVERSION 조정에 연결된 전환 이전에 발생한 adjustmentDateTime이(가) 있습니다. adjustmentDateTime이(가) 올바른지 확인한 후 다시 시도해 주세요.
MORE_RECENT_RESTATEMENT_FOUND 연결된 전환에 대한 최근 조정(adjustmentDateTime)이 이미 보고되었습니다. adjustmentDateTime 조정 값이 올바른지 확인한 후 다시 시도해 주세요.
TOO_RECENT_CONVERSION 너무 최근에 전환이 발생하여 조정을 기록할 수 없습니다. 최소 24시간 전에 발생한 전환을 조정해 보세요.
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE 기본값을 사용하도록 설정된 전환은 조정할 수 없습니다. 전환 액션 값 설정을 확인한 후 다시 시도해 주세요.
TOO_MANY_ADJUSTMENTS_IN_REQUEST 단일 API 요청으로 업로드하는 조정의 수를 2001개 미만으로 하세요.
TOO_MANY_ADJUSTMENTS 전환이 이미 최대 횟수로 조정되었습니다. 기존 전환을 필요한 만큼만 조정하시기 바랍니다.
RESTATEMENT_ALREADY_EXISTS 이전에 동일한 adjustmentDateTime로 다시 작성된 전환이 있습니다. 조정에 정확하고 고유한 adjustmentDateTime이(가) 있는지 확인한 후 다시 시도하세요.
DUPLICATE_ADJUSTMENT_IN_REQUEST 가져온 조정에 동일한 adjustmentDateTime을(를) 가진 중복 전환 조정이 있습니다. 조정에 올바른 adjustmentDateTime이(가) 있는지 확인한 후 다시 시도해 주세요.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 전환 설정에서 고객 데이터 처리 약관에 동의했는지 확인하고 다시 시도하세요.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 지정된 전환 액션으로는 향상된 전환을 사용할 수 없습니다.
INVALID_USER_IDENTIFIER SHA-256을 사용하여 사용자 제공 데이터를 해싱하고 가이드라인에 따라 정규화해야 합니다.
UNSUPPORTED_USER_IDENTIFIER SHA-256을 사용하여 해싱된 이메일 또는 전화번호와 같은 사용자 제공 데이터를 사용하고 다시 시도하세요.
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET gclidDateTimePair와 orderId를 모두 설정할 수 없습니다. 유형 1개만 사용한 후 다시 시도해 주세요.
CONVERSION_ALREADY_ENHANCED 전환에 주문 ID 및 전환 액션이 동일한 개선 사항이 이미 있습니다. 데이터가 올바르게 구성되었는지 확인한 후 다시 시도해 주세요.
DUPLICATE_ENHANCEMENT_IN_REQUEST 전환 액션과 주문 ID가 동일한 개선 사항이 여러 개 있습니다. 데이터가 올바르게 구성되었는지 확인한 후 다시 시도해 주세요.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT Google 고객 데이터 정책으로 인해 향상된 전환을 사용할 수 없는 계정입니다. Google 담당자에게 문의하세요.
MISSING_ORDER_ID_FOR_WEBPAGE 웹사이트 전환을 조정하려면 주문 ID (예: 거래 ID)가 필요합니다. 웹사이트 태그에서 주문 ID를 포착하고 조정과 함께 동일한 주문 ID를 전송해야 합니다.
ORDER_ID_CONTAINS_PII 개인 식별 정보 (PII)가 포함된 주문 ID로는 조정을 사용할 수 없습니다.
INVALID_JOB_ID 요청에 제공된 작업 ID가 허용된 범위를 벗어납니다. 작업 ID는 [1, 2^31) 범위의 양의 정수여야 합니다.
NO_CONVERSION_ACTION_FOUND 조정 요청에 지정된 전환 액션을 찾을 수 없습니다. 이 계정에서 사용할 수 있는지 확인하세요.
INVALID_CONVERSION_ACTION_TYPE 조정 요청에 지정된 전환 액션의 유형은 조정 업로드에서 지원되지 않습니다. RETRACTION 또는 RESTATEMENT 유형의 전환 조정은 SALESFORCE, UPLOAD_CLICK 또는 WEBPAGE 유형의 전환 액션에만 허용됩니다. ENHANCEMENT 유형의 전환 조정은 WEBPAGE 유형의 전환 액션에만 허용됩니다.

ConversionUploadError

발생할 수 있는 전환 업로드 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
TOO_MANY_CONVERSIONS_IN_REQUEST 단일 요청으로 2,001개 미만의 이벤트를 업로드합니다.
UNPARSEABLE_GCLID 가져온 GCLID를 디코딩할 수 없습니다. 클릭 ID를 수정하지 않았는지 확인합니다.
CONVERSION_PRECEDES_EVENT 가져온 이벤트의 클릭 전 conversionDateTime이(가) 있습니다. conversionDateTime이(가) 올바른지 확인한 후 다시 시도해 주세요.
EXPIRED_EVENT 전환의 클릭연결 기간 전에 클릭이 발생했으므로 가져온 이벤트를 기록할 수 없습니다. 최신 데이터를 가져와야 합니다.
TOO_RECENT_EVENT 해당 식별자 또는 iOS URL 매개변수와 관련된 클릭이 발생한 지 6시간이 지나지 않았습니다. 6시간이 지난 후 다시 시도하세요.
EVENT_NOT_FOUND 클릭이 가져온 이벤트에 기여했다고 간주할 수 없습니다. Google Ads 캠페인에서 발생한 이벤트가 아니기 때문일 수 있습니다.
UNAUTHORIZED_CUSTOMER 클릭 ID 또는 통화가 액세스 권한이 없는 Google Ads 계정과 연결되어 있습니다. 관리자 계정에서 관리하는 계정의 전환을 가져와야 합니다.
TOO_RECENT_CONVERSION_ACTION 방금 생성된 전환 액션으로는 이벤트를 가져올 수 없습니다. 6시간 후에 가져오기를 다시 시도하세요.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME 클릭 당시 클릭 Google Ads 계정의 유효 전환 계정에서 전환 추적이 사용 설정되지 않았습니다.
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 가져온 이벤트에 외부 기여 분석 데이터가 포함되어 있지만 전환 액션이 외부 기여 분석 모델을 사용하도록 설정되지 않았습니다. 전환 액션이 올바르게 구성되어 있는지 확인한 후 다시 시도해 주세요.
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 외부 기여 분석 모델을 사용하도록 전환 액션이 설정되어 있지만, 가져온 이벤트에 데이터가 누락되었습니다. 가져온 이벤트에 외부 기여도와 모든 필수 필드가 포함되어 있는지 확인하세요.
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 외부 기여 분석 모델로 측정되는 전환에는 주문 ID를 사용할 수 없습니다. 전환이 올바르게 구성되고 가져온 이벤트에 필요한 데이터만 포함되었는지 확인한 후 다시 시도하세요.
ORDER_ID_ALREADY_IN_USE 가져온 이벤트에 이전에 기록된 주문 ID가 포함되어 있어 이벤트가 처리되지 않았습니다.
DUPLICATE_ORDER_ID 가져온 이벤트에 주문 ID가 동일한 전환이 여러 개 포함되어 있어 처리되지 않았습니다. 주문 ID가 고유한지 확인한 후 다시 시도해 주세요.
TOO_RECENT_CALL 6시간 이내에 발생한 통화는 가져올 수 없습니다. 6시간 후에 다시 업로드해 보세요.
EXPIRED_CALL 이 전환 액션의 전환 확인 기간 이전에 발생했으므로 통화를 기록할 수 없습니다. 최신 데이터를 가져오도록 가져오기가 구성되어 있는지 확인하세요.
CALL_NOT_FOUND 가져온 일정으로 연결되는 호출 또는 클릭을 찾을 수 없습니다. 데이터 소스가 올바른 식별자를 포함하도록 설정되어 있는지 확인하세요.
CONVERSION_PRECEDES_CALL 호출에 연결된 클릭 앞에 conversionDateTime가 있습니다. conversionDateTime이(가) 올바른지 확인하세요.
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME 호출을 가져왔을 때 해당 클릭의 Google Ads 계정에 연결된 유효 전환 계정에서 전환 추적이 사용 설정되지 않았습니다.
UNPARSEABLE_CALLERS_PHONE_NUMBER 전화번호는 E.164 (+16502531234), 국제 전화 (+64 3-331 6005) 또는 미국 전화번호 (6502531234) 형식이어야 합니다.
CLICK_CONVERSION_ALREADY_EXISTS 가져온 이벤트의 클릭 및 conversionDateTime이 기존 전환과 동일합니다. 고유한 이벤트마다 고유한 conversionDateTime 또는 주문 ID를 사용하고 다시 시도하세요.
CALL_CONVERSION_ALREADY_EXISTS 가져온 통화의 conversionDateTime이(가) 기존 전환과 동일합니다. conversionDateTime이(가) 올바르게 구성되었는지 확인한 후 다시 시도해 주세요.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST 여러 이벤트의 클릭수 및 conversionDateTime이(가) 동일합니다. conversionDateTime이(가) 올바르게 구성되었는지 확인한 후 다시 시도해 주세요.
DUPLICATE_CALL_CONVERSION_IN_REQUEST 여러 이벤트에 동일한 호출과 conversionDateTime가 있습니다. conversionDateTime이(가) 올바르게 구성되었는지 확인한 후 다시 시도해 주세요.
CUSTOM_VARIABLE_NOT_ENABLED 전환 설정에서 맞춤 변수를 사용 설정한 후 다시 시도하세요.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII 개인 식별 정보 (PII)가 포함된 맞춤 변수가 있는 이벤트는 가져올 수 없습니다. 이러한 변수를 삭제하고 다시 시도하세요.
INVALID_CUSTOMER_FOR_CLICK 가져온 이벤트의 클릭이 다른 Google Ads 계정과 연결되어 있습니다. 가져오는 계정이 올바른지 확인하세요.
INVALID_CUSTOMER_FOR_CALL 통화에서 발생한 클릭이 다른 Google Ads 계정과 연결되어 있습니다. 가져오는 계정이 올바른지 확인하세요. '고객'에 대해 conversionTrackingSetting.google_ads_conversion_customer를 쿼리하여 올바른 계정을 확인합니다.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY 전환 소스가 Apple 앱 투명성 추적 (ATT) 정책을 준수하지 않거나 고객이 추적에 동의하지 않아 전환을 가져올 수 없습니다.
CLICK_NOT_FOUND 이 이벤트의 이메일 주소 또는 전화번호와 매칭되는 클릭이 없습니다. 이는 Google Ads 캠페인에서 발생한 클릭이 아니기 때문일 수 있으며, 이 경고는 무시해도 됩니다. 가져온 이벤트가 예상보다 많이 포함되어 있으면 설정을 확인해 보세요.
INVALID_USER_IDENTIFIER SHA-256을 사용하여 사용자 제공 데이터를 해싱하고 가이드라인에 따라 정규화해야 합니다.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER 사용자 제공 데이터는 외부 기여 분석 모델과 함께 사용할 수 없습니다. 다른 기여 분석 모델을 사용하거나 사용자 식별자를 생략하고 다시 시도해 주세요.
UNSUPPORTED_USER_IDENTIFIER 제공된 사용자 식별자는 지원되지 않습니다. 해싱된 이메일 또는 전화번호만 사용하고 다시 시도하세요.
GBRAID_WBRAID_BOTH_SET GBRAID 매개변수와 WBRAID 매개변수를 동시에 사용할 수는 없습니다. 1개만 사용하고 다시 시도하세요.
UNPARSEABLE_WBRAID 이벤트 가져오기 데이터를 파싱할 수 없습니다. wbraid 매개변수가 수정되지 않았는지 확인한 후 다시 시도하세요.
UNPARSEABLE_GBRAID 이벤트 가져오기 데이터를 파싱할 수 없습니다. GBRAID 매개변수가 수정되지 않았는지 확인한 후 다시 시도하세요.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID 클릭당 1회의 전환만 집계하는 방식을 사용하는 전환 액션은 GBRAID 또는 WBRAID 매개변수와 함께 사용할 수 없습니다.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Google 고객 데이터 정책으로 인해 향상된 전환을 사용할 수 없는 계정입니다. Google 담당자에게 문의하세요.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 전환 설정에서 고객 데이터 처리 약관에 동의했는지 확인하고 다시 시도하세요. '고객'에 대해 conversionTrackingSetting.accepted_customer_data_terms를 쿼리하여 설정을 확인할 수 있습니다.
ORDER_ID_CONTAINS_PII 주문 ID에 개인 식별 정보 (PII)가 포함된 이벤트는 가져올 수 없습니다.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 전환 설정에서 리드 확보용 향상된 전환을 사용 설정했는지 확인하고 다시 시도해 주세요. Customer에서 conversionTrackingSetting.enhanced_conversions_for_leads_enabled를 쿼리하여 설정을 확인할 수 있습니다.
INVALID_JOB_ID 요청에 제공된 작업 ID가 허용된 범위를 벗어납니다. 작업 ID는 [1, 2^31) 범위의 양의 정수여야 합니다.
NO_CONVERSION_ACTION_FOUND 업로드 요청에 지정된 전환 액션을 찾을 수 없습니다. 이 계정에서 사용할 수 있는지 확인하세요.
INVALID_CONVERSION_ACTION_TYPE 업로드 요청에 지정된 전환 액션이 전환 업로드용으로 설정되지 않았습니다.

DateError

발생할 수 있는 날짜 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
INVALID_FIELD_VALUES_IN_DATE 제공된 필드 값과 올바른 날짜가 일치하지 않습니다.
INVALID_FIELD_VALUES_IN_DATE_TIME 제공된 필드 값이 올바른 날짜 시간과 일치하지 않습니다.
INVALID_STRING_DATE 날짜 문자열은 yyyy-mm-dd 형식이어야 합니다.
INVALID_STRING_DATE_TIME_MICROS 날짜/시간 문자열은 yyyy-mm-dd hh:mm:ss.ssssss 형식이어야 합니다.
INVALID_STRING_DATE_TIME_SECONDS 날짜/시간 문자열은 yyyy-mm-dd hh:mm:ss 형식이어야 합니다.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET 날짜 시간 문자열은 yyyy-mm-dd hh:mm:ss+|-hh:mm 형식이어야 합니다.
EARLIER_THAN_MINIMUM_DATE 허용되는 최소 날짜보다 이전 날짜입니다.
LATER_THAN_MAXIMUM_DATE 허용되는 최댓값 이후입니다.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE 기간 경계가 올바르지 않습니다.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL 범위 내 두 날짜가 모두 null입니다.

DistinctError

발생할 수 있는 고유한 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
DUPLICATE_ELEMENT 중복된 요소입니다.
DUPLICATE_TYPE 유형이 중복되었습니다.

FieldError

가능한 필드 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
REQUIRED 필수 입력란이 없습니다.
IMMUTABLE_FIELD 변경하려는 필드는 변경할 수 없습니다.
INVALID_VALUE 필드 값이 잘못되었습니다.
VALUE_MUST_BE_UNSET 이 필드는 설정할 수 없습니다.
REQUIRED_NONEMPTY_LIST 반복 필수 입력란이 비어 있습니다.
FIELD_CANNOT_BE_CLEARED 이 필드는 지울 수 없습니다.
BLOCKED_VALUE 필드 값이 이 필드의 차단 목록에 있습니다.
FIELD_CAN_ONLY_BE_CLEARED 지우기를 제외하고 필드의 값은 수정할 수 없습니다.

MutateError

발생 가능한 변경 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
RESOURCE_NOT_FOUND 요청한 리소스를 찾을 수 없습니다.
ID_EXISTS_IN_MULTIPLE_MUTATES 하나의 요청에서 동일한 리소스를 두 번 변경할 수 없습니다.
INCONSISTENT_FIELD_VALUES 필드의 내용이 동일한 데이터를 나타내는 다른 필드와 일치하지 않습니다.
MUTATE_NOT_ALLOWED 요청한 리소스에는 변형이 허용되지 않습니다.
RESOURCE_NOT_IN_GOOGLE_ADS 리소스가 Google Ads에 없습니다. 다른 광고 시스템에 속해 있습니다.
RESOURCE_ALREADY_EXISTS 생성 중인 리소스가 이미 있습니다.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY 이 리소스는 'validateOnly'와 함께 사용할 수 없습니다.
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE 이 작업은 'partialFailure'와 함께 사용할 수 없습니다.
RESOURCE_READ_ONLY 읽기 전용 필드에 쓰기를 시도합니다.

NotAllowlistedError

허용 목록에 추가되지 않았을 수 있는 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 고객이 이 기능에 액세스하도록 허용되어 있지 않습니다.

StringFormatError

가능한 문자열 형식 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
ILLEGAL_CHARS 입력 문자열 값에 허용되지 않는 문자가 포함되어 있습니다.
INVALID_FORMAT 연결된 필드의 입력 문자열 값이 잘못되었습니다.

StringLengthError

가능한 문자열 길이 오류를 설명하는 열거형입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
EMPTY 지정된 필드에는 공백이 아닌 문자가 하나 이상 있어야 합니다.
TOO_SHORT 이름이 너무 짧습니다.
TOO_LONG 이름이 너무 깁니다.

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

ProductCategoryConstant

제품 카테고리.

JSON 표현 
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
입력란
resourceName

string

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

productCategoryConstants/{level}~{categoryId}
categoryId

string (int64 format)

출력 전용입니다. 제품 카테고리의 ID입니다.

이 ID는 이 도움말(https://support.google.com/merchants/answer/6324436)에 설명된 google_product_category ID와 동일합니다.
level

enum (ProductCategoryLevel)

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

enum (ProductCategoryState)

출력 전용입니다. 제품 카테고리의 상태입니다.
localizations[]

object (ProductCategoryLocalization)

출력 전용입니다. 제품 카테고리의 사용 가능한 모든 현지화 목록입니다.
productCategoryConstantParent

string

출력 전용입니다. 상위 제품 카테고리의 리소스 이름입니다.

ProductCategoryState

제품 카테고리의 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 카테고리가 사용 설정되었습니다.
OBSOLETE 더 이상 사용되지 않는 카테고리입니다. 보고 목적으로만 사용됩니다.

ProductCategoryLocalization

제품 카테고리의 현지화입니다.

JSON 표현 
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
입력란
regionCode

string

출력 전용입니다. 현지화된 카테고리의 두 글자로 된 대문자 ISO 3166-1 국가 코드입니다.
languageCode

string

출력 전용입니다. 현지화된 카테고리의 두 글자로 된 ISO 639-1 언어 코드입니다.
value

string

출력 전용입니다. 지정된 언어로 된 카테고리 이름입니다.

ProductGroupView

제품 그룹 보기

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

string

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

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

ProductLinkInvitation

Google Ads 계정과 다른 계정 간의 데이터 공유 연결을 위한 초대를 나타냅니다.

JSON 표현 
{
  "resourceName": string,
  "productLinkInvitationId": string,
  "status": enum (ProductLinkInvitationStatus),
  "type": enum (LinkedProductType),

  // Union field invited_account can be only one of the following:
  "hotelCenter": {
    object (HotelCenterLinkInvitationIdentifier)
  },
  "merchantCenter": {
    object (MerchantCenterLinkInvitationIdentifier)
  }
  // End of list of possible types for union field invited_account.
}
입력란
resourceName

string

변경할 수 없습니다. 제품 연결 초대의 리소스 이름입니다. 제품 연결 초대 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/productLinkInvitations/{productLinkInvitationId}
status

enum (ProductLinkInvitationStatus)

출력 전용입니다. 제품 연결 초대의 상태입니다. 이 필드는 읽기 전용입니다.
type

enum (LinkedProductType)

출력 전용입니다. 초대된 계정의 유형입니다. 이 필드는 읽기 전용이며 {@code GoogleAdsService.SearchGoogleAdsRequest}로 초대를 필터링하는 데 사용할 수 있습니다.
통합 필드 invited_account. 이 Google Ads 계정에 연결하도록 초대된 계정입니다. invited_account은 다음 중 하나여야 합니다.
hotelCenter

object (HotelCenterLinkInvitationIdentifier)

출력 전용입니다. 호텔 연결 초대입니다.
merchantCenter

object (MerchantCenterLinkInvitationIdentifier)

출력 전용입니다. 판매자 센터 연결 초대

HotelCenterLinkInvitationIdentifier

호텔 계정의 식별자입니다.

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

string (int64 format)

출력 전용입니다. 호텔 계정의 Hotel Center ID입니다. 이 필드는 읽기 전용입니다.

MerchantCenterLinkInvitationIdentifier

판매자 센터 계정의 식별자입니다.

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

string (int64 format)

출력 전용입니다. 판매자 계정의 판매자 센터 ID입니다. 이 필드는 읽기 전용입니다.

추천

권장사항입니다.

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)
  },
  "forecastingSetTargetCpaRecommendation": {
    object (ForecastingSetTargetCpaRecommendation)
  },
  "setTargetCpaRecommendation": {
    object (ForecastingSetTargetCpaRecommendation)
  },
  "setTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  }
  // 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_ROAS, ROPT_TARGET_PRODUCT_ADDING, CALLOUT_EXTENSION_AGE_TARGET_AGE_AGE_AGE_AGE_AGE_AGE_AGE_SIZE , CALLOUT_EXTENSION, CALL_EXTENSION_TARGET_AGE_의 ,
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)

출력 전용입니다. 동적 검색 광고에서 실적 최대화 캠페인으로의 이전 추천
forecastingSetTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

출력 전용입니다. 예측 시 타겟 CPA 추천 설정
setTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

출력 전용입니다. 설정된 타겟 CPA 추천입니다.
setTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

출력 전용입니다. 설정된 타겟 광고 투자수익(ROAS) 추천입니다.

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 , FORECASTING_SET_TARGET_CPA 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
}
입력란

ForecastingSetTargetCpaRecommendation

설정된 타겟 CPA 추천

JSON 표현 
{
  "recommendedTargetCpaMicros": string,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
입력란
recommendedTargetCpaMicros

string (int64 format)

출력 전용입니다. 추천 타겟 CPA
campaignBudget

object (CampaignBudget)

출력 전용입니다. 캠페인 예산입니다.

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자(영문 기준)입니다.

LocalServicesLead

지역 서비스 리드의 데이터 사용자가 광고주에게 전화를 걸거나 메시지를 보내거나 서비스를 예약할 때 생성되는 리드의 세부정보가 포함됩니다. 추가 정보: https://ads.google.com/local-services-ads

JSON 표현 
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "note": {
    object (Note)
  }
}
입력란
resourceName

string

출력 전용입니다. 지역 서비스 리드 데이터의 리소스 이름입니다. 지역 서비스 리드 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/localServicesLead/{local_services_lead_id}
id

string (int64 format)

출력 전용입니다. 이 리드의 ID입니다.
categoryId

string

출력 전용입니다. 리드의 서비스 카테고리입니다. 예: xcat:service_area_business_hvac, xcat:service_area_business_real_estate_agent 등. 자세한 내용은 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids를 참고하세요.
serviceId

string

출력 전용입니다. 카테고리의 서비스입니다. 예를 들어 xcat:service_area_business_real_estate_agent 카테고리의 경우 buyer_agent, seller_agent입니다.
contactDetails

object (ContactDetails)

출력 전용입니다. 리드의 연락처 세부정보입니다.
leadType

enum (LeadType)

출력 전용입니다. 지역 서비스 리드 유형: 전화, 메시지, 예약 등
leadStatus

enum (LeadStatus)

출력 전용입니다. 리드의 현재 상태입니다.
creationDateTime

string

출력 전용입니다. 지역 서비스 광고에서 리드가 생성된 날짜 시간입니다. 형식은 Google Ads 계정 시간대의 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'
locale

string

출력 전용입니다. 리드에 연결된 지역 서비스 제공업체에서 사용하는 언어입니다. https://developers.google.com/google-ads/api/data/codes-formats#locales
leadCharged

boolean

출력 전용입니다. 광고주에게 리드에 대한 비용이 청구된 경우 true입니다.
note

object (Note)

출력 전용입니다. 광고주가 리드에 추가한 메모입니다.

ContactDetails

소비자 연락처 세부정보가 포함된 필드입니다.

JSON 표현 
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
입력란
phoneNumber

string

출력 전용입니다. E164 형식의 소비자 전화번호입니다.
email

string

출력 전용입니다. 소비자 이메일 주소.
consumerName

string

출력 전용입니다. 소비자가 google.com의 메시지 또는 예약 양식에서 이름을 제공한 경우 소비자 이름

LeadType

가능한 리드 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MESSAGE 메시지 리드
PHONE_CALL 전화 통화로 리드가 생성되었습니다.
BOOKING 예약 리드

LeadStatus

리드의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
NEW 광고주가 아직 확인하지 않은 새로운 리드
ACTIVE 광고주와 상호작용한 리드
BOOKED 리드가 예약되었습니다.
DECLINED 광고주가 리드를 거부했습니다.
EXPIRED 활동이 없어 리드가 만료되었습니다.
DISABLED 스팸 또는 이의 제기로 인해 사용 중지되었습니다.
CONSUMER_DECLINED 소비자가 리드를 거부했습니다.
WIPED_OUT 리드의 개인 식별 정보가 완전 삭제됩니다.

참고

광고주가 리드에 추가한 메모를 나타냅니다. 광고주가 메모를 수정할 수 있으며 이에 따라 수정 시간이 재설정되고 설명이 변경됩니다.

JSON 표현 
{
  "editDateTime": string,
  "description": string
}
입력란
editDateTime

string

출력 전용입니다. 리드 메모가 수정된 날짜 시간입니다. 형식은 Google Ads 계정 시간대의 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'
description

string

출력 전용입니다. 리드 메모의 내용

LocalServicesLeadConversation

지역 서비스 리드 대화의 데이터입니다. 사용자가 광고주에게 전화를 걸거나 메시지를 보내거나 서비스를 예약할 때 생성되는 리드 대화의 세부정보를 포함합니다. 리드에 추가됩니다. 추가 정보: https://ads.google.com/local-services-ads

JSON 표현 
{
  "resourceName": string,
  "id": string,
  "conversationChannel": enum (ConversationType),
  "participantType": enum (ParticipantType),
  "lead": string,
  "eventDateTime": string,
  "phoneCallDetails": {
    object (PhoneCallDetails)
  },
  "messageDetails": {
    object (MessageDetails)
  }
}
입력란
resourceName

string

출력 전용입니다. 지역 서비스 리드 대화 데이터의 리소스 이름입니다. 지역 서비스 리드 대화 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}
id

string (int64 format)

출력 전용입니다. 이 리드 대화의 ID입니다.
conversationChannel

enum (ConversationType)

출력 전용입니다. GLS 리드 대화 유형, EMAIL, MESSAGE, PHONE_CALL, SMS 등
participantType

enum (ParticipantType)

출력 전용입니다. 리드 대화의 참여자 유형(ADVERTISER 또는 CONSUMER)입니다.
lead

string

출력 전용입니다. Lead Conversation과 연결된 리드의 리소스 이름입니다.
eventDateTime

string

출력 전용입니다. 지역 서비스 광고에서 리드 대화가 생성된 날짜 시간입니다. 형식은 Google Ads 계정 시간대의 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'
phoneCallDetails

object (PhoneCallDetails)

출력 전용입니다. PHONE_CALL의 경우 전화 통화 대화의 세부정보
messageDetails

object (MessageDetails)

출력 전용입니다. EMAIL, MESSAGE 또는 SMS의 경우 메시지 대화 세부정보입니다.

ConversationType

가능한 리드 대화 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EMAIL 이메일 리드 대화
MESSAGE 메시지 리드 대화
PHONE_CALL 전화 통화를 통해 발생한 리드 대화
SMS SMS 리드 대화입니다.
BOOKING 예약 리드 대화

ParticipantType

리드 대화 참여자의 가능한 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ADVERTISER 지역 서비스 광고 제공업체 참여자입니다.
CONSUMER 지역 서비스 광고 소비자 참여자입니다.

PhoneCallDetails

전화 통화 대화의 세부정보를 나타냅니다.

JSON 표현 
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
입력란
callDurationMillis

string (int64 format)

출력 전용입니다. 전화 통화의 시간 (밀리초)입니다 (엔드 투 엔드).
callRecordingUrl

string

출력 전용입니다. 통화 녹음 오디오 파일의 URL입니다.

MessageDetails

이메일, 메시지 또는 SMS의 경우 문자 메시지의 세부 사항을 나타냅니다.

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

string

출력 전용입니다. 메시지의 텍스트 콘텐츠입니다.

AndroidPrivacySharedKeyGoogleAdGroup

Google 광고그룹 키의 Android 개인 정보 보호 공유 키 보기

JSON 표현 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "adGroupId": string,
  "sharedAdGroupKey": string
}
입력란
resourceName

string

출력 전용입니다. Android 개인 정보 보호 공유 키의 리소스 이름입니다. Android 개인 정보 보호 공유 키 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/androidPrivacySharedKeyGoogleAdGroups/{campaignId}~{adGroupId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

출력 전용입니다. 공유 키 인코딩에 사용되는 캠페인 ID입니다.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

출력 전용입니다. 공유 키 인코딩에 사용되는 상호작용 유형 enum입니다.
androidPrivacyInteractionDate

string

출력 전용입니다. 공유 키 인코딩에 사용된 상호작용 날짜(UTC 시간대 기준 'YYYY-MM-DD' 형식)입니다.
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

출력 전용입니다. 공유 키 인코딩에 사용되는 네트워크 유형 enum입니다.
adGroupId

string (int64 format)

출력 전용입니다. 공유 키 인코딩에 사용되는 광고그룹 ID입니다.
sharedAdGroupKey

string

출력 전용입니다. 인코딩된 공유 광고그룹 키의 128비트 16진수 문자열로, '0x' 접두사를 포함합니다. 이 키는 집계 전환 키로 비트 OR 연산자를 사용하여 Android 개인 정보 보호 샌드박스에서 Aggregate API 보고서를 검색하는 전체 집계 키를 만드는 데 사용할 수 있습니다.

AndroidPrivacyInteractionType

상호작용 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
CLICK 실제 클릭 상호작용 유형입니다.
ENGAGED_VIEW 10초 조회 충족 상호작용 유형입니다.
VIEW 조회 (광고 노출) 상호작용 유형입니다.

AndroidPrivacyNetworkType

네트워크 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
SEARCH 검색 네트워크를 선택합니다.
DISPLAY (디스플레이 네트워크용)
YOUTUBE YouTube 네트워크

AndroidPrivacySharedKeyGoogleCampaign

Google 캠페인 키의 Android 개인 정보 보호 공유 키 뷰

JSON 표현 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "sharedCampaignKey": string
}
입력란
resourceName

string

출력 전용입니다. Android 개인 정보 보호 공유 키의 리소스 이름입니다. Android 개인 정보 보호 공유 키 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/androidPrivacySharedKeyGoogleCampaigns/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

출력 전용입니다. 공유 키 인코딩에 사용되는 캠페인 ID입니다.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

출력 전용입니다. 공유 키 인코딩에 사용되는 상호작용 유형 enum입니다.
androidPrivacyInteractionDate

string

출력 전용입니다. 공유 키 인코딩에 사용된 상호작용 날짜(UTC 시간대 기준 'YYYY-MM-DD' 형식)입니다.
sharedCampaignKey

string

출력 전용입니다. 인코딩된 공유 캠페인 키의 128비트 16진수 문자열로, '0x' 접두사를 포함합니다. 이 키는 집계 전환 키로 비트 OR 연산자를 사용하여 Android 개인 정보 보호 샌드박스에서 Aggregate API 보고서를 검색하는 전체 집계 키를 만드는 데 사용할 수 있습니다.

AndroidPrivacySharedKeyGoogleNetworkType

Google 네트워크 유형 키의 Android 개인 정보 보호 공유 키 뷰입니다.

JSON 표현 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "sharedNetworkTypeKey": string
}
입력란
resourceName

string

출력 전용입니다. Android 개인 정보 보호 공유 키의 리소스 이름입니다. Android 개인 정보 보호 공유 키 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/androidPrivacySharedKeyGoogleNetworkTypes/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

출력 전용입니다. 공유 키 인코딩에 사용되는 캠페인 ID입니다.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

출력 전용입니다. 공유 키 인코딩에 사용되는 상호작용 유형 enum입니다.
androidPrivacyInteractionDate

string

출력 전용입니다. 공유 키 인코딩에 사용된 상호작용 날짜(UTC 시간대 기준 'YYYY-MM-DD' 형식)입니다.
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

출력 전용입니다. 공유 키 인코딩에 사용되는 네트워크 유형 enum입니다.
sharedNetworkTypeKey

string

출력 전용입니다. '0x' 접두사를 포함하여 인코딩된 공유 네트워크 유형 키의 128비트 16진수 문자열입니다. 이 키는 집계 전환 키로 비트 OR 연산자를 사용하여 Android 개인 정보 보호 샌드박스에서 Aggregate API 보고서를 검색하는 전체 집계 키를 만드는 데 사용할 수 있습니다.

측정항목

측정항목 데이터

JSON 표현 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkInstalls": string,
  "skAdNetworkTotalConversions": 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,
  "crossDeviceConversionsValueMicros": string,
  "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,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "crossSellCostOfGoodsSoldMicros": string,
  "crossSellGrossProfitMicros": string,
  "crossSellRevenueMicros": string,
  "crossSellUnitsSold": number,
  "leadCostOfGoodsSoldMicros": string,
  "leadGrossProfitMicros": string,
  "leadRevenueMicros": string,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": 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)

유료 및 무료 상호작용의 유형입니다.
skAdNetworkInstalls

string (int64 format)

iOS Store Kit 광고 네트워크 전환의 횟수입니다.
skAdNetworkTotalConversions

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에 포함되어 있습니다.
crossDeviceConversionsValueMicros

string (int64 format)

교차 기기 전환 가치의 합계입니다(단위: 마이크로 단위).
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 클릭수입니다. 이 측정값은 애셋 기반 위치에서 발생합니다.
orders

number

주문은 광고로 인한 총 구매 전환수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 텍스트 또는 쇼핑 광고의 경우 클릭수, 동영상 광고의 경우 조회수 등 광고의 이전 상호작용이 전환에 기여한 것으로 집계되면 주문 1건으로 집계됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 웹사이트에서 주문 시 동일한 모자와 셔츠를 구매했습니다. 2개의 제품을 구매했더라도 주문 1건으로 집계됩니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
averageOrderValueMicros

string (int64 format)

평균 주문 금액은 광고에 기여한 주문당 발생한 평균 수익입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 평균 주문 금액은 주문의 총 수익을 총 주문 수로 나눈 값입니다. 예: 3건의 주문을 받아, 10,000원, 15,000원, 20,000원의 수익을 창출했습니다. 평균 주문 금액은 15,000원[(10,000 + 15,000 + 20,000)/3]입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
averageCartSize

number

장바구니의 평균 제품수는 광고를 통해 발생한 각 주문 내 제품의 평균 개수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 장바구니의 평균 제품수는 판매된 총 제품 수를 총 주문 수로 나눈 값입니다. 예: 주문 2건이 있는데, 첫 번째 주문에는 제품 3개가, 두 번째 주문에는 제품 2개가 포함되었습니다. 장바구니의 평균 제품수는 2.5개 = (3+2)/2입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
costOfGoodsSoldMicros

string (int64 format)

매출원가(COGS)는 광고에 기여한 주문으로 판매된 제품의 총 비용입니다. 작동 방식: 판매자 센터의 모든 제품에 매출원가를 추가할 수 있습니다. 장바구니 데이터를 사용한 전환 추적을 보고하면 판매한 제품이 매출원가와 일치하게 되어 각 주문에서 발생한 총 수익을 계산할 수 있습니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문에서 매출원가는 8달러 = 3달러 + 5달러입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
grossProfitMicros

string (int64 format)

총 이익은 광고가 기여한 주문으로 발생한 이익에서 매출원가(COGS)를 제외한 금액입니다. 작동 방식: 총 이익은 광고로 인해 발생한 판매 수익에서 매출원가를 뺀 값입니다. 총 이익 계산에는 판매자 센터에서 매출원가 값이 있는 제품만 포함됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 웹사이트에서 주문 시 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 모자의 매출원가는 3,000원인데 셔츠의 매출원가는 없습니다. 이 주문의 총 이익은 모자만 고려하므로 7,000원 = 10,000원 - 3,000원이 됩니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
grossProfitMargin

number

총 이익률은 광고에 기여한 주문에서 발생한 매출에서 매출원가(COGS)를 제외하고 남은 총 이익의 비율입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 총 이익률은 얻은 총 이익을 총수익으로 나눈 다음 100%를 곱한 값입니다. 총 이익률 계산에는 판매자 센터에서 매출원가 값이 있는 제품만 포함됩니다. 예: 사용자가 웹사이트에서 주문 시 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원이며 매출원가는 3,000원입니다. 이 셔츠의 가격은 20,000원이지만 매출원가는 없습니다. 이 주문의 총 이익률은 모자 비용만 고려합니다. 매출원가가 70% = (10,000원 - 3,000원)/10,000원 x 100%이기 때문입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
revenueMicros

string (int64 format)

수익은 광고에 기여한 주문에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 수익은 광고에 기여한 모든 주문의 총 금액에서 할인 금액을 뺀 금액입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 웹사이트에서 주문 시 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 전체 주문에 5000원 할인 혜택이 적용됩니다. 이 주문의 수익은 25,000원 = (10,000원 + 20,000원) - 5000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
unitsSold

number

판매된 제품 수는 광고에 기여한 주문에서 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 판매된 제품 수는 광고에 기여한 모든 주문에서 판매된 총 제품 수입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자, 셔츠, 재킷을 구매했습니다. 이 주문으로 판매된 개수는 3개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
crossSellCostOfGoodsSoldMicros

string (int64 format)

크로스셀(cross-sell) 매출원가(COGS)는 다른 제품 광고로 인해 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참조) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell) 매출원가는 광고되지 않은 제품의 총 비용입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 크로스셀 매출원가는 5,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
crossSellGrossProfitMicros

string (int64 format)

크로스셀(cross-sell)을 통한 총이익은 다른 제품을 광고한 결과로 판매된 제품으로 얻은 이익에서 매출원가(COGS)를 제외한 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참조) 이 제품은 광고 중인 제품으로 간주됩니다. 구매에 포함된 제품은 판매된 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통한 총이익은 광고에 기여한 크로스셀(cross-sell)에서 얻은 수익에서 매출원가를 뺀 값입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자와 셔츠를 구매했습니다. 이 셔츠의 가격은 20,000원이며 매출원가는 5000원입니다. 이 주문의 크로스셀(cross-sell)을 통한 총이익은 15,000원 = 20,000원 - 5000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
crossSellRevenueMicros

string (int64 format)

크로스셀(cross-sell) 수익은 다른 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참조) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell) 수익은 광고로 인해 발생한 크로스셀(cross-sell)에서 창출된 총 가치입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 크로스셀(cross-sell) 수익은 20,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
crossSellUnitsSold

number

크로스셀(cross-sell)을 통해 판매된 제품수는 다른 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참조) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통해 판매된 제품수는 광고에 기여한 모든 주문의 크로스셀(cross-sell) 제품 총 개수입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 크로스셀(cross-sell)을 통해 판매된 제품수는 2개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
leadCostOfGoodsSoldMicros

string (int64 format)

리드 매출원가(COGS)는 동일한 제품을 광고한 결과로 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 상호작용된 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참조) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이러한 제품의 비용은 리드 매출원가에 포함됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 리드 매출원가는 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
leadGrossProfitMicros

string (int64 format)

리드 총이익은 동일한 제품을 광고한 결과로 판매된 제품으로 얻은 이익에서 매출원가(COGS)를 제외한 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참조) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이 판매에서 얻은 수익에서 매출원가를 뺀 금액이 리드 총이익입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원이며 매출원가는 3,000원입니다. 이 주문의 리드 총이익은 7,000원 = 10,000원 - 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
leadRevenueMicros

string (int64 format)

리드 수익은 동일한 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참조) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고 제품과 판매된 제품이 일치하면 해당 제품의 판매에서 발생한 총 가치가 리드 수익에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 리드 수익은 10,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
leadUnitsSold

number

판매된 리드 단위 수는 동일한 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참조) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 판매된 제품의 총 수가 판매된 리드 단위 아래에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 같은 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 판매된 리드 단위는 1개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.
uniqueUsers

string (int64 format)

요청 기간에 귀하의 광고를 본 순 사용자 수입니다. 이 측정항목은 집계할 수 없으며 92일 이하의 기간에 대해서만 요청할 수 있습니다. 이 측정항목은 디스플레이, 동영상, 디스커버리, 앱 캠페인 유형에 사용할 수 있습니다.
averageImpressionFrequencyPerUser

number

요청된 기간에 순 사용자 한 명이 광고를 본 평균 횟수를 말합니다. 이 측정항목은 집계할 수 없으며 92일 이하의 기간에 대해서만 요청할 수 있습니다. 이 측정항목은 디스플레이, 동영상, 디스커버리, 앱 캠페인 유형에 사용할 수 있습니다.

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),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "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,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": 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)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "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 스토어 키트 광고 네트워크 저작자 표시 크레딧
skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

iOS Store Kit 광고 네트워크 대략적인 전환 가치입니다.
skAdNetworkSourceType

enum (SkAdNetworkSourceType)

iOS 스토어 키트 광고 네트워크 설치를 유도한 광고가 게재된 소스 유형입니다. Null 값은 이 세그먼트가 적용되지 않거나(예: iOS가 아닌 캠페인) Apple에서 전송한 포스트백에 소스 도메인과 소스 앱이 모두 없음을 의미합니다.
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입니다.
productCategoryLevel1

string

제품의 카테고리 (수준 1)입니다.
productCategoryLevel2

string

제품의 카테고리 (수준 2)입니다.
productCategoryLevel3

string

제품의 카테고리 (수준 3)입니다.
productCategoryLevel4

string

제품의 카테고리 (수준 4)입니다.
productCategoryLevel5

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에서 전송한 포스트백에 없었음을 의미합니다.
skAdNetworkSourceDomain

string

iOS 스토어 키트 광고 네트워크 설치를 유도한 광고가 게재된 웹사이트 Null 값은 이 세그먼트가 적용되지 않거나(예: iOS가 아닌 캠페인) Apple에서 전송한 포스트백에 없었음을 의미합니다.
skAdNetworkPostbackSequenceIndex

string (int64 format)

iOS 스토어 키트 광고 네트워크 포스트백 시퀀스 인덱스입니다.
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 (디스플레이 네트워크용)
MIXED 교차 네트워크.
YOUTUBE YouTube
GOOGLE_TV Google TV

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이 기여 요건을 충족하지만 낙찰받지 못했습니다.

SkAdNetworkCoarseConversionValue

SkAdNetwork 대략적인 전환 가치를 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
UNAVAILABLE 포스트백에 값이 없거나 다른 이유로 이 데이터가 없습니다.
LOW 대략적인 전환 가치가 낮음
MEDIUM 중간 정도의 대략적인 전환 가치
HIGH 대략적인 전환 가치가 높음
NONE 대략적인 전환 가치가 구성되지 않았습니다.

SkAdNetworkSourceType

SkAdNetwork 소스 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
UNAVAILABLE 소스 앱 ID 또는 소스 도메인이 포스트백에 없거나 다른 이유로 이 데이터가 없습니다.
WEBSITE 광고가 웹페이지에 게재되었습니다.
MOBILE_APPLICATION 광고가 앱에 게재되었습니다.

AssetInteractionTarget

AssetInteractionTarget 세그먼트입니다.

JSON 표현 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
입력란
asset

string

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

boolean

CustomerAsset, CampaignAsset, AdGroupAsset 측정항목과만 함께 사용하세요. 상호작용 측정항목이 애셋 자체에서 발생했는지 아니면 다른 애셋 또는 광고 단위에서 발생했는지를 나타냅니다.

ConvertingUserPriorEngagementTypeAndLtvBucket

전환하는 사용자의 이전 참여 유형 및 평생 가치 버킷을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
NEW 전환 사용자가 광고주에게 처음 발생합니다.
RETURNING 전환 중인 사용자가 광고주로 돌아오고 있습니다. 재방문의 정의는 두 번째 매장 방문과 두 번째 온라인 구매 같은 전환 유형에 따라 다릅니다.
NEW_AND_HIGH_LTV 전환 사용자는 광고주에게 처음 발생하며 평생 가치가 높습니다.