GoogleAdsRow

查詢傳回的資料列。

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

object (AccountBudget)

查詢中的帳戶預算。
accountBudgetProposal

object (AccountBudgetProposal)

查詢中參照的帳戶預算提案。
adGroup

object (AdGroup)

查詢中參照的廣告群組。
adGroupAd

object (AdGroupAd)

查詢中參照的廣告。
adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

查詢中的廣告群組廣告素材資源組合檢視畫面。
adGroupAdAssetView

object (AdGroupAdAssetView)

查詢中的廣告群組廣告素材資源檢視畫面。
adGroupAdLabel

object (AdGroupAdLabel)

查詢中參照的廣告群組廣告標籤。
adGroupAsset

object (AdGroupAsset)

查詢中參照的廣告群組素材資源。
adGroupAssetSet

object (AdGroupAssetSet)

查詢中參照的廣告群組素材資源組合。
adGroupAudienceView

object (AdGroupAudienceView)

查詢中參照的廣告群組目標對象資料檢視。
adGroupBidModifier

object (AdGroupBidModifier)

查詢中參照的出價調節係數。
adGroupCriterion

object (AdGroupCriterion)

查詢中參照的條件。
adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

查詢中參照的廣告群組條件自訂參數。
adGroupCriterionLabel

object (AdGroupCriterionLabel)

查詢中參照的廣告群組條件標籤。
adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

查詢中參照的廣告群組條件模擬。
adGroupCustomizer

object (AdGroupCustomizer)

查詢中參照的廣告群組自訂參數。
adGroupExtensionSetting

object (AdGroupExtensionSetting)

查詢中參照的廣告群組額外資訊設定。
adGroupFeed

object (AdGroupFeed)

查詢中參照的廣告群組動態饋給。
adGroupLabel

object (AdGroupLabel)

查詢中參照的廣告群組標籤。
adGroupSimulation

object (AdGroupSimulation)

查詢中參照的廣告群組模擬。
adParameter

object (AdParameter)

查詢中參照的廣告參數。
ageRangeView

object (AgeRangeView)

查詢中參照的年齡層資料檢視。
adScheduleView

object (AdScheduleView)

查詢中參照的廣告時段資料檢視。
domainCategory

object (DomainCategory)

查詢中參照的網域類別。
asset

object (Asset)

查詢中參照的資產。
assetFieldTypeView

object (AssetFieldTypeView)

查詢中參照的資產欄位類型檢視畫面。
assetGroupAsset

object (AssetGroupAsset)

查詢中參照的素材資源群組素材資源。
assetGroupSignal

object (AssetGroupSignal)

查詢中參照的素材資源群組信號。
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

查詢中參照的素材資源群組商家資訊群組篩選器。
assetGroupProductGroupView

object (AssetGroupProductGroupView)

查詢中參照的素材資源群組產品群組檢視畫面。
assetGroup

object (AssetGroup)

查詢中參照的素材資源群組。
assetSetAsset

object (AssetSetAsset)

查詢中參照的素材資源集素材資源。
assetSet

object (AssetSet)

查詢中參照的素材資源組合。
assetSetTypeView

object (AssetSetTypeView)

查詢中參照的素材資源集類型檢視畫面。
batchJob

object (BatchJob)

查詢中參照的批次工作。
biddingDataExclusion

object (BiddingDataExclusion)

查詢中參照的出價資料排除。
biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

查詢中參照的出價季節性調整。
biddingStrategy

object (BiddingStrategy)

查詢中參照的出價策略。
biddingStrategySimulation

object (BiddingStrategySimulation)

查詢中參照的出價策略模擬。
billingSetup

object (BillingSetup)

查詢中參照的帳單設定。
callView

object (CallView)

查詢中參照的呼叫檢視畫面。
campaignBudget

object (CampaignBudget)

查詢中參照的廣告活動預算。
campaign

object (Campaign)

查詢中參照的廣告活動。
campaignAsset

object (CampaignAsset)

查詢中參照的廣告活動資產。
campaignAssetSet

object (CampaignAssetSet)

查詢中參照的廣告活動素材資源組合。
campaignAudienceView

object (CampaignAudienceView)

查詢中參照的廣告活動目標對象資料檢視。
campaignBidModifier

object (CampaignBidModifier)

查詢中參照的廣告活動出價調節係數。
campaignConversionGoal

object (CampaignConversionGoal)

查詢中參照的 CampaignConversionGoal。
campaignCriterion

object (CampaignCriterion)

查詢中參照的廣告活動條件。
campaignCustomizer

object (CampaignCustomizer)

查詢中參照的廣告活動自訂參數。
campaignDraft

object (CampaignDraft)

查詢中參照的廣告活動草稿。
campaignExtensionSetting

object (CampaignExtensionSetting)

查詢中參照的廣告活動額外資訊設定。
campaignFeed

object (CampaignFeed)

查詢中參照的廣告活動動態饋給。
campaignGroup

object (CampaignGroup)

AWQL 查詢中參照的廣告活動群組。
campaignLabel

object (CampaignLabel)

查詢中參照的廣告活動標籤。
campaignSearchTermInsight

object (CampaignSearchTermInsight)

查詢中參照的廣告活動搜尋字詞洞察。
campaignSharedSet

object (CampaignSharedSet)

AWQL 查詢中參照的廣告活動共用組合。
campaignSimulation

object (CampaignSimulation)

查詢中參照的廣告活動模擬。
carrierConstant

object (CarrierConstant)

查詢中參照的電信業者常數。
changeEvent

object (ChangeEvent)

查詢中參照的 ChangeEvent。
changeStatus

object (ChangeStatus)

查詢中參照的 ChangeStatus。
combinedAudience

object (CombinedAudience)

查詢中參照的 MergedAudience。
audience

object (Audience)

查詢中參照的目標對象。
conversionAction

object (ConversionAction)

查詢中參照的轉換動作。
conversionCustomVariable

object (ConversionCustomVariable)

查詢中參照的轉換自訂變數。
conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

查詢中參照的 ConversionGoalCampaignConfig。
conversionValueRule

object (ConversionValueRule)

查詢參照的轉換價值規則。
conversionValueRuleSet

object (ConversionValueRuleSet)

查詢中參照的轉換價值規則組合。
clickView

object (ClickView)

查詢中參照的 ClickView。
currencyConstant

object (CurrencyConstant)

查詢中參照的貨幣常數。
customAudience

object (CustomAudience)

查詢中參照的 CustomAudience。
customConversionGoal

object (CustomConversionGoal)

查詢中參照的 CustomConversionGoal。
customInterest

object (CustomInterest)

查詢中參照的 CustomInterest。
customer

object (Customer)

查詢中參照的客戶。
customerAsset

object (CustomerAsset)

查詢中參照的客戶素材資源。
customerAssetSet

object (CustomerAssetSet)

查詢中參照的客戶素材資源組合。
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

查詢中參照的可用出價策略。
customerCustomizer

object (CustomerCustomizer)

查詢中參照的客戶自訂參數。
customerClient

object (CustomerClient)

查詢中參照的 CustomerClient。
customerConversionGoal

object (CustomerConversionGoal)

查詢中參照的 CustomerConversionGoal。
customerExtensionSetting

object (CustomerExtensionSetting)

查詢中參照的客戶額外資訊設定。
customerFeed

object (CustomerFeed)

查詢中參照的顧客動態饋給。
customerLabel

object (CustomerLabel)

查詢中參照的客戶標籤。
customerNegativeCriterion

object (CustomerNegativeCriterion)

查詢中參照的客戶排除條件。
customerSearchTermInsight

object (CustomerSearchTermInsight)

查詢中參照的客戶搜尋字詞洞察。
customerUserAccess

object (CustomerUserAccess)

查詢中參照的 CustomerUserAccess。
customerUserAccessInvitation

object (CustomerUserAccessInvitation)

查詢中參照的客戶使用者存取邀請。
customizerAttribute

object (CustomizerAttribute)

查詢中參照的自訂參數屬性。
detailPlacementView

object (DetailPlacementView)

查詢中參照的詳細資料刊登位置檢視畫面。
detailedDemographic

object (DetailedDemographic)

查詢中參照的詳細客層。
displayKeywordView

object (DisplayKeywordView)

查詢中參照的多媒體廣告關鍵字資料檢視。
distanceView

object (DistanceView)

查詢中參照的距離檢視畫面。
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

查詢中參照的動態搜尋廣告搜尋字詞檢視畫面。
expandedLandingPageView

object (ExpandedLandingPageView)

查詢中參照的延展型到達網頁檢視畫面。
extensionFeedItem

object (ExtensionFeedItem)

查詢中參照的擴充功能動態饋給項目。
feed

object (Feed)

查詢中參照的動態饋給。
feedItem

object (FeedItem)

查詢中參照的動態饋給項目。
feedItemSet

object (FeedItemSet)

查詢中參照的動態饋給項目集。
feedItemTarget

object (FeedItemTarget)

查詢中參照的動態饋給項目目標。
feedMapping

object (FeedMapping)

查詢中參照的動態饋給對應關係。
feedPlaceholderView

object (FeedPlaceholderView)

查詢中參照的動態饋給預留位置檢視畫面。
genderView

object (GenderView)

查詢中參照的性別檢視畫面。
geoTargetConstant

object (GeoTargetConstant)

查詢中參照的指定地理區域常數。
geographicView

object (GeographicView)

查詢中參照的地理區域檢視畫面。
groupPlacementView

object (GroupPlacementView)

查詢中參照的群組刊登位置檢視畫面。
hotelGroupView

object (HotelGroupView)

查詢中參照的飯店群組檢視畫面。
hotelPerformanceView

object (HotelPerformanceView)

查詢中參照的飯店成效檢視畫面。
hotelReconciliation

object (HotelReconciliation)

查詢中參照的飯店對帳列。
incomeRangeView

object (IncomeRangeView)

查詢中參照的收入範圍檢視畫面。
keywordView

object (KeywordView)

查詢中參照的關鍵字檢視。
keywordPlan

object (KeywordPlan)

查詢中參照的關鍵字企劃書。
keywordPlanCampaign

object (KeywordPlanCampaign)

查詢中參照的關鍵字企劃書廣告活動。
keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

查詢中參照的關鍵字企劃書廣告活動關鍵字。
keywordPlanAdGroup

object (KeywordPlanAdGroup)

查詢中參照的關鍵字企劃書廣告群組。
keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

查詢中參照的關鍵字企劃書廣告群組。
keywordThemeConstant

object (KeywordThemeConstant)

查詢中參照的關鍵字主題常數。
label

object (Label)

查詢中參照的標籤。
landingPageView

object (LandingPageView)

查詢中參照的到達網頁檢視畫面。
languageConstant

object (LanguageConstant)

查詢中參照的語言常數。
locationView

object (LocationView)

查詢中參照的位置檢視畫面。
managedPlacementView

object (ManagedPlacementView)

查詢中參照的自選刊登位置資料檢視。
mediaFile

object (MediaFile)

查詢中參照的媒體檔案。
mobileAppCategoryConstant

object (MobileAppCategoryConstant)

查詢中參照的行動應用程式類別常數。
mobileDeviceConstant

object (MobileDeviceConstant)

查詢中參照的行動裝置常數。
offlineUserDataJob

object (OfflineUserDataJob)

查詢中參照的離線使用者資料工作。
operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

查詢中參照的作業系統版本常數。
paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

查詢中參照的付費隨機搜尋字詞檢視畫面。
qualifyingQuestion

object (QualifyingQuestion)

查詢中參照的資格問題。
parentalStatusView

object (ParentalStatusView)

查詢中參照的家長狀態檢視畫面。
perStoreView

object (PerStoreView)

查詢中參照的每項商店檢視畫面。
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

查詢中參照的「產品類別」類別。
productGroupView

object (ProductGroupView)

查詢中參照的產品群組檢視畫面。
recommendation

object (Recommendation)

查詢中參照的建議。
searchTermView

object (SearchTermView)

查詢中參照的搜尋字詞檢視畫面。
sharedCriterion

object (SharedCriterion)

查詢中參照的共用組合。
sharedSet

object (SharedSet)

查詢中參照的共用組合。
smartCampaignSetting

object (SmartCampaignSetting)

查詢中參照的智慧廣告活動設定。
shoppingPerformanceView

object (ShoppingPerformanceView)

查詢中參照的購物成效資料檢視。
smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

查詢中參照的智慧廣告活動搜尋字詞資料檢視。
topicView

object (TopicView)

查詢中參照的主題檢視表。
travelActivityGroupView

object (TravelActivityGroupView)

查詢中參照的旅遊活動群組資料檢視。
travelActivityPerformanceView

object (TravelActivityPerformanceView)

查詢中參照的旅遊活動成效資料檢視。
experiment

object (Experiment)

查詢中參照的實驗。
experimentArm

object (ExperimentArm)

查詢中參照的實驗組。
userInterest

object (UserInterest)

查詢中參照的使用者興趣。
lifeEvent

object (LifeEvent)

查詢中參照的人生大事。
userList

object (UserList)

查詢中參照的使用者名單。
userLocationView

object (UserLocationView)

查詢中參照的使用者位置檢視畫面。
remarketingAction

object (RemarketingAction)

查詢中參照的再行銷動作。
topicConstant

object (TopicConstant)

查詢中參照的主題常數。
video

object (Video)

查詢中參照的影片。
webpageView

object (WebpageView)

查詢中參照的網頁檢視。
leadFormSubmissionData

object (LeadFormSubmissionData)

查詢中參照的待開發客戶表單使用者提交內容。
metrics

object (Metrics)

指標。
segments

object (Segments)

區隔。

AccountBudget

帳戶層級預算。其中包含預算本身的相關資訊，以及最近獲準對預算所做的變更，以及尚待審核的提案變更。「待審核提案」中會顯示待審核的提議變更 (如果有的話)。預算相關的有效詳細資料位於名為「approved_」、「adjusted_」且不含前置字元的欄位。某些有效的詳細資料可能與使用者原先要求的內容不同 (例如支出上限)，系統會透過「proposed_」、「approved_」和「adjusted_」欄位將這些差異調整。

這項資源是透過 AccountBudgetProposal 變更，無法直接變更。預算無論何時最多只能有一個待處理的提案。正在等待待核准的提案。

獲準後，預算可能會受到調整 (例如抵免額調整項)。調整項會在「已核准」和「已調整」欄位之間建立差異，否則這些欄位會完全相同。

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)

僅供輸出。已放送廣告的價值 (以百萬分之一為單位)。

這也包括超量放送費用，在此情況下，系統可能會自動將抵免額套用至預算 (請參閱 TotalAdjustsMicros)。
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)

僅供輸出。建議的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。
proposedSpendingLimitType

enum (SpendingLimitType)

僅供輸出。提議的支出上限和定義明確的類型，例如 INFINITE。

聯集欄位 approved_spending_limit。核准的支出上限。

舉例來說，如果帳戶的支出金額超過提案核准時建議的支出上限，核准支出上限就會設為已支出的金額。approved_spending_limit 只能採用下列其中一種設定：
approvedSpendingLimitMicros

string (int64 format)

僅供輸出。核准的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。只有在提議的支出上限是有限時才會填入資料，且該上限值一律會大於或等於提議的支出上限。
approvedSpendingLimitType

enum (SpendingLimitType)

僅供輸出。已核准的支出上限和明確定義的類型，例如 INFINITE。只有在已核准的支出上限為 INFINITE 時，系統才會填入這個值。

聯集欄位 adjusted_spending_limit。套用調整項後的支出上限。調整項資料會儲存在 total_adjustments_micros 中。

這個值會決定帳戶的支出上限。adjusted_spending_limit 只能採用下列其中一種設定：
adjustedSpendingLimitMicros

string (int64 format)

僅供輸出。調整後的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。

如果已核准的支出上限是有限，調整後的支出上限可能會因預算套用的調整項類型而不同。

如要瞭解各種調整項類型，請參閱：https://support.google.com/google-ads/answer/1704323

舉例來說，扣款調整會降低帳戶的支出上限。
adjustedSpendingLimitType

enum (SpendingLimitType)

僅供輸出。調整後的支出上限和定義明確的類型，例如 INFINITE。只有在調整後的支出上限為 INFINITE 的情況下，系統才會填入這個值。如果已核准的支出上限為 INFINITE，則保證達到一定上限。

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)

僅供輸出。支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。
spendingLimitType

enum (SpendingLimitType)

