GoogleAdsRow

查询返回的行。

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

object (AccountBudget)

查询中的账号预算。

accountBudgetProposal

object (AccountBudgetProposal)

查询中引用的账号预算提案。

adGroup

object (AdGroup)

查询中引用的广告组。

adGroupAd

object (AdGroupAd)

查询中引用的广告。

adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

查询中的广告组广告素材资源组合视图。

adGroupAdAssetView

object (AdGroupAdAssetView)

查询中的广告组广告素材资源视图。

adGroupAdLabel

object (AdGroupAdLabel)

查询中引用的广告组广告标签。

adGroupAsset

object (AdGroupAsset)

查询中引用的广告组素材资源。

adGroupAssetSet

object (AdGroupAssetSet)

查询中引用的广告组素材资源集。

adGroupAudienceView

object (AdGroupAudienceView)

查询中引用的广告组受众群体视图。

adGroupBidModifier

object (AdGroupBidModifier)

查询中引用的出价调节系数。

adGroupCriterion

object (AdGroupCriterion)

查询中引用的条件。

adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

查询中引用的广告组条件定制参数。

adGroupCriterionLabel

object (AdGroupCriterionLabel)

查询中引用的广告组条件标签。

adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

查询中引用的广告组条件模拟。

adGroupCustomizer

object (AdGroupCustomizer)

查询中引用的广告组定制参数。

adGroupExtensionSetting

object (AdGroupExtensionSetting)

查询中引用的广告组附加信息设置。

adGroupFeed

object (AdGroupFeed)

查询中引用的广告组 Feed。

adGroupLabel

object (AdGroupLabel)

查询中引用的广告组标签。

adGroupSimulation

object (AdGroupSimulation)

查询中引用的广告组模拟。

adParameter

object (AdParameter)

查询中引用的广告参数。

ageRangeView

object (AgeRangeView)

查询中引用的年龄段视图。

adScheduleView

object (AdScheduleView)

查询中引用的广告投放时间表视图。

domainCategory

object (DomainCategory)

查询中引用的网域类别。

asset

object (Asset)

查询中引用的资产。

assetFieldTypeView

object (AssetFieldTypeView)

查询中引用的素材资源字段类型视图。

assetGroupAsset

object (AssetGroupAsset)

查询中引用的素材资源组素材资源。

assetGroupSignal

object (AssetGroupSignal)

查询中引用的素材资源组信号。

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

查询中引用的素材资源组产品信息组过滤条件。

assetGroupProductGroupView

object (AssetGroupProductGroupView)

查询中引用的素材资源组产品组视图。

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

查询中引用的素材资源组“效果最佳的组合”视图。

assetGroup

object (AssetGroup)

查询中引用的素材资源组。

assetSetAsset

object (AssetSetAsset)

查询中引用的素材资源组素材资源。

assetSet

object (AssetSet)

查询中引用的素材资源集。

assetSetTypeView

object (AssetSetTypeView)

查询中引用的资产集类型视图。

batchJob

object (BatchJob)

查询中引用的批处理作业。

biddingDataExclusion

object (BiddingDataExclusion)

查询中引用的出价数据排除对象。

biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

查询中引用的出价季节性调整。

biddingStrategy

object (BiddingStrategy)

查询中引用的出价策略。

biddingStrategySimulation

object (BiddingStrategySimulation)

查询中引用的出价策略模拟。

billingSetup

object (BillingSetup)

查询中引用的结算设置。

callView

object (CallView)

查询中引用的调用视图。

campaignBudget

object (CampaignBudget)

查询中引用的广告系列预算。

campaign

object (Campaign)

查询中引用的广告系列。

campaignAsset

object (CampaignAsset)

查询中引用的广告系列素材资源。

campaignAssetSet

object (CampaignAssetSet)

查询中引用的广告系列素材资源组。

campaignAudienceView

object (CampaignAudienceView)

查询中引用的广告系列受众群体视图。

campaignBidModifier

object (CampaignBidModifier)

查询中引用的广告系列出价调节系数。

campaignConversionGoal

object (CampaignConversionGoal)

查询中引用的 CampaignConversionGoal。

campaignCriterion

object (CampaignCriterion)

查询中引用的广告系列定位条件。

campaignCustomizer

object (CampaignCustomizer)

查询中引用的广告系列自定义参数。

campaignDraft

object (CampaignDraft)

查询中引用的广告系列草稿。

campaignExtensionSetting

object (CampaignExtensionSetting)

查询中引用的广告系列附加信息设置。

campaignFeed

object (CampaignFeed)

查询中引用的广告系列 Feed。

campaignGroup

object (CampaignGroup)

AWQL 查询中引用的广告系列组。

campaignLabel

object (CampaignLabel)

查询中引用的广告系列标签。

campaignLifecycleGoal

object (CampaignLifecycleGoal)

查询中引用的广告系列生命周期目标。

campaignSearchTermInsight

object (CampaignSearchTermInsight)

查询中引用的广告系列搜索字词数据洞见。

campaignSharedSet

object (CampaignSharedSet)

AWQL 查询中引用的广告系列共享集。

campaignSimulation

object (CampaignSimulation)

查询中引用的广告系列模拟。

carrierConstant

object (CarrierConstant)

查询中引用的运营商常量。

changeEvent

object (ChangeEvent)

查询中引用的 ChangeEvent。

changeStatus

object (ChangeStatus)

查询中引用的 ChangeStatus。

combinedAudience

object (CombinedAudience)

查询中引用的 CombinedAudience。

audience

object (Audience)

查询中引用的受众群体。

conversionAction

object (ConversionAction)

查询中引用的转化操作。

conversionCustomVariable

object (ConversionCustomVariable)

查询中引用的转化自定义变量。

conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

查询中引用的 ConversionGoalCampaignConfig。

conversionValueRule

object (ConversionValueRule)

查询中引用的转化价值规则。

conversionValueRuleSet

object (ConversionValueRuleSet)

查询中引用的转化价值规则集。

clickView

object (ClickView)

查询中引用的 ClickView。

currencyConstant

object (CurrencyConstant)

查询中引用的货币常量。

customAudience

object (CustomAudience)

查询中引用的 CustomAudience。

customConversionGoal

object (CustomConversionGoal)

查询中引用的 CustomConversionGoal。

customInterest

object (CustomInterest)

查询中引用的自定义兴趣。

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)

查询中引用的客户 Feed。

customerLabel

object (CustomerLabel)

查询中引用的客户标签。

customerLifecycleGoal

object (CustomerLifecycleGoal)

查询中引用的客户生命周期目标。

customerNegativeCriterion

object (CustomerNegativeCriterion)

查询中引用的客户排除条件。

customerSearchTermInsight

object (CustomerSearchTermInsight)

查询中引用的客户搜索字词数据分析。

customerUserAccess

object (CustomerUserAccess)

查询中引用的 CustomerUserAccess。

customerUserAccessInvitation

object (CustomerUserAccessInvitation)

查询中引用的 CustomerUserAccessInvitation。

customizerAttribute

object (CustomizerAttribute)

查询中引用的定制参数属性。

detailPlacementView

object (DetailPlacementView)

查询中引用的详细展示位置视图。

detailedDemographic

object (DetailedDemographic)

查询中引用的详细受众特征。

displayKeywordView

object (DisplayKeywordView)

查询中引用的展示广告关键字视图。

distanceView

object (DistanceView)

查询中引用的距离视图。

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

查询中引用的动态搜索广告搜索字词视图。

expandedLandingPageView

object (ExpandedLandingPageView)

查询中引用的展开后的着陆页视图。

extensionFeedItem

object (ExtensionFeedItem)

查询中引用的附加信息 Feed 项。

feed

object (Feed)

查询中引用的 Feed。

feedItem

object (FeedItem)

查询中引用的 Feed 项。

feedItemSet

object (FeedItemSet)

查询中引用的 Feed 项集。

feedItemTarget

object (FeedItemTarget)

查询中引用的 Feed 项目标。

feedMapping

object (FeedMapping)

查询中引用的 Feed 映射。

feedPlaceholderView

object (FeedPlaceholderView)

查询中引用的 Feed 占位符视图。

genderView

object (GenderView)

查询中引用的性别视图。

geoTargetConstant

object (GeoTargetConstant)

查询中引用的地理位置定位目标常量。

geographicView

object (GeographicView)

查询中引用的地理视图。

groupPlacementView

object (GroupPlacementView)

查询中引用的组展示位置视图。

hotelGroupView

object (HotelGroupView)

查询中引用的酒店组视图。

hotelPerformanceView

object (HotelPerformanceView)

查询中引用的酒店效果视图。

hotelReconciliation

object (HotelReconciliation)

查询中引用的酒店对账。

incomeRangeView

object (IncomeRangeView)

查询中引用的收入范围视图。

keywordView

object (KeywordView)

查询中引用的关键字视图。

keywordPlan

object (KeywordPlan)

查询中引用的关键字方案。

keywordPlanCampaign

object (KeywordPlanCampaign)

查询中引用的关键字方案广告系列。

keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

查询中引用的关键字方案广告系列关键字。

keywordPlanAdGroup

object (KeywordPlanAdGroup)

查询中引用的关键字方案广告组。

keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

查询中引用的关键字方案广告组。

keywordThemeConstant

object (KeywordThemeConstant)

查询中引用的关键字主题常量。

label

object (Label)

查询中引用的标签。

landingPageView

object (LandingPageView)

查询中引用的着陆页视图。

languageConstant

object (LanguageConstant)

查询中引用的语言常量。

locationView

object (LocationView)

查询中引用的位置视图。

managedPlacementView

object (ManagedPlacementView)

查询中引用的自选展示位置视图。

mediaFile

object (MediaFile)

查询中引用的媒体文件。

localServicesEmployee

object (LocalServicesEmployee)

查询中引用的本地生活服务员工。

localServicesVerificationArtifact

object (LocalServicesVerificationArtifact)

查询中引用的本地生活服务验证工件。

mobileAppCategoryConstant

object (MobileAppCategoryConstant)

查询中引用的移动应用类别常量。

mobileDeviceConstant

object (MobileDeviceConstant)

查询中引用的移动设备常量。

offlineConversionUploadClientSummary

object (OfflineConversionUploadClientSummary)

客户级别的线下转化数据上传摘要。

offlineUserDataJob

object (OfflineUserDataJob)

查询中引用的离线用户数据作业。

operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

查询中引用的操作系统版本常量。

paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

查询中引用的付费自然搜索字词视图。

qualifyingQuestion

object (QualifyingQuestion)

查询中引用的甄别问题。

parentalStatusView

object (ParentalStatusView)

查询中引用的育儿状况视图。

perStoreView

object (PerStoreView)

查询中引用的按商店划分的视图。

productCategoryConstant

object (ProductCategoryConstant)

查询中引用的商品类别。

productGroupView

object (ProductGroupView)

查询中引用的产品组视图。

recommendation

object (Recommendation)

查询中引用的建议。

recommendationSubscription

object (RecommendationSubscription)

查询中引用的推荐订阅。

searchTermView

object (SearchTermView)

查询中引用的搜索字词视图。

sharedCriterion

object (SharedCriterion)

查询中引用的共享集。

sharedSet

object (SharedSet)

查询中引用的共享集。

smartCampaignSetting

object (SmartCampaignSetting)

查询中引用的智能广告系列设置。

shoppingPerformanceView

object (ShoppingPerformanceView)

查询中引用的购物广告效果视图。

smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

查询中引用的智能广告系列搜索字词视图。

topicView

object (TopicView)

查询中引用的主题视图。

travelActivityGroupView

object (TravelActivityGroupView)

查询中引用的旅行活动组视图。

travelActivityPerformanceView

object (TravelActivityPerformanceView)

查询中引用的旅行活动效果视图。

experiment

object (Experiment)

查询中引用的实验。

experimentArm

object (ExperimentArm)

查询中引用的实验组。

userInterest

object (UserInterest)

查询中提及的用户兴趣。

lifeEvent

object (LifeEvent)

查询中引用的人生大事。

userList

object (UserList)

查询中引用的用户列表。

userLocationView

object (UserLocationView)

查询中引用的用户位置视图。

remarketingAction

object (RemarketingAction)

查询中引用的再营销操作。

topicConstant

object (TopicConstant)

查询中引用的主题常量。

video

object (Video)

查询中引用的视频。

webpageView

object (WebpageView)

查询中引用的网页视图。

leadFormSubmissionData

object (LeadFormSubmissionData)

查询中提及的潜在客户表单用户提交内容。

localServicesLead

object (LocalServicesLead)

查询中引用的本地生活服务潜在客户。

localServicesLeadConversation

object (LocalServicesLeadConversation)

查询中提及的本地生活服务潜在客户对话。

androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

查询中引用的 Android 隐私权共享键 Google 广告组。

androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

查询中引用的 Android 隐私权共享键 Google 广告系列。

androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

查询中引用的 Android 隐私权共享密钥 Google 网络类型。

metrics

object (Metrics)

指标。

segments

object (Segments)

细分。

AccountBudget

账号级预算。其中包含有关预算本身的信息,以及最近批准的预算更改和待审批的预算更改建议。您可以在“pendingProposal”中找到待审批的建议更改(如果有)。有关预算的有效详细信息位于前缀为“approved_”“adjusted_”和不带前缀的字段中。由于某些有效详细信息可能会与用户最初请求的信息不同(例如支出限额),因此这些差异会通过“proposed_”“approved_”和可能的“adjusted_”字段并排显示。

此资源是使用 AccountBudgetProposal 进行更改的,无法直接更改。在任何给定时间,预算最多只能有一个待处理的提案。通过 pendingProposal 读取。

预算获得批准后,可能会发生调整,例如赠送金额调整。调整会导致“已批准”字段和“已调整”字段之间出现差异,否则这两个字段将完全相同。

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

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

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

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

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

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

string

仅限输出。账号级预算的资源名称。AccountBudget 资源名称的格式为:

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum (AccountBudgetStatus)

仅限输出。此账号级预算的状态。

totalAdjustmentsMicros

string (int64 format)

仅限输出。调整项总金额。

调整项的示例包括礼节性赠送金额。

amountServedMicros

string (int64 format)

仅限输出。已投放的广告的价值,以微秒为单位。

这包括超额投放费用,在这种情况下,系统可能会自动向预算返还相应金额(请参阅 totalAdjustmentsMicros)。

pendingProposal

object (PendingAccountBudgetProposal)

仅限输出。修改此预算的待处理提案(如果适用)。

id

string (int64 format)

仅限输出。账号级预算的 ID。

billingSetup

string

仅限输出。与此账号级预算关联的结算设置的资源名称。BillingSetup 资源名称的格式为:

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

仅限输出。账号级预算的名称。

proposedStartDateTime

string

仅限输出。账号级预算的建议开始时间,格式为 yyyy-MM-dd HH:mm:ss。如果提议的开始时间类型为“NOW”,则此字段为请求时间。

approvedStartDateTime

string

仅限输出。账号级预算的已获批准的开始时间,格式为 yyyy-MM-dd HH:mm:ss。

例如,如果新预算在建议的开始时间之后获得批准,则批准的开始时间为批准时间。

purchaseOrderNumber

string

仅限输出。采购订单编号是一个值,可帮助用户在月度账单中引用此预算。

notes

string

仅限输出。与预算相关联的备注。

联合字段 proposed_end_time。账号级预算的建议结束时间。proposed_end_time 只能是下列其中一项:
proposedEndDateTime

string

仅限输出。建议的结束时间,格式为 yyyy-MM-dd HH:mm:ss。

proposedEndTimeType

enum (TimeType)

仅限输出。建议的结束时间(采用明确定义的类型,例如 FOREVER)。

联合字段 approved_end_time。账号级预算的获批结束时间。

例如,如果预算的结束时间已更新,并且提案在提议的结束时间之后获得批准,则批准的结束时间为批准时间。approved_end_time 只能是下列其中一项:

approvedEndDateTime

string

仅限输出。已获批准的结束时间,采用 yyyy-MM-dd HH:mm:ss 格式。

approvedEndTimeType

enum (TimeType)

仅限输出。已获批准的结束时间,采用明确定义的类型,例如 FOREVER。

联合字段 proposed_spending_limit。建议的支出限额。proposed_spending_limit 只能是下列其中一项:
proposedSpendingLimitMicros

string (int64 format)

仅限输出。建议的支出限额(以微单位表示)。一百万个微单位为一个单位。

proposedSpendingLimitType

enum (SpendingLimitType)

仅限输出。以明确定义的类型(例如 INFINITE)提供建议的支出限额。

联合字段 approved_spending_limit。已批准的支出限额。

例如,如果账号在方案获得批准时已支出的金额超过了拟议的支出限额,则批准的支出限额会设为已支出的金额。approved_spending_limit 只能是下列其中一项:

approvedSpendingLimitMicros

string (int64 format)

仅限输出。已获批准的支出限额(以微单位表示)。一百万等同于一个单位。只有在建议的支出限额是有限的值时,系统才会填充此值,并且此值始终大于或等于建议的支出限额。

approvedSpendingLimitType

enum (SpendingLimitType)

仅限输出。已获批准的支出限额,采用明确定义的类型,例如 INFINITE。只有在获批的支出限额为“无限”时,系统才会填充此字段。

联合字段 adjusted_spending_limit。应用调整后的支出限额。调整项存储在 total_adjustments_micros 中。

此值对账号的支出金额具有最终决定权。adjusted_spending_limit 只能是下列其中一项:

adjustedSpendingLimitMicros

string (int64 format)

仅限输出。调整后的支出限额(以微为单位)。一百万个微单位为一个单位。

如果已获批的支出限额是有限的,则调整后的支出限额可能会因应用于此预算的调整类型(如果适用)而异。

如需了解不同类型的调整,请参阅以下网址:https://support.google.com/google-ads/answer/1704323

例如,借记调整会减少账号的支出限额。

adjustedSpendingLimitType

enum (SpendingLimitType)

仅限输出。调整后的支出限额,应为定义明确的类型,例如 INFINITE。只有当调整后的支出上限为 INFINITE 时,系统才会填充此字段。如果获批的支出上限为 INFINITE,则此字段一定为 true。

AccountBudgetStatus

AccountBudget 的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
PENDING 账号预算正在等待批准。
APPROVED 账号预算已获批准。
CANCELLED 用户已取消账号预算。

PendingAccountBudgetProposal

与封闭的账号级预算相关联的待处理提案(如果适用)。

JSON 表示法
{
  "proposalType": enum (AccountBudgetProposalType),
  "accountBudgetProposal": string,
  "name": string,
  "startDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,
  "creationDateTime": string,

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

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

enum (AccountBudgetProposalType)

仅限输出。此提案的类型,例如 END,表示结束与此提案关联的预算。

accountBudgetProposal

string

仅限输出。提案的资源名称。AccountBudgetProposal 资源名称的格式为:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}

name

string

仅限输出。要为账号级预算分配的名称。

startDateTime

string

仅限输出。开始时间,采用 yyyy-MM-dd HH:mm:ss 格式。

purchaseOrderNumber

string

