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)
  },
  "localServicesEmployee": {
    object (LocalServicesEmployee)
  },
  "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)

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

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)

쿼리에서 참조된 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)

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

localServicesEmployee

object (LocalServicesEmployee)

쿼리에서 참조된 지역 서비스 직원입니다.

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

계정 단위 예산 예산 자체에 대한 정보와 함께 가장 최근에 승인된 예산 변경사항 및 승인 대기 중인 제안된 변경사항이 포함됩니다. 승인 대기 중인 제안된 변경사항(있는 경우)은 'pendingProposal'에서 확인할 수 있습니다. 예산에 대한 효과적인 세부정보는 '승인된_', '조정_' 접두사가 붙은 필드와 접두사가 없는 필드에 나와 있습니다. 일부 유효한 세부정보는 사용자가 원래 요청한 내용과 다를 수 있으므로(예: 지출 한도) 이러한 차이는 'proposed_', 'approved_', 'adjusted_' 필드를 통해 나란히 표시됩니다.

이 리소스는 AccountBudgetProposal을 사용하여 변경되며 직접 변경할 수 없습니다. 예산에는 보류 중인 제안서가 항상 1개만 포함될 수 있습니다. pendingProposal을 통해 읽습니다.

예산이 승인되면 크레딧 조정과 같은 조정이 적용될 수 있습니다. 조정을 하면 '승인됨' 및 '조정됨' 필드 간에 차이가 발생하며, 그렇지 않으면 동일합니다.

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만은 1단위와 같습니다.

proposedSpendingLimitType

enum (SpendingLimitType)

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

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

예를 들어 계정에서 이미 지출한 금액이 제안이 승인된 시점에 제안된 지출 한도를 초과하는 경우 승인된 지출 한도는 이미 지출한 금액으로 설정됩니다. approved_spending_limit는 다음 중 하나여야 합니다.

approvedSpendingLimitMicros

string (int64 format)

출력 전용입니다. 승인된 지출 한도(마이크로 단위)입니다. 100만은 1단위에 해당합니다. 제안된 지출 한도가 유한한 경우에만 채워지며 항상 제안된 지출 한도보다 크거나 같아야 합니다.

approvedSpendingLimitType

enum (SpendingLimitType)

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

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

이 값에 따라 계정에서 지출할 수 있는 금액을 최종적으로 결정합니다. adjusted_spending_limit는 다음 중 하나여야 합니다.

adjustedSpendingLimitMicros

string (int64 format)

출력 전용입니다. 마이크로 단위로 조정된 지출 한도입니다. 100만은 1단위와 같습니다.

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

다양한 조정 유형은 https://support.google.com/google-ads/answer/1704323에서 확인하세요.

예를 들어 청구 금액 조정은 계정에서 지출할 수 있는 금액을 줄입니다.

adjustedSpendingLimitType

enum (SpendingLimitType)

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

AccountBudgetStatus

AccountBudget의 가능한 상태입니다.

열거형
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

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

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만은 1단위에 해당합니다.

spendingLimitType

enum (SpendingLimitType)

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

AdGroupAdAssetCombinationView

광고그룹 광고 확장 소재 조합의 사용에 대한 보기입니다. 이제 반응형 검색 광고에 AdGroupAdAssetCombinationView만 지원되며 향후 더 많은 광고 유형이 지원될 예정입니다.

JSON 표현
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
필드
resourceName

string

출력 전용입니다. 광고 그룹 광고 확장 소재 조합 뷰의 리소스 이름입니다. 조합 ID의 길이는 128비트입니다. 여기서 상위 64비트는 asset_combination_id_high에 저장되고 하위 64비트는 asset_combination_id_low에 저장됩니다. AdGroupAd Asset Combination 뷰 리소스 이름의 형식은 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와 애셋 간의 연결입니다. 현재는 앱 광고 및 반응형 검색 광고에 대해서만 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. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
  4. 호텔 - LISTING_GROUP - CPC_BID - UNIFORM
  5. 호텔 - 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

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

열거형
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 - 기본값
  2. SEARCH - CPC_BID - UNIFORM
  3. SEARCH - TARGET_CPA - UNIFORM
  4. 검색 - TARGET_ROAS - UNIFORM
  5. DISPLAY - CPC_BID - DEFAULT
  6. 디스플레이 - CPC_BID - UNIFORM
  7. DISPLAY - 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