僅供輸出。支出上限與定義明確的類型，例如 INFINITE。

AdGroupAdAssetCombinationView

廣告群組廣告素材資源組合的使用情況。回應式搜尋廣告目前僅支援 AdAssetCombinationView，我們預計日後將支援更多廣告類型。

JSON 表示法 
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
欄位
resourceName

string

僅供輸出。廣告群組廣告素材資源組合檢視畫面的資源名稱。組合 ID 的長度為 128 位元，上方 64 位元會儲存在 asset_combination_id_high 中，而較低的 64 位元則儲存在 asset_combination_id_low 中。廣告群組廣告素材資源組合檢視資源名稱的格式如下：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

廣告群組廣告與素材資源之間的連結。AppAds 和回應式搜尋廣告目前僅支援 廣告群組 AdAssetView。

JSON 表示法 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
欄位
resourceName

string

僅供輸出。廣告群組廣告素材資源檢視畫面的資源名稱。廣告群組廣告素材資源檢視資源名稱的格式為 (V4 之前)：

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

廣告群組廣告素材資源檢視資源名稱的格式應為 (從 V4 開始)：

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

enum (AssetFieldType)

僅供輸出。素材資源在廣告中的角色。
policySummary

object (AdGroupAdAssetPolicySummary)

僅供輸出。廣告群組廣告素材資源的政策資訊。
performanceLabel

enum (AssetPerformanceLabel)

僅供輸出。素材資源連結的成效。
pinnedField

enum (ServedAssetFieldType)

僅供輸出。固定欄位。
adGroupAd

string

僅供輸出。素材資源連結的廣告群組廣告。
asset

string

僅供輸出。與廣告群組廣告連結的素材資源。
enabled

boolean

僅供輸出。素材資源和廣告最新版本的狀態。如果為 true，素材資源會連結至廣告的最新版本。如果為 false，則表示該連結曾經存在，但已移除，且不會再顯示在最新版本的廣告中。

AdGroupAdAssetPolicySummary

包含廣告群組廣告素材資源的政策資訊。

JSON 表示法 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
欄位
policyTopicEntries[]

object (PolicyTopicEntry)

僅供輸出。廣告群組廣告素材資源的政策結果清單。
reviewStatus

enum (PolicyReviewStatus)

僅供輸出。這項廣告群組廣告素材資源的審核程序。
approvalStatus

enum (PolicyApprovalStatus)

僅供輸出。這個廣告群組廣告素材資源的整體核准狀態，根據個別政策主題項目的狀態計算而得。

AdGroupAudienceView

廣告群組目標對象資料檢視。包括多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單，以及在目標對象層級匯總的搜尋廣告再行銷名單。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。廣告群組目標對象檢視畫面的資源名稱。廣告群組目標對象資料檢視資源名稱的格式如下：

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

AdGroupCriterionSimulation

廣告群組條件模擬。以下分別列出支援的廣告管道類型、條件類型、模擬類型和模擬修改方法組合。從 V5 開始的飯店廣告群組條件模擬作業。

  1. 多媒體廣告 - 關鍵字 - 單次點擊出價 - 單次點擊出價 - UNIFORM
  2. 搜尋 - 關鍵字 - 單次點擊出價 - 單次點擊出價 - 排除
  3. SHOPPING - LISTING_GROUP -CPC_bid - UNIFORM
  4. 飯店 - LISTING_GROUP - 單次點擊出價 - 非重複出價
  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 模擬結果可用於單次點擊出價。
CPV_BID 模擬結果是針對單次收視出價。
TARGET_CPA 模擬工具為單次轉換出價目標。
BID_MODIFIER 這項模擬作業適用於出價調節係數，
TARGET_ROAS 模擬功能是針對廣告投資報酬率目標進行模擬。
PERCENT_CPC_BID 模擬結果是單次點擊出價百分比。
TARGET_IMPRESSION_SHARE 模擬結果是曝光比重目標。
BUDGET 模擬作業僅適用於預算。

SimulationModificationMethod

列舉說明模擬作業修改欄位的方法。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
UNIFORM 模擬中的值會套用至指定資源的所有子項。未遵循子資源的覆寫。
DEFAULT 系統會將模擬中的值套用至指定資源。系統會遵循子資源的覆寫設定，且流量估算並未納入這些資源。
SCALING 模擬中的值全都是由相同的因素縮放。舉例來說，在模擬的 TargetCpa 廣告活動中，系統會將廣告活動目標和所有廣告群組目標設定成 X 的係數。

CpcBidSimulationPointList

用於模擬「CPC_BID」類型模擬作業的容器。

JSON 表示法 
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
欄位
points[]

object (CpcBidSimulationPoint)

一系列單次點擊出價金額的預測指標。

CpcBidSimulationPoint

特定單次點擊出價金額的預測指標。

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_scaling_modifier。cpc_simulation_key_value 只能是下列其中一項：
cpcBidMicros

string (int64 format)

模擬單次點擊出價，預估指標是根據預測指標計算而得。
cpcBidScalingModifier

number

模擬縮放修飾符是以預測指標為基礎。與模擬實體相關的所有單次點擊出價都會由這個修飾符調整。

PercentCpcBidSimulationPointList

用於模擬 PERCENT_CPC_BID 類型模擬點的容器。

JSON 表示法 
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
欄位
points[]

object (PercentCpcBidSimulationPoint)

一系列單次點擊出價百分比的預測指標。

PercentCpcBidSimulationPoint

特定單次點擊出價金額的預測指標。只有飯店廣告管道類型支援這個欄位。

JSON 表示法 
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
欄位
percentCpcBidMicros

string (int64 format)

模擬單次點擊出價百分比，預計指標是根據預測指標計算而得。單次點擊出價百分比 (以商品或服務在廣告價格中所佔的比例表示)。在這裡儲存的值為 1,000,000 * [fraction]。
biddableConversions

number

預計可出價轉換次數。
biddableConversionsValue

number

可出價轉換的預計總價值 (以當地幣別計算)。
clicks

string (int64 format)

預計點擊次數。
costMicros

string (int64 format)

預估費用 (以百萬分之一為單位)
impressions

string (int64 format)

預計曝光次數。
topSlotImpressions

string (int64 format)

預測的頂端版位曝光次數。

AdGroupSimulation

廣告群組模擬。下方詳細說明瞭廣告管道類型、模擬類型和模擬修改方法所支援的組合。

  1. 搜尋聯播網 - 單次點擊出價 - 預設
  2. 搜尋 - 單次點擊出價 - 排除
  3. 搜尋 - TARGET_CPA - 非表單
  4. 搜尋 - TARGET_ROAS - 聯合國處理
  5. 多媒體 - 單次點擊出價 - 預設
  6. 多媒體廣告 - 單次點擊出價 - 不重複出價
  7. 多媒體廣告 - TARGET_CPA - 非必填
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)

一系列單次收視出價金額的預測指標。

CpvBidSimulationPoint

特定單次收視出價金額的預測指標。

JSON 表示法 
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
欄位
cpvBidMicros

string (int64 format)

模擬單次收視出價是以預測指標為基礎。
costMicros

string (int64 format)

預估費用 (以百萬分之一為單位)
impressions

string (int64 format)

預計曝光次數。
views

string (int64 format)

預計觀看次數。

TargetCpaSimulationPointList

用於模擬 TARGET_CPA 類型模擬點的容器。

JSON 表示法 
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
欄位
points[]

object (TargetCpaSimulationPoint)

一系列目標單次轉換出價金額的預測指標。

TargetCpaSimulationPoint

特定目標單次轉換出價金額的預測指標。

JSON 表示法 
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

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

string (int64 format)

廣告主為了獲得預估流量而必須設定的預計每日預算 (以廣告客戶貨幣的百萬分之一表示)。
appInstalls

number

預計應用程式安裝次數。
inAppActions

number

預估應用程式內動作次數。
biddableConversions

number

預計可出價轉換次數。
biddableConversionsValue

number

可出價轉換的預計總價值。
clicks

string (int64 format)

預計點擊次數。
costMicros

string (int64 format)

預估費用 (以百萬分之一為單位)
impressions

string (int64 format)

預計曝光次數。
topSlotImpressions

string (int64 format)

預測的頂端版位曝光次數。只有搜尋廣告管道類型支援這個欄位。
聯集欄位 target_cpa_simulation_key_value。當 SimulationModificationMethod = UNIFORM 或 DEFAULT 時，系統會設定 target_cpa_micros。當 SimulationModificationMethod = SCALING 時，已設定 target_cpa_scaling_modifier。target_cpa_simulation_key_value 只能是下列其中一項：
targetCpaMicros

string (int64 format)

模擬目標單次轉換出價，其中預測指標是根據預測指標計算而得。
targetCpaScalingModifier

number

模擬縮放修飾符是以預測指標為基礎。與模擬實體相關的所有單次操作出價目標都會由這個修飾符調整。

TargetRoasSimulationPointList

用於模擬 TARGET_ROAS 類型模擬點的容器。

JSON 表示法 
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
欄位
points[]

object (TargetRoasSimulationPoint)

一系列目標廣告投資報酬率金額的預測指標。

TargetRoasSimulationPoint

特定目標廣告投資報酬率金額的預測指標。

JSON 表示法 
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
欄位
requiredBudgetAmountMicros

string (int64 format)

廣告主為了獲得預估流量而必須設定的預計每日預算 (以廣告客戶貨幣的百萬分之一表示)。
targetRoas

number

模擬目標廣告投資報酬率 (根據預測指標所依據)。
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)

僅供輸出。這個類別在類別集中的位置。數字越小表示網域越符合網域；空值表示不建議使用。
hasChildren

boolean

僅供輸出。指出此類別是否包含子類別。
recommendedCpcBidMicros

string (int64 format)

僅供輸出。該類別的建議單次點擊出價。

AssetFieldTypeView

素材資源欄位類型檢視畫面。當使用素材資源做為額外資訊時，這個檢視畫面會回報各素材資源欄位類型的未重疊指標。

JSON 表示法 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
欄位
resourceName

string

僅供輸出。資產欄位類型檢視畫面的資源名稱。資產欄位類型檢視資源名稱的格式如下所示：

customers/{customerId}/assetFieldTypeViews/{fieldType}
fieldType

enum (AssetFieldType)

僅供輸出。資產欄位類型檢視畫面的素材資源欄位類型。

AssetGroupProductGroupView

素材資源群組產品群組檢視畫面。

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
欄位
resourceName

string

僅供輸出。素材資源群組產品群組檢視畫面的資源名稱。素材資源群組產品群組檢視畫面資源名稱的格式如下：

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

string

僅供輸出。與商家資訊群組篩選器相關聯的素材資源群組。
assetGroupListingGroupFilter

string

僅供輸出。素材資源群組商家資訊群組篩選器的資源名稱。

AssetSetTypeView

素材資源集類型檢視畫面。這個檢視畫面會記錄每個素材資源集類型的未重疊指標。這份報表不包含子素材資源集類型。統計資料彙整於父項素材資源集類型下方。

JSON 表示法 
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
欄位
resourceName

string

僅供輸出。資產集類型檢視畫面的資源名稱。資產集類型檢視資源名稱的格式如下：

customers/{customerId}/assetSetTypeViews/{assetSetType}
assetSetType

enum (AssetSetType)

僅供輸出。素材資源集類型檢視畫面的素材資源集類型。

BiddingStrategySimulation

出價策略模擬。下方詳細說明瞭支援的模擬類型和模擬修改方法組合。

  1. TARGET_CPA - 聯合國工夫
  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 秒，則為空值。
callDurationSeconds

string (int64 format)

僅供輸出。廣告客戶提供的通話時間長度 (以秒為單位)。
startCallDateTime

string

僅供輸出。廣告主提供的通話開始日期時間。
endCallDateTime

string

僅供輸出。廣告主提供的通話結束日期時間。
callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

僅供輸出。來電追蹤顯示位置。
type

enum (CallType)

僅供輸出。呼叫類型。
callStatus

enum (GoogleVoiceCallStatus)

僅供輸出。通話狀態。

CallTrackingDisplayLocation

可能的來電追蹤顯示位置。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
AD 透過廣告撥打的電話。
LANDING_PAGE 透過到達網頁廣告所撥打的電話。

CallType

發出呼叫時可能出現的屬性類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
MANUALLY_DIALED 使用者手動撥打了電話。

GoogleVoiceCallStatus

Google 語音通話的可能狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
MISSED 未接聽來電。
RECEIVED 已收到通話。

CampaignAudienceView

廣告活動目標對象檢視畫面。包含多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單，以及依廣告活動和目標對象條件匯總的搜尋廣告再行銷名單 (RLSA)。這個檢視畫面只包含廣告活動層級附加的目標對象。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。廣告活動目標對象檢視畫面的資源名稱。廣告活動目標對象資料檢視資源名稱的格式如下：

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

CampaignSearchTermInsight

廣告活動搜尋字詞檢視。歷來資料從 2023 年 3 月起開始提供。

JSON 表示法 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
欄位
resourceName

string

僅供輸出。廣告活動層級搜尋字詞洞察的資源名稱。廣告活動層級搜尋字詞洞察資源名稱的格式如下：

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

string

僅供輸出。搜尋類別的標籤。如果搜尋字詞不符合其他類別，就會表示屬於「全部接收」類別。
id

string (int64 format)

僅供輸出。深入分析的 ID。
campaignId

string (int64 format)

僅供輸出。廣告活動的 ID。

CampaignSimulation

廣告活動模擬。下方詳細說明瞭廣告管道類型、模擬類型和模擬修改方法所支援的組合。

  • 搜尋 - 單次點擊出價 - 排除
  • 搜尋 - 單次點擊出價 - 放送
  • 搜尋 - TARGET_CPA - 非表單
  • 搜尋 - TARGET_CPA - SCALING
  • 搜尋 - TARGET_ROAS - 聯合國處理
  • 搜尋 - TARGET_IMPRESSION_SHARE - 專屬
  • 搜尋聯播網 - 預算 - 公開
  • 購物 - 預算 - 不公開
  • 購物 - TARGET_ROAS - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • 探索 - TARGET_CPA - 預設
  • 多媒體廣告 - TARGET_CPA - 非必填
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - 預算 - 非表單
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)

模擬目標曝光比重值 (以百萬分之一為單位)，預計指標依據。舉例來說，10% 曝光比重 (等於 0.1) 就會儲存為 100_000。這個值已完成驗證，而且不會超過 100 萬 (100%)。
requiredCpcBidCeilingMicros

string (int64 format)

廣告客戶為了獲得這項模擬結果，必須設定的每日單次點擊出價上限 (以廣告客戶貨幣的百萬分之一表示)。
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
}
欄位
budgetAmountMicros

string (int64 format)

根據預計指標計算出的模擬預算。
requiredCpcBidCeilingMicros

string (int64 format)

廣告客戶為了獲得這項模擬結果，必須設定的每日單次點擊出價上限 (以廣告客戶貨幣的百萬分之一表示)。只有採用「目標支出」出價策略的廣告活動才支援這個欄位。
biddableConversions

number

預計可出價轉換次數。
biddableConversionsValue

number

可出價轉換的預計總價值。
clicks

string (int64 format)

預計點擊次數。
costMicros

string (int64 format)

預估費用 (以百萬分之一為單位)
impressions

string (int64 format)

預計曝光次數。
topSlotImpressions

string (int64 format)

預測的頂端版位曝光次數。只有搜尋廣告管道類型支援這個欄位。

CarrierConstant

可用於廣告活動指定目標的電信業者條件。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
欄位
resourceName

string

僅供輸出。電信業者條件的資源名稱。電信業者條件資源名稱的格式如下：

carrierConstants/{criterionId}
id

string (int64 format)

僅供輸出。電信業者條件的 ID。
name

string

僅供輸出。通訊業者的全名 (英文)。
countryCode

string

僅供輸出。通訊業者所在國家/地區的國家/地區代碼，例如「AR」、「FR」等

ChangeEvent

說明特定資源類型傳回資源的精細變更。並納入過去 30 天內透過 UI 或 API 所做的變更。變更後的欄位會顯示先前的和新值。ChangeEvent 可能需要最多 3 分鐘才會反映新的變更。

JSON 表示法 
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string,
  "asset": string
}
欄位
resourceName

string

僅供輸出。變更事件的資源名稱。變更事件資源名稱的格式如下：

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

string

僅供輸出。對這項資源提交變更的時間。
changeResourceType

enum (ChangeEventResourceType)