仅限输出。采购订单编号是一个值,可帮助用户在月度账单中引用此预算。

notes

string

仅限输出。与此预算关联的备注。

creationDateTime

string

仅限输出。此账号级预算提案的创建时间。格式为 yyyy-MM-dd HH:mm:ss。

联合字段 end_time。账号级预算的结束时间。end_time 只能是下列其中一项:
endDateTime

string

仅限输出。结束时间(采用 yyyy-MM-dd HH:mm:ss 格式)。

endTimeType

enum (TimeType)

仅限输出。结束时间(采用明确定义的类型,例如 FOREVER)。

联合字段 spending_limit。支出限额。spending_limit 只能是下列其中一项:
spendingLimitMicros

string (int64 format)

仅限输出。支出限额(以微单位表示)。一百万个微单位为一个单位。

spendingLimitType

enum (SpendingLimitType)

仅限输出。支出限额作为明确定义的类型,例如 INFINITE。

AdGroupAdAssetCombinationView

广告组广告素材资源组合的使用情况。目前,我们仅支持针对自适应搜索广告使用 AdGroupAdAssetCombinationView,但计划在未来支持更多广告类型。

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

string

仅限输出。广告组广告素材资源组合视图的资源名称。组合 ID 的长度为 128 位,其中高 64 位存储在 asset_combination_id_high 中,低 64 位存储在 asset_combination_id_low 中。AdGroupAd 素材资源组合视图资源名称采用以下格式:customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}

servedAssets[]

object (AssetUsage)

仅限输出。投放的素材资源。

enabled

boolean

仅限输出。素材资源组合与最新版广告之间的状态。如果为 true,则素材资源组合会与最新版本的广告相关联。如果为 false,则表示该链接曾经存在,但已被移除,并且在最新版本的广告中不再显示。

AssetUsage

包含资源的使用信息。

JSON 表示法
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
字段
asset

string

资产的资源名称。

servedAssetFieldType

enum (ServedAssetFieldType)

素材资源的投放字段类型。

AdGroupAdAssetView

将 AdGroupAd 与素材资源相关联。目前,我们仅支持针对应用广告和自适应搜索广告使用 AdGroupAdAssetView。

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

string

仅限输出。广告组广告素材资源视图的资源名称。广告组广告素材资源视图资源名称的格式如下(在 v4 之前):

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

广告组广告素材资源视图资源名称的格式如下(从 v4 开始):

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

fieldType

enum (AssetFieldType)

仅限输出。素材资源在广告中的角色。

policySummary

object (AdGroupAdAssetPolicySummary)

仅限输出。广告组广告素材资源的政策信息。

performanceLabel

enum (AssetPerformanceLabel)

仅限输出。素材资源关联的效果。

pinnedField

enum (ServedAssetFieldType)

仅限输出。固定字段。

source

enum (AssetSource)

仅限输出。广告组广告素材资源的来源。

adGroupAd

string

仅限输出。素材资源关联到的广告组广告。

asset

string

仅限输出。与广告组广告相关联的素材资源。

enabled

boolean

仅限输出。素材资源与最新版广告之间的状态。如果为 true,则表示素材资源与最新版本的广告相关联。如果为 false,则表示该链接曾经存在,但已被移除,并且在最新版本的广告中不再显示。

AdGroupAdAssetPolicySummary

包含广告组广告素材资源的政策信息。

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

object (PolicyTopicEntry)

仅限输出。广告组广告素材资源的政策违规问题列表。

reviewStatus

enum (PolicyReviewStatus)

仅限输出。此广告组广告素材资源在审核流程的哪个阶段。

approvalStatus

enum (PolicyApprovalStatus)

仅限输出。此广告组广告素材资源的整体审批状态,根据其各个政策主题条目的状态计算得出。

AdGroupAudienceView

广告组受众群体视图。包括在受众群体一级汇总的展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式:

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

AdGroupCriterionSimulation

广告组条件模拟。下文分别详细介绍了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法组合。从 v5 开始,酒店 AdGroupCriterion 模拟操作。

  1. 展示广告 - 关键字 - CPC_BID - UNIFORM
  2. 搜索广告 - 关键字 - CPC_BID - UNIFORM
  3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
  4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM
  5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 表示法
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

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

string

仅限输出。广告组条件模拟的资源名称。广告组条件模拟资源名称采用以下格式:

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

type

enum (SimulationType)

仅限输出。模拟修改的字段。

modificationMethod

enum (SimulationModificationMethod)

仅限输出。模拟如何修改字段。

adGroupId

string (int64 format)

仅限输出。模拟的广告组 ID。

criterionId

string (int64 format)

仅限输出。模拟的条件 ID。

startDate

string

仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。

endDate

string

仅限输出。模拟数据所依据的最后一天,采用 YYYY-MM-DD 格式。

联合字段 point_list。模拟点列表。point_list 只能是下列其中一项:
cpcBidPointList

object (CpcBidSimulationPointList)

仅限输出。如果模拟类型为 CPC_BID,则为模拟得分。

percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

仅限输出。如果模拟类型为 PERCENT_CPC_BID,则为模拟得分。

SimulationType

用于描述模拟修改的字段的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CPC_BID 模拟的是每次点击费用出价。
CPV_BID 模拟结果适用于每次观看费用出价。
TARGET_CPA 模拟结果适用于目标每次转化费用。
BID_MODIFIER 此模拟针对的是出价调节系数。
TARGET_ROAS 模拟结果适用于广告支出回报率目标。
PERCENT_CPC_BID 模拟的是百分比形式的每次点击费用出价。
TARGET_IMPRESSION_SHARE 此模拟适用于展示次数份额目标。
BUDGET 模拟的是预算。

SimulationModificationMethod

用于描述模拟修改字段的方法的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
UNIFORM 模拟中的值会统一应用于给定资源的所有子项。系统未遵循子资源的替换项。
DEFAULT 模拟中的值已应用于给定资源。系统会遵循对子资源的替换项,并且流量估算值不包括这些资源。
SCALING 模拟中的值均按相同的系数缩放。例如,在模拟的“每次转化费用目标”广告系列中,广告系列目标和所有广告组目标均按 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

预测指标所依据的模拟缩放修饰符。与模拟实体相关的所有 CPC 出价都会按此调节系数进行缩放。

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. 搜索广告 - CPC_BID - 默认
  2. 搜索 - CPC_BID - UNIFORM
  3. 搜索广告 - TARGET_CPA - UNIFORM
  4. 搜索广告系列 - TARGET_ROAS - UNIFORM
  5. 展示广告 - CPC_BID - 默认
  6. 展示广告 - CPC_BID - UNIFORM
  7. 展示广告 - 目标每次转化费用 - 统一
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,
  "interactions": string,

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

string (int64 format)

广告客户必须设置的预计所需每日预算才能获得预计流量,以广告客户币种为单位,以微为单位。

appInstalls

number

预计应用安装次数。

inAppActions

number

预计应用内操作次数。

biddableConversions

number

预计可出价的转化次数。

biddableConversionsValue

number

可出价转化的预计总价值。

clicks

string (int64 format)

预计点击次数。

costMicros

string (int64 format)

预计费用(以百万分之一表示)。

impressions

string (int64 format)

预计的展示次数。

topSlotImpressions

string (int64 format)

预计的顶部广告位展示次数。只有搜索广告渠道类型支持此字段。

interactions

string (int64 format)

预计互动次数。只有发现广告渠道类型支持此字段。

联合字段 target_cpa_simulation_key_value。当 SimulationModificationMethod 为 UNIFORM 或 DEFAULT 时,系统会设置 target_cpa_micros。当 SimulationModificationMethod 设为 SCALING 时,系统会设置 target_cpa_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

仅限输出。广告时间表视图的资源名称。广告时间表视图资源名称采用以下格式:

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

DomainCategory

通过抓取网域自动生成的类别。如果广告系列使用 DynamicSearchAdsSetting,系统会为网域生成网域类别。您可以使用 WebpageConditionInfo 定位这些类别。请参阅:https://support.google.com/google-ads/answer/2471185

JSON 表示法
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
字段
resourceName

string

仅限输出。网域类别的资源名称。网域类别资源名称的格式为:

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

campaign

string

仅限输出。此类别推荐用于的广告系列。

category

string

仅限输出。为网站网域推荐的类别。例如,如果您有一个电子产品网站,则类别可以是“相机”“电视”等。

languageCode

string

仅限输出。用于指定网站语言的语言代码,例如“en”表示英语。您可以在动态搜索广告所需的 DynamicSearchAdsSetting 中指定语言。这是您希望 Google Ads 查找的网页的语言,为网页制作广告并将搜索与之匹配。

domain

string

仅限输出。网站的域名。您可以在动态搜索广告所需的 DynamicSearchAdsSetting 中指定网域。

coverageFraction

number

仅限输出。与此类别匹配的您网站上网页所占的百分比。

categoryRank

string (int64 format)

仅限输出。此类别在类别集中的位置。数字越小,与网域的匹配度越高。null 表示不建议。

hasChildren

boolean

仅限输出。指示此类别是否有子类别。

recommendedCpcBidMicros

string (int64 format)

仅限输出。相应类别的建议每次点击费用。

AssetFieldTypeView

素材资源字段类型视图。当素材资源用作附加信息时,此视图会报告每种素材资源字段类型的非重复统计指标。

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

string

仅限输出。素材资源字段类型视图的资源名称。资产字段类型视图资源名称的格式为:

customers/{customerId}/assetFieldTypeViews/{fieldType}

fieldType

enum (AssetFieldType)

仅限输出。素材资源字段类型视图的素材资源字段类型。

AssetGroupProductGroupView

素材资源组产品组视图。

JSON 表示法
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
字段
resourceName

string

仅限输出。素材资源组商品组视图的资源名称。素材资源组产品组视图资源名称采用以下格式:

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

assetGroup

string

仅限输出。与产品信息组过滤条件关联的素材资源组。

assetGroupListingGroupFilter

string

仅限输出。素材资源组产品信息组过滤条件的资源名称。

AssetGroupTopCombinationView

广告组广告素材资源组合使用情况的视图。

JSON 表示法
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
字段
resourceName

string

仅限输出。素材资源组“效果最佳的组合”视图的资源名称。素材资源组热门组合视图资源名称采用以下格式:“customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}”

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

仅限输出。一起投放的效果最佳的素材资源组合。

AssetGroupAssetCombinationData

素材资源组素材资源组合数据

JSON 表示法
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
字段
assetCombinationServedAssets[]

object (AssetUsage)

仅限输出。投放的素材资源。

AssetSetTypeView

素材资源组类型视图。此视图会报告每种素材资源组类型的未过量统计指标。此报告不包含子素材资源集类型。其统计信息会汇总到父级素材资源集类型下。

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

string

仅限输出。资产集类型视图的资源名称。资产集类型视图资源名称的格式为:

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum (AssetSetType)

仅限输出。素材资源组类型视图的素材资源组类型。

BiddingStrategySimulation

出价策略模拟。下面分别详细介绍了支持的模拟类型和模拟修改方法组合。

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

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

string

仅限输出。出价策略模拟的资源名称。出价策略模拟资源名称的格式为:

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

biddingStrategyId

string (int64 format)

仅限输出。模拟的出价策略共享集 ID。

type

enum (SimulationType)

仅限输出。模拟修改的字段。

modificationMethod

enum (SimulationModificationMethod)

仅限输出。模拟如何修改字段。

startDate

string

仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。

endDate

string

仅限输出。模拟数据所依据的最后一天,采用 YYYY-MM-DD 格式

联合字段 point_list。模拟点列表。point_list 只能是下列其中一项:
targetCpaPointList

object (TargetCpaSimulationPointList)

仅限输出。如果模拟类型为 TARGET_CPA,则为模拟得分。

targetRoasPointList

object (TargetRoasSimulationPointList)

仅限输出。如果模拟类型为 TARGET_ROAS,则为模拟得分。

CallView

来电视图,其中包含来电专用广告或附加电话信息的来电跟踪数据。

JSON 表示法
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
字段
resourceName

string

仅限输出。通话视图的资源名称。通话视图资源名称的格式为:

customers/{customerId}/callViews/{call_detail_id}

callerCountryCode

string

仅限输出。来电者的国家/地区代码。

callerAreaCode

string

仅限输出。来电者的区号。如果通话时长短于 15 秒,则为 null。

callDurationSeconds

string (int64 format)

仅限输出。广告客户提供的通话时长(以秒为单位)。

startCallDateTime

string

仅限输出。广告客户提供的通话开始日期时间。

endCallDateTime

string

仅限输出。广告客户提供的通话结束日期时间。

callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

仅限输出。来电跟踪的显示位置。

type

enum (CallType)

仅限输出。通话类型。

callStatus

enum (GoogleVoiceCallStatus)

仅限输出。通话的状态。

CallTrackingDisplayLocation

可能的来电跟踪显示位置。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
AD 通过广告拨打的电话。
LANDING_PAGE 通过广告指向的着陆页拨打的电话。

CallType

发起调用的可能媒体资源类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
MANUALLY_DIALED 电话是手动拨打的。

GoogleVoiceCallStatus

Google Voice 通话的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
MISSED 您错过了来电。
RECEIVED 我们已收到该通话。

CampaignAudienceView

广告系列受众群体视图。包括展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据,按广告系列和受众群体条件汇总。此视图仅包含在广告系列一级附加的受众群体。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。广告系列受众群体视图的资源名称。广告系列受众群体视图资源名称采用以下格式:

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

CampaignSearchTermInsight

“广告系列搜索字词”视图。历史数据从 2023 年 3 月开始提供。

JSON 表示法
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
字段
resourceName

string

仅限输出。广告系列级搜索字词数据分析的资源名称。广告系列级搜索字词数据分析资源名称的格式如下:

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

categoryLabel

string

仅限输出。搜索类别的标签。空字符串表示不属于其他类别的搜索字词的统称类别。

id

string (int64 format)

仅限输出。数据分析的 ID。

campaignId

string (int64 format)

仅限输出。广告系列的 ID。

CampaignSimulation

广告系列模拟。下面分别详细介绍了广告渠道类型、模拟类型和模拟修改方法的支持组合。

  • 搜索 - CPC_BID - UNIFORM
  • 搜索 - CPC_BID - 缩放
  • 搜索广告 - TARGET_CPA - UNIFORM
  • 搜索广告 - 目标每次转化费用 - 扩展
  • 搜索广告系列 - TARGET_ROAS - UNIFORM
  • 搜索广告 - TARGET_IMPRESSION_SHARE - UNIFORM
  • 搜索 - 预算 - 统一
  • 购物 - 预算 - 制服
  • 购物 - TARGET_ROAS - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • 发现广告系列 - 目标每次转化费用 - 默认
  • 展示广告 - 目标每次转化费用 - 统一
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - BUDGET - UNIFORM
JSON 表示法
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

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

string

仅限输出。广告系列模拟的资源名称。广告系列模拟资源名称的格式如下:

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

campaignId

string (int64 format)

仅限输出。模拟的广告系列 ID。

type

enum (SimulationType)

仅限输出。模拟修改的字段。

modificationMethod

enum (SimulationModificationMethod)

仅限输出。模拟如何修改字段。

startDate

string

仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。

endDate

string

仅限输出。模拟数据所依据的最后一天,采用 YYYY-MM-DD 格式

联合字段 point_list。模拟点列表。point_list 只能是下列其中一项:
cpcBidPointList

object (CpcBidSimulationPointList)

仅限输出。如果模拟类型为 CPC_BID,则为模拟得分。

targetCpaPointList

object (TargetCpaSimulationPointList)

仅限输出。如果模拟类型为 TARGET_CPA,则为模拟得分。

targetRoasPointList

object (TargetRoasSimulationPointList)

仅限输出。如果模拟类型为 TARGET_ROAS,则为模拟得分。

targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

仅限输出。如果模拟类型为 TARGET_IMPRESSION_SHARE,则为模拟数据点。

budgetPointList

object (BudgetSimulationPointList)

仅限输出。如果模拟类型为“预算”,则为模拟积分。

TargetImpressionShareSimulationPointList

用于存放类型为 TARGET_IMPRESSION_SHARE 的模拟的模拟点的容器。

JSON 表示法
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
字段
points[]

object (TargetImpressionShareSimulationPoint)

针对特定目标展示次数份额值的预测指标。

TargetImpressionShareSimulationPoint

针对特定目标展示次数份额值的预测指标。

JSON 表示法
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
字段
targetImpressionShareMicros

string (int64 format)

预测指标所依据的模拟目标展示次数份额值(以微单位表示)。例如,10% 的展示次数份额(等于 0.1)会存储为 100_000。此值经过验证,且不会超过 100 万(100%)。

requiredCpcBidCeilingMicros

string (int64 format)

广告客户必须设置的预计所需的每日 CPC 出价上限,以广告客户币种的微单位表示,用于实现此模拟。

requiredBudgetAmountMicros

string (int64 format)

广告客户必须设置的预计所需每日预算才能获得预计流量,以广告客户币种为单位,以微为单位。

biddableConversions

number

预计可出价的转化次数。

biddableConversionsValue

number

可出价转化的预计总价值。

clicks

string (int64 format)

预计点击次数。

costMicros

string (int64 format)

预计费用(以百万分之一表示)。

impressions

string (int64 format)

预计的展示次数。

topSlotImpressions

string (int64 format)

预计的顶部广告位展示次数。只有搜索广告渠道类型支持此字段。

absoluteTopImpressions

string (int64 format)

绝对页首展示次数的预测值。只有搜索广告渠道类型支持此字段。

BudgetSimulationPointList

用于存放类型为 BUDGET 的模拟的模拟点的容器。

JSON 表示法
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
字段
points[]

object (BudgetSimulationPoint)

一系列预算金额的预测指标。

BudgetSimulationPoint

特定预算金额的预测指标。

JSON 表示法
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string
}
字段
budgetAmountMicros

string (int64 format)

预测指标所依据的模拟预算。

requiredCpcBidCeilingMicros

string (int64 format)

广告客户必须设置的预计所需每日 CPC 出价上限,以广告客户币种的微单位表示,用于实现此模拟。只有采用“目标支出”出价策略的广告系列支持此字段。

biddableConversions

number

预计可出价的转化次数。

biddableConversionsValue

number

可出价转化的预计总价值。

clicks

string (int64 format)

预计点击次数。

costMicros

string (int64 format)

预计费用(以百万分之一表示)。

impressions

string (int64 format)

预计的展示次数。

topSlotImpressions

string (int64 format)

预计的顶部广告位展示次数。只有搜索广告渠道类型支持此字段。

interactions

string (int64 format)

预计互动次数。只有发现广告渠道类型支持此字段。

CarrierConstant

可用于广告系列定位条件的运营商定位条件。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
字段
resourceName

string

仅限输出。运营商条件的资源名称。运营商条件资源名称采用以下格式:

carrierConstants/{criterionId}

id

string (int64 format)

仅限输出。运营商条件的 ID。

name

string

仅限输出。运营商的英文全名。

countryCode

string

仅限输出。运营商所在国家/地区的国家/地区代码,例如“AR”“FR”等。