애셋 필드 유형 뷰입니다. 이 뷰는 확장 소재로 사용되는 경우 각 확장 소재 필드 유형에 대해 오버 counting되지 않은 측정항목을 보고합니다.

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/{assetGroupId}~{listing_group_filter_id}

assetGroup

string

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

assetGroupListingGroupFilter

string

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

AssetGroupTopCombinationView

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

JSON 표현
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
필드
resourceName

string

출력 전용입니다. 애셋 그룹 상단 조합 뷰의 리소스 이름입니다. AssetGroup Top Combination 뷰 리소스 이름의 형식은 `"customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}"입니다.

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

출력 전용입니다. 함께 게재된 확장 소재의 주요 조합입니다.

AssetGroupAssetCombinationData

애셋 그룹 애셋 조합 데이터

JSON 표현
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
필드
assetCombinationServedAssets[]

object (AssetUsage)

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

AssetSetTypeView

애셋 설정 유형 뷰 이 뷰에는 각 애셋 세트 유형에 대해 오버 counting되지 않은 측정항목이 보고됩니다. 하위 애셋 세트 유형은 이 보고서에 포함되지 않습니다. 이러한 확장 소재의 통계는 상위 확장 소재 세트 유형 아래에 집계됩니다.

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 Voice 통화의 가능한 상태입니다.

열거형
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

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

  • 검색 - CPC_BID - UNIFORM
  • 검색 - CPC_BID - 확장
  • 검색 - TARGET_CPA - UNIFORM
  • 검색 - TARGET_CPA - 확장
  • SEARCH - TARGET_ROAS - UNIFORM
  • 검색 - TARGET_IMPRESSION_SHARE - UNIFORM
  • SEARCH - BUDGET - UNIFORM
  • 쇼핑 - 예산 - 유니폼
  • 쇼핑 - 타겟 ROAS - 균일
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • 디스커버리 - TARGET_CPA - DEFAULT
  • 디스플레이 - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - BUDGET - 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)

출력 전용입니다. 시뮬레이션 유형이 BUDGET이면 시뮬레이션이 포인트가 됩니다.

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)

예측 측정항목의 기반이 되는 시뮬레이션된 타겟 노출 점유율 값(마이크로)입니다. 예를 들어 0.1과 동일한 10%의 노출 점유율은 100_000으로 저장됩니다. 이 값은 검증되며 1,000,000(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

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

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)

출력 전용입니다. 변경된 리소스의 유형입니다. 이렇게 하면 oldResource 및 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

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

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 Campaignguidelines 리소스 변경입니다.
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

지원되는 모든 리소스를 표시하는 래퍼 프로토콜입니다. 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의 경우 campaign 및 adGroup 필드가 설정됩니다.

resourceStatus

enum (ChangeStatusOperation)

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

sharedSet

string

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

campaignSharedSet

string

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

asset

string

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

customerAsset

string

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

campaignAsset

string

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

adGroupAsset

string

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

combinedAudience

string

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

lastChangeDateTime

string

출력 전용입니다. 이 리소스에 가장 최근에 변경사항이 발생한 시간입니다.

campaign

string

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

adGroup

string

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

adGroupAd

string

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

adGroupCriterion

string

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

campaignCriterion

string

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

feed

string

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

feedItem

string

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

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 Campaignguidelines 리소스 변경입니다.
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 CombinedAudience 리소스 변경사항.

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

출력 전용입니다. 연결된 키워드(존재하고 클릭이 SEARCH 채널에 해당하는 경우)입니다.

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의 세 자리 통화 코드입니다(예: 'USD').

name

string

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

symbol

string

출력 전용입니다. 이 통화를 나타내는 표준 기호입니다(예: 미국 달러의 경우 '$').

billableUnitMicros

string (int64 format)

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

AccessibleBiddingStrategy

고객이 소유하고 고객과 공유하는 BiddingStrategies의 뷰를 나타냅니다.

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

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

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

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

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

maximizeConversionValue

object (MaximizeConversionValue)

출력 전용입니다. 예산을 지출하면서 캠페인의 전환 가치를 최대한 높일 수 있는 자동 입찰 전략입니다.

maximizeConversions

object (MaximizeConversions)

출력 전용입니다. 캠페인에서 예산이 지출될 때 최대한 많은 전환이 발생하도록 설정하는 자동 입찰 전략입니다.

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

JSON 표현
{
  "targetRoas": number
}
필드
targetRoas

number

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

MaximizeConversions

캠페인에서 예산이 지출될 때 최대한 많은 전환이 발생하도록 설정하는 자동 입찰 전략입니다.

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

string (int64 format)

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

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(Common Locale Data Repository) 문자열 표현입니다(예: 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

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

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 (advertisingChannelType 유형만 설정되고 카테고리는 그 아래의 모든 하위 유형에서 사용 가능) 또는 CHANNEL_TYPE_AND_SUBTYPES (advertisingChannelType, advertisingChannelSubType, includeDefaultChannelSubType)가 모두 설정될 수 있음)일 수 있습니다.

advertisingChannelType

enum (AdvertisingChannelType)

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

advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

카테고리를 사용할 수 있는 채널 유형 아래의 채널 하위유형

includeDefaultChannelSubType

boolean

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

CriterionCategoryChannelAvailabilityMode

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

열거형
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 사용자가 위치에서 1킬로미터 이내에 있었습니다.
WITHIN_5KM 사용자가 위치에서 5km 이내에 있었습니다.
WITHIN_10KM 사용자가 위치에서 10킬로미터 이내에 있었습니다.
WITHIN_15KM 사용자가 위치에서 15km 이내에 있었습니다.
WITHIN_20KM 사용자가 위치에서 20킬로미터 이내에 있었습니다.
WITHIN_25KM 사용자가 위치에서 25km 이내에 있었습니다.
WITHIN_30KM 사용자가 위치에서 30km 이내에 있었습니다.
WITHIN_35KM 사용자가 위치에서 35킬로미터 이내에 있었습니다.
WITHIN_40KM 사용자가 해당 위치에서 40km 이내에 있었습니다.
WITHIN_45KM 사용자가 위치에서 45킬로미터 이내에 있었습니다.
WITHIN_50KM 사용자가 위치에서 50km 이내에 있었습니다.
WITHIN_55KM 사용자가 위치에서 55km 이내에 있었습니다.
WITHIN_60KM 사용자가 해당 위치에서 60km 이내에 있었습니다.
WITHIN_65KM 사용자가 위치에서 65km 이내에 있었습니다.
BEYOND_65KM 사용자가 위치에서 65km 이상 떨어져 있었습니다.
WITHIN_0_7MILES 사용자가 위치에서 1.2km 이내에 있었습니다.
WITHIN_1MILE 사용자가 위치에서 1마일 이내에 있었습니다.
WITHIN_5MILES 사용자가 위치에서 8km 이내에 있었습니다.
WITHIN_10MILES 사용자가 위치에서 16km 이내에 있었습니다.
WITHIN_15MILES 사용자가 위치에서 25마일 이내에 있었습니다.
WITHIN_20MILES 사용자가 해당 위치에서 32km 이내에 있었습니다.
WITHIN_25MILES 사용자가 해당 위치에서 40km 이내에 있었습니다.
WITHIN_30MILES 사용자가 해당 위치에서 48km 이내에 있었습니다.
WITHIN_35MILES 사용자가 위치에서 56km 이내에 있었습니다.
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

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

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

string

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

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

GeographicView

지역 보기

지역 뷰에는 국가 수준에서 집계된 모든 측정항목이 국가당 1행씩 포함됩니다. 사용자의 실제 위치 또는 관심분야에서 측정항목을 보고합니다. 다른 세그먼트 필드를 사용하는 경우 국가당 행이 두 개 이상 표시될 수 있습니다.

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)

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

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

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

string

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

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

ManagedPlacementView

선택 게재위치 뷰

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

string

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

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

미디어 파일

미디어 파일

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)

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

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 URL에 표시되는 YouTube 동영상 ID입니다. 이 ID에 접두사 'https://www.youtube.com/watch?v='를 추가하면 이 동영상의 YouTube 스트리밍 URL을 얻게 됩니다.

advertisingIdCode

string

출력 전용입니다. 이 동영상의 광고 디지털 식별 코드로, 주로 텔레비전 광고에 사용되며 미국 광고 대행사 협회에서 정의했습니다.

isciCode

string

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

LocalServicesEmployee

지역 서비스 직원 자원.

JSON 표현
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesEmployeeStatus),
  "type": enum (LocalServicesEmployeeType),
  "universityDegrees": [
    {
      object (UniversityDegree)
    }
  ],
  "residencies": [
    {
      object (Residency)
    }
  ],
  "fellowships": [
    {
      object (Fellowship)
    }
  ],
  "languagesSpoken": [
    string
  ],
  "categoryIds": [
    string
  ],
  "id": string,
  "jobTitle": string,
  "yearStartedPracticing": integer,
  "nationalProviderIdNumber": string,
  "emailAddress": string,
  "firstName": string,
  "middleName": string,
  "lastName": string
}
필드
resourceName

string

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

customers/{customerId}/localServicesEmployees/{gls_employee_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 (LocalServicesEmployeeStatus)

출력 전용입니다. 직원 상태(예: 삭제됨 또는 사용 설정됨)

type

enum (LocalServicesEmployeeType)

출력 전용입니다. 직원 유형입니다.

universityDegrees[]

object (UniversityDegree)

출력 전용입니다. 이 직원이 취득하여 추천하고 싶은 학위 목록입니다.

residencies[]

object (Residency)

출력 전용입니다. 직원이 거주지를 완료한 기관

fellowships[]

object (Fellowship)

출력 전용입니다. 직원이 펠로우십을 마친 기관입니다.

languagesSpoken[]

string

출력 전용입니다. 직원이 사용하는 언어로, https://developers.google.com/admin-sdk/directory/v1/languages의 언어 태그로 표시됩니다.

categoryIds[]

string

출력 전용입니다. 직원 카테고리입니다. 지역 서비스 카테고리 ID 목록은 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids에서 확인할 수 있습니다.

id

string (int64 format)

출력 전용입니다. 직원의 ID입니다.

jobTitle

string

출력 전용입니다. 이 직원의 직책입니다(예: 법률 카테고리의 '선임 파트너').

yearStartedPracticing

integer

출력 전용입니다. 이 직원이 이 분야에서 활동하기 시작한 연도입니다.

nationalProviderIdNumber

string

출력 전용입니다. 직원과 연결된 NPI ID입니다.

emailAddress

string

출력 전용입니다. 직원의 이메일 주소입니다.

firstName

string

출력 전용입니다. 직원의 이름입니다.

middleName

string

출력 전용입니다. 직원의 중간 이름입니다.

lastName

string

출력 전용입니다. 직원의 성입니다.

LocalServicesEmployeeStatus

지역 서비스 직원의 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 직원이 삭제되지 않았으며 직원 상태가 활성 상태입니다.
REMOVED 직원이 삭제됩니다. 비즈니스에서 직원을 삭제하는 데 사용됩니다.

LocalServicesEmployeeType

지역 서비스 직원의 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BUSINESS_OWNER 비즈니스의 소유자를 나타냅니다.
EMPLOYEE 비즈니스의 직원을 나타냅니다.

UniversityDegree

이 직원이 취득했으며 표시하려는 학위 목록입니다.

JSON 표현
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
필드
institutionName

string

출력 전용입니다. 학위를 취득한 대학의 이름입니다.

degree

string

출력 전용입니다. 취득한 학위 이름

graduationYear

integer

출력 전용입니다. 졸업 연도입니다.

거주

직원의 의료 전공에 대한 세부정보. 레지던시 프로그램은 자격을 갖춘 의료 전문가가 선임 임상의의 감독 아래 실습을 진행하는 의학 전문 학위 과정의 한 단계입니다.

JSON 표현
{
  "institutionName": string,
  "completionYear": integer
}
필드
institutionName

string

출력 전용입니다. 전공의 수련이 완료된 기관의 이름

completionYear

integer

출력 전용입니다. 수료 연도

교제

직원의 의료 펠로우십에 대한 세부정보입니다. 펠로우십은 전문의가 레지던시를 마친 후 수행하는 의학 교육 기간입니다.

JSON 표현
{
  "institutionName": string,
  "completionYear": integer
}
필드
institutionName

string

출력 전용입니다. 펠로우십을 이수한 교육 기관의 이름입니다.

completionYear

integer

출력 전용입니다. 완료 연도입니다.

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

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

businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

출력 전용입니다. 사업자 등록 확인 확인 아티팩트

LocalServicesVerificationArtifactStatus

로컬 서비스 인증 아티팩트의 상태를 설명하는 enum입니다.

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

LocalServicesVerificationArtifactType

로컬 서비스 확인 아티팩트의 가능한 유형을 설명하는 enum입니다.

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

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 라이선스에 명시되지 않은 또 다른 결함이 있습니다.

BusinessRegistrationCheckVerificationArtifact

지역 서비스 사업자 등록 확인과 관련된 정보를 담고 있는 프로토콜입니다.

JSON 표현
{
  "registrationType": enum (LocalServicesBusinessRegistrationType),
  "checkId": string,
  "rejectionReason": enum (LocalServicesBusinessRegistrationCheckRejectionReason),

  // Union field business_registration can be only one of the following:
  "registrationNumber": {
    object (BusinessRegistrationNumber)
  },
  "registrationDocument": {
    object (BusinessRegistrationDocument)
  }
  // End of list of possible types for union field business_registration.
}
필드
registrationType

enum (LocalServicesBusinessRegistrationType)

출력 전용입니다. 사업자등록 확인 유형(번호, 문서)입니다.

checkId

string

출력 전용입니다. 'VAT 세금 ID' 요구사항을 나타내는 수표의 ID입니다(예: vat_tax_id).

rejectionReason

enum (LocalServicesBusinessRegistrationCheckRejectionReason)

출력 전용입니다. 등록 문서가 거부된 이유입니다.

통합 필드 business_registration. 사업자 등록을 위한 등록 정보입니다. 국가별 요구사항에 따른 다음 양식 중 하나입니다. business_registration은 다음 중 하나여야 합니다.
registrationNumber

object (BusinessRegistrationNumber)

출력 전용입니다. 비즈니스에 대해 정부에서 발급한 번호를 저장하는 메시지입니다.

registrationDocument

object (BusinessRegistrationDocument)

출력 전용입니다. 비즈니스의 문서 정보를 저장하는 메시지입니다.

LocalServicesBusinessRegistrationType

지역 서비스 비즈니스 등록 확인 인증 아티팩트의 가능한 등록 유형을 설명하는 enum입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
NUMBER 등록 번호 확인 유형입니다.
DOCUMENT 등록 서류 확인 유형입니다.

LocalServicesBusinessRegistrationCheckRejectionReason

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

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BUSINESS_NAME_MISMATCH 업체 이름이 지역 서비스 광고의 업체 이름과 일치하지 않습니다.
BUSINESS_DETAILS_MISMATCH 비즈니스 세부정보가 일치하지 않습니다.
ID_NOT_FOUND 사업자 등록 ID를 찾을 수 없습니다.
POOR_DOCUMENT_IMAGE_QUALITY 업로드된 서류가 선명하지 않거나 흐릿합니다.
DOCUMENT_EXPIRED 업로드된 서류가 만료되었습니다.
DOCUMENT_INVALID 문서가 취소되었거나 해지되었습니다.
DOCUMENT_TYPE_MISMATCH 문서 유형이 일치하지 않습니다.
DOCUMENT_UNVERIFIABLE 업로드된 서류가 합법적인지 확인할 수 없습니다.
OTHER 문제가 발생하여 사업자 등록 절차를 완료할 수 없습니다. 자세한 내용은 https://support.google.com/localservices를 참고하세요.

BusinessRegistrationNumber

지역 서비스 사업자등록번호와 관련된 정보를 담고 있는 프로토콜입니다.

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

string

출력 전용입니다. 정부에서 발급한 비즈니스 전화번호

BusinessRegistrationDocument

지역 서비스 비즈니스 등록 문서에 관한 정보를 보유하는 프로토입니다.

JSON 표현
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
필드
documentReadonly

object (LocalServicesDocumentReadOnly)

출력 전용입니다. 업로드된 사업자 등록증의 정보를 포함하는 읽기 전용 필드입니다.

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 웹 클라이언트(Google Ads UI, SFTP 등 여러 소스를 포함할 수 있음)
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를 모두 설정할 수 없습니다. 한 가지 유형만 사용하고 다시 시도해 보세요.
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

가능한 전환 업로드 오류를 설명하는 enum입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
TOO_MANY_CONVERSIONS_IN_REQUEST 단일 요청으로 업로드하는 이벤트의 수를 2001개 미만으로 하세요.
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 계정과 연결되어 있습니다. 가져오는 계정이 올바른지 확인하세요. Customer에서 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 개인 식별 정보(PII)가 포함된 주문 ID가 있는 이벤트는 가져올 수 없습니다.
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

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

languageCode

string

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

value

string

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

ProductGroupView

제품 그룹 뷰

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

string

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

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

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

사용자 관심분야

사용자 관심분야: 타겟팅할 특정 관심기반 카테고리입니다.

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

출력 전용입니다. 사용자 관심분야가 모든 채널 및 언어로 출시된 경우 true입니다.

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"}는 '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

출력 전용입니다. 제출된 리드 양식과 연결된 AdGroup입니다.

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)
  },
  "creditDetails": {
    object (CreditDetails)
  }
}
필드
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)

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

creditDetails

object (CreditDetails)

출력 전용입니다. 리드의 크레딧 세부정보입니다.

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

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

CreditDetails

리드의 신용 세부정보를 나타냅니다.

JSON 표현
{
  "creditState": enum (CreditState),
  "creditStateLastUpdateDateTime": string
}
필드
creditState

enum (CreditState)

출력 전용입니다. 리드의 신용 상태입니다.

creditStateLastUpdateDateTime

string

출력 전용입니다. 리드의 신용 상태가 마지막으로 업데이트된 날짜입니다. 형식은 Google Ads 계정 시간대의 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'

CreditState

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

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
PENDING 크레딧이 제출되었으며 Google Ads 백엔드에서 처리 중이지만 아직 계정에 적용되지 않았습니다.
CREDITED Google Ads 계정에 크레딧이 지급되었습니다.

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)

출력 전용입니다. 리드 대화의 참여자 유형입니다(광고주 또는 소비자).

lead

string

출력 전용입니다. 리드 대화와 연결된 리드의 리소스 이름입니다.

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,
  "attachmentUrls": [
    string
  ]
}
필드
text

string

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

attachmentUrls[]

string

출력 전용입니다. SMS 또는 이메일 첨부파일의 URL입니다. 이러한 URL은 개발자 토큰을 사용하여 첨부파일의 콘텐츠를 다운로드하는 데 사용할 수 있습니다.

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

출력 전용입니다. '0x' 접두사를 포함하는 인코딩된 공유 광고그룹 키의 128비트 16진수 문자열입니다. 이 키는 집계 전환 키로 비트 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 개인 정보 보호 샌드박스에서 집계 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 스토어 키트 광고 네트워크 총 전환수입니다.

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

상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다.

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, recommendationType) 조합마다 URL을 반환합니다.

organicClicks

string (int64 format)

특정 검색에 의해 표시된 자연 검색결과에서 웹사이트의 검색결과를 클릭한 횟수입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요.

organicClicksPerQuery

number

사용자가 무료 검색결과에서 내 사이트를 클릭한 횟수 (organicClicks)는 내 사이트의 페이지를 검색결과로 표시한 총 검색 수 (organicQueries)로 나눈 값입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요.

organicImpressions

string (int64 format)

무료 검색 결과에 표시되는 사이트의 등록정보 수입니다. 자세한 내용은 도움말 페이지(https://support.google.com/google-ads/answer/3097241)를 참고하세요.

organicImpressionsPerQuery

number

사이트의 페이지가 무료 검색결과에 표시된 횟수를 (organicImpressions) 무료 검색결과에 사이트가 표시된 검색 횟수 (organicQueries)로 나눈 값입니다. 자세한 내용은 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원입니다. 이 주문의 크로스셀(cross-sell) 매출원가는 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,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": 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)

노출과 전환 사이 또는 노출과 전환 조정 사이의 일수를 나타내는 enum 값입니다.

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 Store Kit 광고 네트워크 광고 이벤트 유형입니다.

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS Store Kit 광고 네트워크 기여 분석 크레딧

skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

iOS 스토어 키트 광고 네트워크의 대략적인 전환 가치입니다.

skAdNetworkSourceType

enum (SkAdNetworkSourceType)

iOS 스토어 키트 광고 네트워크 설치를 유도한 광고가 게재된 소스 유형입니다. Null 값은 이 세그먼트를 적용할 수 없음을 의미합니다(예: iOS 외 캠페인 또는 Apple에서 전송한 포스트백에 소스 도메인 또는 소스 앱이 없음).

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

이는 사용자가 신규 고객인지 재방문 고객인지에 따라 전환을 분류하기 위한 것입니다. 이 세분화는 일반적으로 고객 획득 목표의 영향을 측정하는 데 사용됩니다.

activityAccountId

string (int64 format)

활동 계정 ID입니다.

activityCity

string

여행 활동을 이용할 수 있는 도시입니다.

activityCountry

string

여행 활동을 이용할 수 있는 국가입니다.

activityRating

string (int64 format)

활동 등급

activityState

string

여행 활동을 사용할 수 있는 상태입니다.

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

주(canton)를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetCity

string

도시를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetCountry

string

국가를 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

geoTargetCounty

string

카운티를 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

geoTargetDistrict

string

구역을 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

geoTargetMetro

string

대중교통을 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetMostSpecificLocation

string

가장 구체적인 위치를 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

geoTargetPostalCode

string

우편번호를 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

geoTargetProvince

string

시/도를 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

geoTargetRegion

string

지역을 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetState

string

주(state)를 나타내는 지역 타겟 상수의 리소스 이름입니다.

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 이하의 숫자로 나타냅니다.

interactionOnThisExtension

boolean

피드 항목 측정항목에만 사용됩니다. 상호작용 측정항목이 피드 항목 자체에서 발생했는지 아니면 다른 확장 소재 또는 광고 단위에서 발생했는지 나타냅니다.

month

string

월(월의 첫 번째 날의 날짜로 표시) 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 Store Kit 광고 네트워크 포스트백 시퀀스 인덱스입니다.

assetInteractionTarget

object (AssetInteractionTarget)

CustomerAsset, CampaignAsset, AdGroupAsset 측정항목에만 사용됩니다. 상호작용 측정항목이 확장 소재 자체에서 발생했는지 아니면 다른 확장 소재 또는 광고 단위에서 발생했는지 나타냅니다. 상호작용(예: 클릭)은 게재된 광고의 모든 부분(예: 광고 자체 및 사이트링크와 같은 기타 구성요소)에서 함께 게재될 때 집계됩니다. 상호작용 OnThisAsset이 true이면 이 특정 애셋에서 상호작용이 발생했다는 의미이고,InteractionOnThisAsset이 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~2일로 변경되었습니다. 0일은 포함되고 1일은 포함되지 않습니다.
ADJUSTMENT_ONE_TO_TWO_DAYS 전환 조정 지연 시간 버킷이 1~2일에서 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 전환 지연 시간 버킷 UNKNOWN Google Ads에서 전환 지연 버킷을 사용할 수 있기 전의 날짜입니다.
ADJUSTMENT_UNKNOWN 전환 조정 지연 버킷이 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 사용자가 광고를 클릭한 후 광고주의 웹사이트에서 설치된 JavaScript에 의해 동적으로 생성된 전화번호로 전화를 걸 때 발생하는 전환입니다. 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 기여 분석에서 제어하는 전환입니다.
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 Search Ads 360 전용으로 Google 애널리틱스에서 발생한 전환입니다. 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 버전에서 알 수 없는 값입니다. 이 API 버전에서는 true enum 값을 반환할 수 없거나 아직 지원되지 않습니다.
UNAVAILABLE 포스트백에 값이 없거나 다른 이유로 이 데이터가 없습니다.
WON Google이 광고 기여 분석을 낙찰받은 광고 네트워크입니다.
CONTRIBUTED Google은 기여 분석을 획득할 자격을 갖췄지만 수상하지 못했습니다.

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 전환하는 사용자는 광고주에게 처음이며 평생 가치가 높습니다.