僅供輸出。已變更資源的類型。這會指定哪個資源會在舊資源和 newResource 中設定。
changeResourceName

string

僅供輸出。發生這項變更的 Just 資源。
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

列出 ChangesEvent 資源支援的資源類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中的未分類資源。
AD 廣告資源變更。
AD_GROUP 廣告群組資源變更。
AD_GROUP_CRITERION 廣告群組條件資源變更。
CAMPAIGN 廣告活動資源變更。
CAMPAIGN_BUDGET CampaignBudget 資源變更。
AD_GROUP_BID_MODIFIER 廣告群組 BidModifier 資源變更。
CAMPAIGN_CRITERION CampaignCriterion 資源變更。
FEED 動態饋給資源變更。
FEED_ITEM FeedItem 資源變更。
CAMPAIGN_FEED CampaignFeed 資源變更。
AD_GROUP_FEED 廣告群組動態饋給資源異動。
AD_GROUP_AD 廣告群組廣告資源變更。
ASSET 資產資源變更。
CUSTOMER_ASSET CustomerAsset 資源變更。
CAMPAIGN_ASSET CampaignAsset 資源變更。
AD_GROUP_ASSET 廣告群組資產變更。
ASSET_SET AssetSet 資源變更。
ASSET_SET_ASSET AssetSetAsset 資源變更。
CAMPAIGN_ASSET_SET CampaignAssetSet 資源變更。

ChangeClientType

changeEvent 資源的執行來源。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本不明的未分類用戶端類型。
GOOGLE_ADS_WEB_CLIENT 透過 ads.google.com.tw 所做的變更。例如透過廣告活動管理進行變更。
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 透過內部工具所做的變更。舉例來說，如果使用者在廣告活動等實體中設定網址範本，系統就會自動將該範本與 SA360 Clickserver 網址包裝在一起。
OTHER 未分類的變更類型 (例如透過 Google Ads 優待券兌換的變更)。

ChangedResource

展示所有支援資源的包裝函式 proto。系統只會設定 changeResourceType 資源。

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

object (Ad)

僅供輸出。設定 if changeResourceType == AD 時，才設定此參數。
adGroup

object (AdGroup)

僅供輸出。設定 if changeResourceType == AD_GROUP 時，才設定此參數。
adGroupCriterion

object (AdGroupCriterion)

僅供輸出。設定 if 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)

僅供輸出。設定 if changeResourceType == AD_GROUP_AD 時，才設定此參數。
asset

object (Asset)

僅供輸出。針對 changeResourceType == ASSET 設定。
customerAsset

object (CustomerAsset)

僅供輸出。如果 changeResourceType == CUSTOMER_ASSET ，設定此參數。
campaignAsset

object (CampaignAsset)

僅供輸出。針對 changeResourceType == CAMPAIGN_ASSET 設定。
adGroupAsset

object (AdGroupAsset)

僅供輸出。設定 if 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

僅供輸出。受這項異動影響的客戶資產。
campaignAsset

string

僅供輸出。受到這項異動影響的 CampaignAsset。
adGroupAsset

string

僅供輸出。受這項異動影響的 adAsset。
combinedAudience

string

僅供輸出。受這項異動影響的 MergedAudience。
lastChangeDateTime

string

僅供輸出。最近一次變更於這項資源的時間。
campaign

string

僅供輸出。受這項異動影響的廣告活動。
adGroup

string

僅供輸出。受到這項變更影響的廣告群組。
adGroupAd

string

僅供輸出。受到這項變更影響的 廣告群組廣告。
adGroupCriterion

string

僅供輸出。受此變更影響的 廣告群組條件。
campaignCriterion

string

僅供輸出。受到這項異動影響的 CampaignCriterion。
feed

string

僅供輸出。受到這項異動影響的動態饋給。
feedItem

string

僅供輸出。受到這項變更影響的 FeedItem。
adGroupFeed

string

僅供輸出。受到這項異動影響的廣告群組動態饋給。
campaignFeed

string

僅供輸出。受到這項異動影響的廣告活動動態饋給。
adGroupBidModifier

string

僅供輸出。受這項變更影響的 廣告群組 BidModifier。

ChangeStatusResourceType

列舉列出 ChangeStatus 資源支援的資源類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中的未分類資源。
AD_GROUP 廣告群組資源變更。
AD_GROUP_AD 廣告群組廣告資源變更。
AD_GROUP_CRITERION 廣告群組條件資源變更。
CAMPAIGN 廣告活動資源變更。
CAMPAIGN_CRITERION CampaignCriterion 資源變更。
FEED 動態饋給資源變更。
FEED_ITEM FeedItem 資源變更。
AD_GROUP_FEED 廣告群組動態饋給資源異動。
CAMPAIGN_FEED CampaignFeed 資源變更。
AD_GROUP_BID_MODIFIER 廣告群組 BidModifier 資源變更。
SHARED_SET SharedSet 資源變更。
CAMPAIGN_SHARED_SET CampaignSharedSet 資源變更。
ASSET 資產資源變更。
CUSTOMER_ASSET CustomerAsset 資源變更。
CAMPAIGN_ASSET CampaignAsset 資源變更。
AD_GROUP_ASSET 廣告群組資產變更。
COMBINED_AUDIENCE MergedAudience 資源變更。

ChangeStatusOperation

已變更資源的狀態

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中的未分類資源。
ADDED 已建立資源。
CHANGED 資源已修改。
REMOVED 資源已移除。

CombinedAudience

說明含有不同目標對象的合併目標對象資源。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
欄位
resourceName

string

不可變動。合併目標對象的資源名稱。合併目標對象名稱的形式如下：

customers/{customerId}/combinedAudience/{combined_audience_id}
id

string (int64 format)

僅供輸出。合併目標對象的 ID。
status

enum (CombinedAudienceStatus)

僅供輸出。這個合併目標對象的狀態。指出合併目標對像是否已啟用或已移除。
name

string

僅供輸出。合併目標對象的名稱。所有合併目標對象的值不得重複。
description

string

僅供輸出。這個合併目標對象的說明。

CombinedAudienceStatus

列舉包括可能的合併目標對象狀態類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ENABLED 已啟用狀態 - 合併目標對像已啟用，可以指定。
REMOVED 已移除狀態 - 合併目標對像已移除，且無法用於指定目標。

ClickView

點擊檢視畫面，內含各個點擊層級匯總的指標，包括有效和無效點擊。對非搜尋廣告活動來說，Metrics.clicks 代表有效與無效互動次數。包含 ClickView 的查詢必須採用一個篩選器，將結果範圍限制在一天內，而且可以要求在要求提出前 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 點擊編號。
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

代表客戶擁有並與其共用的出價策略檢視畫面。

相較於出價策略，這項資源包括客戶管理員所擁有的策略，以及與客戶的共用策略，以及客戶擁有的策略。這項資源不提供指標，且隻公開一部分的出價策略屬性。

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

僅供輸出。出價策略擁有者的描述性名稱。

聯集欄位 scheme。出價配置。

只能設定其中一項。scheme 只能採用下列其中一種設定：
maximizeConversionValue

object (MaximizeConversionValue)

僅供輸出。自動出價策略會以您的預算為廣告活動爭取最大轉換價值，
maximizeConversions

object (MaximizeConversions)

僅供輸出。一種自動出價策略，用您的預算為廣告活動爭取最多轉換。
targetCpa

object (TargetCpa)

僅供輸出。這項出價策略會按照您指定的目標單次轉換出價盡量爭取轉換。
targetImpressionShare

object (TargetImpressionShare)

僅供輸出。會自動最佳化指定百分比曝光的出價策略。
targetRoas

object (TargetRoas)

僅供輸出。這個出價策略會在平均分配特定目標廣告投資報酬率，協助您爭取最高收益。
targetSpend

object (TargetSpend)

僅供輸出。這項出價策略會設定出價，在預算範圍內盡量爭取點擊。

MaximizeConversionValue

自動出價策略會以您的預算為廣告活動爭取最大轉換價值，

JSON 表示法 
{
  "targetRoas": number
}
欄位
targetRoas

number

僅供輸出。目標廣告投資報酬率選項。如果設定這項參數，出價策略會盡可能提高收益，同時平均地設定目標廣告投資報酬率。如果目標廣告投資報酬率偏高，出價策略可能無法用完整筆預算。如未設定目標廣告投資報酬率，出價策略會在預算範圍內盡可能達成最高廣告投資報酬率。

MaximizeConversions

一種自動出價策略，用您的預算為廣告活動爭取最多轉換。

JSON 表示法 
{
  "targetCpaMicros": string
}
欄位
targetCpaMicros

string (int64 format)

僅供輸出。目標單次轉換出價選項。這是指您願意為每次轉換支付的平均金額。

TargetCpa

「目標單次轉換出價」是一種自動出價策略，可按照您指定的目標單次轉換出價盡量爭取轉換。

JSON 表示法 
{
  "targetCpaMicros": string
}
欄位
targetCpaMicros

string (int64 format)

僅供輸出。平均單次轉換出價目標。這個指定目標必須大於或等於最低計費單位 (以帳戶幣別為準)。

TargetImpressionShare

這項自動出價策略可設定出價，讓特定百分比的搜尋廣告顯示在第一頁 (或其他目標地區) 的頂端。

JSON 表示法 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
欄位
location

enum (TargetImpressionShareLocation)

僅供輸出。搜尋結果網頁上的目標地區。
locationFractionMicros

string (int64 format)

選擇在目標地區顯示的廣告比例 (以百萬分之一為單位)。例如，1% 等於 10,000。
cpcBidCeilingMicros

string (int64 format)

僅供輸出。自動出價系統允許指定的最高單次點擊出價。這是廣告客戶輸入的必填欄位，可以設定上限值 (以當地微秒為單位)。

TargetRoas

這是一種自動出價策略，可協助您提高收益，同時平均分配特定的目標廣告投資報酬率。

JSON 表示法 
{
  "targetRoas": number
}
欄位
targetRoas

number

僅供輸出。每單位支出的所選收益 (根據轉換資料)。

TargetSpend

「自動出價策略」會自動設定出價，在預算範圍內盡量爭取點擊。

JSON 表示法 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
欄位
targetSpendMicros
(deprecated)

string (int64 format)

僅供輸出。盡量爭取點擊的支出目標。目標支出出價工具會嘗試支出這個值中較小的值或自然調節支出金額。如果未指定，則會使用預算做為支出目標。這個欄位已淘汰，不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
cpcBidCeilingMicros

string (int64 format)

僅供輸出。出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。

CustomerClient

指定客戶與客戶客戶之間的連結。只有管理員客戶能找到 CustomerClient。包含所有直接和間接客戶，以及管理員本身。

JSON 表示法 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
欄位
resourceName

string

僅供輸出。客戶用戶端的資源名稱。CustomerClient 資源名稱的格式如下：customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

僅供輸出。提出要求的客戶所擁有的標籤資源名稱，該標籤將套用至客戶客戶。標籤資源名稱的格式如下：

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

僅供輸出。客戶客戶的狀態。唯讀。
clientCustomer

string

僅供輸出。與客戶連結的客戶資源名稱。唯讀。
hidden

boolean

僅供輸出。指出這是隱藏的帳戶。唯讀。
level

string (int64 format)

僅供輸出。指定客戶和客戶之間的距離。如為自我連結，層級值會是 0。唯讀。
timeZone

string

僅供輸出。用戶端時區的常見語言代碼資料存放區 (CLDR) 字串，例如 America/Los_Angeles。唯讀。
testAccount

boolean

僅供輸出。識別客戶是否為測試帳戶。唯讀。
manager

boolean

僅供輸出。指出客戶是否為管理員。唯讀。
descriptiveName

string

僅供輸出。客戶的描述性名稱。唯讀。
currencyCode

string

僅供輸出。客戶的幣別代碼，例如「USD」、「EUR」。唯讀。
id

string (int64 format)

僅供輸出。客戶的 ID。唯讀。

CustomerSearchTermInsight

客戶搜尋字詞檢視。歷來資料從 2023 年 3 月起開始提供。

JSON 表示法 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
欄位
resourceName

string

僅供輸出。客戶層級搜尋字詞洞察的資源名稱。客戶層級搜尋字詞洞察資源名稱的格式如下：

customers/{customerId}/customerSearchTermInsights/{categoryId}
categoryLabel

string

僅供輸出。搜尋類別的標籤。如果搜尋字詞不符合其他類別，就會表示屬於「全部接收」類別。
id

string (int64 format)

僅供輸出。深入分析的 ID。

DetailPlacementView

包含依廣告群組和網址或 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

僅供輸出。詳細資料層級的自動刊登位置字串，例如網站網址、行動應用程式 ID 或 YouTube 影片 ID。
displayName

string

僅供輸出。顯示名稱為網站的網址、YouTube 影片名稱，以及行動應用程式的翻譯行動應用程式名稱。
groupPlacementTargetUrl

string

僅供輸出。群組刊登位置的網址 (例如網域、應用程式商店中的行動應用程式連結) 或 YouTube 頻道網址。
targetUrl

string

僅供輸出。刊登位置的網址 (例如網站)、應用程式商店中的行動應用程式連結，或 YouTube 影片網址。

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 (只會設定 adChannelType 類型，此類別可供其底下的所有子類型使用) 或 CHANNEL_TYPE_AND_SUBTYPES (全部設定 adsChannelType、advertisingChannelSubType 和 includeDefaultChannelSubType)。
advertisingChannelType

enum (AdvertisingChannelType)

類別適用的頻道類型。
advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

該類別適用的頻道類型下的頻道子類型。
includeDefaultChannelSubType

boolean

是否包含預設管道子類型。舉例來說，如果 advertisingChannelType 為「DISPLAY」，且 includeDefaultChannelSubType 為「false」，代表有未設定管道子類型的預設多媒體廣告活動，就不會納入這項供應情形設定中。

CriterionCategoryChannelAvailabilityMode

列舉包含可能的 CriterionCategoryChannelAvailabilityMode。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ALL_CHANNELS 類別適用於所有管道類型和子類型的廣告活動。
CHANNEL_TYPE_AND_ALL_SUBTYPES 類別適用於特定管道類型的廣告活動，包括該類別之下的所有子類型。
CHANNEL_TYPE_AND_SUBSET_SUBTYPES 類別適用於特定管道類型和子類型的廣告活動。

CriterionCategoryLocaleAvailability

特定類別適用的地區資訊。

JSON 表示法 
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
欄位
availabilityMode

enum (CriterionCategoryLocaleAvailabilityMode)

地區供應情形的格式。可以是 LAUNCHED_TO_ALL (國家/地區和語言皆為空白)、COUNTRY (僅設定國家/地區)、LANGUAGE (僅設定語言)、COUNTRY_AND_LANGUAGE (設定國家/地區和語言)。
countryCode

string

與類別相關聯的 ISO-3166-1 alpha-2 國家/地區代碼。
languageCode

string

類別相關語言的 ISO 639-1 代碼。

CriterionCategoryLocaleAvailabilityMode

列舉包含可能的 CriterionCategoryLocaleAvailabilityMode 的列舉。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ALL_LOCALES 該類別適用於所有語言代碼的廣告活動。
COUNTRY_AND_ALL_LANGUAGES 類別適用於要列於國家/地區清單中的廣告活動，不論語言為何。
LANGUAGE_AND_ALL_COUNTRIES 類別適用於採用語言清單內的廣告活動，不考慮國家/地區。
COUNTRY_AND_LANGUAGE 類別適用於位於國家/地區與語言組合清單中的廣告活動。

DisplayKeywordView

多媒體廣告關鍵字檢視畫面。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。多媒體廣告關鍵字檢視畫面的資源名稱。多媒體廣告關鍵字檢視資源名稱的格式如下：

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

DistanceView

距離檢視畫面，根據使用者與廣告客戶地點額外資訊之間的距離，顯示匯總相關指標。每個 DistanceBucket 會納入所有落在距離內，且每次曝光一次曝光，都會計入包含使用者距離的所有 DistanceBucket 指標中。

JSON 表示法 
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
欄位
resourceName

string

僅供輸出。距離檢視畫面的資源名稱。距離檢視資源名稱的格式如下：

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

enum (DistanceBucket)

僅供輸出。使用者與地點額外資訊之間的距離分組。
metricSystem

boolean

僅供輸出。如果 DistanceBucket 使用的是公制系統，則為 True，否則為 false。

DistanceBucket