ChangeEvent

描述特定资源类型的返回资源的精细更改。其中包括过去 30 天内通过界面或 API 进行的更改。系统会显示更改的字段的旧值和新值。ChangeEvent 最长可能需要 3 分钟才能反映出新更改。

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

string

仅限输出。更改事件的资源名称。更改事件资源名称的格式为:

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

changeDateTime

string

仅限输出。对此资源提交更改的时间。

changeResourceType

enum (ChangeEventResourceType)

仅限输出。更改的资源的类型。这决定了将在 oldResource 和 newResource 中设置哪些资源。

changeResourceName

string

仅限输出。发生更改的 Simply 资源。

clientType

enum (ChangeClientType)

仅限输出。更改的途径。

userEmail

string

仅限输出。做出此更改的用户的电子邮件地址。

oldResource

object (ChangedResource)

仅限输出。更改前的旧资源。系统只会填充更改后的字段。

newResource

object (ChangedResource)

仅限输出。更改后的新资源。系统只会填充更改后的字段。

resourceChangeOperation

enum (ResourceChangeOperation)

仅限输出。对更改的资源执行的操作。

changedFields

string (FieldMask format)

仅限输出。返回的资源中已更改的字段的列表。

这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo"

campaign

string

仅限输出。受此次变更影响的广告系列。

adGroup

string

仅限输出。受此更改影响的广告组。

feed

string

仅限输出。受此更改影响的 Feed。

feedItem

string

仅限输出。受此更改影响的 FeedItem。

asset

string

仅限输出。受此更改影响的资产。

ChangeEventResourceType

列出 ChangeEvent 资源支持的资源类型的枚举。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的分类资源。
AD 广告资源更改。
AD_GROUP AdGroup 资源更改。
AD_GROUP_CRITERION AdGroupCriterion 资源更改。
CAMPAIGN 广告系列资源更改。
CAMPAIGN_BUDGET CampaignBudget 资源更改。
AD_GROUP_BID_MODIFIER AdGroupBidModifier 资源更改。
CAMPAIGN_CRITERION CampaignCriterion 资源更改。
FEED Feed 资源更改。
FEED_ITEM FeedItem 资源更改。
CAMPAIGN_FEED CampaignFeed 资源更改。
AD_GROUP_FEED AdGroupFeed 资源更改。
AD_GROUP_AD AdGroupAd 资源更改。
ASSET 资产资源更改。
CUSTOMER_ASSET CustomerAsset 资源更改。
CAMPAIGN_ASSET CampaignAsset 资源更改。
AD_GROUP_ASSET AdGroupAsset 资源更改。
ASSET_SET AssetSet 资源更改。
ASSET_SET_ASSET AssetSetAsset 资源更改。
CAMPAIGN_ASSET_SET CampaignAssetSet 资源更改。

ChangeClientType

创建 changeEvent 资源的来源。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的未分类客户端类型。
GOOGLE_ADS_WEB_CLIENT 通过“ads.google.com”进行的更改。例如,通过广告系列管理工具进行的更改。
GOOGLE_ADS_AUTOMATED_RULE 通过 Google Ads 自动规则进行的更改。
GOOGLE_ADS_SCRIPTS 通过 Google Ads 脚本进行的更改。
GOOGLE_ADS_BULK_UPLOAD 通过 Google Ads 批量上传功能进行的更改。
GOOGLE_ADS_API Google Ads API 所做的更改。
GOOGLE_ADS_EDITOR 由 Google Ads 编辑器所做的更改。此值为占位符。该 API 不会返回这些更改。
GOOGLE_ADS_MOBILE_APP 通过 Google Ads 移动应用进行的更改。
GOOGLE_ADS_RECOMMENDATIONS 通过 Google Ads 建议进行的更改。
SEARCH_ADS_360_SYNC 通过 Search Ads 360 Sync 进行的更改。
SEARCH_ADS_360_POST 通过 Search Ads 360 Post 进行的更改。
INTERNAL_TOOL 通过内部工具进行的更改。例如,当用户在广告系列等实体上设置网址模板时,系统会自动将其封装在 SA360 Clickserver 网址中。
OTHER 未分类的更改类型,例如通过 Google Ads 兑换优惠券所做的更改。
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION 订阅 Google Ads 建议后所做的更改。

ChangedResource

用于呈现所有受支持资源的封装容器 proto。系统只会设置 changeResourceType 的资源。

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

object (Ad)

仅限输出。如果 changeResourceType == AD,则设置。

adGroup

object (AdGroup)

仅限输出。如果 changeResourceType == AD_GROUP,则设置此属性。

adGroupCriterion

object (AdGroupCriterion)

仅限输出。如果 changeResourceType == AD_GROUP_CRITERION,则进行设置。

campaign

object (Campaign)

仅限输出。如果 changeResourceType == CAMPAIGN,则进行设置。

campaignBudget

object (CampaignBudget)

仅限输出。如果 changeResourceType == CAMPAIGN_BUDGET,则进行设置。

adGroupBidModifier

object (AdGroupBidModifier)

仅限输出。如果 changeResourceType == AD_GROUP_BID_MODIFIER,则设置。

campaignCriterion

object (CampaignCriterion)

仅限输出。如果 changeResourceType == CAMPAIGN_CRITERION,则进行设置。

feed

object (Feed)

仅限输出。如果 changeResourceType == FEED,则设置。

feedItem

object (FeedItem)

仅限输出。如果 changeResourceType == FEED_ITEM,则设置。

campaignFeed

object (CampaignFeed)

仅限输出。如果 changeResourceType == CAMPAIGN_FEED,则进行设置。

adGroupFeed

object (AdGroupFeed)

仅限输出。如果 changeResourceType == AD_GROUP_FEED,则设置此属性。

adGroupAd

object (AdGroupAd)

仅限输出。如果 changeResourceType == AD_GROUP_AD,则设置此属性。

asset

object (Asset)

仅限输出。如果 changeResourceType == ASSET,则设置。

customerAsset

object (CustomerAsset)

仅限输出。如果 changeResourceType == CUSTOMER_ASSET,则设置。

campaignAsset

object (CampaignAsset)

仅限输出。如果 changeResourceType == CAMPAIGN_ASSET,则进行设置。

adGroupAsset

object (AdGroupAsset)

仅限输出。如果 changeResourceType == AD_GROUP_ASSET,则进行设置。

assetSet

object (AssetSet)

仅限输出。如果 changeResourceType == ASSET_SET,则设置。

assetSetAsset

object (AssetSetAsset)

仅限输出。如果 changeResourceType == ASSET_SET_ASSET,则设置。

campaignAssetSet

object (CampaignAssetSet)

仅限输出。如果 changeResourceType == CAMPAIGN_ASSET_SET,则设置此属性。

ResourceChangeOperation

changeEvent 资源中对更改的资源执行的操作。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的分类操作。
CREATE 资源已创建。
UPDATE 资源已修改。
REMOVE 资源已被移除。

ChangeStatus

描述返回资源的状态。ChangeStatus 最长可能需要 3 分钟才能反映出新的更改。

JSON 表示法
{
  "resourceName": string,
  "resourceType": enum (ChangeStatusResourceType),
  "resourceStatus": enum (ChangeStatusOperation),
  "sharedSet": string,
  "campaignSharedSet": string,
  "asset": string,
  "customerAsset": string,
  "campaignAsset": string,
  "adGroupAsset": string,
  "combinedAudience": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "feed": string,
  "feedItem": string,
  "adGroupFeed": string,
  "campaignFeed": string,
  "adGroupBidModifier": string
}
字段
resourceName

string

仅限输出。更改状态的资源名称。更改状态资源名称的格式为:

customers/{customerId}/changeStatus/{change_status_id}

resourceType

enum (ChangeStatusResourceType)

仅限输出。表示更改的资源的类型。这决定了要设置哪些字段。例如,对于 AD_GROUP,系统会设置 campaign 和 adGroup 字段。

resourceStatus

enum (ChangeStatusOperation)

仅限输出。表示更改后的资源的状态。

sharedSet

string

仅限输出。受此变更影响的 SharedSet。

campaignSharedSet

string

仅限输出。受此次变更影响的 CampaignSharedSet。

asset

string

仅限输出。受此更改影响的资产。

customerAsset

string

仅限输出。受此变更影响的 CustomerAsset。

campaignAsset

string

仅限输出。受此次变更影响的 CampaignAsset。

adGroupAsset

string

仅限输出。受此变更影响的 AdGroupAsset。

combinedAudience

string

仅限输出。受此次变更影响的 CombinedAudience。

lastChangeDateTime

string

仅限输出。此资源最近发生更改的时间。

campaign

string

仅限输出。受此次变更影响的广告系列。

adGroup

string

仅限输出。受此更改影响的广告组。

adGroupAd

string

仅限输出。受此变更影响的 AdGroupAd。

adGroupCriterion

string

仅限输出。受此更改影响的 AdGroupCriterion。

campaignCriterion

string

仅限输出。受此次变更影响的 CampaignCriterion。

feed

string

仅限输出。受此更改影响的 Feed。

feedItem

string

仅限输出。受此更改影响的 FeedItem。

adGroupFeed

string

仅限输出。受此变更影响的 AdGroupFeed。

campaignFeed

string

仅限输出。受此次变更影响的 CampaignFeed。

adGroupBidModifier

string

仅限输出。受此变更影响的 AdGroupBidModifier。

ChangeStatusResourceType

列出 ChangeStatus 资源支持的资源类型的枚举。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的分类资源。
AD_GROUP AdGroup 资源更改。
AD_GROUP_AD AdGroupAd 资源更改。
AD_GROUP_CRITERION AdGroupCriterion 资源更改。
CAMPAIGN 广告系列资源更改。
CAMPAIGN_CRITERION CampaignCriterion 资源更改。
FEED Feed 资源更改。
FEED_ITEM FeedItem 资源更改。
AD_GROUP_FEED AdGroupFeed 资源更改。
CAMPAIGN_FEED CampaignFeed 资源更改。
AD_GROUP_BID_MODIFIER AdGroupBidModifier 资源更改。
SHARED_SET SharedSet 资源更改。
CAMPAIGN_SHARED_SET CampaignSharedSet 资源更改。
ASSET 资产资源更改。
CUSTOMER_ASSET CustomerAsset 资源更改。
CAMPAIGN_ASSET CampaignAsset 资源更改。
AD_GROUP_ASSET AdGroupAsset 资源更改。
COMBINED_AUDIENCE CombinedAudience 资源更改。

ChangeStatusOperation

更改后的资源的状态

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的分类资源。
ADDED 资源已创建。
CHANGED 资源已修改。
REMOVED 资源已被移除。

CombinedAudience

说明包含不同受众群体的组合受众群体的资源。

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

string

不可变。组合受众群体的资源名称。组合的受众群体名称的格式如下:

customers/{customerId}/combinedAudience/{combined_audience_id}

id

string (int64 format)

仅限输出。组合受众群体的 ID。

status

enum (CombinedAudienceStatus)

仅限输出。此组合受众群体的状态。指示组合受众群体是处于启用还是移除状态。

name

string

仅限输出。组合受众群体的名称。它在所有组合的受众群体中都应是唯一的。

description

string

仅限输出。此组合受众群体的说明。

CombinedAudienceStatus

包含可能的组合受众群体状态类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 已启用状态 - 组合的受众群体已启用,可以定位到。
REMOVED 已移除状态 - 组合受众群体已移除,无法用于定位。

ClickView

点击视图,其中包含在每个点击级别汇总的指标,包括有效和无效点击。对于非搜索广告系列,metrics.clicks 表示有效互动和无效互动的数量。包含 ClickView 的查询必须包含一个过滤条件,将结果限制为一天,并且可以请求查询请求时间前 90 天内的数据。

JSON 表示法
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
字段
resourceName

string

仅限输出。点击视图的资源名称。点击视图资源名称采用以下格式:

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

areaOfInterest

object (ClickLocation)

仅限输出。与展示所关联的兴趣区域相匹配的地理位置条件。

locationOfPresence

object (ClickLocation)

仅限输出。与展示机会相关联的营业地点所对应的地理位置条件。

keyword

string

仅限输出。关联的关键字(如果存在且相应点击属于“搜索”渠道)。

keywordInfo

object (KeywordInfo)

仅限输出。与关联的关键字(如果有)相关的基本信息。

gclid

string

仅限输出。Google 点击 ID。

pageNumber

string (int64 format)

仅限输出。展示广告的页面在搜索结果中的页码。

adGroupAd

string

仅限输出。关联的广告。

campaignLocationTarget

string

仅限输出。关联的广告系列地理位置定位条件(如果有)。

userList

string

仅限输出。关联的用户列表(如果有)。

ClickLocation

与点击相关联的地理位置条件。

JSON 表示法
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
字段
city

string

与展示相关联的城市地理位置条件。

country

string

与展示次数相关联的国家/地区位置条件。

metro

string

与展示相关联的都会区地理位置条件。

mostSpecific

string

与展示相关联的最具体的地理位置条件。

region

string

与展示相关的地区地理位置条件。

CurrencyConstant

货币常量。

JSON 表示法
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
字段
resourceName

string

仅限输出。货币常量的资源名称。货币常量资源名称的格式为:

currencyConstants/{code}

code

string

仅限输出。符合 ISO 4217 标准、由 3 个字母组成的货币代码,例如“USD”

name

string

仅限输出。相应币种的英文全称。

symbol

string

仅限输出。用于描述此币种的标准符号,例如,美元为“$”。

billableUnitMicros

string (int64 format)

仅限输出。此币种的计费单位。结算金额应为此值的倍数。

AccessibleBiddingStrategy

表示由客户拥有并与客户共享的出价策略的视图。

与 BiddingStrategy 不同,此资源除了包含客户拥有的策略之外,还包含客户经理拥有并与客户共享的策略。此资源不提供指标,并且仅公开一部分出价策略属性。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

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

string

仅限输出。可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称的格式为:

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string (int64 format)

仅限输出。出价策略的 ID。

name

string

仅限输出。出价策略的名称。

type

enum (BiddingStrategyType)

仅限输出。出价策略的类型。

ownerCustomerId

string (int64 format)

仅限输出。拥有出价策略的客户的 ID。

ownerDescriptiveName

string

仅限输出。拥有出价策略的客户的 descriptiveName。

联合字段 scheme。出价方案。

只能设置一个。scheme 只能是下列其中一项:

maximizeConversionValue

object (MaximizeConversionValue)

仅限输出。这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。

maximizeConversions

object (MaximizeConversions)

仅限输出。这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。

targetCpa

object (TargetCpa)

仅限输出。一种出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。

targetImpressionShare

object (TargetImpressionShare)

仅限输出。一种出价策略,可自动针对所选的展示次数百分比进行优化。

targetRoas

object (TargetRoas)

仅限输出。这种出价策略有助于您在尽可能提高收入的同时,尽可能使平均广告支出回报率等于您设置的目标回报率。

targetSpend

object (TargetSpend)

仅限输出。一种出价策略,会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。

MaximizeConversionValue

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。

JSON 表示法
{
  "targetRoas": number
}
字段
targetRoas

number

仅限输出。目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。

MaximizeConversions

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。

JSON 表示法
{
  "targetCpaMicros": string
}
字段
targetCpaMicros

string (int64 format)

仅限输出。目标每次转化费用 (CPA) 选项。这是指您愿意为每次转化支付的平均金额。

TargetCpa

一种自动出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。

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

这是一种自动出价策略,可帮助您在达到特定目标广告支出回报率 (ROAS) 平均值的同时,尽可能提高收入。

JSON 表示法
{
  "targetRoas": number
}
字段
targetRoas

number

仅限输出。每单位支出所选择的收入(基于转化数据)。

TargetSpend

这是一种自动出价策略,使用该策略,系统会自动为您设置适当的出价,助您在不超出预算的前提下为您争取尽可能多的点击。

JSON 表示法
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
字段
targetSpendMicros
(deprecated)

string (int64 format)

仅限输出。尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 此字段已废弃,不应再使用。如需了解详情,请访问 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html

cpcBidCeilingMicros

string (int64 format)

仅限输出。可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

CustomerClient

给定客户与客户客户之间的关联。CustomerClient 仅适用于经理客户。包括所有直接客户和间接客户,以及经理本人。

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

string

仅限输出。客户端的资源名称。CustomerClient 资源名称采用以下格式:customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

仅限输出。请求方客户拥有的标签的资源名称,这些标签应用于客户客户。标签资源名称采用以下格式:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

仅限输出。客户客户的状态。只读。

clientCustomer

string

仅限输出。与指定客户关联的客户端-客户资源的名称。只读。

hidden

boolean

仅限输出。指定这是否为隐藏账号。只读。

level

string (int64 format)

仅限输出。给定客户与客户之间的距离。对于自链接,级别值为 0。只读。

timeZone

string

仅限输出。客户端时区的通用区域设置数据库 (CLDR) 字符串表示法,例如 America/Los_Angeles。只读。

testAccount

boolean

仅限输出。用于确定客户是否为测试账号。只读。

manager

boolean

仅限输出。用于标识客户端是否为经理。只读。

descriptiveName

string

仅限输出。客户端的描述性名称。只读。

currencyCode

string

仅限输出。客户的币种代码(例如“USD”“EUR”)。只读。

id

string (int64 format)

仅限输出。客户客户的 ID。只读。

CustomerSearchTermInsight

“客户搜索字词”视图。历史数据从 2023 年 3 月开始提供。

JSON 表示法
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
字段
resourceName

string

仅限输出。客户级搜索字词数据分析的资源名称。客户级搜索字词数据分析资源名称采用以下格式:

customers/{customerId}/customerSearchTermInsights/{categoryId}

categoryLabel

string

仅限输出。搜索类别的标签。空字符串表示不属于其他类别的搜索字词的统称类别。

id

string (int64 format)

仅限输出。数据分析的 ID。

DetailPlacementView

此视图会按广告组和网址或 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 视频的 YouTube 视频名称,以及移动应用的译名。

groupPlacementTargetUrl

string

仅限输出。组展示位置的网址,例如网域、指向应用商店中的移动应用的链接或 YouTube 频道网址。

targetUrl

string

仅限输出。展示位置的网址,例如网站、应用商店中移动应用的链接或 YouTube 视频网址。

PlacementType

Feed 映射的可能展示位置类型。

枚举
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

仅限输出。detailedDemographic 的父级。

launchedToAll

boolean

仅限输出。如果详细受众特征面向所有渠道和语言区域发布,则为 true。

availabilities[]

object (CriterionCategoryAvailability)

仅限输出。详细受众特征的可用性信息。

CriterionCategoryAvailability

每个广告渠道的类别可用性信息。

JSON 表示法
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
字段
channel

object (CriterionCategoryChannelAvailability)

相应类别可用的渠道类型和子类型。

locale[]

object (CriterionCategoryLocaleAvailability)

频道类别可用的语言区域。

CriterionCategoryChannelAvailability

类别适用的广告渠道类型和子类型的相关信息。

JSON 表示法
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
字段
availabilityMode

enum (CriterionCategoryChannelAvailabilityMode)

频道播出信息的格式。可以是 ALL_CHANNELS(系统不会设置其余字段)、CHANNEL_TYPE(系统只会设置 advertisingChannelType 类型,此类别适用于其下的所有子类型)或 CHANNEL_TYPE_AND_SUBTYPES(系统会设置 advertisingChannelType、advertisingChannelSubType 和 includeDefaultChannelSubType)。

advertisingChannelType

enum (AdvertisingChannelType)

此类别适用的渠道类型。

advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

该类别适用的渠道类型下的渠道子类型。

includeDefaultChannelSubType

boolean

是否包含默认频道子类型。例如,如果 advertisingChannelType 为 DISPLAY 且 includeDefaultChannelSubType 为 false,则表示未设置渠道子类型的默认展示广告系列不包含在此适用性配置中。

CriterionCategoryChannelAvailabilityMode

包含可能的 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 用户位于相应地点的 15 公里范围内。
WITHIN_20KM 用户位于相应地点的 20 公里范围内。
WITHIN_25KM 用户位于相应地点的 25 公里范围内。
WITHIN_30KM 用户位于相应地点的 30 公里范围内。
WITHIN_35KM 用户位于相应地点的 35 公里范围内。
WITHIN_40KM 用户位于相应地点 40 公里范围内。
WITHIN_45KM 用户位于相应地点 45 公里范围内。
WITHIN_50KM 用户位于相应地点的 50 公里范围内。
WITHIN_55KM 用户位于相应地点的 55 公里范围内。
WITHIN_60KM 用户位于相应地点的 60 公里范围内。
WITHIN_65KM 用户位于相应地点的 65 公里范围内。
BEYOND_65KM 用户距离相应地点超过 65 公里。
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

仅限输出。为展示投放的网页 Feed 项的网址。

此字段为只读字段。

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

Feed 占位符视图。

JSON 表示法
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
字段
resourceName

string

仅限输出。Feed 占位符视图的资源名称。Feed 占位符视图资源名称的格式为:

customers/{customerId}/feedPlaceholderViews/{placeholderType}

placeholderType

enum (PlaceholderType)

仅限输出。Feed 占位符视图的占位符类型。

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 是指转化跟踪代码的“transaction_id”参数中提供的此预订的标识符。

campaign

string

仅限输出。与转化相关联的广告系列的资源名称。

hotelCenterId

string (int64 format)

仅限输出。为酒店广告系列提供房价信息的 Hotel Center 账号的标识符。

hotelId

string

仅限输出。标识已预订房源的唯一标识符,如 Hotel Center Feed 中所提供。酒店 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

仅限输出。相应语言的全称(英语),例如“英语(美国)”“西班牙语”等。

targetable

boolean

仅限输出。相应语言是否可定位。

LocationView

“地理位置”视图会按地理位置条件汇总广告系列的效果。如果未设置任何位置条件,则系统不会返回任何结果;而是使用 geographicView 或 userLocationView 来获取访问者位置数据。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。位置视图的资源名称。营业地点视图资源名称采用以下格式:

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

ManagedPlacementView

自选展示位置视图。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。受管型展示位置视图的资源名称。受管理的展示位置视图资源名称的格式为:

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

MediaFile

媒体文件。

JSON 表示法
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

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

string

不可变。媒体文件的资源名称。媒体文件资源名称的格式为:

customers/{customerId}/mediaFiles/{media_file_id}

type

enum (MediaType)

不可变。媒体文件的类型。

mimeType

enum (MimeType)

仅限输出。媒体文件的 MIME 类型。

id

string (int64 format)

仅限输出。媒体文件的 ID。

sourceUrl

string

不可变。原始媒体文件的下载来源网址(或文件名)。仅适用于类型为 AUDIO 和 IMAGE 的媒体。

name

string

不可变。媒体文件的名称。客户端可以使用此名称来帮助识别之前上传的媒体。

fileSize

string (int64 format)

仅限输出。媒体文件的大小(以字节为单位)。

联合字段 mediatype。媒体文件的具体类型。mediatype 只能是下列其中一项:
image

object (MediaImage)

不可变。封装 Image。

mediaBundle

object (MediaBundle)

不可变。内容包含 HTML5 素材资源的 ZIP 压缩文件媒体。

audio

object (MediaAudio)

仅限输出。封装音频。

video

object (MediaVideo)

不可变。封装视频。

MediaType

媒体的类型。

枚举
UNSPECIFIED 未指定媒体类型。
UNKNOWN

此版本中未知收到的值。

这是仅限响应的值。

IMAGE 静态图片,用于图片广告。
ICON 小图片,用于地图广告。
MEDIA_BUNDLE ZIP 文件,用于模板广告的字段。
AUDIO 音频文件。
VIDEO 视频文件。
DYNAMIC_IMAGE 动画图片,例如 GIF 动画。

MediaImage

封装 Image。

JSON 表示法
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
字段
data

string (bytes format)

不可变。原始图片数据。

使用 base64 编码的字符串。

fullSizeImageUrl

string

仅限输出。指向图片全尺寸版本的网址。

previewSizeImageUrl

string

仅限输出。图片的预览大小版本的网址。

MediaBundle

表示内容包含 HTML5 素材资源的 ZIP 归档媒体。

JSON 表示法
{
  "data": string,
  "url": string
}
字段
data

string (bytes format)

不可变。压缩的原始数据。

使用 base64 编码的字符串。

url

string

仅限输出。用于访问上传的压缩数据的网址。例如,https://tpc.googlesyndication.com/simgad/123。此字段为只读字段。

MediaAudio

封装音频。

JSON 表示法
{
  "adDurationMillis": string
}
字段
adDurationMillis

string (int64 format)

仅限输出。音频的时长(以毫秒为单位)。

MediaVideo

封装视频。

JSON 表示法
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
字段
adDurationMillis

string (int64 format)

仅限输出。视频的时长(以毫秒为单位)。

youtubeVideoId

string

不可变。YouTube 视频 ID(如 YouTube 网址中所示)。将前缀“https://www.youtube.com/watch?v=" 添加到此 ID 后,即可获得此视频的 YouTube 在线播放网址。

advertisingIdCode

string

仅限输出。此视频的广告数字标识代码,由美国广告代理协会定义,主要用于电视广告。

isciCode

string

仅限输出。此视频的业界标准商业标识符代码,主要用于电视广告。

LocalServicesEmployee

本地生活服务员工资源。

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

string

不可变。本地服务验证的资源名称。Local Services Verification 资源名称采用以下格式:

customers/{customerId}/localServicesEmployees/{gls_employee_id}

creationDateTime

string

仅限输出。员工创建时间戳。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

status

enum (LocalServicesEmployeeStatus)

仅限输出。员工状态,例如“已删除”或“已启用”。

type

enum (LocalServicesEmployeeType)

仅限输出。员工类型。

universityDegrees[]

object (UniversityDegree)

仅限输出。此员工已获得且希望展示的学位列表。

residencies[]

object (Residency)

仅限输出。员工完成住院培训的机构。

fellowships[]

object (Fellowship)

仅限输出。员工完成了哪些机构的奖学金项目。

languagesSpoken[]

string

仅限输出。员工所说的语言,表示为 https://developers.google.com/admin-sdk/directory/v1/languages 中的语言代码

categoryIds[]

string

仅限输出。员工类别。如需查看本地生活服务类别 ID 列表,请访问 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids

id

string (int64 format)

仅限输出。员工的 ID。

jobTitle

string

仅限输出。此员工的职位,例如法律行业中的“高级合伙人”。

yearStartedPracticing

integer

仅限输出。此员工开始从事此领域工作的年份。

nationalProviderIdNumber

string

仅限输出。与员工关联的 NPI ID。

emailAddress

string

仅限输出。员工的电子邮件地址。

firstName

string

仅限输出。员工的名字。

middleName

string

仅限输出。员工的中间名字。

lastName

string

仅限输出。员工的姓氏。

LocalServicesEmployeeStatus

用于描述本地生活服务员工状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 员工未被移除,且员工状态为有效。
REMOVED 员工被移除。用于从商家中删除员工。

LocalServicesEmployeeType

用于描述本地生活服务员工类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
BUSINESS_OWNER 表示商家的所有者。
EMPLOYEE 表示商家的员工。

UniversityDegree

此员工已获得且希望展示的学位列表。

JSON 表示法
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
字段
institutionName

string

仅限输出。获得学位的大学的名称。

degree

string

仅限输出。所获学位的名称。

graduationYear

integer

仅限输出。毕业年份。

住所

有关员工医疗住院的详细信息。住院医师是高等医学教育的一个阶段,在该阶段,符合条件的医务专业人员在高级临床医生的监督下执业。

JSON 表示法
{
  "institutionName": string,
  "completionYear": integer
}
字段
institutionName

string

仅限输出。完成住院工作的机构的名称。

completionYear

integer

仅限输出。完成年份。

团契

有关员工医学奖学金的详细信息。研究员是指专业人士在完成住院医师培训后接受的一段医学培训。

JSON 表示法
{
  "institutionName": string,
  "completionYear": integer
}
字段
institutionName

string

仅限输出。完成该奖学金的机构的名称。

completionYear

integer

仅限输出。完成年份。

LocalServicesVerificationArtifact

本地服务验证资源。

JSON 表示法
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesVerificationArtifactStatus),
  "artifactType": enum (LocalServicesVerificationArtifactType),
  "id": string,

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

string

不可变。本地服务验证的资源名称。Local Services Verification 资源名称采用以下格式:

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}

creationDateTime

string

仅限输出。创建此验证工件时的时间戳。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

status

enum (LocalServicesVerificationArtifactStatus)

仅限输出。验证工件的状态。

artifactType

enum (LocalServicesVerificationArtifactType)

仅限输出。验证工件的类型。

id

string (int64 format)

仅限输出。验证工件的 ID。

联合字段 artifact_data。验证信息的类型。artifact_data 只能是以下类型之一:
backgroundCheckVerificationArtifact

object (BackgroundCheckVerificationArtifact)

仅限输出。背景调查验证工件。

insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

仅限输出。保险验证工件。

licenseVerificationArtifact

object (LicenseVerificationArtifact)

仅限输出。许可验证工件。

businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

仅限输出。工商登记核查验证工件。

LocalServicesVerificationArtifactStatus

用于描述本地生活服务验证工件的状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
PASSED 工件已通过验证。
FAILED 工件验证失败。
PENDING 工件正在验证中。
NO_SUBMISSION 工件需要用户上传信息,然后才能进行验证。
CANCELLED 工件已被用户取消。

LocalServicesVerificationArtifactType

枚举,用于描述本地生活服务验证工件可能的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
BACKGROUND_CHECK 背景调查验证工件。
INSURANCE 保险验证工件。
LICENSE 许可验证工件。
BUSINESS_REGISTRATION_CHECK 工商登记核查验证工件。

BackgroundCheckVerificationArtifact

用于存储本地生活服务背景调查专用信息的 proto。

JSON 表示法
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
字段
caseUrl

string

仅限输出。用于访问后台支持请求的网址。

finalAdjudicationDateTime

string

仅限输出。此背景调查案例结果的判定时间戳。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

InsuranceVerificationArtifact

一个 Proto,用于存储特定于本地生活服务保险的信息。

JSON 表示法
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
字段
amountMicros

string (int64 format)

仅限输出。保险金额。此值以保险文件中所述币种的“微”为单位。

rejectionReason

enum (LocalServicesInsuranceRejectionReason)

仅限输出。保险单据的拒绝原因。

insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

仅限输出。包含上传的保险文件信息的只读字段。

LocalServicesInsuranceRejectionReason

枚举,用于描述本地生活服务保险验证工件可能被拒的原因。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
BUSINESS_NAME_MISMATCH 商家名称与本地生活服务广告的商家名称不一致。
INSURANCE_AMOUNT_INSUFFICIENT 保险金额不符合相应地理位置 + 类别 ID 组合在法律摘要文档中列出的要求。
EXPIRED 保险单据已过期。
NO_SIGNATURE 保险单据缺少签名。
NO_POLICY_NUMBER 保险单据缺少保单号。
NO_COMMERCIAL_GENERAL_LIABILITY 保险文件中未勾选“商业一般责任险(CGL)”复选框。
EDITABLE_FORMAT 保险单据采用可修改的格式。
CATEGORY_MISMATCH 保险单据未涵盖特定类别的保险。
MISSING_EXPIRATION_DATE 保险文件缺少到期日期。
POOR_QUALITY 保险文件质量不佳 - 图片模糊不清、难以辨认等
POTENTIALLY_EDITED 保险单据疑似被修改。
WRONG_DOCUMENT_TYPE 保险单据不符合要求。例如,我们不接受缺少保险范围的保险方案文件。
NON_FINAL 保险文件尚未定稿。
OTHER 保险文件存在未明确列出的其他缺陷。

LocalServicesDocumentReadOnly

包含可读取数据的本地生活服务文档。

JSON 表示法
{
  "documentUrl": string
}
字段
documentUrl

string

用于访问已上传的本地生活服务文档的网址。

LicenseVerificationArtifact

用于存储特定于本地服务许可的相关信息的 proto。