使用者與廣告客戶地點額外資訊之間的距離區間。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
WITHIN_700M 使用者位於該地區 700 公尺以內。
WITHIN_1KM 使用者位於該地點 1 公里內。
WITHIN_5KM 使用者位於該地點 5 公里內。
WITHIN_10KM 使用者位於該地點 10 公里內。
WITHIN_15KM 使用者位於該地點 1.5 公里內。
WITHIN_20KM 使用者位於該地點 20 公里內。
WITHIN_25KM 使用者位於該地點 2.5 公里內。
WITHIN_30KM 使用者位於該地點 30,000 以內。
WITHIN_35KM 使用者位於該地點 3.5 公里內。
WITHIN_40KM 使用者位於該地點 40 公里內。
WITHIN_45KM 使用者位於該地點 45 公里內。
WITHIN_50KM 使用者位於該地點 50 公里內。
WITHIN_55KM 使用者位於該地點 5.5 公里內。
WITHIN_60KM 使用者位於該地點 60 公里內。
WITHIN_65KM 使用者位於該地點 65 公里內。
BEYOND_65KM 使用者超過了地點的 6.5 公里。
WITHIN_0_7MILES 使用者位於該地點 0.7 英里內。
WITHIN_1MILE 使用者位於該地點 1 英里內。
WITHIN_5MILES 使用者距離該地點 5 英里內。
WITHIN_10MILES 使用者位於該地點 10 英里內。
WITHIN_15MILES 使用者距離該地點 15 英里內。
WITHIN_20MILES 距離該地 20 英里內的使用者。
WITHIN_25MILES 使用者距離該地點 25 英里內。
WITHIN_30MILES 距離該地 30 英里內的使用者。
WITHIN_35MILES 使用者距離該地點 35 英里內。
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

僅供輸出。曝光時動態選取的到達網頁網址。

這是唯讀欄位。
pageUrl

string

僅供輸出。針對曝光放送的網頁動態饋給項目網址。

這是唯讀欄位。
hasNegativeKeyword

boolean

僅供輸出。如果查詢與排除關鍵字相符，則為 True。

這是唯讀欄位。
hasMatchingKeyword

boolean

僅供輸出。如果將查詢新增至目標關鍵字，則為 True。

這是唯讀欄位。
hasNegativeUrl

boolean

僅供輸出。如果查詢與排除網址相符，則為 True。

這是唯讀欄位。

ExpandedLandingPageView

到達網頁檢視畫面，內含在延展型最終到達網址層級匯總的指標。

JSON 表示法 
{
  "resourceName": string,
  "expandedFinalUrl": string
}
欄位
resourceName

string

僅供輸出。展開到達網頁檢視畫面的資源名稱。延展型到達網頁檢視資源名稱的格式如下：

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}
expandedFinalUrl

string

僅供輸出。點擊後會導向的最終到達網址。

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

地理區域檢視。

「地理區域檢視」會列出國家/地區層級匯總的所有指標，每個國家/地區一列。記錄使用者的實際位置或感興趣的區域的指標。如果使用了其他區隔欄位，每個國家/地區的資料可能不只一列。

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

僅供輸出。群組刊登位置的網址 (例如網域、應用程式商店中的行動應用程式連結) 或 YouTube 頻道網址。

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 是這筆預訂的 ID，如同轉換追蹤代碼的「transaction_id」參數所提供的一樣。
campaign

string

僅供輸出。與轉換相關聯的廣告活動資源名稱。
hotelCenterId

string (int64 format)

僅供輸出。提供飯店廣告活動房價的 Hotel Center 帳戶 ID。
hotelId

string

僅供輸出。預訂房源的專屬 ID，與 Hotel Center 動態饋給提供的 ID 相同。飯店 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 這項預訂已標記為取消。若取消入住的值大於零 (因設有最低住宿日數規定或取消費用)，會在退房日期算起 45 天後收費。

IncomeRangeView

收入範圍檢視。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。收入範圍檢視畫面的資源名稱。收入範圍檢視資源名稱的格式如下：

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

KeywordView

關鍵字檢視。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。關鍵字檢視畫面的資源名稱。關鍵字檢視資源名稱的格式如下：

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

LandingPageView

到達網頁檢視畫面，含有未展開最終到達網址層級匯總的指標。

JSON 表示法 
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
欄位
resourceName

string

僅供輸出。到達網頁檢視的資源名稱。到達網頁檢視資源名稱的格式如下：

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}
unexpandedFinalUrl

string

僅供輸出。廣告客戶指定的最終到達網址。

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

僅供輸出。英文的完整語言名稱，例如「英文 (US)、西班牙文」等。
targetable

boolean

僅供輸出。是否可指定該語言。

LocationView

地區檢視會按地區條件顯示廣告活動的成效摘要。如未設定 Location 條件，則不會傳回任何結果；請改用 GeoView 或 userLocationView 取得訪客位置資料。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。位置檢視的資源名稱。位置檢視畫面資源名稱的格式如下：

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

ManagedPlacementView

自選刊登位置檢視畫面。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。自選刊登位置檢視畫面的資源名稱。自選刊登位置檢視畫面資源名稱的格式如下：

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

MobileAppCategoryConstant

行動應用程式類別常數。

JSON 表示法 
{
  "resourceName": string,
  "id": integer,
  "name": string
}
欄位
resourceName

string

僅供輸出。行動應用程式類別常數的資源名稱。行動應用程式類別常數資源名稱的格式如下：

mobileAppCategoryConstants/{mobile_app_category_id}
id

integer

僅供輸出。行動應用程式類別常數的 ID。
name

string

僅供輸出。行動應用程式類別名稱。

MobileDeviceConstant

行動裝置常數。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
欄位
resourceName

string

僅供輸出。行動裝置常數的資源名稱。行動裝置常數資源名稱的格式如下：

mobileDeviceConstants/{criterionId}
type

enum (MobileDeviceType)

僅供輸出。行動裝置的類型。
id

string (int64 format)

僅供輸出。行動裝置常數的 ID。
name

string

僅供輸出。行動裝置的名稱。
manufacturerName

string

僅供輸出。行動裝置的製造商。
operatingSystemName

string

僅供輸出。行動裝置的作業系統。

MobileDeviceType

行動裝置的類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
MOBILE 手機。
TABLET 平板電腦。

OperatingSystemVersionConstant

行動作業系統版本或版本範圍 (視 operatorType 而定)。如要查看可用的行動平台清單，請前往 https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

JSON 表示法 
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
欄位
resourceName

string

僅供輸出。作業系統版本常數的資源名稱。作業系統版本常數資源名稱的格式如下：

operatingSystemVersionConstants/{criterionId}
operatorType

enum (OperatingSystemVersionOperatorType)

僅供輸出。決定此常數要代表單一版本或版本範圍。
id

string (int64 format)

僅供輸出。作業系統版本的 ID。
name

string

僅供輸出。作業系統的名稱。
osMajorVersion

integer

僅供輸出。OS 主要版本號碼。
osMinorVersion

integer

僅供輸出。OS 子版本號碼。

OperatingSystemVersionOperatorType

作業系統版本類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
EQUALS_TO 等於指定版本。
GREATER_THAN_EQUALS_TO 大於或等於指定的版本。

PaidOrganicSearchTermView

付費隨機搜尋字詞檢視畫面可在廣告群組層級顯示按搜尋字詞匯總的廣告和自然搜尋結果搜尋統計資料。

JSON 表示法 
{
  "resourceName": string,
  "searchTerm": string
}
欄位
resourceName

string

僅供輸出。搜尋字詞檢視畫面的資源名稱。搜尋字詞檢視表資源名稱的格式如下：

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

string

僅供輸出。搜尋字詞。

QualifyingQuestion

待開發客戶表單的篩選問題。

JSON 表示法 
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
欄位
resourceName

string

僅供輸出。資格問題的資源名稱。

「qualifiedQuestions/{qualeligibilityQuestionId}」
qualifyingQuestionId

string (int64 format)

僅供輸出。資格問題的 ID。
locale

string

僅供輸出。資格問題的語言代碼。
text

string

僅供輸出。資格問題。

ParentalStatusView

家長狀態檢視模式。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。家長狀態檢視畫面的資源名稱。家長狀態檢視資源名稱的格式如下：

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

PerStoreView

每筆商店檢視畫面。這項檢視畫面會提供廣告客戶個別商店曝光觸及率和本地動作轉換統計資料。

JSON 表示法 
{
  "resourceName": string,
  "placeId": string
}
欄位
resourceName

string

僅供輸出。每個商店檢視畫面的資源名稱。個別商店檢視表資源名稱的格式如下：

customers/{customerId}/perStoreViews/{placeId}
placeId

string

僅供輸出。每個商店檢視畫面的地點 ID。

ProductBiddingCategoryConstant

產品類別。

JSON 表示法 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
欄位
resourceName

string

僅供輸出。產品出價類別的資源名稱。產品類別資源名稱的格式如下：

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

enum (ProductBiddingCategoryLevel)

僅供輸出。產品類別層級。
status

enum (ProductBiddingCategoryStatus)

僅供輸出。產品出價類別的狀態。
id

string (int64 format)

僅供輸出。產品類別的 ID。

這個 ID 等同於 google_product_category [Google 產品類別] ID，詳情請參閱 https://support.google.com/merchants/answer/6324436。
countryCode

string

僅供輸出。產品出價類別的雙字母國家/地區代碼。
productBiddingCategoryConstantParent

string

僅供輸出。父項產品出價類別的資源名稱。
languageCode

string

僅供輸出。產品出價類別的語言代碼。
localizedName

string

僅供輸出。根據 languageCode 本地化的產品類別顯示值。

ProductBiddingCategoryStatus

以列舉方式說明產品類別的狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ACTIVE 類別有效，可用於出價。
OBSOLETE 類別已過時，只會用於製作報表。

ProductGroupView

產品群組檢視。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。產品群組檢視畫面的資源名稱。產品群組檢視資源名稱的格式如下：

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

建議

建議。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
欄位
resourceName

string

不可變動。建議的資源名稱。

customers/{customerId}/recommendations/{recommendation_id}
type

enum (RecommendationType)

僅供輸出。最佳化建議的類型。
impact

object (RecommendationImpact)

僅供輸出。套用建議對帳戶成效的影響。
campaigns[]

string

僅供輸出。這項建議指定的廣告活動。

系統將針對下列最佳化建議類型設定這個欄位：CAMPAIGN_BUDGET、FORECASTING_CAMPAIGN_BUDGET、MARGINAL_ROI_CAMPAIGN_BUDGET 和 MOVE_UNUSED_BUDGET
campaignBudget

string

僅供輸出。這項建議指定的預算。只有在最佳化建議會影響單一廣告活動預算時，才需要設定。

系統將針對下列最佳化建議類型設定這個欄位：CAMPAIGN_BUDGET、FORECASTING_CAMPAIGN_BUDGET、MARGINAL_ROI_CAMPAIGN_BUDGET、MOVE_UNUSED_BUDGET
campaign

string

僅供輸出。這項建議指定的廣告活動。

這個欄位將針對以下類型設定：CALL_CALL_EXTENSION_TARGET_EXTENSION_TARGET_TARGET_TARGET_TARGET_TARGET_TARGET_TARGET_TARGET_CPC_TARGET_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX、UPGRADE_LOCAL_CAMPAIGN_OPT_IN；
adGroup

string

僅供輸出。這項建議指定的廣告群組。只有在最佳化建議影響單一廣告群組時，系統才會設定這項設定。

系統將針對下列最佳化建議類型設定這個欄位：KEYWORD、OPTIMIZE_AD_ROTATION、RESPONSIVE_SEARCH_AD、RESPONSIVE_SEARCH_AD_ASSET、TEXT_AD
dismissed

boolean

僅供輸出。是否關閉建議。
聯集欄位 recommendation。最佳化建議的詳細資料。recommendation 只能是下列其中一項：
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

僅供輸出。廣告活動預算建議。
forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

僅供輸出。預測廣告活動預算建議。
keywordRecommendation

object (KeywordRecommendation)

僅供輸出。關鍵字建議。
textAdRecommendation

object (TextAdRecommendation)

僅供輸出。新增延展型文字廣告最佳化建議。
targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

僅供輸出。「採用目標單次轉換出價」最佳化建議。
maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

僅供輸出。「選擇採用盡量爭取轉換」最佳化建議。
enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

僅供輸出。「成本效益管理系統」最佳化建議。
searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

僅供輸出。「選擇採用搜尋夥伴」最佳化建議。
maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

僅供輸出。採用「盡量爭取點擊」最佳化建議。
optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

僅供輸出。「最佳化廣告輪播」最佳化建議。
keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

僅供輸出。「關鍵字比對類型」建議。
moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

僅供輸出。移動未用到的預算建議。
targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

僅供輸出。「採用目標廣告投資報酬率」最佳化建議。
responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

僅供輸出。新增回應式搜尋廣告最佳化建議。
marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

僅供輸出。邊際投資報酬率廣告活動預算建議。
useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

僅供輸出。使用廣泛比對關鍵字最佳化建議。
responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

僅供輸出。回應式搜尋廣告素材資源最佳化建議。
upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

僅供輸出。將智慧購物廣告活動升級為最高成效廣告活動最佳化建議。
responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

僅供輸出。回應式搜尋廣告可提高廣告優異度建議。
displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

僅供輸出。「採用多媒體廣告聯播網」最佳化建議。
upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

僅供輸出。將地區廣告活動升級為最高成效廣告活動最佳化建議。
raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

僅供輸出。提高的目標單次轉換出價建議太低。
forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

僅供輸出。預測設定目標廣告投資報酬率的建議。
calloutAssetRecommendation

object (CalloutAssetRecommendation)

僅供輸出。摘要素材資源最佳化建議。
callAssetRecommendation

object (CallAssetRecommendation)

僅供輸出。電話素材資源最佳化建議。
shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

僅供輸出。購物新增年齡層建議。
shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

僅供輸出。購物新增顏色建議。
shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

僅供輸出。購物新增性別建議。
shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

僅供輸出。購物新增全球交易品項識別碼建議。
shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

僅供輸出。購物廣告新增更多 ID 最佳化建議。
shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

僅供輸出。購物新增商品尺寸建議。
shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

僅供輸出。購物將產品加進廣告活動最佳化建議。
shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

僅供輸出。購物修正遭拒登的產品最佳化建議。
shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

僅供輸出。購物目標所有建議項目。
shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

僅供輸出。修正購物問題已導致 Merchant Center 帳戶遭到停權的建議。
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

僅供輸出。「購物修正了 Merchant Center 帳戶停權」警示建議。
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

僅供輸出。購物廣告將一般購物廣告活動的商品遷移至最高成效廣告活動最佳化建議。
dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

僅供輸出。建議您在帳戶中啟用動態圖片額外資訊，方便 Google 從廣告到達網頁找出成效最佳的圖片，並搭配文字廣告。
raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

僅供輸出。提高目標單次轉換出價的建議。
lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

僅供輸出。建議降低目標廣告投資報酬率。
performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

僅供輸出。「採用最高成效廣告活動」最佳化建議。
improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

僅供輸出。最高成效廣告活動廣告優異度最佳化建議。
migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

僅供輸出。「將動態搜尋廣告活動遷移至最高成效廣告活動」最佳化建議。

RecommendationType