JSON 表示法
{
  "licenseType": string,
  "licenseNumber": string,
  "licenseeFirstName": string,
  "licenseeLastName": string,
  "rejectionReason": enum (LocalServicesLicenseRejectionReason),
  "licenseDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
字段
licenseType

string

仅限输出。许可类型 / 名称。

licenseNumber

string

仅限输出。许可证号。

licenseeFirstName

string

仅限输出。许可人姓氏。

licenseeLastName

string

仅限输出。许可人姓氏。

rejectionReason

enum (LocalServicesLicenseRejectionReason)

仅限输出。许可遭拒原因。

licenseDocumentReadonly

object (LocalServicesDocumentReadOnly)

仅限输出。包含上传的许可证文档信息的只读字段。

LocalServicesLicenseRejectionReason

枚举,用于描述本地生活服务许可验证工件可能被拒的原因。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
BUSINESS_NAME_MISMATCH 商家名称与本地生活服务广告的商家名称不一致。
UNAUTHORIZED 许可未经授权或已被撤消。
EXPIRED 许可已过期。
POOR_QUALITY 许可证质量较差 - 图片模糊不清、难以辨认等
UNVERIFIABLE 由于图片不合法,因此无法验证许可。
WRONG_DOCUMENT_OR_ID 执照不是请求的证件类型,或者包含无效的身份证件。
OTHER 许可中存在未明确列出的其他缺陷。

BusinessRegistrationCheckVerificationArtifact

一个 proto,用于存储与本地生活服务商家注册核查相关的信息。

JSON 表示法
{
  "registrationType": enum (LocalServicesBusinessRegistrationType),
  "checkId": string,
  "rejectionReason": enum (LocalServicesBusinessRegistrationCheckRejectionReason),

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

enum (LocalServicesBusinessRegistrationType)

仅限输出。企业注册核查类型(编号、证件)。

checkId

string

仅限输出。检查的 ID,例如 vat_tax_id,表示“增值税号”要求。

rejectionReason

enum (LocalServicesBusinessRegistrationCheckRejectionReason)

仅限输出。注册证件遭拒原因。

联合字段 business_registration。企业注册的注册信息。具体形式取决于不同国家/地区的要求,可能是以下任一形式。business_registration 只能是下列其中一项:
registrationNumber

object (BusinessRegistrationNumber)

仅限输出。用于存储商家由政府签发的号码的消息。

registrationDocument

object (BusinessRegistrationDocument)

仅限输出。用于存储商家文档信息的消息。

LocalServicesBusinessRegistrationType

枚举,用于描述本地服务商家注册检查验证工件的可能注册类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
NUMBER 注册号检查类型。
DOCUMENT 注册证件核实类型。

LocalServicesBusinessRegistrationCheckRejectionReason

枚举,用于描述本地生活服务商家工商登记核查验证工件可能被拒的原因。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
BUSINESS_NAME_MISMATCH 商家名称与本地生活服务广告的商家名称不一致。
BUSINESS_DETAILS_MISMATCH 商家详情不一致。
ID_NOT_FOUND 未找到企业注册 ID。
POOR_DOCUMENT_IMAGE_QUALITY 上传的文件不清晰、模糊不清等
DOCUMENT_EXPIRED 上传的文件已过期。
DOCUMENT_INVALID 证件已撤消或作废。
DOCUMENT_TYPE_MISMATCH 文档类型不匹配。
DOCUMENT_UNVERIFIABLE 上传的文件无法验证是否合法。
OTHER 由于出现问题,商家注册流程无法完成。如需了解详情,请访问 https://support.google.com/localservices

BusinessRegistrationNumber

包含特定于本地服务商家注册编号的信息的 proto。

JSON 表示法
{
  "number": string
}
字段
number

string

仅限输出。商家获得的由政府签发的编号。

BusinessRegistrationDocument

用于存储本地服务商家注册证书专用信息的 proto。

JSON 表示法
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
字段
documentReadonly

object (LocalServicesDocumentReadOnly)

仅限输出。包含上传的企业注册证件的相关信息的只读字段。

MobileAppCategoryConstant

移动应用类别常量。

JSON 表示法
{
  "resourceName": string,
  "id": integer,
  "name": string
}
字段
resourceName

string

仅限输出。移动应用类别常量的资源名称。移动应用类别常量资源名称的格式为:

mobileAppCategoryConstants/{mobile_app_category_id}

id

integer

仅限输出。移动应用类别常量的 ID。

name

string

仅限输出。移动应用类别名称。

MobileDeviceConstant

移动设备常量。

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

string

仅限输出。移动设备常量的资源名称。移动设备常量资源名称采用以下格式:

mobileDeviceConstants/{criterionId}

type

enum (MobileDeviceType)

仅限输出。移动设备的类型。

id

string (int64 format)

仅限输出。移动设备常量的 ID。

name

string

仅限输出。移动设备的名称。

manufacturerName

string

仅限输出。移动设备的制造商。

operatingSystemName

string

仅限输出。移动设备的操作系统。

MobileDeviceType

移动设备的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
MOBILE 手机。
TABLET 平板电脑。

OfflineConversionUploadClientSummary

客户级别的线下转化数据上传摘要。

JSON 表示法
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
字段
resourceName

string

仅限输出。客户级别的线下转化数据上传摘要的资源名称。线下转化数据上传客户摘要资源名称采用以下格式:

customers/{customerId}/offlineConversionUploadClientSummaries/{client}

client

enum (OfflineEventUploadClient)

仅限输出。上传事件的客户端类型。

status

enum (OfflineConversionDiagnosticStatus)

仅限输出。线下转化客户摘要的整体状态。状态是根据包含上传统计数据的最近日历日生成的。

totalEventCount

string (int64 format)

仅限输出。上传的事件总数。

successfulEventCount

string (int64 format)

仅限输出。成功上传的事件总数。

successRate

number

仅限输出。成功率。

lastUploadDateTime

string

仅限输出。最近一次上传批次的日期。格式为“yyyy-mm-dd hh:mm:ss”,并采用 Google Ads 账号的时区。

dailySummaries[]

object (OfflineConversionSummary)

仅限输出。过去 N 天的历史统计数据摘要。

jobSummaries[]

object (OfflineConversionSummary)

仅限输出。按过去 N 个作业显示历史统计信息摘要。

alerts[]

object (OfflineConversionAlert)

仅限输出。每个错误代码的详细信息。系统会根据最近一个日历日的上传统计数据生成提醒。

OfflineEventUploadClient

客户端类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
GOOGLE_ADS_API Google Ads API。
GOOGLE_ADS_WEB_CLIENT Google Ads 网络客户端,可能包括 Google Ads 界面、SFTP 等多个来源
ADS_DATA_CONNECTOR 连接平台。

OfflineConversionDiagnosticStatus

线下数据提取设置的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
EXCELLENT 您的线下数据注入设置已启用,并且最适合进行下游处理。
GOOD 您的线下数据提取设置已启用,但还可以做出进一步改进。查看提醒。
NEEDS_ATTENTION 您的线下数据提取设置已启用,但存在一些错误需要您注意。查看提醒。
NO_RECENT_UPLOAD 您的线下数据提取设置在过去 28 天内未收到任何数据,其中可能存在问题。

OfflineConversionSummary

历史上传摘要,按上传日期或作业分组。

JSON 表示法
{
  "successfulCount": string,
  "failedCount": string,

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

string (int64 format)

仅限输出。成功事件的总数。

failedCount

string (int64 format)

仅限输出。失败事件的总数。

联合字段 dimension_key。摘要的维度键。dimension_key 只能是下列其中一项:
jobId

string (int64 format)

仅限输出。最后 N 个作业的维度键。

uploadDate

string

仅限输出。过去 N 天的维度键。

OfflineConversionAlert

线下转化客户摘要的提醒。

JSON 表示法
{
  "error": {
    object (OfflineConversionError)
  },
  "errorPercentage": number
}
字段
error

object (OfflineConversionError)

仅限输出。线下转化客户提醒出错。

errorPercentage

number

仅限输出。错误百分比,此字段的范围应为 [0, 1.0]。

OfflineConversionError

线下转化客户端摘要可能出现的错误。

JSON 表示法
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
字段
联合字段 error_code。说明有误。error_code 只能是下列其中一项:
collectionSizeError

enum (CollectionSizeError)

仅限输出。集合大小错误。

conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

仅限输出。转化调整上传出错。

conversionUploadError

enum (ConversionUploadError)

仅限输出。转化数据上传出错。

dateError

enum (DateError)

仅限输出。日期错误。

distinctError

enum (DistinctError)

仅限输出。不重复错误。

fieldError

enum (FieldError)

仅限输出。字段错误。

mutateError

enum (MutateError)

仅限输出。出现 Mutate 错误。

notAllowlistedError

enum (NotAllowlistedError)

仅限输出。未列入许可名单错误。

stringFormatError

enum (StringFormatError)

仅限输出。字符串格式错误。

stringLengthError

enum (StringLengthError)

仅限输出。字符串长度错误。

CollectionSizeError

用于描述可能的集合大小错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不支持收到的错误代码。
TOO_FEW 太少了。
TOO_MANY 太多了。

ConversionAdjustmentUploadError

用于描述可能出现的转化调整上传错误的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
TOO_RECENT_CONVERSION_ACTION 无法将事件导入刚刚创建的转化操作。请在 6 小时后再次尝试导入。
CONVERSION_ALREADY_RETRACTED 转化已撤消。此调整未得到处理。
CONVERSION_NOT_FOUND 找不到此转化操作和转化标识符对应的转化数据。请确保您的转化标识符与正确的转化操作相关联,然后重试。
CONVERSION_EXPIRED 无法对早于 54 天前发生的转化进行调整。
ADJUSTMENT_PRECEDES_CONVERSION 调整的 adjustmentDateTime 发生在关联的转化之前。请确保您的 adjustmentDateTime 正确无误,然后重试。
MORE_RECENT_RESTATEMENT_FOUND 已为关联的转化报告了更近期的调整 adjustmentDateTime。请确保您的调整 adjustmentDateTime 正确无误,然后重试。
TOO_RECENT_CONVERSION 由于转化时间过近,因此无法记录调整项。请尝试调整至少 24 小时前发生的转化。
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE 无法对设置为使用默认价值的转化进行调整。请检查您的转化操作价值设置,然后重试。
TOO_MANY_ADJUSTMENTS_IN_REQUEST 请尝试在单个 API 请求中上传少于 2,001 个调整项。
TOO_MANY_ADJUSTMENTS 转化已调整到次数上限。请确保您仅对现有转化做出必要的调整。
RESTATEMENT_ALREADY_EXISTS 转化先前已有相同 adjustmentDateTime 的重报。请确保调整项的 adjustmentDateTime 正确无误且唯一,然后重试。
DUPLICATE_ADJUSTMENT_IN_REQUEST 导入的调整项包含具有相同 adjustmentDateTime 的重复转化调整项。请确保您的调整项具有正确的 adjustmentDateTime,然后重试。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 请确保您已在转化设置中同意客户数据处理条款,然后重试。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 无法将增强型转化与指定的转化操作搭配使用。
INVALID_USER_IDENTIFIER 请务必使用 SHA-256 算法对用户提供的数据进行哈希处理,并确保您已按照相关准则进行规范化处理。
UNSUPPORTED_USER_IDENTIFIER 使用使用 SHA-256 算法对用户提供的数据(例如电子邮件地址或电话号码)进行哈希处理,然后重试。
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET 不能同时设置 gclidDateTimePair 和 orderId。请仅使用其中一种类型,然后重试。
CONVERSION_ALREADY_ENHANCED 增强型转化已经包含相同订单 ID 和转化操作。请确保您的数据配置正确无误,然后重试。
DUPLICATE_ENHANCEMENT_IN_REQUEST 多项增强功能具有相同的转化操作和订单 ID。请确保您的数据配置正确无误,然后重试。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT 由于 Google 客户数据政策,此账号无法使用增强型转化。请与您的 Google 代表联系。
MISSING_ORDER_ID_FOR_WEBPAGE 调整网站转化需要提供订单 ID(即交易 ID)。请确保您的网站代码能够获取订单 ID,并且您在进行调整时发送相同的订单 ID。
ORDER_ID_CONTAINS_PII 无法对包含个人身份信息 (PII) 的订单 ID 使用调整。
INVALID_JOB_ID 请求中提供的职位 ID 不在允许范围内。作业 ID 必须是 [1, 2^31] 这个范围内的正整数。
NO_CONVERSION_ACTION_FOUND 找不到调整请求中指定的转化操作。请确保该转化操作可在此账号中使用。
INVALID_CONVERSION_ACTION_TYPE 调整请求中指定的转化操作类型不支持上传调整项。RETRACTIONRESTATEMENT 类型的转化调整项只能用于 SALESFORCEUPLOAD_CLICKWEBPAGE 类型的转化操作。ENHANCEMENT 类型的转化调整项只能用于 WEBPAGE 类型的转化操作。

ConversionUploadError

用于描述可能出现的转化数据上传错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
TOO_MANY_CONVERSIONS_IN_REQUEST 在单个请求中上传的事件数量不得超过 2,001 个。
UNPARSEABLE_GCLID 无法对导入的 GCLID 进行解码。请确保您未修改点击 ID。
CONVERSION_PRECEDES_EVENT 导入事件的 conversionDateTime 早于点击。请确保您的 conversionDateTime 正确无误,然后重试。
EXPIRED_EVENT 此项转化的点击时间早于其点击型转化时间范围,因此无法记录导入的事件。请确保您导入的是最新数据。
TOO_RECENT_EVENT 与给定标识符或 iOS 网址参数关联的点击发生时间还不到 6 小时。请在 6 小时后重试。
EVENT_NOT_FOUND 导入的事件无法归因于某个点击。导致这种情况的原因可能是:该事件不是由 Google Ads 广告系列带来的。
UNAUTHORIZED_CUSTOMER 点击 ID 或调用与您无权访问的 Google Ads 账号相关联。请务必导入由您的经理账号管理的账号的转化数据。
TOO_RECENT_CONVERSION_ACTION 无法将事件导入刚刚创建的转化操作。请在 6 小时后再次尝试导入。
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME 在点击发生时,点击所对应的 Google Ads 账号的有效转化账号未启用转化跟踪。
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 导入的事件包含外部归因数据,但相应转化操作未设置为使用外部归因模型。请确保转化操作配置正确无误,然后重试。
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 转化操作已设置为使用外部归因模型,但导入的事件缺少数据。请确保导入的事件包含外部归因功劳和所有必填字段。
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 订单 ID 无法用于通过外部归因模型衡量的转化。请确保该转化配置正确无误,并且导入的事件仅包含必要的数据,然后重试。
ORDER_ID_ALREADY_IN_USE 导入的事件包含之前记录的订单 ID,因此未对其进行处理。
DUPLICATE_ORDER_ID 导入的事件包含多个具有相同订单 ID 的转化,因而未能得到处理。请确保订单 ID 是唯一的,然后重试。
TOO_RECENT_CALL 无法导入发生时间还不足 6 小时的通话。请在 6 小时后再次尝试上传。
EXPIRED_CALL 由于通话发生在此转化操作的回溯期之前,因此无法记录。请确保导入设置已配置为获取最新数据。
CALL_NOT_FOUND 找不到促成导入事件的来电或点击。请确保您的数据源已设置为包含正确的标识符。
CONVERSION_PRECEDES_CALL 来电的 conversionDateTime 早于关联的点击。确保您的 conversionDateTime 正确无误。
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME 在导入来电时,点击所对应的 Google Ads 账号的有效转化账号中未启用转化跟踪。
UNPARSEABLE_CALLERS_PHONE_NUMBER 请确保电话号码采用 E.164 格式(+16502531234)、国际电话号码格式(+64 3-331 6005)或美国国内电话号码格式(6502531234)。
CLICK_CONVERSION_ALREADY_EXISTS 导入的事件与现有转化具有相同的点击次数和 conversionDateTime。请为每个唯一事件使用唯一的 conversionDateTime 或订单 ID,然后重试。
CALL_CONVERSION_ALREADY_EXISTS 导入的来电与现有转化具有相同的 conversionDateTime。请确保您的 conversionDateTime 配置正确无误,然后重试。
DUPLICATE_CLICK_CONVERSION_IN_REQUEST 多个事件具有相同的点击和 conversionDateTime。请确保您的 conversionDateTime 配置正确无误,然后重试。
DUPLICATE_CALL_CONVERSION_IN_REQUEST 多个事件具有相同的来电信息和 conversionDateTime。请确保您的 conversionDateTime 配置正确无误,然后重试。
CUSTOM_VARIABLE_NOT_ENABLED 请在转化设置中启用自定义变量,然后重试。
CUSTOM_VARIABLE_VALUE_CONTAINS_PII 事件的自定义变量包含个人身份信息 (PII),因此无法导入。请移除这些变量,然后重试。
INVALID_CUSTOMER_FOR_CLICK 导入的事件带来的点击与其他 Google Ads 账号相关联。请确保要导入的账号正确无误。
INVALID_CUSTOMER_FOR_CALL 来电带来的点击与其他 Google Ads 账号相关联。请确保要导入的账号正确无误。针对“客户”查询 conversionTrackingSetting.google_ads_conversion_customer,以识别正确的账号。
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY 无法导入相应转化,因为相应转化来源未遵守 Apple 应用跟踪透明度 (ATT) 政策,或者客户未同意跟踪。
CLICK_NOT_FOUND 此事件的电子邮件地址或电话号码无法与点击相匹配。这可能是因为该事件不是由 Google Ads 广告系列促成,您可以放心地忽略此警告。如果包含的导入事件数量超出预期,您可能需要检查设置。
INVALID_USER_IDENTIFIER 请务必使用 SHA-256 算法对用户提供的数据进行哈希处理,并确保您已按照相关准则进行规范化处理。
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER 用户提供的数据不能与外部归因模型搭配使用。请使用其他归因模型或省略用户标识符,然后重试。
UNSUPPORTED_USER_IDENTIFIER 所提供的用户标识符不受支持。请仅使用经过哈希处理的电子邮件或电话号码,然后重试。
GBRAID_WBRAID_BOTH_SET 无法同时使用 gbraid 和 wbraid 参数。请仅使用其中一个,然后重试。
UNPARSEABLE_WBRAID 无法解析事件导入数据。请检查您的 wbraid 参数是否未修改,然后重试。
UNPARSEABLE_GBRAID 无法解析事件导入数据。请检查您的 gbraid 参数是否未修改,然后重试。
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID 使用每次点击统计为一次转化设置的转化操作无法与 gbraid 或 wbraid 参数配合使用。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS 由于 Google 客户数据政策,此账号无法使用增强型转化。请与您的 Google 代表联系。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 请确保您已在转化设置中同意客户数据处理条款,然后重试。您可以通过对 Customer 查询 conversionTrackingSetting.accepted_customer_data_terms 来检查您的设置。
ORDER_ID_CONTAINS_PII 事件的订单 ID 包含个人身份信息 (PII),因此无法导入。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 请确保您已在转化设置中启用增强型潜在客户转化,然后重试。您可以通过查询“客户”中的 conversionTrackingSetting.enhanced_conversions_for_leads_enabled 来检查您的设置。
INVALID_JOB_ID 请求中提供的职位 ID 不在允许范围内。作业 ID 必须是 [1, 2^31] 这个范围内的正整数。
NO_CONVERSION_ACTION_FOUND 找不到上传请求中指定的转化操作。请确保该转化操作可在此账号中使用。
INVALID_CONVERSION_ACTION_TYPE 上传请求中指定的转化操作未设置为上传相应转化数据。

DateError

用于描述可能的日期错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不支持收到的错误代码。
INVALID_FIELD_VALUES_IN_DATE 指定的字段值与有效日期不符。
INVALID_FIELD_VALUES_IN_DATE_TIME 指定的字段值不对应于有效的日期时间。
INVALID_STRING_DATE 字符串日期的格式应为 yyyy-mm-dd。
INVALID_STRING_DATE_TIME_MICROS 字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss.ssssss。
INVALID_STRING_DATE_TIME_SECONDS 字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss。
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET 字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss+|-hh:mm。
EARLIER_THAN_MINIMUM_DATE 日期早于允许的最早日期。
LATER_THAN_MAXIMUM_DATE 日期晚于允许的最晚日期。
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE 构成日期范围的下限日期晚于相应的上限日期。
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL 构成日期范围的上限与下限日期都为 Null。

DistinctError

用于描述可能的不同错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不支持收到的错误代码。
DUPLICATE_ELEMENT 元素重复。
DUPLICATE_TYPE 重复类型。

FieldError

用于描述可能的字段错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不支持收到的错误代码。
REQUIRED 缺少必填字段。
IMMUTABLE_FIELD 尝试进行更改的字段是不可变的。
INVALID_VALUE 该字段的值无效。
VALUE_MUST_BE_UNSET 无法设置该字段。
REQUIRED_NONEMPTY_LIST 必填的重复字段为空。
FIELD_CANNOT_BE_CLEARED 此字段无法清除。
BLOCKED_VALUE 字段的值在此字段的拒绝列表中。
FIELD_CAN_ONLY_BE_CLEARED 除清除外,无法修改此字段的值。

MutateError

用于描述可能的更改错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不支持收到的错误代码。
RESOURCE_NOT_FOUND 找不到所请求的资源。
ID_EXISTS_IN_MULTIPLE_MUTATES 在一个请求中,不能对同一资源进行两次更改。
INCONSISTENT_FIELD_VALUES 字段的内容与表示相同数据的另一个字段不匹配。
MUTATE_NOT_ALLOWED 不允许对请求的资源进行更改。
RESOURCE_NOT_IN_GOOGLE_ADS 资源不在 Google Ads 中。它属于其他广告系统。
RESOURCE_ALREADY_EXISTS 要创建的资源已存在。
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY 此资源不能与“validateOnly”搭配使用。
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE 此操作不能与“partialFailure”搭配使用。
RESOURCE_READ_ONLY 尝试写入只读字段。

NotAllowlistedError

用于描述可能未列入许可名单的错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不支持收到的错误代码。
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 客户未列入可使用该功能的许可名单。

StringFormatError

用于描述可能的字符串格式错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不支持收到的错误代码。
ILLEGAL_CHARS 输入字符串值包含不允许使用的字符。
INVALID_FORMAT 关联字段的输入字符串值无效。

StringLengthError

用于描述可能的字符串长度错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不支持收到的错误代码。
EMPTY 指定的字段应包含至少一个非空白字符。
TOO_SHORT 太短。
TOO_LONG 过长。

OperatingSystemVersionConstant

移动操作系统版本或版本范围,具体取决于 operatorType。可用移动平台列表:https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

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

string

仅限输出。操作系统版本常量的资源名称。操作系统版本常量资源名称采用以下形式:

operatingSystemVersionConstants/{criterionId}

operatorType

enum (OperatingSystemVersionOperatorType)

仅限输出。确定此常量是代表单个版本还是版本范围。

id

string (int64 format)

仅限输出。操作系统版本的 ID。

name

string

仅限输出。操作系统的名称。

osMajorVersion

integer

仅限输出。操作系统主要版本号。

osMinorVersion

integer

仅限输出。操作系统次要版本号。

OperatingSystemVersionOperatorType

操作系统版本的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
EQUALS_TO 等于指定的版本。
GREATER_THAN_EQUALS_TO 大于或等于指定的版本。

PaidOrganicSearchTermView

“付费自然搜索字词”视图会按广告组级别汇总广告和自然搜索结果的搜索统计信息,以便您一目了然。

JSON 表示法
{
  "resourceName": string,
  "searchTerm": string
}
字段
resourceName

string

仅限输出。搜索字词视图的资源名称。搜索字词视图资源名称采用以下格式:

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

searchTerm

string

仅限输出。搜索字词。

QualifyingQuestion

潜在客户表单的甄别问题。

JSON 表示法
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
字段
resourceName

string

仅限输出。限定问题的资源名称。

'qualifyingQuestions/{qualifyingQuestionId}'

qualifyingQuestionId

string (int64 format)

仅限输出。甄别问题的 ID。

locale

string

仅限输出。甄别问题的语言区域。

text

string

仅限输出。甄别问题。

ParentalStatusView

育儿状况视图。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。家长控制状态视图的资源名称。家长控制状态视图资源名称的格式为:

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

PerStoreView

按商店的视图。此视图可为广告客户提供按商店划分的展示次数覆盖面和本地操作转化统计信息。

JSON 表示法
{
  "resourceName": string,
  "placeId": string
}
字段
resourceName

string

仅限输出。按实体店视图的资源名称。每家商店视图资源名称的格式如下:

customers/{customerId}/perStoreViews/{placeId}

placeId

string

仅限输出。按实体店查看时所需的地点 ID。

ProductCategoryConstant

商品类别。

JSON 表示法
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
字段
resourceName

string

仅限输出。商品类别的资源名称。商品类别资源名称采用以下格式:

productCategoryConstants/{level}~{categoryId}

categoryId

string (int64 format)

仅限输出。商品类别的 ID。

此 ID 相当于本文中所述的 google_product_category ID:https://support.google.com/merchants/answer/6324436

level

enum (ProductCategoryLevel)

仅限输出。商品类别的级别。

state

enum (ProductCategoryState)

仅限输出。商品类别的状态。

localizations[]

object (ProductCategoryLocalization)

仅限输出。商品类别的所有可用本地化版本的列表。

productCategoryConstantParent

string

仅限输出。父级商品类别的资源名称。

ProductCategoryState

用于描述商品类别状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 相应类别已启用。
OBSOLETE 此类别已过时。仅用于生成报告。

ProductCategoryLocalization

商品类别的本地化。

JSON 表示法
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
字段
regionCode

string

仅限输出。本地化类别的 ISO 3166-1 国家/地区代码(两个字母,采用大写形式)。

languageCode

string

仅限输出。本地化类别的 ISO 639-1 双字母语言代码。

value

string

仅限输出。指定语言区域中的类别名称。

ProductGroupView

产品组视图。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。商品组视图的资源名称。产品组视图资源名称采用以下格式:

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

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

购物广告效果视图。提供按多个产品维度级别汇总的购物广告系列统计信息。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

包含可能的 UserInterestTaxonomyType 的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
AFFINITY 此用户兴趣的相似度。
IN_MARKET 此用户兴趣的市场。
MOBILE_APP_INSTALL_USER 已知已安装指定类别应用的用户。
VERTICAL_GEO 基于兴趣的行业的地理位置。
NEW_SMART_PHONE_USER 面向智能手机新用户的用户兴趣条件。

LifeEvent

人生大事:一种基于兴趣的特定行业,可用于在用户面临人生重大事件时触达他们。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
字段
resourceName

string

仅限输出。人生大事的资源名称。生命事件资源名称的格式为:

customers/{customerId}/lifeEvents/{lifeEventId}

id

string (int64 format)

仅限输出。人生大事的 ID。

name

string

仅限输出。人生大事的名称,例如“最近搬家”

parent

string

仅限输出。lifeEvent 的父级。

launchedToAll

boolean

仅限输出。如果直播活动面向所有频道和语言区域发布,则为 true。

availabilities[]

object (CriterionCategoryAvailability)

仅限输出。人生大事的可用性信息。

UserLocationView

用户位置信息视图。

“用户所在位置”视图包含在国家/地区一级汇总的所有指标,每个国家/地区一行。它会按定位到或未定位到的位置报告用户实际所处位置的指标。如果使用其他细分受众群字段,则每个国家/地区可能会有多个行。

JSON 表示法
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
字段
resourceName

string

仅限输出。用户位置信息视图的资源名称。UserLocation 视图资源名称采用以下格式:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

仅限输出。国家/地区的条件 ID。

targetingLocation

boolean

仅限输出。指明是否定位到地理位置。

TopicConstant

您可以使用主题,根据展示位置所属的类别(例如“宠物和动物/宠物/狗”)来定位或排除 Google 展示广告网络中的展示位置。

JSON 表示法
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
字段
resourceName

string

仅限输出。主题常量的资源名称。主题常量资源名称的格式为:

topicConstants/{topic_id}

path[]

string

仅限输出。要定位或排除的类别。数组中的每个后续元素都描述了更具体的子类别。例如,{"Pets & Animals", "Pets", "Dogs"} 表示“宠物与动物/宠物/狗”类别。可用主题类别列表:https://developers.google.com/google-ads/api/reference/data/verticals

id

string (int64 format)

仅限输出。主题的 ID。

topicConstantParent

string

仅限输出。主题常量的父级资源名称。

视频

视频。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
字段
resourceName

string

仅限输出。视频的资源名称。视频资源名称的格式为:

customers/{customerId}/videos/{videoId}

id

string

仅限输出。视频的 ID。

channelId

string

仅限输出。视频的所有者频道 ID。

durationMillis

string (int64 format)

仅限输出。视频的时长(以毫秒为单位)。

title

string

仅限输出。视频的标题。

WebpageView

网页浏览。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

仅限输出。网页视图的资源名称。网页视图资源名称采用以下格式:

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

LeadFormSubmissionData

潜在客户表单提交数据。

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

string

仅限输出。潜在客户表单提交数据的资源名称。潜在客户表单提交数据资源名称采用以下格式:

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

仅限输出。此潜在客户表单提交内容的 ID。

asset

string

仅限输出。与提交的潜在客户表单相关联的素材资源。

campaign

string

仅限输出。与提交的潜在客户表单相关联的广告系列。

leadFormSubmissionFields[]

object (LeadFormSubmissionField)

仅限输出。与潜在客户表单相关联的提交数据。

customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

仅限输出。与自定义潜在客户表单关联的提交数据。

adGroup

string

仅限输出。与提交的潜在客户表单关联的广告组。

adGroupAd

string

仅限输出。与提交的潜在客户表单相关联的 AdGroupAd。

gclid

string

仅限输出。与未填写的潜在客户表单相关联的 Google 点击 ID。

submissionDateTime

string

仅限输出。潜在客户表单的提交日期和时间。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。

LeadFormSubmissionField

提交的潜在客户表单中的字段。

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

enum (LeadFormFieldUserInputType)

仅限输出。潜在客户表单字段的字段类型。

fieldValue

string

仅限输出。潜在客户表单字段的字段值。

CustomLeadFormSubmissionField

提交的自定义问题中的字段

JSON 表示法
{
  "questionText": string,
  "fieldValue": string
}
字段
questionText

string

仅限输出。自定义题目的题目文本,字符数上限为 300。

fieldValue

string

仅限输出。自定义问题回答的字段值,字符数上限为 70。

LocalServicesLead

来自本地生活服务潜在客户的数据。包含潜在客户的详细信息。潜在客户是在用户向广告客户致电、发送消息或预约服务时生成的。了解详情:https://ads.google.com/local-services-ads

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "note": {
    object (Note)
  },
  "creditDetails": {
    object (CreditDetails)
  }
}
字段
resourceName

string

仅限输出。本地服务潜在客户数据的资源名称。本地生活服务潜在客户资源名称的格式为

customers/{customerId}/localServicesLead/{local_services_lead_id}

id

string (int64 format)

仅限输出。此潜在客户的 ID。

categoryId

string

仅限输出。潜在客户的服务类别。例如:xcat:service_area_business_hvacxcat:service_area_business_real_estate_agent 等。如需了解详情,请参阅:https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids

serviceId

string

仅限输出。相应类别的服务。例如:buyer_agentseller_agent 用于 xcat:service_area_business_real_estate_agent 类别。

contactDetails

object (ContactDetails)

仅限输出。潜在客户的详细联系信息。

leadType

enum (LeadType)

仅限输出。本地生活服务潜在客户的类型:来电、短信、预约等

leadStatus

enum (LeadStatus)

仅限输出。潜在客户的当前状态。

creationDateTime

string

仅限输出。本地生活服务广告创建潜在客户的日期时间。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

locale

string

仅限输出。与潜在客户相关联的本地生活服务提供商使用的语言。请参阅 https://developers.google.com/google-ads/api/data/codes-formats#locales

leadCharged

boolean

仅限输出。如果广告客户为潜在客户支付了费用,则为 true。

note

object (Note)

仅限输出。广告客户为潜在客户添加的备注。

creditDetails

object (CreditDetails)

仅限输出。潜在客户的赠金详情。

ContactDetails

包含消费者详细联系信息的字段。

JSON 表示法
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
字段
phoneNumber

string

仅限输出。采用 E.164 格式的消费者电话号码。

email

string

仅限输出。消费者的电子邮件地址。

consumerName

string

仅限输出。如果消费者在 google.com 上的“消息”或“预订”表单中提供了姓名,请提供该姓名

LeadType

可能的潜在客户类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
MESSAGE 消息类潜在客户。
PHONE_CALL 通过来电创建的潜在客户。
BOOKING 预订潜在客户信息。

LeadStatus

潜在客户的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
NEW 广告客户尚未看到的新潜在客户。
ACTIVE 广告客户互动过的潜在客户。
BOOKED 潜在客户已预订。
DECLINED 广告客户拒绝了潜在客户。
EXPIRED 潜在客户因闲置而过期。
DISABLED 因垃圾内容或争议而被停用。
CONSUMER_DECLINED 使用方拒绝了潜在客户。
WIPED_OUT 系统会清除潜在客户的个人身份信息。

备注

表示广告客户为潜在客户添加的备注。广告客户可以修改备注,这会重置修改时间并更改说明。

JSON 表示法
{
  "editDateTime": string,
  "description": string
}
字段
editDateTime

string

仅限输出。潜在客户备注的修改日期时间。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

description

string

仅限输出。主备注的内容。

CreditDetails

表示潜在客户的信用详细信息。

JSON 表示法
{
  "creditState": enum (CreditState),
  "creditStateLastUpdateDateTime": string
}
字段
creditState

enum (CreditState)

仅限输出。潜在客户的信用状态。

creditStateLastUpdateDateTime

string

仅限输出。潜在客户的信用状态上次更新的日期时间。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

CreditState

潜在客户的可能功劳状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
PENDING 赠送金额已提交,正在由 Google Ads 后端处理,但尚未应用于账号。
CREDITED 赠金已发放至 Google Ads 账号。

LocalServicesLeadConversation

来自本地生活服务潜在客户对话的数据。包含潜在客户对话的详细信息,这些信息是在用户向广告客户致电、发送消息或预约服务时生成的。这些信息会附加到潜在客户中。了解详情:https://ads.google.com/local-services-ads

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "conversationChannel": enum (ConversationType),
  "participantType": enum (ParticipantType),
  "lead": string,
  "eventDateTime": string,
  "phoneCallDetails": {
    object (PhoneCallDetails)
  },
  "messageDetails": {
    object (MessageDetails)
  }
}
字段
resourceName

string

仅限输出。本地生活服务潜在客户对话数据的资源名称。本地生活服务潜在客户对话资源名称采用以下格式

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}