最佳化建議類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
CAMPAIGN_BUDGET 為目前預算不足的廣告活動提供預算建議 (不適用於 FORECASTING_CAMPAIGN_BUDGET 建議，這項建議不適用於未來預期將預算不足的廣告活動)。
KEYWORD 關鍵字建議。
TEXT_AD 建議新增文字廣告。
TARGET_CPA_OPT_IN 建議將廣告活動更新為使用「目標單次轉換出價」策略。
MAXIMIZE_CONVERSIONS_OPT_IN 建議更新廣告活動，以便使用「盡量爭取轉換」出價策略。
ENHANCED_CPC_OPT_IN 建議為廣告活動啟用「成本效益管理系統」。
SEARCH_PARTNERS_OPT_IN 建議開始在 Google 搜尋夥伴網站上放送廣告活動的廣告。
MAXIMIZE_CLICKS_OPT_IN 建議更新廣告活動，以便使用「盡量爭取點擊」出價策略。
OPTIMIZE_AD_ROTATION 建議先為指定廣告群組採用「最佳化」廣告輪播設定。
KEYWORD_MATCH_TYPE 將現有關鍵字從一個比對類型變更為更廣泛的比對類型。
MOVE_UNUSED_BUDGET 建議將未用到的預算挪給預算有限的預算。
FORECASTING_CAMPAIGN_BUDGET 針對預計未來將預算不足的廣告活動提供預算建議 (不適用於目前預算不足廣告活動的 CAMPAIGN_BUDGET 建議)。
TARGET_ROAS_OPT_IN 建議將廣告活動改為使用「目標廣告投資報酬率」出價策略。
RESPONSIVE_SEARCH_AD 新增回應式搜尋廣告的建議。
MARGINAL_ROI_CAMPAIGN_BUDGET 針對預期投資報酬率會增加的廣告活動，提供預算建議。
USE_BROAD_MATCH_KEYWORD 對於以轉換為準出價廣告活動，建議新增關鍵字的廣泛比對版本。
RESPONSIVE_SEARCH_AD_ASSET 建議新增回應式搜尋廣告素材資源。
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX 最佳化建議：將智慧購物廣告活動升級為最高成效廣告活動。
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH 改善回應式搜尋廣告強度的建議。
DISPLAY_EXPANSION_OPT_IN 建議將廣告活動更新為採用多媒體廣告聯播網。
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX 最佳化建議：將地區廣告活動升級為最高成效廣告活動。
RAISE_TARGET_CPA_BID_TOO_LOW 建議將目標單次轉換出價設得太低，且轉換次數太少，或完全沒有轉換。這項作業會以非同步方式套用，而且可能需要幾分鐘的時間，視相關廣告活動中的廣告群組數量而定。
FORECASTING_SET_TARGET_ROAS 建議在季節性事件預計會提高流量前，先提高預算，並將出價策略從「盡量提高轉換價值」改為「目標廣告投資報酬率」。
CALLOUT_ASSET 建議在廣告活動或客戶層級加入摘要素材資源。
CALL_ASSET 建議在廣告活動或客戶層級加入電話素材資源。
SHOPPING_ADD_AGE_GROUP 建議為因缺少年齡層而降低排名的商品，新增年齡層屬性。
SHOPPING_ADD_COLOR 建議為因缺少顏色而降低排名的商品，新增顏色。
SHOPPING_ADD_GENDER 建議為因為缺少性別資訊而降低排名的優惠項目，新增性別屬性。
SHOPPING_ADD_GTIN 建議為因缺少全球交易品項識別碼而降低排名的商品，新增全球交易品項識別碼 (GTIN)。
SHOPPING_ADD_MORE_IDENTIFIERS 建議新增更多 ID，以便用於因缺少 ID 而遭排名降低的商品。
SHOPPING_ADD_SIZE 建議為因缺少尺寸而導致排名降低的優惠新增尺寸。
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN 最佳化建議會通知客戶廣告活動，因為未指定任何產品而無法放送。
SHOPPING_FIX_DISAPPROVED_PRODUCTS 購物建議會告知客戶有關廣告活動有大量遭拒登產品的情況。
SHOPPING_TARGET_ALL_OFFERS 建議建立通用產品廣告活動，指定所有優惠。
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT 修正 Merchant Center 帳戶停權問題的建議。
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING 修正 Merchant Center 帳戶停權警告問題的建議。
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX 建議將一般購物廣告活動指定的優惠遷移至現有的最高成效廣告活動。
DYNAMIC_IMAGE_EXTENSION_OPT_IN 建議您在帳戶中啟用動態圖片額外資訊，方便 Google 從廣告到達網頁找出成效最佳的圖片，並搭配文字廣告。
RAISE_TARGET_CPA 根據 Google 根據過往轉換的預測資料，提出提高目標單次轉換出價的建議。這項作業會以非同步方式套用，而且可能需要幾分鐘的時間，視相關廣告活動中的廣告群組數量而定。
LOWER_TARGET_ROAS 建議降低目標廣告投資報酬率。
PERFORMANCE_MAX_OPT_IN 最佳化建議：啟用最高成效廣告活動。
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH 最佳化建議，將最高成效廣告活動素材資源群組的優異度提升至「極佳」。
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX 將動態搜尋廣告遷移至最高成效廣告活動的建議。

RecommendationImpact

按照建議內容進行變更後的影響。某些類型的最佳化建議可能不會影響資訊。

JSON 表示法 
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
欄位
baseMetrics

object (RecommendationMetrics)

僅供輸出。產生建議時的基本指標。
potentialMetrics

object (RecommendationMetrics)

僅供輸出。套用建議後的預估指標。

RecommendationMetrics

每週帳戶成效指標。部分最佳化建議類型在過去 90 天內的平均值，因此可能會有分數。

JSON 表示法 
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "videoViews": number
}
欄位
impressions

number

僅供輸出。廣告曝光次數。
clicks

number

僅供輸出。廣告點擊次數。
costMicros

string (int64 format)

僅供輸出。廣告費用 (以微量為單位)，以帳戶當地幣別顯示。
conversions

number

僅供輸出。轉換次數。
videoViews

number

僅供輸出。影片廣告活動的影片觀看次數。

CampaignBudgetRecommendation

預算不足廣告活動的預算建議。

JSON 表示法 
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
欄位
budgetOptions[]

object (CampaignBudgetRecommendationOption)

僅供輸出。預算金額和相關影響估算值，可指出部分可能預算金額。
currentBudgetAmountMicros

string (int64 format)

僅供輸出。目前預算金額 (以百萬分之一為單位)。
recommendedBudgetAmountMicros

string (int64 format)

僅供輸出。建議的預算金額 (以百萬分之一為單位)。

CampaignBudgetRecommendationOption

特定預算金額的預估影響。

JSON 表示法 
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
欄位
impact

object (RecommendationImpact)

僅供輸出。將預算變更為這個選項中指定的金額後，這項預估結果會受到影響。
budgetAmountMicros

string (int64 format)

僅供輸出。這個選項的預算金額。

KeywordRecommendation

關鍵字建議。

JSON 表示法 
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
欄位
keyword

object (KeywordInfo)

僅供輸出。建議的關鍵字。
searchTerms[]

object (SearchTerm)

僅供輸出。與這個關鍵字相符的搜尋字詞清單。多個關鍵字可以重複相同的搜尋字詞。
recommendedCpcBidMicros

string (int64 format)

僅供輸出。建議單次點擊出價。

SearchTerm

與關鍵字建議相關的搜尋字詞資訊。

JSON 表示法 
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
欄位
text

string

僅供輸出。搜尋字詞的文字。
estimatedWeeklySearchCount

string (int64 format)

僅供輸出。這個搜尋字詞的每週預估搜尋量。

TextAdRecommendation

文字廣告建議。

JSON 表示法 
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
欄位
ad

object (Ad)

僅供輸出。建議廣告。
creationDate

string

僅供輸出。建議廣告的建立日期。YYYY-MM-DD 格式，例如 2018-04-17。
autoApplyDate

string

僅供輸出。日期 (如有) 是自動套用最佳化建議的最早日期。YYYY-MM-DD 格式，例如 2018-04-17。

TargetCpaOptInRecommendation

「採用目標單次轉換出價」最佳化建議。

JSON 表示法 
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
欄位
options[]

object (TargetCpaOptInRecommendationOption)

僅供輸出。目標單次轉換出價策略的可用目標和相應選項。
recommendedTargetCpaMicros

string (int64 format)

僅供輸出。建議的平均單次轉換出價目標。您可在選項清單中查看必要的預算金額，以及採用這項建議的影響。

TargetCpaOptInRecommendationOption

「採用目標單次轉換出價」選項，以及影響估算值。

JSON 表示法 
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
欄位
goal

enum (TargetCpaOptInRecommendationGoal)

僅供輸出。這個選項所達成的目標。
impact

object (RecommendationImpact)

僅供輸出。如果選取這個選項，影響估算值。
targetCpaMicros

string (int64 format)

僅供輸出。平均單次轉換出價目標。
requiredCampaignBudgetAmountMicros

string (int64 format)

僅供輸出。帳戶要達到目標單次轉換出價所需的最低廣告活動預算 (以當地幣別表示)。金額是以微量指定，100 萬相當於一個貨幣單位。

TargetCpaOptInRecommendationGoal

TargetCpaOptIn 建議的目標。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
SAME_COST 建議設定目標單次轉換出價，以維持相同費用。
SAME_CONVERSIONS 建議設定目標單次轉換出價，以維持相同的轉換。
SAME_CPA 建議設定目標單次轉換出價，以維持相同的單次轉換出價。
CLOSEST_CPA 建議將目標單次轉換出價設為盡可能接近，但低於實際單次轉換出價 (針對過去 28 天計算得出的值)。

MaximizeConversionsOptInRecommendation

「採用『盡量爭取轉換』最佳化建議」。

JSON 表示法 
{
  "recommendedBudgetAmountMicros": string
}
欄位
recommendedBudgetAmountMicros

string (int64 format)

僅供輸出。建議的新預算金額。

EnhancedCpcOptInRecommendation

這個類型沒有任何欄位。

「成本效益管理系統」最佳化建議。

SearchPartnersOptInRecommendation

這個類型沒有任何欄位。

「選擇採用搜尋夥伴」最佳化建議。

MaximizeClicksOptInRecommendation

採用「盡量爭取點擊」最佳化建議。

JSON 表示法 
{
  "recommendedBudgetAmountMicros": string
}
欄位
recommendedBudgetAmountMicros

string (int64 format)

僅供輸出。建議的新預算金額。只有在目前預算過高時才需要設定。

OptimizeAdRotationRecommendation

這個類型沒有任何欄位。

「最佳化廣告輪播」最佳化建議。

KeywordMatchTypeRecommendation

「關鍵字比對類型」建議。

JSON 表示法 
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
欄位
keyword

object (KeywordInfo)

僅供輸出。現有關鍵字的比對類型應該會更廣泛的現有關鍵字。
recommendedMatchType

enum (KeywordMatchType)

僅供輸出。建議採用的新比對類型。

MoveUnusedBudgetRecommendation

移動未用到的預算建議。

JSON 表示法 
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
欄位
budgetRecommendation

object (CampaignBudgetRecommendation)

僅供輸出。預算不足的建議提高。
excessCampaignBudget

string

僅供輸出。超出預算的 resourceName。

TargetRoasOptInRecommendation

「採用目標廣告投資報酬率」最佳化建議。

JSON 表示法 
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
欄位
recommendedTargetRoas

number

僅供輸出。建議目標廣告投資報酬率 (每單位支出的收益)。這個值必須介於 0.01 到 1000.0 (含) 之間。
requiredCampaignBudgetAmountMicros

string (int64 format)

僅供輸出。要達到目標廣告投資報酬率所需的最低廣告活動預算 (以當地幣別表示)，金額是以微量指定，100 萬相當於一個貨幣單位。

ResponsiveSearchAdRecommendation

新增回應式搜尋廣告最佳化建議。

JSON 表示法 
{
  "ad": {
    object (Ad)
  }
}
欄位
ad

object (Ad)

僅供輸出。建議廣告。

UseBroadMatchKeywordRecommendation

使用廣泛比對關鍵字最佳化建議。

JSON 表示法 
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
欄位
keyword[]

object (KeywordInfo)

僅供輸出。要擴充至廣泛比對的關鍵字範例。
suggestedKeywordsCount

string (int64 format)

僅供輸出。廣告活動中要擴充為廣泛比對的關鍵字總數。
campaignKeywordsCount

string (int64 format)

僅供輸出。廣告活動的關鍵字總數。
campaignUsesSharedBudget

boolean

僅供輸出。相關廣告活動是否使用共用預算。
requiredCampaignBudgetAmountMicros

string (int64 format)

僅供輸出。建議預算，以免在套用建議後受到預算限制。

ResponsiveSearchAdAssetRecommendation

新增回應式搜尋廣告素材資源最佳化建議。

JSON 表示法 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
欄位
currentAd

object (Ad)

僅供輸出。目前要更新的廣告。
recommendedAssets

object (Ad)

僅供輸出。建議的素材資源。這個欄位只會填入新的廣告標題和/或說明，否則會空白。

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

將智慧購物廣告活動升級為最高成效廣告活動最佳化建議。

JSON 表示法 
{
  "merchantId": string,
  "salesCountryCode": string
}
欄位
merchantId

string (int64 format)

僅供輸出。Merchant Center 帳戶的 ID。
salesCountryCode

string

僅供輸出。應包含商家商品目錄資料的國家/地區。

ResponsiveSearchAdImproveAdStrengthRecommendation

回應式搜尋廣告可提高廣告優異度建議。

JSON 表示法 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
欄位
currentAd

object (Ad)

僅供輸出。目前要更新的廣告。
recommendedAd

object (Ad)

僅供輸出。更新後的廣告。

DisplayExpansionOptInRecommendation

這個類型沒有任何欄位。

「採用多媒體廣告聯播網」最佳化建議。

UpgradeLocalCampaignToPerformanceMaxRecommendation

這個類型沒有任何欄位。

「將地區廣告活動升級為最高成效廣告活動」最佳化建議。

RaiseTargetCpaBidTooLowRecommendation

提高的目標單次轉換出價建議太低。

JSON 表示法 
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
欄位
recommendedTargetMultiplier

number

僅供輸出。大於 1.0 的數字，表示我們建議您提高目標單次轉換出價的因素。
averageTargetCpaMicros

string (int64 format)

僅供輸出。廣告活動目前的平均目標單次轉換出價，以客戶當地幣別百萬為單位。

ForecastingSetTargetRoasRecommendation

預測設定目標廣告投資報酬率的建議。

JSON 表示法 
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
欄位
recommendedTargetRoas

number

僅供輸出。建議目標廣告投資報酬率 (每單位支出的收益)。這個值必須介於 0.01 到 1000.0 (含) 之間。
campaignBudget

object (CampaignBudget)

僅供輸出。廣告活動預算。

CampaignBudget

由各種預算最佳化建議類型共用的廣告活動預算。

JSON 表示法 
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
欄位
currentAmountMicros

string (int64 format)

僅供輸出。目前預算金額。
recommendedNewAmountMicros

string (int64 format)

僅供輸出。建議的預算金額。
newStartDate

string

僅供輸出。新預算開始放送的日期。這個欄位將針對下列最佳化建議類型設定：FORECASTING_SET_TARGET_ROAS YYYY-MM-DD，例如 2018-04-17。

CalloutAssetRecommendation

摘要素材資源最佳化建議。

JSON 表示法 
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
欄位
recommendedCampaignCalloutAssets[]

object (Asset)

僅供輸出。在廣告活動層級建議新增摘要額外資訊素材資源。
recommendedCustomerCalloutAssets[]

object (Asset)

僅供輸出。建議在客戶層級新增摘要額外資訊素材資源。

SitelinkAssetRecommendation

網站連結素材資源最佳化建議。

JSON 表示法 
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
欄位

CallAssetRecommendation

這個類型沒有任何欄位。

電話素材資源最佳化建議。

ShoppingOfferAttributeRecommendation

購物建議會新增因缺少屬性而降低排名的產品。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
欄位
merchant

object (MerchantInfo)

僅供輸出。Merchant Center 帳戶的詳細資料。
feedLabel

string

僅供輸出。廣告活動動態饋給標籤。
offersCount

string (int64 format)

僅供輸出。可放送的線上優惠數量。
demotedOffersCount

string (int64 format)

僅供輸出。線上可供應商品數量，因缺少屬性而遭降低的水準。請前往 Merchant Center 瞭解詳情。

MerchantInfo

Merchant Center 帳戶詳細資料。

JSON 表示法 
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
欄位
id

string (int64 format)

僅供輸出。Merchant Center 帳戶 ID。
name

string

僅供輸出。Merchant Center 帳戶名稱。
multiClient

boolean

僅供輸出。Merchant Center 帳戶是否為多重客戶帳戶 (MCA)。

ShoppingAddProductsToCampaignRecommendation

購物建議會將產品加進購物廣告活動的廣告空間。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
欄位
merchant

object (MerchantInfo)

僅供輸出。Merchant Center 帳戶的詳細資料。
feedLabel

string

僅供輸出。廣告活動的動態饋給標籤。
reason

enum (Reason)

僅供輸出。廣告活動未附加任何產品的原因。

原因

導致購物廣告活動無法指定任何產品的問題。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS Merchant Center 帳戶沒有任何已提交的產品。
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED Merchant Center 帳戶的動態饋給中沒有任何提交的產品。
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN Google Ads 帳戶含有有效的廣告活動篩選器，因此無法在廣告活動中加入優惠。
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN 廣告活動已將所有產品明確從指定目標中排除。