id

string (int64 format)

仅限输出。此潜在客户对话的 ID。

conversationChannel

enum (ConversationType)

仅限输出。GLS 潜在客户对话类型,例如 EMAIL、MESSAGE、PHONE_CALL、SMS 等

participantType

enum (ParticipantType)

仅限输出。潜在对话中的参与者类型,即广告客户或消费者。

lead

string

仅限输出。与潜在客户对话关联的潜在客户的资源名称。

eventDateTime

string

仅限输出。本地生活服务广告创建潜在客户对话的日期时间。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

phoneCallDetails

object (PhoneCallDetails)

仅限输出。如果是 PHONE_CALL,则包含通话对话的详细信息。

messageDetails

object (MessageDetails)

仅限输出。如果是电子邮件、消息或短信,请提供消息对话的详细信息。

ConversationType

可能的潜在客户对话类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
EMAIL 电子邮件潜在客户对话。
MESSAGE 短信咨询的潜在客户对话。
PHONE_CALL 来电潜在客户对话。
SMS 短信潜在客户对话。
BOOKING 预约潜在客户对话。

ParticipantType

主要对话参与者的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ADVERTISER 本地生活服务广告提供商参与者。
CONSUMER 本地生活服务广告消费者参与者。

PhoneCallDetails

表示通话对话的详细信息。

JSON 表示法
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
字段
callDurationMillis

string (int64 format)

仅限输出。通话时长(端到端,以毫秒为单位)。

callRecordingUrl

string

仅限输出。通话录音音频文件的网址。

MessageDetails

表示电子邮件、消息或短信的文本消息详情。

JSON 表示法
{
  "text": string,
  "attachmentUrls": [
    string
  ]
}
字段
text

string

仅限输出。消息的文本内容。

attachmentUrls[]

string

仅限输出。短信或电子邮件附件的网址。您可以使用开发者令牌通过这些网址下载附件的相应内容。

AndroidPrivacySharedKeyGoogleAdGroup

适用于 Google 广告组键的 Android 隐私共享键视图。

JSON 表示法
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "adGroupId": string,
  "sharedAdGroupKey": string
}
字段
resourceName

string

仅限输出。Android 隐私权共享密钥的资源名称。Android 隐私权共享密钥资源名称采用以下格式:

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

campaignId

string (int64 format)

仅限输出。分享键编码中使用的广告系列 ID。

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

仅限输出。分享键编码中使用的互动类型枚举。

androidPrivacyInteractionDate

string

仅限输出。在共享密钥编码中使用的互动日期,采用“YYYY-MM-DD”格式(世界协调时间 [UTC] 时区)。

androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

仅限输出。共享密钥编码中使用的网络类型枚举。

adGroupId

string (int64 format)

仅限输出。在共享键编码中使用的广告组 ID。

sharedAdGroupKey

string

仅限输出。编码后的共享广告组键的 128 位十六进制字符串,包括“0x”前缀。此键可用于与汇总转化键执行按位或运算,以创建完整的汇总键,以便在 Android Privacy Sandbox 中检索汇总 API 报告。

AndroidPrivacyInteractionType

枚举互动类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
CLICK 实体点击互动类型。
ENGAGED_VIEW 10 秒感兴趣的观看互动类型。
VIEW 观看(广告展示)互动类型。

AndroidPrivacyNetworkType

枚举网络类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
SEARCH 搜索网络。
DISPLAY 展示广告网络。
YOUTUBE YouTube 广告网络。

AndroidPrivacySharedKeyGoogleCampaign

适用于 Google 广告系列键的 Android 隐私共享密钥视图。

JSON 表示法
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "sharedCampaignKey": string
}
字段
resourceName

string

仅限输出。Android 隐私权共享密钥的资源名称。Android 隐私权共享密钥资源名称采用以下格式:

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

campaignId

string (int64 format)

仅限输出。分享键编码中使用的广告系列 ID。

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

仅限输出。分享键编码中使用的互动类型枚举。

androidPrivacyInteractionDate

string

仅限输出。在共享密钥编码中使用的互动日期,采用“YYYY-MM-DD”格式(世界协调时间 [UTC] 时区)。

sharedCampaignKey

string

仅限输出。编码后的共享广告系列键的 128 位十六进制字符串,包括“0x”前缀。此键可用于与汇总转化键执行按位或运算,以创建完整的汇总键,以便在 Android Privacy Sandbox 中检索汇总 API 报告。

AndroidPrivacySharedKeyGoogleNetworkType

适用于 Google 网络类型键的 Android 隐私共享密钥视图。

JSON 表示法
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "sharedNetworkTypeKey": string
}
字段
resourceName

string

仅限输出。Android 隐私权共享密钥的资源名称。Android 隐私权共享密钥资源名称采用以下格式:

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

campaignId

string (int64 format)

仅限输出。分享键编码中使用的广告系列 ID。

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

仅限输出。分享键编码中使用的互动类型枚举。

androidPrivacyInteractionDate

string

仅限输出。在共享密钥编码中使用的互动日期,采用“YYYY-MM-DD”格式(世界协调时间 [UTC] 时区)。

androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

仅限输出。共享密钥编码中使用的网络类型枚举。

sharedNetworkTypeKey

string

仅限输出。编码后的共享网络类型键的 128 位十六进制字符串,包括“0x”前缀。此键可用于与汇总转化键执行按位或运算,以创建完整的汇总键,以便在 Android Privacy Sandbox 中检索汇总 API 报告。

指标

指标数据。

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

number

所有转化的价值。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009

allConversionsByConversionDate

number

转化总次数。包括所有转化,无论 includeInConversionsMetric 的值如何。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009

conversionsValueByConversionDate

number

转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009

conversionsByConversionDate

number

转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009

historicalCreativeQualityScore

enum (QualityScoreBucket)

广告素材的历史质量得分。

historicalLandingPageQualityScore

enum (QualityScoreBucket)

历史着陆页体验的质量。

historicalSearchPredictedCtr

enum (QualityScoreBucket)

历史搜索的预测点击率 (CTR)。

interactionEventTypes[]

enum (InteractionEventType)

付费和免费互动的类型。

skAdNetworkInstalls

string (int64 format)

iOS Store Kit 广告联盟转化次数。

skAdNetworkTotalConversions

string (int64 format)

iOS Store Kit 广告联盟转化的总次数。

publisherPurchasedClicks

string (int64 format)

来自并非由发布商所拥有的媒体资源的点击,其流量是由发布商付费或通过奖励活动获得的

publisherOrganicClicks

string (int64 format)

来自媒体资源的点击,其流量不是由发布商付费或通过奖励活动获得的

publisherUnknownClicks

string (int64 format)

来自未被标识为“发布商购买”或“发布商自然”的流量的点击

absoluteTopImpressionPercentage

number

“搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。

activeViewCpm

number

可见展示的平均费用 (activeViewImpressions)。

activeViewCtr

number

Active View 可衡量的点击次数除以 Active View 可见的展示次数。

系统仅会针对展示广告网络报告此指标。

activeViewImpressions

string (int64 format)

衡量广告在展示广告网络网站上的可见频率。

activeViewMeasurability

number

Active View 可衡量的展示次数与投放展示次数之比。

activeViewMeasurableCostMicros

string (int64 format)

Active View 可衡量的您获得的展示费用。

activeViewMeasurableImpressions

string (int64 format)

广告出现在可见位置中的展示位置的次数。

activeViewViewability

number

广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。

allConversionsFromInteractionsRate

number

互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。

allConversionsValue

number

所有转化的值。

allNewCustomerLifetimeValue

number

所有新客户的生命周期转化价值。如果您在账号一级或广告系列一级设置了“新客户获取”目标,则此指标将包括可出价和不可出价转化带来的新客户额外转化价值。如果您的广告系列采用了“客户获取”目标,并选择了“针对新客户提高出价”,则这些价值将包含在“allConversionsValue”中。如需了解详情,请参阅 https://support.google.com/google-ads/answer/12080169

allConversions

number

转化总次数。包括所有转化,无论 includeInConversionsMetric 的值如何。

allConversionsValuePerCost

number

所有转化的价值除以广告互动(例如文字广告的点击次数或视频广告的观看次数)的总费用。

allConversionsFromClickToCall

number

用户在广告展示过程中或点击广告后,点击“致电”按钮向相应实体店致电的次数。此数值不考虑致电是否接通,也不考虑通话时长。

此指标仅适用于 Feed 项。

allConversionsFromDirections

number

用户在点击广告后,点击“查询路线”按钮导航到相应实体店的次数。

此指标仅适用于 Feed 项。

allConversionsFromInteractionsValuePerInteraction

number

互动带来的所有转化价值除以互动总次数。

allConversionsFromMenu

number

用户在点击广告后,点击链接查看相应实体店的菜单的次数。

此指标仅适用于 Feed 项。

allConversionsFromOrder

number

用户在点击广告后,在相应商店下单的次数。

此指标仅适用于 Feed 项。

allConversionsFromOtherEngagement

number

用户在点击广告后发生的其他转化(例如,发布对商店的评价或保存该商店的地理位置)的次数。

此指标仅适用于 Feed 项。

allConversionsFromStoreVisit

number

用户在点击广告后光顾相应商店的次数估算值。