ShoppingFixDisapprovedProductsRecommendation

購物建議：修正購物廣告活動廣告空間中遭拒登的產品。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
欄位
merchant

object (MerchantInfo)

僅供輸出。Merchant Center 帳戶的詳細資料。
feedLabel

string

僅供輸出。廣告活動的動態饋給標籤。
productsCount

string (int64 format)

僅供輸出。廣告活動的產品數量。
disapprovedProductsCount

string (int64 format)

僅供輸出。廣告活動中遭拒登的產品數量。

ShoppingTargetAllOffersRecommendation

購物建議應建立通用產品，指定所有商品。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
欄位
merchant

object (MerchantInfo)

僅供輸出。Merchant Center 帳戶的詳細資料。
untargetedOffersCount

string (int64 format)

僅供輸出。未指定的優惠數量。
feedLabel

string

僅供輸出。優惠動態饋給標籤。

ShoppingMerchantCenterAccountSuspensionRecommendation

修正購物建議，修正 Merchant Center 帳戶停權問題。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
欄位
merchant

object (MerchantInfo)

僅供輸出。Merchant Center 帳戶的詳細資料。
feedLabel

string

僅供輸出。停權廣告活動的動態饋給標籤。

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

購物建議將一般購物廣告活動的指定優惠遷移至最高成效廣告活動。

JSON 表示法 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
欄位
merchant

object (MerchantInfo)

僅供輸出。Merchant Center 帳戶的詳細資料。
feedLabel

string

僅供輸出。廣告活動指定優惠的動態饋給標籤。

DynamicImageExtensionOptInRecommendation

這個類型沒有任何欄位。

建議您在帳戶中啟用動態圖片額外資訊，方便 Google 從廣告到達網頁找出成效最佳的圖片，並搭配文字廣告。

RaiseTargetCpaRecommendation

提高目標單次轉換出價的建議。

JSON 表示法 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
欄位
targetAdjustment

object (TargetAdjustmentInfo)

僅供輸出。說明建議目標調整的相關資訊。
appBiddingGoal

enum (AppBiddingGoal)

僅供輸出。代表出價策略應最佳化的目標。僅針對應用程式廣告活動填入資料。

TargetAdjustmentInfo

目標調整項建議的資訊。

JSON 表示法 
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
欄位
recommendedTargetMultiplier

number

僅供輸出。建議調整目標的因素。
currentAverageTargetMicros

string (int64 format)

僅供輸出。這項建議指定的廣告活動或組合目前的平均目標。
sharedSet

string

僅供輸出。已定義目標的組合出價策略的共用組合資源名稱。只有在建議為組合層級時才會填入資料。

AppBiddingGoal

代表應針對應用程式廣告活動的出價策略進行最佳化的目標。

列舉
UNSPECIFIED 未指定。
UNKNOWN 代表這個 API 版本中的未知值。
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME 應用程式廣告活動的出價策略應著重於盡量提高應用程式安裝次數。
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME 應用程式廣告活動的出價策略應盡量提升所選應用程式內轉換量。
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE 應用程式廣告活動的出價策略應著重於盡量提高所有轉換的價值，即安裝和選取的應用程式內轉換。
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION 應用程式廣告活動的出價策略應著重於盡可能增加所選應用程式內轉換量，同時達成或超過目標單次應用程式內轉換費用。
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND 應用程式廣告活動的出價策略應著重於盡量提高所有轉換的價值，即安裝並選取應用程式內轉換，同時達成或超過目標廣告投資報酬率。
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI 這個應用程式廣告活動的出價策略應設法提高應用程式的安裝量，但廣告客戶不必提供目標單次安裝出價。
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME 這個應用程式廣告活動的出價策略應著重於盡量吸引使用者預先註冊。

LowerTargetRoasRecommendation

建議降低目標廣告投資報酬率。

JSON 表示法 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
欄位
targetAdjustment

object (TargetAdjustmentInfo)

僅供輸出。說明建議目標調整的相關資訊。

PerformanceMaxOptInRecommendation

這個類型沒有任何欄位。

「採用最高成效廣告活動」最佳化建議。

ImprovePerformanceMaxAdStrengthRecommendation

最佳化建議，將最高成效廣告活動素材資源群組的優異度提升至「極佳」。

JSON 表示法 
{
  "assetGroup": string
}
欄位
assetGroup

string

僅供輸出。素材資源群組資源名稱。

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

「將動態搜尋廣告活動遷移至最高成效廣告活動」最佳化建議。

JSON 表示法 
{
  "applyLink": string
}
欄位

SearchTermView

搜尋字詞檢視畫面，內含廣告群組層級依搜尋字詞匯總的指標。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
欄位
resourceName

string

僅供輸出。搜尋字詞檢視畫面的資源名稱。搜尋字詞檢視表資源名稱的格式如下：

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}
status

enum (SearchTermTargetingStatus)

僅供輸出。表示搜尋字詞目前是您的目標或排除關鍵字。
searchTerm

string

僅供輸出。搜尋字詞。
adGroup

string

僅供輸出。放送搜尋字詞的廣告群組。

SearchTermTargetingStatus

表示搜尋字詞是其中一個指定或排除關鍵字。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ADDED 搜尋字詞已新增至目標關鍵字中。
EXCLUDED 搜尋字詞與排除關鍵字相符。
ADDED_EXCLUDED 已加入及排除搜尋字詞。
NONE 未指定或排除搜尋字詞。

ShoppingPerformanceView

Shopping 成效資料檢視。提供購物廣告活動統計資料，這些統計資料按數個產品維度層級匯總。Merchant Center 中的產品維度值 (例如品牌、類別、自訂屬性、產品狀況和產品類型)，都會反映對應事件記錄日期和時間時，各個維度的狀態。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。購物成效檢視畫面的資源名稱。購物效能檢視畫面資源名稱的格式如下：customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

智慧廣告活動搜尋字詞檢視畫面。

JSON 表示法 
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
欄位
resourceName

string

僅供輸出。智慧廣告活動搜尋字詞檢視畫面的資源名稱。智慧廣告活動搜尋字詞資料檢視資源名稱的格式如下：

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}
searchTerm

string

僅供輸出。搜尋字詞。
campaign

string

僅供輸出。放送搜尋字詞的智慧廣告活動。

TopicView

主題檢視區塊。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。主題檢視畫面的資源名稱。主題檢視表資源名稱的格式如下：

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

TravelActivityGroupView

旅遊活動群組檢視畫面。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。旅遊活動群組檢視畫面的資源名稱。旅遊活動群組檢視畫面資源名稱的格式如下：

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

TravelActivityPerformanceView

旅遊活動成效資料檢視。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。旅遊活動成效檢視畫面的資源名稱。旅遊活動效能檢視資源名稱的格式如下：

customers/{customerId}/travelActivityPerformanceView

UserInterest

使用者興趣：要指定的特定興趣產業。

JSON 表示法 
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
欄位
resourceName

string

僅供輸出。使用者興趣的資源名稱。使用者興趣資源名稱的格式如下：

customers/{customerId}/userInterests/{userInterestId}
taxonomyType

enum (UserInterestTaxonomyType)

僅供輸出。使用者興趣的分類類型，
availabilities[]

object (CriterionCategoryAvailability)

僅供輸出。使用者興趣的供應情形資訊。
userInterestId

string (int64 format)

僅供輸出。使用者興趣的 ID。
name

string

僅供輸出。使用者興趣的名稱。
userInterestParent

string

僅供輸出。使用者興趣的父項。
launchedToAll

boolean

僅供輸出。如果使用者興趣適用於所有管道和地區，則為 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"} 代表「寵物與動物/寵物/狗」類別。如要查看可用的主題類別清單，請前往 https://developers.google.com/google-ads/api/reference/data/verticals
id

string (int64 format)

僅供輸出。主題的 ID。
topicConstantParent

string

僅供輸出。主題常數父項的資源名稱。

影片

影片。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
欄位
resourceName

string

僅供輸出。影片的資源名稱。影片資源名稱的格式如下：

customers/{customerId}/videos/{videoId}
id

string

僅供輸出。影片的 ID。
channelId

string

僅供輸出。影片的擁有者頻道 ID。
durationMillis

string (int64 format)

僅供輸出。影片的時間長度 (以毫秒為單位)。
title

string

僅供輸出。影片的標題。

WebpageView

網頁瀏覽。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

僅供輸出。網頁檢視的資源名稱。網頁檢視資源名稱的格式如下：

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

LeadFormSubmissionData

來自待開發客戶表單提交的資料。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
欄位
resourceName

string

僅供輸出。待開發客戶表單提交資料的資源名稱。待開發客戶表單提交資料資源名稱的格式如下：

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}
id

string

僅供輸出。這份待開發客戶表單提交的 ID。
asset

string

僅供輸出。與提交的待開發客戶表單相關聯的素材資源。
campaign

string

僅供輸出。與提交的待開發客戶表單相關聯的廣告活動。
leadFormSubmissionFields[]

object (LeadFormSubmissionField)

僅供輸出。與待開發客戶表單相關聯的提交資料。
customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

僅供輸出。與自訂待開發客戶表單相關聯的提交資料。
adGroup

string

僅供輸出。與提交的待開發客戶表單相關聯的廣告群組。
adGroupAd

string

僅供輸出。與提交的待開發客戶表單相關聯的 廣告群組廣告。
gclid

string

僅供輸出。與已轉入待開發客戶表單相關聯的 Google 點擊 ID。
submissionDateTime

string

僅供輸出。待開發客戶表單的提交日期和時間。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」，例如「2019-01-01 12:32:45-08:00」。

LeadFormSubmissionField

所提交待開發客戶表單中的欄位。

JSON 表示法 
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
欄位
fieldType

enum (LeadFormFieldUserInputType)

僅供輸出。待開發客戶表單欄位的欄位類型。
fieldValue

string

僅供輸出。待開發客戶表單欄位的欄位值。

CustomLeadFormSubmissionField

提交的自訂問題中的欄位

JSON 表示法 
{
  "questionText": string,
  "fieldValue": string
}
欄位
questionText

string

僅供輸出。自訂問題的問題文字，長度上限為 300 個半形字元。
fieldValue

string

僅供輸出。自訂問題回覆的欄位值，最多 70 個半形字元。

指標

指標資料。

JSON 表示法 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number
}
欄位
allConversionsValueByConversionDate

number

所有轉換的價值。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/google-ads/answer/9549009。
allConversionsByConversionDate

number

轉換總次數。無論 includeInConversionsMetric 價值為何，系統都會計入所有轉換。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/google-ads/answer/9549009。
conversionsValueByConversionDate

number

轉換價值。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/google-ads/answer/9549009。
conversionsByConversionDate

number

轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/google-ads/answer/9549009。
historicalCreativeQualityScore

enum (QualityScoreBucket)

廣告素材歷來品質分數。
historicalLandingPageQualityScore

enum (QualityScoreBucket)

歷來到達網頁體驗的品質。
historicalSearchPredictedCtr

enum (QualityScoreBucket)

歷來搜尋預測點閱率 (CTR)。
interactionEventTypes[]

enum (InteractionEventType)

應付費和免費互動類型。
skAdNetworkConversions

string (int64 format)

iOS Store Kit 廣告聯播網轉換次數。
publisherPurchasedClicks

string (int64 format)

發布商透過付費方式或獎勵活動從他人的資源獲得流量後，所爭取到的點擊
publisherOrganicClicks

string (int64 format)

發布商並未透過獎勵活動付費，或是從獎勵活動中獲得的流量，所獲得的點擊次數
publisherUnknownClicks

string (int64 format)

來自非「發布商購買」或「發布商自然」流量的點擊
absoluteTopImpressionPercentage

number

「搜尋絕對頂端曝光比重」是指有多少百分比的搜尋廣告曝光位於最顯眼的搜尋廣告刊登位置。
activeViewCpm

number

平均可視曝光費用 (activeViewImpressions)。
activeViewCtr

number

Active View 可評估點擊次數除以 Active View 可視曝光次數。

這項指標只會針對多媒體廣告聯播網回報。
activeViewImpressions

string (int64 format)

用來評估廣告在多媒體廣告聯播網網站上可見的頻率。
activeViewMeasurability

number

Active View 可評估的曝光次數在已放送曝光次數中所佔的比例。
activeViewMeasurableCostMicros

string (int64 format)

您獲得的 Active View 可評估曝光費用。
activeViewMeasurableImpressions

string (int64 format)

廣告在刊登位置可見位置顯示的次數。
activeViewViewability

number

廣告出現在已啟用 Active View 的網站上 (可評估曝光) 且可見 (可視曝光) 的次數百分比。
allConversionsFromInteractionsRate

number

互動帶來的所有轉換 (意即瀏覽後轉換) 除以廣告互動次數。
allConversionsValue

number

所有轉換的價值。
allNewCustomerLifetimeValue

number

所有新顧客的生命週期轉換價值。如果在帳戶層級或廣告活動層級設定獲取新客目標，就會納入新顧客的額外轉換價值 (包括可出價和不可出價轉換)。如果廣告活動採用獲取新客目標，並選取「針對新顧客提高出價」，這些價值就會納入「allConversionsValue」中。詳情請參閱 https://support.google.com/google-ads/answer/12080169。
allConversions

number

轉換總次數。無論 includeInConversionsMetric 價值為何，系統都會計入所有轉換。
allConversionsValuePerCost

number

計算方式是將所有轉換的價值除以廣告互動費用 (例如點擊文字廣告或觀看影片廣告)。
allConversionsFromClickToCall

number

使用者按下廣告當下或之後，點擊「致電」按鈕致電商家的次數。計算這項數據時，電話接通與否或通話持續時間等因素不會被納入。

這項指標僅適用於動態饋給項目。
allConversionsFromDirections

number

使用者按下廣告後，點選「取得路線」按鈕前往商家的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromInteractionsValuePerInteraction

number

將互動帶來的所有轉換值除以互動總數。
allConversionsFromMenu

number

使用者點擊廣告後，點擊連結查看商家選單的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromOrder

number

使用者按下廣告後下單的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromOtherEngagement

number

使用者按下廣告後，發生其他轉換的次數 (例如張貼評論或儲存商家地點)。

這項指標僅適用於動態饋給項目。
allConversionsFromStoreVisit

number

使用者點擊廣告後親臨門市的預估次數。

這項指標僅適用於動態饋給項目。
allConversionsFromStoreWebsite

number

使用者點擊廣告後，前往商店網址的次數。

這項指標僅適用於動態饋給項目。
auctionInsightSearchAbsoluteTopImpressionPercentage

number

這個指標是競價分析報表的一部分，用來瞭解其他參與者的廣告在搜尋結果網頁上最顯眼位置顯示的頻率。這個百分比只會用來計算您在網頁上進行的競價。

這項指標並未公開。
auctionInsightSearchImpressionShare

number

這項指標屬於競價分析報表的一部分，可顯示其他參與者獲得的曝光次數百分比，以及廣告有資格獲得的曝光總數。系統會將低於 0.1 的值回報為 0.0999。

這項指標並未公開。
auctionInsightSearchOutrankingShare

number

這個指標是競價分析報表的一部分，用來表示相較於廣告有資格獲得的曝光總數，您的廣告排名在競價中勝過另一名參與者 (也就是顯示在上方) 的曝光次數百分比。系統會將低於 0.1 的值回報為 0.0999。

這項指標並未公開。
auctionInsightSearchOverlapRate

number

這項指標是競價分析報表的一部分，用來瞭解其他參與者的廣告和您的廣告同時獲得曝光的頻率。

這項指標並未公開。
auctionInsightSearchPositionAboveRate

number

這個指標屬於競價分析報表的一部分，會指出其他參與者的廣告和您的廣告在同一個頁面上顯示時，其排名超越您的頻率。

這項指標並未公開。
auctionInsightSearchTopImpressionPercentage

number

這項指標是競價分析報表的一部分，用來瞭解其他參與者的廣告在熱門自然搜尋結果旁顯示的頻率。這個百分比只會用來計算您在網頁上進行的競價。

這項指標並未公開。
averageCost

number

您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。
averageCpc

number

所有點擊的總費用除以獲得的點擊總數。
averageCpe

number

您為每次廣告參與支付的平均費用。計算方式是將所有廣告參與的總費用除以廣告參與總數。
averageCpm

number

平均千次曝光出價
averageCpv

number

每次有人觀看您的廣告時，您需要支付的平均費用金額。計算方式是所有廣告收視次數的總費用除以觀看次數。
averagePageViews

number

每個工作階段的平均網頁瀏覽量。
averageTimeOnSite

number

所有工作階段的總時間長度 (以秒為單位) 除以工作階段數。從 Google Analytics (分析) 匯入。
benchmarkAverageMaxCpc

number

顯示其他廣告客戶如何對類似產品出價。
biddableAppInstallConversions

number

應用程式安裝次數。
biddableAppPostInstallConversions

number

應用程式內動作次數。
benchmarkCtr

number

這項指標會根據使用者看到廣告點擊的頻率，顯示其他廣告主類似產品的購物廣告成效。
bounceRate

number

使用者只造訪您網站上單一網頁的點擊百分比。從 Google Analytics (分析) 匯入。
clicks

string (int64 format)

點擊次數。
combinedClicks

string (int64 format)

廣告在非付費搜尋結果中顯示的次數，是廣告或網站搜尋結果的點擊次數。詳情請參閱以下說明頁面：https://support.google.com/google-ads/answer/3097241。
combinedClicksPerQuery

number

廣告在非付費結果中獲得點擊的次數 (合併點擊次數) 除以合併查詢次數。詳情請參閱以下說明頁面：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)

在這段期間內，您的單次點擊出價和千次曝光出價總和。
costPerAllConversions

number

廣告互動費用除以所有轉換。
costPerConversion

number

廣告互動費用除以轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
costPerCurrentModelAttributedConversion

number

廣告互動費用除以目前的模式歸因轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
crossDeviceConversions

number

客戶在某部裝置上點擊 Google Ads 廣告，然後使用其他裝置或瀏覽器完成轉換。所有轉換已納入跨裝置轉換。
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

發起的即時通訊訊息 (messageChat) 除以訊息曝光次數 (訊息曝光次數)。使用者從廣告曝光中發起訊息即時通訊的比率，其中含有訊息選項和訊息追蹤。請注意，對於特定訊息曝光，這個速率可能會大於 1.0。
mobileFriendlyClicksPercentage

number

前往行動裝置友善網頁的行動點擊百分比。
optimizationScoreUplift

number

所有最佳化建議的最佳化分數總升幅。
optimizationScoreUrl

string

Google Ads 網頁介面中最佳化分數頁面的網址。您可以從 customer 或 campaign 選取這項指標，並按 segments.recommendation_type 區隔。舉例來說，SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer 會傳回每個不重複 (customer、RecommendationType) 組合的網址。
organicClicks

string (int64 format)

使用者在某項查詢的非付費結果中，按下您網站搜尋結果的次數。詳情請參閱以下說明頁面：https://support.google.com/google-ads/answer/3097241。
organicClicksPerQuery

number

使用者在非付費結果中點選您網站的搜尋結果的次數，除以傳回您網站網頁的搜尋總數 (自然查詢)。詳情請參閱以下說明頁面：https://support.google.com/google-ads/answer/3097241。
organicImpressions

string (int64 format)

網站在非付費搜尋結果中顯示的商品數量。詳情請參閱以下說明頁面：https://support.google.com/google-ads/answer/3097241。
organicImpressionsPerQuery

number

將您網站的網頁列在非付費搜尋結果中的次數 (自然曝光次數) 除以非付費結果中的搜尋結果傳回網站的次數 (自然查詢) 所得的值。詳情請參閱以下說明頁面：https://support.google.com/google-ads/answer/3097241。
organicQueries

string (int64 format)

在免付費搜尋結果中，傳回網站產品資訊的搜尋總次數。詳情請參閱以下說明頁面：https://support.google.com/google-ads/answer/3097241。
percentNewVisitors

number

首次工作階段 (使用者過去從未造訪過您的網站的使用者) 所佔的百分比。從 Google Analytics (分析) 匯入。
phoneCalls

string (int64 format)

離線通話次數。
phoneImpressions

string (int64 format)

離線電話曝光次數。
phoneThroughRate

number

獲得的通話次數 (來電) 除以電話號碼顯示次數 (電話曝光) 所算出的比例。
relativeCtr

number

您的點閱率除以刊登您廣告的網站上，所有廣告客戶的平均點閱率。評估您的廣告在多媒體廣告聯播網網站上與其他廣告相較之下的成效。
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)

平均目標單次轉換出價，如果無法使用 (如果無法使用的話)，則一律設定這個值 (例如來自組合出價策略或非目標單次轉換出價的廣告活動)。
averageTargetRoas

number

平均目標廣告投資報酬率；如果無法使用，則不設定這個值 (例如來自組合出價策略或非目標廣告投資報酬率的廣告活動)。
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

發生可付費廣告事件 (點擊或曝光) 後，任何地點途徑的網站網址點擊次數。這項評估資料來自以素材資源為依據的位置。
eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

顯示商店位置或用於指定目標的曝光次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetClickToCall

number

曝光後任何地點途徑的通話按鈕點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetDirections

number

曝光後任何地點表面的行車路線點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetMenu

number

廣告曝光後，任何地點途徑的選單連結點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetOrder

number

曝光後任何地點途徑的訂單點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetOtherEngagement

number

曝光後任何地點途徑產生的其他本地動作點擊次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetStoreVisits

number

廣告曝光後親臨門市的預估次數。這項評估資料來自以素材資源為依據的位置。
viewThroughConversionsFromLocationAssetWebsite

number

廣告曝光後，在任何地點上點擊的網站網址。這項評估資料來自以素材資源為依據的位置。

InteractionEventType

列舉可能的應付費和免費互動類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
CLICK 按一下網站。在多數情況下，系統會將這項互動導向外部位置，通常是廣告客戶的到達網頁。也是點擊事件的預設 InteractionEventType。
ENGAGEMENT 使用者表示有意與廣告互動。
VIDEO_VIEW 使用者看過影片廣告。
NONE 廣告轉換事件的預設 InteractionEventType。如果廣告轉換列「並未」表示免費互動 (例如廣告轉換) 應「宣傳」並記錄在核心指標中，就需要使用這項指標。這些轉換就是其他 (廣告) 轉換。

SearchVolumeRange

搜尋量範圍。實際搜尋量落在這個範圍內。

JSON 表示法 
{
  "min": string,
  "max": string
}
欄位
min

string (int64 format)

搜尋量下限。
max

string (int64 format)

搜尋量上限。

路段

僅限區隔的欄位。

JSON 表示法 
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
欄位
adDestinationType

enum (AdDestinationType)

廣告到達網頁類型。
adNetworkType

enum (AdNetworkType)

廣告聯播網類型。
budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

預算廣告活動連結狀態。
clickType

enum (ClickType)

Click type.
conversionActionCategory

enum (ConversionActionCategory)

轉換動作類別。
conversionAttributionEventType

enum (ConversionAttributionEventType)

轉換歸因事件類型。
conversionLagBucket

enum (ConversionLagBucket)

列舉值，代表曝光到轉換之間經過的天數。
conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

列舉值，代表曝光與轉換之間，或曝光與轉換調整之間經過的天數。
dayOfWeek

enum (DayOfWeek)

星期幾，例如 MONDAY。
device

enum (Device)

要套用指標的裝置。
externalConversionSource

enum (ExternalConversionSource)

外部轉換來源。
hotelCheckInDayOfWeek

enum (DayOfWeek)

飯店入住日期。
hotelDateSelectionType

enum (HotelDateSelectionType)

飯店日期選取類型。
hotelRateType

enum (HotelRateType)

飯店房價類型。
hotelPriceBucket

enum (HotelPriceBucket)

飯店價格區間。
keyword

object (Keyword)

關鍵字條件。
monthOfYear

enum (MonthOfYear)

月份，例如 1 月。
placeholderType

enum (PlaceholderType)

預留位置類型。這個指標只會用於動態饋給項目指標。
productChannel

enum (ProductChannel)

產品的頻道。
productChannelExclusivity

enum (ProductChannelExclusivity)

產品的通路獨佔性。
productCondition

enum (ProductCondition)

產品狀況，
recommendationType

enum (RecommendationType)

建議類型。
searchEngineResultsPageType

enum (SearchEngineResultsPageType)

搜尋引擎結果網頁的類型。
searchTermMatchType

enum (SearchTermMatchType)

觸發廣告的關鍵字比對類型 (包括變體)。
slot

enum (Slot)

廣告的位置。
conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

已套用轉換價值規則的主要維度。NO_RULE_APPLIED 會顯示未套用價值規則的轉換所記錄的總價值。「原始」會顯示已套用價值規則的轉換原始價值。GEO_LOCATION、DEVICE，目標對象會顯示套用價值規則後的淨調整項。
skAdNetworkUserType

enum (SkAdNetworkUserType)

iOS Store Kit 廣告聯播網使用者類型。
skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

iOS Store Kit 廣告聯播網廣告事件類型。
skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS Store Kit Kit 廣告聯播網歸因功勞
newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

這項功能的用途是按照使用者是新客戶或回訪客戶來區隔轉換。這類區隔通常用於評估獲取新客目標的影響。
activityAccountId

string (int64 format)

活動帳戶 ID。
activityRating

string (int64 format)

活動評分。
externalActivityId

string

廣告主提供的活動編號。
adGroup

string

廣告群組的資源名稱。
assetGroup

string

素材資源群組的資源名稱。
auctionInsightDomain

string

競價分析報表中參與者的網域 (可見網址)。
campaign

string

廣告活動的資源名稱。
conversionAction

string

轉換動作的資源名稱。
conversionActionName

string

轉換動作名稱。
conversionAdjustment

boolean

系統會按照原始轉換和轉換價值，以及若經過調整後的差異值，區隔轉換欄。虛列資料則符合原本所述的方式；但「true」列現在的資料和原本說明的資料有差異。加總這兩者的調整後資料。
date

string

指標適用的日期。格式為 yyyy-MM-dd，例如「2018-04-17」。
geoTargetAirport

string

代表機場的指定地理區域常數資源名稱。
geoTargetCanton

string

代表行政區的指定地理區域常數資源名稱。
geoTargetCity

string

地理目標常數的資源名稱，該常數代表城市。
geoTargetCountry

string

代表國家/地區的指定地理區域常數資源名稱。
geoTargetCounty

string

代表郡/縣的指定地理區域常數資源名稱。
geoTargetDistrict

string

指定地理區域常數的資源名稱，該常數代表區域。
geoTargetMetro

string

代表都會區的指定地理區域常數資源名稱。
geoTargetMostSpecificLocation

string

指定地理區域常數的資源名稱，代表最明確的位置。
geoTargetPostalCode

string

代表郵遞區號的指定地理區域常數資源名稱。
geoTargetProvince

string

代表州/省的指定地理區域常數資源名稱。
geoTargetRegion

string

代表區域的指定地理區域常數資源名稱。
geoTargetState

string

代表狀態的指定地理區域常數資源名稱。
hotelBookingWindowDays

string (int64 format)

飯店預訂期 (天)。
hotelCenterId

string (int64 format)

Hotel Center ID。
hotelCheckInDate

string

飯店入住日期。格式為「yyyy-MM-dd」。
hotelCity

string

旅館所在城市。
hotelClass

integer

飯店星級。
hotelCountry

string

旅館所在國家/地區。
hotelLengthOfStay

integer

飯店入住天數。
hotelRateRuleId

string

飯店房價規則 ID。
hotelState

string

旅館所在州/省。
hour

integer

時段，以 0 到 23 (含) 之間的數字表示。
interactionOnThisExtension

boolean

只搭配動態饋給項目指標使用。指出互動指標是發生在動態饋給項目本身，還是其他額外資訊/廣告單元上。
month

string

以每月第一天的日期表示的月份。格式為「yyyy-MM-dd」。
partnerHotelId

string

合作夥伴飯店 ID。
productAggregatorId

string (int64 format)

產品的集結網站 ID。
productBiddingCategoryLevel1

string

產品的出價類別 (層級 1)。
productBiddingCategoryLevel2

string

產品的出價類別 (層級 2)。
productBiddingCategoryLevel3

string

產品的出價類別 (層級 3)。
productBiddingCategoryLevel4

string

產品的出價類別 (層級 4)。
productBiddingCategoryLevel5

string

產品的出價類別 (層級 5)。
productBrand

string

產品的品牌。
productCountry

string

產品銷售國家/地區的指定地理區域常數資源名稱。
productCustomAttribute0

string

產品的自訂屬性 0。
productCustomAttribute1

string

產品的自訂屬性 1。
productCustomAttribute2

string

產品的自訂屬性 2。
productCustomAttribute3

string

產品的自訂屬性 3。
productCustomAttribute4

string

產品的自訂屬性 4。
productFeedLabel

string

產品的動態饋給標籤。
productItemId

string

產品的項目 ID。
productLanguage

string

產品語言的語言常數資源名稱。
productMerchantId

string (int64 format)

產品的商家 ID。
productStoreId

string

產品的商店 ID。
productTitle

string

產品的標題。
productTypeL1

string

產品的類型 (第 1 級)。
productTypeL2

string

產品的類型 (第 2 級)。
productTypeL3

string

產品的類型 (第 3 級)。
productTypeL4

string

產品的類型 (第 4 級)。
productTypeL5

string

產品的類型 (第 5 級)。
quarter

string

季度，以季度第一天的日期表示。使用當季季度，例如 2018 年第二季是從 2018 年 4 月 1 日開始。格式為「yyyy-MM-dd」。
searchSubcategory

string

搜尋字詞子類別。如果搜尋字詞不適用於其他子類別，則代表不涵蓋該子類別的搜尋字詞。
searchTerm

string

搜尋字詞。
webpage

string

代表網頁條件的廣告群組條件資源名稱。
week

string

一週的定義為星期一到星期日，以星期一的日期表示。格式為「yyyy-MM-dd」。
year

integer

年，格式為 yyyy。
skAdNetworkConversionValue

string (int64 format)

iOS Store Kit 廣告聯播網轉換價值。空值代表此區隔不適用，例如非 iOS 廣告活動。
skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

應用程式在何處顯示帶來 iOS Store Kit Kit Network Network 安裝的廣告。空值代表此區隔不適用 (例如非 iOS 廣告活動)，或是 Apple 傳送的任何回傳中都不包含這個區隔。
assetInteractionTarget

object (AssetInteractionTarget)

只搭配 CustomerAsset、CampaignAsset 和 adAsset 指標使用。指出互動指標是發生在素材資源本身，還是其他素材資源/廣告單元上。當廣告放送的所有部分 (例如「廣告本身」和「網站連結」等其他元件) 一起放送時，系統會將互動 (例如點擊) 計算在內。如果 engagementOnThisAsset 為 true，代表互動位於此特定素材資源，當 engagementOnThisAsset 為 False 時，代表互動並非在特定素材資源上，而是在放送這項素材資源的其他部分發生。

AdDestinationType

列舉 Google Ads 目的地類型

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
NOT_APPLICABLE 廣告不會將使用者帶往其他到達網頁
WEBSITE 網站
APP_STORE iOS App Store 或 Play 商店
PHONE_CALL 通話撥號
MAP_DIRECTIONS 地圖應用程式
LOCATION_LISTING 位置資訊專用網頁
MESSAGE 文字訊息
LEAD_FORM 待開發客戶產生表單
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS 包含不明鍵的轉換廣告到達網頁

AdNetworkType

列舉 Google Ads 聯播網類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
SEARCH Google 搜尋。
SEARCH_PARTNERS 搜尋聯播網夥伴。
CONTENT 您廣告的位置
YOUTUBE_WATCH YouTube 影片
MIXED 跨聯播網。

BudgetCampaignAssociationStatus

「BudgetCampaignAssociationStatus」區隔。

JSON 表示法 
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
欄位
status

enum (BudgetCampaignAssociationStatus)

預算廣告活動連結狀態。
campaign

string

廣告活動資源名稱。

BudgetCampaignAssociationStatus

預算與廣告活動之間的關聯狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ENABLED 廣告活動目前使用預算。
REMOVED 廣告活動已不再使用該預算。

ClickType