此指标仅适用于 Feed 项。

allConversionsFromStoreWebsite

number

用户在点击广告后,转到相应商店网址的次数。

此指标仅适用于 Feed 项。

auctionInsightSearchAbsoluteTopImpressionPercentage

number

此指标属于“竞价分析”报告的一部分,用于显示其他参与者的广告在搜索结果页上最醒目的位置展示的频率。此百分比仅根据您在网页中展示的竞价计算得出。

此指标不公开。

auctionInsightSearchImpressionShare

number

此指标属于“竞价分析”报告的一部分,表示其他参与者获得的展示次数占您广告有资格获得的总展示次数的百分比。任何低于 0.1 的值都会报告为 0.0999。

此指标不公开。

auctionInsightSearchOutrankingShare

number

此指标属于“竞价分析”报告的一部分,表示您的广告在竞价中胜过(展示在)其他参与者的广告的展示次数占您广告有资格获得的总展示次数的百分比。任何低于 0.1 的值都会报告为 0.0999。

此指标不公开。

auctionInsightSearchOverlapRate

number

此指标属于“竞价分析”报告,用于反映在您的广告获得展示机会的同时,其他参与者的广告也获得展示机会的频率。

此指标不公开。

auctionInsightSearchPositionAboveRate

number

此指标是竞价分析报告的一部分,用于显示当您与其他参与者的广告同时在同一网页上展示时,该参与者的广告在排名上高过您的频率。

此指标不公开。

auctionInsightSearchTopImpressionPercentage

number

此指标属于“竞价分析”报告的一部分,用于显示其他参与者的广告在顶部自然搜索结果邻近位置展示的频率。此百分比仅根据您在网页中展示的竞价计算得出。

此指标不公开。

averageCost

number

您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。

averageCpc

number

所有点击总费用除以获得的总点击次数。

averageCpe

number

您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。

averageCpm

number

平均每千次展示费用 (CPM)。

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

您的广告或网站的商品详情在未付费结果中的点击次数 (combinedClicks) 除以 combinedQueries。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。

combinedQueries

string (int64 format)

在未付费结果中返回您的网站的网页或展示一个文字广告的搜索次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。

contentBudgetLostImpressionShare

number

您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意:内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

contentImpressionShare

number

您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

conversionLastReceivedRequestDateTime

string

此转化操作的转化跟踪代码上次成功触发并被 Google Ads 检测到的时间。此触发事件可能不是可归因转化的结果(例如,因为代码是从之前未点击相应广告客户的广告的浏览器触发的)。日期/时间采用客户的时区。

conversionLastConversionDate

string

此转化操作的最近一次转化日期。日期采用客户所在的时区。

contentRankLostImpressionShare

number

您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

conversionsFromInteractionsRate

number

互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

conversionsValue

number

转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

newCustomerLifetimeValue

number

新客户的生命周期转化价值。如果您在账号一级或广告系列一级设置了客户获取目标,则此指标将包含可出价转化带来的新客户的额外转化价值。如果您的广告系列采用了“客户获取”目标,并选择了“针对新客户提高出价”,系统会将这些价值纳入“conversionsValue”中进行优化。如需了解详情,请参阅 https://support.google.com/google-ads/answer/12080169

conversionsValuePerCost

number

转化价值除以广告互动费用。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

conversionsFromInteractionsValuePerInteraction

number

互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

conversions

number

转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

costMicros

string (int64 format)

在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。

costPerAllConversions

number

广告互动费用除以所有转化次数。

costPerConversion

number

广告互动费用除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

costPerCurrentModelAttributedConversion

number

广告互动费用除以当前模型归因转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

crossDeviceConversions

number

客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 allConversions 中。

crossDeviceConversionsValueMicros

string (int64 format)

跨设备转化的价值的总和(以微单位表示)。

ctr

number

广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。

currentModelAttributedConversions

number

显示历史转化数据在您目前选择的归因模型下的情况。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

currentModelAttributedConversionsFromInteractionsRate

number

当前模型归因的互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

当前模型归因的互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

currentModelAttributedConversionsValue

number

当前模型归因转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

currentModelAttributedConversionsValuePerCost

number

当前模型归因转化的价值除以广告互动费用。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

engagementRate

number

在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。

engagements

string (int64 format)

深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。

hotelAverageLeadValueMicros

number

基于点击次数计算的平均潜在客户价值。

hotelCommissionRateMicros

string (int64 format)

佣金出价率(以微单位表示)。20% 的佣金表示为 200,000。

hotelExpectedCommissionCost

number

预计佣金费用。佣金金额乘以广告客户币种的 hotel_commission_rate 的结果。

hotelPriceDifferencePercentage

number

举报酒店广告客户提供的价格与竞争广告客户提供的最低价格之间的平均差价。

hotelEligibleImpressions

string (int64 format)

酒店合作伙伴本可获得的展示次数(根据其 Feed 效果)。

historicalQualityScore

string (int64 format)

历史质量得分。

gmailForwards

string (int64 format)

广告以邮件形式转发给其他人的次数。

gmailSaves

string (int64 format)

某人将 Gmail 广告以邮件形式保存到收件箱的次数。

gmailSecondaryClicks

string (int64 format)

Gmail 广告展开状态下的着陆页点击次数。

impressionsFromStoreReach

string (int64 format)

商店特定营业点的广告所展示的次数。

此指标仅适用于 Feed 项。

impressions

string (int64 format)

广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。

interactionRate

number

在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。

interactions

string (int64 format)

互动次数。互动是指与某种广告格式关联的主用户操作:对于文字广告和购物广告而言是点击,对于视频广告而言是观看,诸如此类。

invalidClickRate

number

报告期内从总点击次数(过滤后 + 未过滤的点击次数)过滤出的点击次数所占的百分比。

invalidClicks

string (int64 format)

Google 认为不合规定且不向您收费的点击次数。

messageChats

string (int64 format)

针对符合消息跟踪条件的“点击即可发消息”展示次数发起的消息聊天数量。

messageImpressions

string (int64 format)

符合消息跟踪条件的“点击即可发消息”展示次数。

messageChatRate

number

发起的消息聊天次数 (messageChats) 除以消息展示次数 (messageImpressions)。在启用了消息功能和消息跟踪的广告展示中,用户发起消息聊天所占的比率。请注意,给定消息展示的点击率可能高于 1.0。

mobileFriendlyClicksPercentage

number

适合移动设备的页面的移动点击次数所占的百分比。

optimizationScoreUplift

number

采纳所有建议后的优化得分总提升幅度。

optimizationScoreUrl

string

Google Ads 网页界面中优化得分页面的网址。此指标可从 customercampaign 中选择,并且可按 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

某人点击未付费结果中您网站的商品详情的次数 (organicClicks) 除以返回您网站的网页的总搜索次数 (organicQueries)。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。

organicImpressions

string (int64 format)

未付费搜索结果中您的网站的商品详情数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。

organicImpressionsPerQuery

number

您的网站的网页在未付费搜索结果中列出的次数 (organicImpressions) 除以在未付费结果中返回您的网站的商品详情的搜索次数 (organicQueries)。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。

organicQueries

string (int64 format)

在未付费结果中返回您的网站的商品详情的总搜索次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。

percentNewVisitors

number

首次会话数(来自之前从未访问过您的网站的用户)所占的百分比。自 Google Analytics 导入。

phoneCalls

string (int64 format)

离线通话次数。

phoneImpressions

string (int64 format)

离线电话号码展示次数。

phoneThroughRate

number

接听的电话次数 (phoneCalls) 除以电话号码展示次数 (phoneImpressions)。

relativeCtr

number

您的点击率 (Ctr) 除以展示您的广告的网站上所有广告主的平均点击率。衡量您的广告与同一网站上的其他广告相比在展示广告网络中的效果。

searchAbsoluteTopImpressionShare

number

在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请参阅 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。

searchBudgetLostAbsoluteTopImpressionShare

number

此数字用于估算您的广告因预算不足而未能在搜索结果中的页首广告中作为头条广告进行展示的频率。注意:搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchBudgetLostImpressionShare

number

您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchBudgetLostTopImpressionShare

number

此数字用于估算您的广告因预算低而未能在顶部自然搜索结果邻近位置展示的频率。注意:搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchClickShare

number

您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意:搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

searchExactMatchImpressionShare

number

对于与关键字完全匹配(或是关键字的紧密变体形式)的搜索字词,此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意:搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

searchImpressionShare

number

您在搜索网络中获得的展示次数除以您有资格获得的估算展示次数。注意:在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

searchRankLostAbsoluteTopImpressionShare

number

此数字用于估算您的广告因广告评级较低而未能在搜索结果中的页首广告中作为头条广告进行展示的频率。注意:搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchRankLostImpressionShare

number

您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchRankLostTopImpressionShare

number

此数字用于估算您的广告因广告评级差而未能在顶部自然搜索结果邻近位置展示的频率。注意:搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchTopImpressionShare

number

您在页首广告中实际获得的展示次数除以您有资格获得的估算展示次数所得到的百分比。注意:搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

页首广告通常展示在顶部自然搜索结果上方,但在某些查询中,页首广告可能会展示在顶部自然搜索结果下方。

searchVolume

object (SearchVolumeRange)

搜索字词数据分析类别的搜索量范围。

speedScore

string (int64 format)

衡量点击移动广告后网页加载的速度。得分范围介于 1 到 10 之间,10 是最快的。

averageTargetCpaMicros

string (int64 format)

平均目标每次转化费用,如果不可用则不设置(例如,对于获得了组合出价策略或非目标每次转化费用出价策略带来的流量的广告系列)。

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

在任何营业地点展示面上获得展示后,网站网址获得的点击次数。此衡量标准来自基于素材资源的地理位置。

orders

number

“订单数”是指广告为您带来的购买转化总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果某次转化是由于用户之前与您广告的互动(点击文字广告或购物广告、观看视频广告等)带来的,系统会将其计为一笔订单。示例:某用户点击了宣传一款帽子的购物广告,然后在您的网站上下单购买了该帽子和一件衬衫。虽然该用户购买了 2 件商品,但仍会计为 1 笔订单。此指标仅在您报告了含购物车数据的转化的情况下可用。

averageOrderValueMicros

string (int64 format)

“平均订单价值”是指广告促成的每笔订单带来的平均收入。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。系统会用订单带来的总收入除以订单总数,计算出平均订单价值。示例:您收到了 3 笔订单,它们分别带来了 10 美元、15 美元和 20 美元的收入。平均订单价值为 15 美元,计算方法为:(10 美元 + 15 美元 + 20 美元)/3。此指标仅在您报告了含购物车数据的转化的情况下可用。

averageCartSize

number

“平均购物车内商品数量”是指广告带来的每个订单的平均商品数量。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。系统会用所售商品总数除以您获得的订单总数,计算出平均购物车内商品数量。示例:您获得了 2 个订单,第一个订单包含 3 件商品,第二个订单包含 2 件商品。平均购物车内商品数量即为 2.5 件商品,计算方法为:(3+2)/2。此指标仅在您报告了含购物车数据的转化的情况下可用。

costOfGoodsSoldMicros

string (int64 format)

“所售商品的成本”(COGS) 是指广告促成的订单中所售产品的总成本。运作方式:您可以在 Merchant Center 中为每个产品添加销货成本价值。如果您报告含购物车数据的转化,系统会将所售产品与其销货成本价值进行匹配,并可据此计算每笔订单的毛利润。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。那么,这笔订单的销货成本就是:8 美元 = 3 美元 + 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。

grossProfitMicros

string (int64 format)

毛利润是指扣除销货成本 (COGS) 后,归因于广告的订单所产生的利润。运作方式:毛利润是指扣除销货成本后,归因于广告的销售所带来的收益。在计算毛利润时,只会涵盖在 Merchant Center 中具有销货成本值的产品。示例:客户点击了宣传某款帽子的购物广告,然后在您的网站上下单购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,衬衫的价格为 20 美元。帽子的销货成本值为 3 美元,但衬衫没有销货成本值。在计算此订单的毛利润时,仅会考虑帽子,因此毛利润为 7 美元(10 美元 - 3 美元)。此指标仅在您报告了含购物车数据的转化的情况下可用。

grossProfitMargin

number

“毛利润率”是指在扣除销货成本 (COGS) 后,广告促成的订单带来的毛利润所占的百分比。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。毛利润率是指用所得毛利润除以总收入,然后再乘 100%,计算得出的值。计算毛利润率时,只会纳入 Merchant Center 中具有销货成本价值的产品。示例:客户在您的网站上下单购买了帽子和衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。衬衫的价格为 20 美元,但没有销货成本价值。这笔订单中只有帽子有销货成本价值,因此计算毛利润率时只会将帽子考虑在内,也就是 70% =(10 美元 - 3 美元)/10 美元 x 100%。此指标仅在您报告了含购物车数据的转化的情况下可用。

revenueMicros

string (int64 format)

“收入”是指您从广告促成的订单中赚到的总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。广告促成的所有订单的总价值减去所有折扣即为收入。示例:客户点击了宣传某款帽子的购物广告,然后在您的网站上下单购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。整个订单有 5 美元的折扣。那么,这笔订单的收入就是:25 美元 =(10 美元 + 20 美元)- 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。

unitsSold

number

“售出数量”是指广告促成的订单中的售出产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。“售出数量”是指广告促成的所有订单中的售出产品的总数。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,售出数量为 3。此指标仅在您报告了含购物车数据的转化的情况下可用。

crossSellCostOfGoodsSoldMicros

string (int64 format)

“作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的销货成本为 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。

crossSellGrossProfitMicros

string (int64 format)

“作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的其他产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。衬衫的价格为 20 美元,其销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的毛利润就是:15 美元 = 20 美元 - 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。

crossSellRevenueMicros

string (int64 format)

“作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售所产生的总价值。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为交叉销售产品时的收入为 20 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。

crossSellUnitsSold

number

“作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。

leadCostOfGoodsSoldMicros

string (int64 format)

“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些货品的成本会计入“作为主推产品时的销货成本”。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为主推产品时的销货成本为 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。

leadGrossProfitMicros

string (int64 format)

“作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的同一产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。在这笔订单中,作为主推产品时的毛利润就是:7 美元 = 10 美元 - 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。

leadRevenueMicros

string (int64 format)

“作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为主推产品时的收入为 10 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。

leadUnitsSold

number

“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些售出产品的总数会计入“作为主推产品时的销量”。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。

uniqueUsers

string (int64 format)

在指定时间段内看到您广告的唯一身份用户数。此指标无法汇总,并且只能针对 92 天以内的日期范围进行请求。此指标适用于以下广告系列类型:展示广告系列、视频广告系列、发现广告系列和应用广告系列。

averageImpressionFrequencyPerUser

number

在指定时间段内,唯一身份用户看到您广告的平均次数。此指标无法汇总,并且只能针对 92 天以内的日期范围进行请求。此指标适用于以下广告系列类型:展示广告系列、视频广告系列、发现广告系列和应用广告系列。

InteractionEventType

用于描述可能的付费和免费互动类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CLICK 点击即可访问网站。在大多数情况下,此互动会导航到外部位置,通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。
ENGAGEMENT 用户表达的意图,即在原地与广告互动。
VIDEO_VIEW 用户观看了视频广告。
NONE 广告转化事件的默认 InteractionEventType。如果广告转化行未指明应将非付费互动(例如广告转化)“提升”为核心指标并报告,则应使用此值。这些转化只是“其他(广告)转化”。

SearchVolumeRange

搜索量范围。实际搜索量在此范围内。

JSON 表示法
{
  "min": string,
  "max": string
}
字段
min

string (int64 format)

搜索量的下限。

max

string (int64 format)

搜索量的上限。

细分

仅细分字段。

JSON 表示法
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
字段
adDestinationType

enum (AdDestinationType)

广告目标类型。

adNetworkType

enum (AdNetworkType)

广告网络类型。

budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

预算与广告系列的关联状态。

clickType

enum (ClickType)

点击类型。

conversionActionCategory

enum (ConversionActionCategory)

转化操作类别。

conversionAttributionEventType

enum (ConversionAttributionEventType)

转化归因事件类型。

conversionLagBucket

enum (ConversionLagBucket)

一个枚举值,表示展示和转化之间的天数。

conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

一个枚举值,表示从展示到转化或从展示到调整转化所需的天数。

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)

一年中的月份,例如 1 月。

placeholderType

enum (PlaceholderType)

占位符类型。此字段仅适用于 Feed 项指标。

productChannel

enum (ProductChannel)

商品的渠道。

productChannelExclusivity

enum (ProductChannelExclusivity)

商品的渠道独占性。

productCondition

enum (ProductCondition)

商品的使用情况。

recommendationType

enum (RecommendationType)

推荐类型。

searchEngineResultsPageType

enum (SearchEngineResultsPageType)

搜索引擎结果页 (SERP) 的类型。

searchTermMatchType

enum (SearchTermMatchType)

触发广告展示的关键字的匹配类型,包括变体。

slot

enum (Slot)

广告的位置。

conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

应用的转化价值规则的主要维度。NO_RULE_APPLIED 显示未应用价值规则的转化记录的总价值。“原始价值”显示已应用价值规则的转化的原始价值。GEO_LOCATION、DEVICE、AUDIENCE 会显示应用价值规则后的净调整值。

skAdNetworkUserType

enum (SkAdNetworkUserType)

iOS Store Kit 广告网络用户类型。

skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

iOS Store Kit 广告网络广告事件类型。

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS Store Kit 广告联盟归因功劳

skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

iOS Store Kit 广告网络粗略转化价值。

skAdNetworkSourceType

enum (SkAdNetworkSourceType)

促成 iOS Store Kit Ad Network 安装的广告的展示来源类型。值为 null 表示此细分不适用,例如非 iOS 广告系列,或者 Apple 发送的任何回传中都没有来源网域或来源应用。

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

此维度用于按用户是新客户还是回头客对转化进行细分。此细分通常用于衡量“获取客户”目标的影响。

activityAccountId

string (int64 format)

活动账号 ID。

activityCity

string

相应旅行活动的提供城市。

activityCountry

string

相应旅行活动可供使用的国家/地区。

activityRating

string (int64 format)

活动评分。

activityState

string

相应旅行活动可供使用的州。

externalActivityId

string

广告客户提供的活动 ID。

adGroup

string

广告组的资源名称。

assetGroup

string

素材资源组的资源名称。

auctionInsightDomain

string

“竞价分析”报告中竞价参与者的网域(显示网址)。

campaign

string

广告系列的资源名称。

conversionAction

string

转化操作的资源名称。

conversionActionName

string

转化操作名称。

conversionAdjustment

boolean

此维度会按原始转化次数和转化价值与调整后的转化次数和转化价值的差异对转化列进行细分。“False”行包含原始声明的数据;而“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 之间(包括 0 和 23)的数字表示的时段。

interactionOnThisExtension

boolean

仅适用于 Feed 项指标。指示互动指标是发生在 Feed 项本身还是其他附加信息或广告单元中。

month

string

由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。

partnerHotelId

string

合作伙伴酒店 ID。