列舉 Google Ads 點擊類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
BREADCRUMBS 導覽標記。
BROADBAND_PLAN 寬頻方案。
CALL_TRACKING 手動撥打的電話。
CALLS 。
CLICK_ON_ENGAGEMENT_AD 點按參與式廣告。
GET_DIRECTIONS 行車路線。
LOCATION_EXPANSION 取得地點詳細資料。
LOCATION_FORMAT_CALL 。
LOCATION_FORMAT_DIRECTIONS 。
LOCATION_FORMAT_IMAGE 圖片。
LOCATION_FORMAT_LANDING_PAGE 前往到達網頁。
LOCATION_FORMAT_MAP 地圖。
LOCATION_FORMAT_STORE_INFO 前往商店資訊。
LOCATION_FORMAT_TEXT 文字。
MOBILE_CALL_TRACKING 行動通話。
OFFER_PRINTS 列印優惠。
OTHER 其他。
PRODUCT_EXTENSION_CLICKS 產品加號方塊優惠。
PRODUCT_LISTING_AD_CLICKS 購物 - 產品 - 線上。
STORE_LOCATOR 顯示附近門市。
URL_CLICKS 廣告標題。
VIDEO_APP_STORE_CLICKS App Store。
VIDEO_CALL_TO_ACTION_CLICKS 行動號召重疊廣告。
VIDEO_CARD_ACTION_HEADLINE_CLICKS 資訊卡。
VIDEO_END_CAP_CLICKS 結尾展示畫面。
VIDEO_WEBSITE_CLICKS 網站。
WIRELESS_PLAN 無線網路方案。
PRODUCT_LISTING_AD_LOCAL 購物 - 產品 - 本地。
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL 購物 - 產品 - 多管道本地。
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE 購物 - 產品 - 多管道線上。
PRODUCT_LISTING_ADS_COUPON 購物 - 產品 - 優待券。
PRODUCT_LISTING_AD_TRANSACTABLE 購物 - 產品 - 在 Google 上銷售。
PROMOTION_EXTENSION 促銷額外資訊。
HOTEL_PRICE 飯店房價。
PRICE_EXTENSION 價格額外資訊。
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION 在 Google 上預訂的飯店房間選項。
SHOPPING_COMPARISON_LISTING 購物 - 比較商家資訊。
CROSS_NETWORK 跨聯播網。來自最高成效廣告活動和探索廣告活動。

ConversionAttributionEventType

歸因的轉換事件類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 代表這個版本未知的值。
IMPRESSION 系統會將轉換歸因於曝光。
INTERACTION 轉換歸因於互動。

ConversionLagBucket

列舉表示曝光到轉換之間經過的天數。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
LESS_THAN_ONE_DAY 轉換時間差區間從 0 到 1 天。包含 0 天，不包含 1 天。
ONE_TO_TWO_DAYS 轉換時間差區間從 1 到 2 天。包含 1 天，不包含 2 天。
TWO_TO_THREE_DAYS 轉換時間差區間從 2 到 3 天。包含 2 天，不包含 3 天。
THREE_TO_FOUR_DAYS 轉換時間差區間從 3 到 4 天。包含 3 天，不包含 4 天。
FOUR_TO_FIVE_DAYS 轉換時間差區間從 4 到 5 天。包含 4 天，不含 5 天。
FIVE_TO_SIX_DAYS 轉換時間差區間從 5 到 6 天。包含 5 天，不含 6 天。
SIX_TO_SEVEN_DAYS 轉換時間差區間從 6 到 7 天。包含 6 天，不包含 7 天。
SEVEN_TO_EIGHT_DAYS 轉換時間差區間從 7 天到 8 天。包含 7 天，不包含 8 天。
EIGHT_TO_NINE_DAYS 轉換時間差區間從 8 天到 9 天。包含 8 天，不包含 9 天。
NINE_TO_TEN_DAYS 轉換時間差區間從 9 到 10 天。包含 9 天，不包含 10 天。
TEN_TO_ELEVEN_DAYS 轉換時間差區間從 10 到 11 天。包含 10 天，不包含 11 天。
ELEVEN_TO_TWELVE_DAYS 轉換時間差區間從 11 天到 12 天。包含 11 天，不包含 12 天。
TWELVE_TO_THIRTEEN_DAYS 轉換時間差區間從 12 到 13 天。包含 12 天，不包含 13 天。
THIRTEEN_TO_FOURTEEN_DAYS 轉換時間差區間從 13 到 14 天。包含 13 天，不包含 14 天。
FOURTEEN_TO_TWENTY_ONE_DAYS 轉換時間差區間從 14 至 21 天。包含 14 天，不包含 21 天。
TWENTY_ONE_TO_THIRTY_DAYS 轉換時間差區間從 21 到 30 天。包含 21 天，不包含 30 天。
THIRTY_TO_FORTY_FIVE_DAYS 轉換時間差區間從 30 到 45 天。包含 30 天，不包含 45 天。
FORTY_FIVE_TO_SIXTY_DAYS 轉換時間差區間從 45 天到 60 天。包含 45 天，不包含 60 天。
SIXTY_TO_NINETY_DAYS 轉換時間差區間從 60 天到 90 天。包含 60 天，不包含 90 天。

ConversionOrAdjustmentLagBucket

列舉代表從曝光到轉換之間，或曝光與轉換調整之間經過的天數。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
CONVERSION_LESS_THAN_ONE_DAY 轉換時間差區間從 0 到 1 天。包含 0 天，不包含 1 天。
CONVERSION_ONE_TO_TWO_DAYS 轉換時間差區間從 1 到 2 天。包含 1 天，不包含 2 天。
CONVERSION_TWO_TO_THREE_DAYS 轉換時間差區間從 2 到 3 天。包含 2 天，不包含 3 天。
CONVERSION_THREE_TO_FOUR_DAYS 轉換時間差區間從 3 到 4 天。包含 3 天，不包含 4 天。
CONVERSION_FOUR_TO_FIVE_DAYS 轉換時間差區間從 4 到 5 天。包含 4 天，不含 5 天。
CONVERSION_FIVE_TO_SIX_DAYS 轉換時間差區間從 5 到 6 天。包含 5 天，不含 6 天。
CONVERSION_SIX_TO_SEVEN_DAYS 轉換時間差區間從 6 到 7 天。包含 6 天，不包含 7 天。
CONVERSION_SEVEN_TO_EIGHT_DAYS 轉換時間差區間從 7 天到 8 天。包含 7 天，不包含 8 天。
CONVERSION_EIGHT_TO_NINE_DAYS 轉換時間差區間從 8 天到 9 天。包含 8 天，不包含 9 天。
CONVERSION_NINE_TO_TEN_DAYS 轉換時間差區間從 9 到 10 天。包含 9 天，不包含 10 天。
CONVERSION_TEN_TO_ELEVEN_DAYS 轉換時間差區間從 10 到 11 天。包含 10 天，不包含 11 天。
CONVERSION_ELEVEN_TO_TWELVE_DAYS 轉換時間差區間從 11 天到 12 天。包含 11 天，不包含 12 天。
CONVERSION_TWELVE_TO_THIRTEEN_DAYS 轉換時間差區間從 12 到 13 天。包含 12 天，不包含 13 天。
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS 轉換時間差區間從 13 到 14 天。包含 13 天，不包含 14 天。
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS 轉換時間差區間從 14 至 21 天。包含 14 天，不包含 21 天。
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS 轉換時間差區間從 21 到 30 天。包含 21 天，不包含 30 天。
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS 轉換時間差區間從 30 到 45 天。包含 30 天，不包含 45 天。
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS 轉換時間差區間從 45 天到 60 天。包含 45 天，不包含 60 天。
CONVERSION_SIXTY_TO_NINETY_DAYS 轉換時間差區間從 60 天到 90 天。包含 60 天，不包含 90 天。
ADJUSTMENT_LESS_THAN_ONE_DAY 轉換調整項時間差區間介於 0 至 1 天。包含 0 天，不包含 1 天。
ADJUSTMENT_ONE_TO_TWO_DAYS 轉換調整項時間差區間介於 1 至 2 天。包含 1 天，不包含 2 天。
ADJUSTMENT_TWO_TO_THREE_DAYS 轉換調整項時間差區間介於 2 至 3 天。包含 2 天，不包含 3 天。
ADJUSTMENT_THREE_TO_FOUR_DAYS 轉換調整項時間差區間介於 3 至 4 天。包含 3 天，不包含 4 天。
ADJUSTMENT_FOUR_TO_FIVE_DAYS 轉換調整項時間差區間介於 4 至 5 天。包含 4 天，不含 5 天。
ADJUSTMENT_FIVE_TO_SIX_DAYS 轉換調整項時間差區間介於 5 至 6 天。包含 5 天，不含 6 天。
ADJUSTMENT_SIX_TO_SEVEN_DAYS 轉換調整項時間差區間介於 6 至 7 天。包含 6 天，不包含 7 天。
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS 轉換調整項時間差區間介於 7 至 8 天。包含 7 天，不包含 8 天。
ADJUSTMENT_EIGHT_TO_NINE_DAYS 轉換調整項時間差區間介於 8 至 9 天。包含 8 天，不包含 9 天。
ADJUSTMENT_NINE_TO_TEN_DAYS 轉換調整項時間差區間介於 9 至 10 天。包含 9 天，不包含 10 天。
ADJUSTMENT_TEN_TO_ELEVEN_DAYS 轉換調整項時間差區間介於 10 至 11 天。包含 10 天，不包含 11 天。
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS 轉換調整項時間差區間介於 11 至 12 天。包含 11 天，不包含 12 天。
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS 轉換調整項時間差區間介於 12 至 13 天。包含 12 天，不包含 13 天。
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS 轉換調整項時間差區間介於 13 至 14 天。包含 13 天，不包含 14 天。
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS 轉換調整項時間差區間介於 14 至 21 天。包含 14 天，不包含 21 天。
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS 轉換調整項時間差區間介於 21 至 30 天。包含 21 天，不包含 30 天。
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS 轉換調整項時間差區間介於 30 至 45 天。包含 30 天，不包含 45 天。
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS 轉換調整項時間差區間介於 45 至 60 天。包含 45 天，不包含 60 天。
ADJUSTMENT_SIXTY_TO_NINETY_DAYS 轉換調整項時間差介於 60 到 90 天。包含 60 天，不包含 90 天。
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS 轉換調整項時間差介於 90 到 145 天。包含 90 天，不包含 145 天。
CONVERSION_UNKNOWN 轉換時間差類別 UNKNOWN。這是指在 Google Ads 支援轉換時間差區間之前的日期。
ADJUSTMENT_UNKNOWN 轉換調整項時間差類別 UNKNOWN。這是指在 Google Ads 支援轉換調整項時間差區間之前的日期。

ExternalConversionSource

與 ConversionAction 相關聯的外部轉換來源。

列舉
UNSPECIFIED 未指定。
UNKNOWN 代表這個版本未知的值。
WEBPAGE 這是指使用者在觀看廣告後前往特定網頁時發生的轉換；在 Google Ads 使用者介面中會顯示為「網站」。
ANALYTICS 轉換來自已連結的 Google Analytics (分析) 目標或交易，在 Google Ads 使用者介面中會顯示為「Analytics (分析)」。
UPLOAD 透過 ConversionUploadService 上傳的網站轉換；在 Google Ads 使用者介面中會顯示為「從點擊次數匯入」。
AD_CALL_METRICS 這是指使用者直接在廣告上點按來電額外資訊時產生的轉換，在 Google Ads 使用者介面中會顯示為「廣告轉接來電」。
WEBSITE_CALL_METRICS 轉換是指使用者在按下廣告後，從廣告客戶的網站撥打動態產生的電話號碼 (透過安裝 JavaScript)，接著在 Google Ads 使用者介面中顯示為「網站來電」。
STORE_VISITS 這是指使用者在點擊 Google 廣告後造訪廣告主的零售商店，並在 Google Ads 使用者介面中顯示為「親臨門市」。
ANDROID_IN_APP 使用者採取應用程式內動作時發生的轉換，例如在 Android 應用程式中完成購買；在 Google Ads 使用者介面中顯示為「Android 應用程式內動作」。
IOS_IN_APP 使用者採取應用程式內動作時發生的轉換，例如在 iOS 應用程式中完成購買；在 Google Ads 使用者介面中顯示為「iOS 應用程式內動作」。
IOS_FIRST_OPEN 這是指使用者首次開啟 iOS 應用程式時發生的轉換；在 Google Ads 使用者介面中，轉換會顯示為「iOS 應用程式安裝 (初次開啟)」。
APP_UNSPECIFIED 未提供 AppPlatform 的舊版應用程式轉換；在 Google Ads UI 中顯示為「行動應用程式」。
ANDROID_FIRST_OPEN 這是指使用者首次開啟 Android 應用程式時發生的轉換；在 Google Ads 使用者介面中會顯示為「Android 應用程式安裝 (初次開啟)」。
UPLOAD_CALLS 透過 ConversionUploadService 上傳的來電轉換資料；在 Google Ads 使用者介面中會顯示為「從來電匯入」。
FIREBASE 轉換來自已連結的 Firebase 事件；在 Google Ads UI 中會顯示為「Firebase」。
CLICK_TO_CALL 這是指使用者點選手機號碼時發生的轉換，在 Google Ads 使用者介面中顯示為「電話號碼點擊」。
SALESFORCE 轉換來自 Salesforce，在 Google Ads 使用者介面中會顯示為「Salesforce.com」。
STORE_SALES_CRM 轉換來自客戶關係管理系統記錄的店內購物，在 Google Ads 使用者介面中會顯示為「商店銷售 (資料合作夥伴)」。
STORE_SALES_PAYMENT_NETWORK 轉換來自付款聯播網的店內購物，在 Google Ads 使用者介面中會顯示為「商店銷售 (付款聯播網)」。
GOOGLE_PLAY 無程式碼 Google Play 轉換；在 Google Ads 使用者介面中會顯示為「Google Play」。
THIRD_PARTY_APP_ANALYTICS 轉換來自已連結的第三方應用程式分析事件；在 Google Ads 使用者介面中會顯示為「第三方應用程式分析」。
GOOGLE_ATTRIBUTION 由 Google 歸因分析控制的轉換。
STORE_SALES_DIRECT_UPLOAD 商店銷售轉換是根據第一方或第三方商家資料所上傳的。在 Google Ads 使用者介面中，顯示為「商店銷售 (直接上傳)」。
STORE_SALES 根據上傳的第三方或第三方商家資料，和/或透過付款網路中的卡片在店內購物產生的商店銷售轉換。在 Google Ads 使用者介面中顯示為「商店銷售」。
SEARCH_ADS_360 從 Search Ads 360 Floodlight 資料匯入的轉換。
GOOGLE_HOSTED 與廣告互動後，追蹤來自 Google 產品和服務的本地動作的轉換。
FLOODLIGHT Floodlight 代碼回報的轉換。
ANALYTICS_SEARCH_ADS_360 來自 Google Analytics (分析) 專為 Search Ads 360 提供的轉換。在 Google Ads 使用者介面中會顯示為 Analytics (分析) (SA360)。
FIREBASE_SEARCH_ADS_360 Search Ads 360 已連結 Firebase 事件帶來的轉換。
DISPLAY_AND_VIDEO_360_FLOODLIGHT 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

廣告群組條件資源名稱。

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 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 Store Kit Kit Network Network 安裝的廣告所在的應用程式 ID。

SkAdNetworkAttributionCredit

列舉 SkAdNetwork 歸因抵免額。

列舉
UNSPECIFIED 預設值。這個值等於空值。
UNKNOWN 此 API 版本無法辨識這個值。這個 API 版本無法傳回 true 列舉值，或系統尚未支援。
UNAVAILABLE 回傳中包含此值，或是我們基於其他原因而沒有這些資料。
WON Google 是贏得廣告標示的廣告聯播網。
CONTRIBUTED Google 符合歸因資格，但未獲勝。

AssetInteractionTarget

AssetInteractionTarget 區隔。

JSON 表示法 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
欄位
asset

string

資產資源名稱。
interactionOnThisAsset

boolean

只搭配 CustomerAsset、CampaignAsset 和 adAsset 指標使用。指出互動指標是發生在素材資源本身，還是其他素材資源/廣告單元上。

ConvertingUserPriorEngagementTypeAndLtvBucket

列舉會轉換使用者先前的參與類型和生命週期價值區間

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
NEW 廣告主第一次進行轉換。
RETURNING 正在轉換的使用者將回到廣告主頁面。回訪的定義因轉換類型而異 (例如第二次親臨門市與第二次線上購物)。
NEW_AND_HIGH_LTV 轉換新使用者是廣告主的新對象，生命週期價值很高。