productAggregatorId

string (int64 format)

商品的集合商家 ID。

productCategoryLevel1

string

商品的类别(第 1 级)。

productCategoryLevel2

string

商品的类别(第 2 级)。

productCategoryLevel3

string

商品的类别(第 3 级)。

productCategoryLevel4

string

商品的类别(第 4 级)。

productCategoryLevel5

string

商品的类别(第 5 级)。

productBrand

string

商品的品牌。

productCountry

string

商品目标销售国家/地区的地理位置定位目标常量的资源名称。

productCustomAttribute0

string

商品的自定义属性 0。

productCustomAttribute1

string

商品的自定义属性 1。

productCustomAttribute2

string

商品的自定义属性 2。

productCustomAttribute3

string

商品的自定义属性 3。

productCustomAttribute4

string

商品的自定义属性 4。

productFeedLabel

string

商品的 Feed 标签。

productItemId

string

商品的项目 ID。

productLanguage

string

商品语言的语言常量的资源名称。

productMerchantId

string (int64 format)

商品的商家 ID。

productStoreId

string

商品的商店 ID。

productTitle

string

商品的名称。

productTypeL1

string

商品的类型(第 1 级)。

productTypeL2

string

商品的类型(第 2 级)。

productTypeL3

string

商品的类型(第 3 级)。

productTypeL4

string

商品的类型(第 4 级)。

productTypeL5

string

商品的类型(第 5 级)。

quarter

string

由一个季度第一天的日期表示的季度。对季度使用日历年,例如 2018 年第 2 季度从 2018 年 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 广告网络转化价值。值为 null 表示此细分不适用,例如非 iOS 广告系列。

skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

促成 iOS Store Kit Ad Network 安装的广告所展示的应用。值为 null 表示此细分受众群体不适用(例如,非 iOS 广告系列),或者未出现在 Apple 发送的任何回传中。

skAdNetworkSourceDomain

string

促成 iOS Store Kit Ad Network 安装的广告是在对应的网站中展示的。值为 null 表示此细分受众群体不适用(例如,非 iOS 广告系列),或者未出现在 Apple 发送的任何回传中。

skAdNetworkPostbackSequenceIndex

string (int64 format)

iOS Store Kit 广告网络回传顺序索引。

assetInteractionTarget

object (AssetInteractionTarget)

仅适用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。如果广告的所有部分(例如广告本身和附加链接等其他组件)一起投放,系统会统计这些部分获得的互动次数(例如点击次数)。如果 interactionOnThisAsset 为 true,则表示互动发生在此特定素材资源上;如果 interactionOnThisAsset 为 false,则表示互动并非发生在此特定素材资源上,而是发生在与此素材资源一起投放的广告的其他部分。

AdDestinationType

枚举 Google Ads 目标类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
NOT_APPLICABLE 广告不打算将用户从广告引导至其他目标页面
WEBSITE 网站
APP_STORE iOS App Store 或 Play 商店
PHONE_CALL 通话拨号器
MAP_DIRECTIONS 地图应用
LOCATION_LISTING 专门用于位置信息的页面
MESSAGE 短信
LEAD_FORM 潜在客户发掘表单
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS 转化广告目标页面键值未知

AdNetworkType

枚举 Google Ads 广告网络类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
SEARCH Google 搜索。
SEARCH_PARTNERS 搜索网络合作伙伴。
CONTENT 展示广告网络。
MIXED 跨广告网络。
YOUTUBE YouTube
GOOGLE_TV Google TV

BudgetCampaignAssociationStatus

BudgetCampaignAssociationStatus 细分。

JSON 表示法
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
字段
status

enum (BudgetCampaignAssociationStatus)

预算与广告系列的关联状态。

campaign

string

广告系列资源名称。

BudgetCampaignAssociationStatus

预算与广告系列之间关联的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 广告系列目前正在使用该预算。
REMOVED 广告系列不再使用该预算。

ClickType

枚举 Google Ads 点击类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
BREADCRUMBS 面包屑导航。
BROADBAND_PLAN 宽带套餐。
CALL_TRACKING 手动拨打的电话。
CALLS 来电。
CLICK_ON_ENGAGEMENT_AD 点击“互动广告”。
GET_DIRECTIONS 驾车方向。
LOCATION_EXPANSION 获取详细位置信息。
LOCATION_FORMAT_CALL 致电。
LOCATION_FORMAT_DIRECTIONS 路线。
LOCATION_FORMAT_IMAGE 图片。
LOCATION_FORMAT_LANDING_PAGE 前往着陆页。
LOCATION_FORMAT_MAP 地图。
LOCATION_FORMAT_STORE_INFO 前往商店信息。
LOCATION_FORMAT_TEXT 文本。
MOBILE_CALL_TRACKING 手机通话。
OFFER_PRINTS 打印优惠券。
OTHER 其他。
PRODUCT_EXTENSION_CLICKS 产品加号方块优惠信息。
PRODUCT_LISTING_AD_CLICKS 购物 - 产品 - 在线。
STORE_LOCATOR 显示附近的位置。
URL_CLICKS 标题。
VIDEO_APP_STORE_CLICKS 应用商店。
VIDEO_CALL_TO_ACTION_CLICKS 号召性用语重叠式广告。
VIDEO_CARD_ACTION_HEADLINE_CLICKS 卡片。
VIDEO_END_CAP_CLICKS 结尾画面。
VIDEO_WEBSITE_CLICKS 网站。
WIRELESS_PLAN 无线套餐。
PRODUCT_LISTING_AD_LOCAL 购物 - 产品 - 本地。
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL 购物 - 产品 - 多渠道本地。
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE 购物 - 产品 - 多渠道在线。
PRODUCT_LISTING_ADS_COUPON 购物 - 产品 - 优惠券。
PRODUCT_LISTING_AD_TRANSACTABLE 购物 - 产品 - 在 Google 上销售。
PROMOTION_EXTENSION 附加促销信息。
HOTEL_PRICE 酒店价格。
PRICE_EXTENSION 附加价格信息。
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION “Google 上的酒店预订”房间选择。
SHOPPING_COMPARISON_LISTING 购物 - 购物比较服务详情。
CROSS_NETWORK 跨广告网络。通过效果最大化广告系列和发现广告系列。

ConversionAttributionEventType

归因的转化的事件类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 表示此版本中未知的值。
IMPRESSION 转化会归因于展示。
INTERACTION 转化归因于互动。

ConversionLagBucket

表示展示和转化之间相隔的天数的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
LESS_THAN_ONE_DAY 转化延迟时间分桶范围为 0 到 1 天。0 天包含在内,1 天不包含在内。
ONE_TO_TWO_DAYS 转化延迟时间分桶范围为 1 到 2 天。1 天包含在内,2 天不包含在内。
TWO_TO_THREE_DAYS 转化延迟时间分桶范围为 2 到 3 天。2 天包含在内,3 天不包含在内。
THREE_TO_FOUR_DAYS 转化延迟时间分桶范围为 3 到 4 天。3 天包含在内,4 天不包含在内。
FOUR_TO_FIVE_DAYS 转化延迟时间分桶范围为 4 到 5 天。4 天算在内,5 天不算在内。
FIVE_TO_SIX_DAYS 转化延迟时间分桶从 5 天改为 6 天。包含 5 天,不包含 6 天。
SIX_TO_SEVEN_DAYS 将转化延迟时间分桶从 6 天改为 7 天。包含 6 天,不包含 7 天。
SEVEN_TO_EIGHT_DAYS 将转化延迟时间分桶从 7 天改为 8 天。7 天包含在内,8 天不包含在内。
EIGHT_TO_NINE_DAYS 将转化延迟时间分桶从 8 天改为 9 天。8 天包含在内,9 天不包含在内。
NINE_TO_TEN_DAYS 将转化延迟时间分桶从 9 天改为 10 天。包含第 9 天,不包含第 10 天。
TEN_TO_ELEVEN_DAYS 将转化延迟时间分桶从 10 天改为 11 天。10 天算在内,11 天不算在内。
ELEVEN_TO_TWELVE_DAYS 转化延迟时间分桶范围为 11 到 12 天。包含第 11 天,不包含第 12 天。
TWELVE_TO_THIRTEEN_DAYS 将转化延迟时间分桶从 12 天改为 13 天。包含 12 天,不包含 13 天。
THIRTEEN_TO_FOURTEEN_DAYS 将转化延迟时间分桶从 13 天改为 14 天。包含第 13 天,不包含第 14 天。
FOURTEEN_TO_TWENTY_ONE_DAYS 转化延迟时间分桶范围为 14 到 21 天。14 天包含在内,21 天不包含在内。
TWENTY_ONE_TO_THIRTY_DAYS 转化延迟时间分桶范围为 21 到 30 天。包含 21 天,不包含 30 天。
THIRTY_TO_FORTY_FIVE_DAYS 转化延迟时间分桶范围从 30 天到 45 天。包含 30 天,不包含 45 天。
FORTY_FIVE_TO_SIXTY_DAYS 转化延迟时间分桶范围为 45 到 60 天。45 天包含在内,60 天不包含在内。
SIXTY_TO_NINETY_DAYS 转化延迟时间分桶范围从 60 天到 90 天。60 天包含在内,90 天不包含在内。

ConversionOrAdjustmentLagBucket

表示从展示到转化或从展示到对转化的调整所需的天数的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CONVERSION_LESS_THAN_ONE_DAY 转化延迟时间分桶范围为 0 到 1 天。0 天包含在内,1 天不包含在内。
CONVERSION_ONE_TO_TWO_DAYS 转化延迟时间分桶范围为 1 到 2 天。1 天包含在内,2 天不包含在内。
CONVERSION_TWO_TO_THREE_DAYS 转化延迟时间分桶范围为 2 到 3 天。2 天包含在内,3 天不包含在内。
CONVERSION_THREE_TO_FOUR_DAYS 转化延迟时间分桶范围为 3 到 4 天。3 天包含在内,4 天不包含在内。
CONVERSION_FOUR_TO_FIVE_DAYS 转化延迟时间分桶范围为 4 到 5 天。4 天算在内,5 天不算在内。
CONVERSION_FIVE_TO_SIX_DAYS 转化延迟时间分桶从 5 天改为 6 天。包含 5 天,不包含 6 天。
CONVERSION_SIX_TO_SEVEN_DAYS 将转化延迟时间分桶从 6 天改为 7 天。包含 6 天,不包含 7 天。
CONVERSION_SEVEN_TO_EIGHT_DAYS 将转化延迟时间分桶从 7 天改为 8 天。7 天包含在内,8 天不包含在内。
CONVERSION_EIGHT_TO_NINE_DAYS 将转化延迟时间分桶从 8 天改为 9 天。8 天包含在内,9 天不包含在内。
CONVERSION_NINE_TO_TEN_DAYS 将转化延迟时间分桶从 9 天改为 10 天。包含第 9 天,不包含第 10 天。
CONVERSION_TEN_TO_ELEVEN_DAYS 将转化延迟时间分桶从 10 天改为 11 天。10 天算在内,11 天不算在内。
CONVERSION_ELEVEN_TO_TWELVE_DAYS 转化延迟时间分桶范围为 11 到 12 天。包含第 11 天,不包含第 12 天。
CONVERSION_TWELVE_TO_THIRTEEN_DAYS 将转化延迟时间分桶从 12 天改为 13 天。包含 12 天,不包含 13 天。
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS 将转化延迟时间分桶从 13 天改为 14 天。包含第 13 天,不包含第 14 天。
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS 转化延迟时间分桶范围为 14 到 21 天。14 天包含在内,21 天不包含在内。
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS 转化延迟时间分桶范围为 21 到 30 天。包含 21 天,不包含 30 天。
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS 转化延迟时间分桶范围从 30 天到 45 天。包含 30 天,不包含 45 天。
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS 转化延迟时间分桶范围为 45 到 60 天。45 天包含在内,60 天不包含在内。
CONVERSION_SIXTY_TO_NINETY_DAYS 转化延迟时间分桶范围从 60 天到 90 天。60 天包含在内,90 天不包含在内。
ADJUSTMENT_LESS_THAN_ONE_DAY 转化调整延迟时间分桶范围为 0 到 1 天。0 天包含在内,1 天不包含在内。
ADJUSTMENT_ONE_TO_TWO_DAYS 转化调整延迟时间分桶(1 到 2 天)。1 天包含在内,2 天不包含在内。
ADJUSTMENT_TWO_TO_THREE_DAYS 转化调整延迟时间分桶从 2 天改为 3 天。2 天包含在内,3 天不包含在内。
ADJUSTMENT_THREE_TO_FOUR_DAYS 转化调整延迟时间分桶从 3 天改为 4 天。3 天包含在内,4 天不包含在内。
ADJUSTMENT_FOUR_TO_FIVE_DAYS 转化调整延迟时间分桶从 4 天改为 5 天。4 天算在内,5 天不算在内。
ADJUSTMENT_FIVE_TO_SIX_DAYS 转化调整延迟时间分桶从 5 天改为 6 天。包含 5 天,不包含 6 天。
ADJUSTMENT_SIX_TO_SEVEN_DAYS 将转化调整延迟时间分桶从 6 天改为 7 天。包含 6 天,不包含 7 天。
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS 将转化调整延迟时间分桶从 7 天改为 8 天。7 天包含在内,8 天不包含在内。
ADJUSTMENT_EIGHT_TO_NINE_DAYS 转化调整延迟时间分桶从 8 天改为 9 天。8 天包含在内,9 天不包含在内。
ADJUSTMENT_NINE_TO_TEN_DAYS 将转化调整延迟时间分桶从 9 天改为 10 天。包含第 9 天,不包含第 10 天。
ADJUSTMENT_TEN_TO_ELEVEN_DAYS 转化调整延迟时间分桶从 10 天改为 11 天。10 天算在内,11 天不算在内。
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS 转化调整延迟时间分桶从 11 天改为 12 天。包含第 11 天,不包含第 12 天。
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS 转化调整延迟时间分桶从 12 天改为 13 天。包含 12 天,不包含 13 天。
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS 将转化调整延迟时间分桶从 13 天改为 14 天。包含第 13 天,不包含第 14 天。
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS 将转化调整延迟时间分桶从 14 天延长至 21 天。14 天包含在内,21 天不包含在内。
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS 转化调整延迟时间分桶范围从 21 天扩大到 30 天。包含 21 天,不包含 30 天。
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS 将转化调整延迟时间分桶从 30 天延长至 45 天。包含 30 天,不包含 45 天。
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS 将转化调整延迟时间分桶从 45 天改为 60 天。45 天包含在内,60 天不包含在内。
ADJUSTMENT_SIXTY_TO_NINETY_DAYS 将转化调整延迟时间分桶从 60 天延长至 90 天。60 天包含在内,90 天不包含在内。
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS 转化调整延迟时间分桶从 90 天延长至 145 天。90 天包含在内,145 天不包含在内。
CONVERSION_UNKNOWN 转化延迟时间分桶为“未知”。适用于 Google Ads 中未提供转化延迟时间分桶之前的日期。
ADJUSTMENT_UNKNOWN 转化调整延迟时间分桶为“未知”。适用于 Google Ads 中未提供转化调整延迟时间分桶之前的日期。

ExternalConversionSource

与 ConversionAction 相关联的外部转化来源。

枚举
UNSPECIFIED 未指定。
UNKNOWN 表示此版本中未知的值。
WEBPAGE 用户在观看广告后转到特定网页时发生的转化;在 Google Ads 界面中显示为“网站”。
ANALYTICS 来自关联的 Google Analytics 目标或交易的转化;在 Google Ads 界面中显示为“Google 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 界面中显示为“移动应用”。
ANDROID_FIRST_OPEN 用户首次打开 Android 应用时发生的转化;在 Google Ads 界面中显示为“Android 应用安装(首次打开)”。
UPLOAD_CALLS 通过 ConversionUploadService 上传的来电转化;在 Google Ads 界面中显示为“从来电导入”。
FIREBASE 来自关联的 Firebase 事件的转化;在 Google Ads 界面中显示为“Firebase”。
CLICK_TO_CALL 用户点击移动电话号码时发生的转化;在 Google Ads 界面中显示为“电话号码点击次数”。
SALESFORCE 来自 Salesforce 的转化;在 Google Ads 界面中显示为“Salesforce.com”。
STORE_SALES_CRM 由 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 专门针对 Search Ads 360 从 Google Analytics 导入的转化。在 Google Ads 界面中显示为“Google 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 提供会员回馈活动费率,并且满足公开费率等基本要求。界面处理方式将带删除线显示公开费率,并指明用户可以享受折扣。如需详细了解“符合条件的房价”,请访问 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 仅显示合作伙伴。

Keyword

关键字条件细分。

JSON 表示法
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
字段
info

object (KeywordInfo)

关键字信息。

adGroupCriterion

string

AdGroupCriterion 资源名称。

SearchEngineResultsPageType

搜索引擎结果页的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ADS_ONLY 搜索引擎结果页中仅包含广告。
ORGANIC_ONLY 搜索引擎结果页中仅包含自然搜索结果。
ADS_AND_ORGANIC 搜索引擎结果页中同时包含广告和自然搜索结果。

SearchTermMatchType

触发广告的关键字可能的匹配类型,包括变体。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
BROAD 广泛匹配。
EXACT 完全匹配。
PHRASE 词组匹配。
NEAR_EXACT 完全匹配(紧密变体)。
NEAR_PHRASE 词组匹配(紧密变体)。

广告位

枚举广告可能出现的位置。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
SEARCH_SIDE Google 搜索:侧边。
SEARCH_TOP Google 搜索:顶部。
SEARCH_OTHER Google 搜索:其他。
CONTENT
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 Ad Network 安装的广告所展示的应用 ID。

SkAdNetworkAttributionCredit

枚举 SkAdNetwork 归因功劳。

枚举
UNSPECIFIED 默认值。此值等同于 null。
UNKNOWN 在此 API 版本中,此值未知。此 API 版本无法返回 true 枚举值,或者尚不支持此值。
UNAVAILABLE 该值未在回传中,或者我们因其他原因不具备此数据。
WON Google 是赢得广告归因的广告联盟。
CONTRIBUTED Google 符合归因条件,但未胜出。

SkAdNetworkSourceType

枚举 SkAdNetwork 来源类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
UNAVAILABLE 回传中未包含来源应用 ID 或来源网域,或者我们出于其他原因不具备此类数据。
WEBSITE 广告在网页上展示。
MOBILE_APPLICATION 广告是在应用中展示的。

AssetInteractionTarget

AssetInteractionTarget 细分。

JSON 表示法
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
字段
asset

string

素材资源名称。

interactionOnThisAsset

boolean

仅适用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。

ConvertingUserPriorEngagementTypeAndLtvBucket

枚举转化用户之前的互动类型和生命周期价值分桶

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
NEW 转化用户是广告客户的新客户。
RETURNING 转化用户返回到广告客户。回头客的定义因转化类型而异,例如第二次光顾实体店与第二次在线购买。
NEW_AND_HIGH_LTV 完成转化的用户是广告客户的新客户,并且具有较高的生命周期价值。