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)

查询中引用的 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_”“已批准”字段,还可能包含“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。只有当已批准的支出限额为 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)时,系统才会填充此字段。

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)

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

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 中。广告组广告素材资源组合视图资源名称采用以下格式: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

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

  1. 展示 - 关键字 - CPC_BID - 统一
  2. 搜索 - 关键字 - CPC_BID - UNIFORM
  3. 购物 - LISTING_GROUP - CPC_出价 - 统一
  4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM
  5. 酒店 - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 表示法
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

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

string

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

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

type

enum (SimulationType)

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

modificationMethod

enum (SimulationModificationMethod)

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

adGroupId

string (int64 format)

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

criterionId

string (int64 format)

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

startDate

string

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

endDate

string

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

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

object (CpcBidSimulationPointList)

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

percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

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

SimulationType

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

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CPC_BID 模拟的是每次点击费用出价。
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. 目标每次转化费用 - 统一
  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_IMPRESSION_SHARE - UNIFORM
  • 搜索广告系列 - 预算 - 统一
  • 购物广告系列 - 预算 - 统一
  • 购物 - TARGET_ROAS - UNIFORM
  • 多渠道 - 目标每次转化费用 - 统一
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • 发现广告系列 - 目标每次转化费用 - 默认
  • 展示广告 - 目标每次转化费用 - 统一
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - 预算 - UNIFORM
JSON 表示法
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

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

string

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

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

campaignId

string (int64 format)

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

type

enum (SimulationType)

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

modificationMethod

enum (SimulationModificationMethod)

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

startDate

string

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

endDate

string

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

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

object (CpcBidSimulationPointList)

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

targetCpaPointList

object (TargetCpaSimulationPointList)

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

targetRoasPointList

object (TargetRoasSimulationPointList)

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

targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

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

budgetPointList

object (BudgetSimulationPointList)

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

TargetImpressionShareSimulationPointList

TARGET_IMPRESSION_SHARE 类型的模拟的模拟点容器。

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

object (TargetImpressionShareSimulationPoint)

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

TargetImpressionShareSimulationPoint

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

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

string (int64 format)

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

requiredCpcBidCeilingMicros

string (int64 format)

广告客户为实现此模拟而必须设置的预计每日每次点击费用出价上限,以广告客户币种的微单位表示。

requiredBudgetAmountMicros

string (int64 format)

广告客户为获得估算流量而必须设置的预计每日预算(以广告客户币种的微单位表示)。

biddableConversions

number

预计可出价转化次数。

biddableConversionsValue

number

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

clicks

string (int64 format)

预计点击次数。

costMicros

string (int64 format)

以微单位表示的预计费用。

impressions

string (int64 format)

预计展示次数。

topSlotImpressions

string (int64 format)

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

absoluteTopImpressions

string (int64 format)

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

BudgetSimulationPointList

预算类型模拟的模拟点容器。

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)

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

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

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

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 资源发生变化。
AD_GROUP 更改广告组资源。
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 广告组 Feed 资源更改。
AD_GROUP_AD 更改了 AdGroupAd 资源。
ASSET 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 发布所做的更改。
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)

仅限输出。设置 if 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 更改广告组资源。
AD_GROUP_AD 更改了 AdGroupAd 资源。
AD_GROUP_CRITERION 一项 AdGroupCriterion 资源更改。
CAMPAIGN 广告系列资源发生更改。
CAMPAIGN_CRITERION CampaignCriterion 资源更改。
FEED Feed 资源更改。
FEED_ITEM FeedItem 资源更改。
AD_GROUP_FEED 广告组 Feed 资源更改。
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

表示客户拥有并与其共享的 BiddingStrategies 视图。

与 BiddingStrategy 相比,该资源除了包含该客户拥有的策略之外,还包含该客户拥有并与该客户共享的策略。此资源不提供指标,而且仅公开了部分 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)

仅限输出。一种出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。

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

这是一种自动出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。

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

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

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

是否包含默认频道子类型。例如,如果 adChannelType 为 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

地理位置视图按地理位置条件汇总了广告系列的效果。如果未设置任何地理位置条件,则不会返回任何结果;而是使用 geoView 或 userLocationView 作为访问者位置数据。

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

string

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

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

ManagedPlacementView

自选展示位置视图。

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

string

仅限输出。自选展示位置视图的资源名称。自选展示位置视图资源名称采用以下格式:

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

MediaFile

媒体文件。

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

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

string

不可变。媒体文件的资源名称。媒体文件资源名称采用以下格式:

customers/{customerId}/mediaFiles/{media_file_id}

type

enum (MediaType)

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

mimeType

enum (MimeType)

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

id

string (int64 format)

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

sourceUrl

string

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

name

string

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

fileSize

string (int64 format)

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

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

object (MediaImage)

不可变。封装图像。

mediaBundle

object (MediaBundle)

不可变。内容包含 HTML5 素材资源的 ZIP 归档媒体。

audio

object (MediaAudio)

仅限输出。封装音频。

video

object (MediaVideo)

不可变。封装视频。

MediaType

媒体的类型。

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

此版本中未知收到的值。

这是一个仅用于响应的值。

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

MediaImage

封装图像。

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

string (bytes format)

不可变。原始图片数据。

使用 base64 编码的字符串。

fullSizeImageUrl

string

仅限输出。指向完整尺寸图片的网址。

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

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

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

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

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 许可不是所请求的文档类型或包含无效的 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)

仅限输出。转变错误。

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。请仅使用 1 种类型,然后重试。
CONVERSION_ALREADY_ENHANCED 此转化已有具有相同订单 ID 和转化操作的增强功能。请确保您的数据配置正确无误,然后重试。
DUPLICATE_ENHANCEMENT_IN_REQUEST 多项增强功能具有相同的转化操作和订单 ID。请确保您的数据配置正确无误,然后重试。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT 由于 Google 客户数据政策,此账号无法使用增强型转化。请与您的 Google 代表联系。
MISSING_ORDER_ID_FOR_WEBPAGE 调整网站转化需要提供订单 ID(即交易 ID)。请确保您的网站代码能够获取订单 ID,并且您在进行调整时发送相同的订单 ID。
ORDER_ID_CONTAINS_PII 无法对包含个人身份信息 (PII) 的订单 ID 使用调整。
INVALID_JOB_ID 请求中提供的职位 ID 不在允许范围内。作业 ID 必须是 [1, 2^31] 这个范围内的正整数。
NO_CONVERSION_ACTION_FOUND 找不到调整请求中指定的转化操作。请确保该转化操作可在此账号中使用。
INVALID_CONVERSION_ACTION_TYPE 调整请求中指定的转化操作类型不支持上传调整项。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 请确保您在转化设置中同意客户数据处理条款,然后重试。您可以通过查询客户的 conversionTrackingSetting.accepted_customer_data_terms 检查您的设置。
ORDER_ID_CONTAINS_PII 事件的订单 ID 包含个人身份信息 (PII),因此无法导入。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 请确保您已在转化设置中启用增强型潜在客户转化,然后重试。要检查您的设置,请查询客户的 conversionTrackingSetting.Enhance_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 不能在一个请求中对同一个资源执行两次 mutate 操作。
INCONSISTENT_FIELD_VALUES 字段的内容与表示相同数据的另一个字段不匹配。
MUTATE_NOT_ALLOWED 不允许对所请求的资源执行 mutate 操作。
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 相当于 https://support.google.com/merchants/answer/6324436 一文中所述的 google_product_category ID。

level

enum (ProductCategoryLevel)

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

state

enum (ProductCategoryState)

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

localizations[]

object (ProductCategoryLocalization)

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

productCategoryConstantParent

string

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

ProductCategoryState

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

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

ProductCategoryLocalization

商品类别的本地化版本。

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

string

仅限输出。本地化类别的大写双字母 ISO 3166-1 国家/地区代码。

languageCode

string

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

value

string

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

ProductGroupView

产品组视图。

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

string

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

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

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

包含可能的 UserInterestTaxonomyTypes 的枚举。

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

LifeEvent

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

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

string

仅限输出。人生大事的资源名称。人生大事资源名称采用以下格式:

customers/{customerId}/lifeEvents/{lifeEventId}

id

string (int64 format)

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

name

string

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

parent

string

仅限输出。LifeEvent 的父级。

launchedToAll

boolean

仅限输出。如果人生大事面向所有渠道和语言区域发布,则为“true”。

availabilities[]

object (CriterionCategoryAvailability)

仅限输出。人生大事的空闲情况信息。

UserLocationView

用户位置信息视图。

用户地理位置视图包含国家/地区级别的所有汇总指标,每个国家/地区占一行。它会按已定位或未定位的地理位置报告用户实际所处的地理位置的指标。如果使用了其他细分字段,每个国家/地区可能会占多行。

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

string

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

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

countryCriterionId

string (int64 format)

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

targetingLocation

boolean

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

TopicConstant

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

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

string

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

topicConstants/{topic_id}

path[]

string

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

id

string (int64 format)

仅限输出。主题的 ID。

topicConstantParent

string

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

视频

视频。

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

string

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

customers/{customerId}/videos/{videoId}

id

string

仅限输出。视频的 ID。

channelId

string

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

durationMillis

string (int64 format)

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

title

string

仅限输出。视频的标题。

WebpageView

网页浏览。

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

string

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

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

LeadFormSubmissionData

潜在客户表单提交的数据。

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

string

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

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

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

asset

string

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

campaign

string

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

leadFormSubmissionFields[]

object (LeadFormSubmissionField)

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

customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

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

adGroup

string

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

adGroupAd

string

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

gclid

string

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

submissionDateTime

string

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

LeadFormSubmissionField

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

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

enum (LeadFormFieldUserInputType)

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

fieldValue

string

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

CustomLeadFormSubmissionField

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

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

string

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

fieldValue

string

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

LocalServicesLead

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

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "note": {
    object (Note)
  },
  "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

仅限输出。E164 格式的消费者电话号码。

email

string

仅限输出。消费者电子邮件地址。

consumerName

string

仅限输出。消费者姓名(如果消费者在 google.com 上的消息或预订表单中提供姓名)

LeadType

可能的潜在客户类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
MESSAGE 给潜在客户发消息。
PHONE_CALL 通过来电创建的潜在客户。
BOOKING 预订负责人。

LeadStatus

潜在客户的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
NEW 广告客户尚未看到的新潜在客户。
ACTIVE 与广告主进行过互动的潜在客户。
BOOKED 潜在客户已预订。
DECLINED 潜在客户已被广告主拒绝。
EXPIRED 潜在客户因闲置而过期。
DISABLED 因垃圾内容或异议而被停用。
CONSUMER_DECLINED 消费者拒绝了潜在客户。
WIPED_OUT 系统会清除潜在客户的个人身份信息。

备注

表示广告客户向潜在客户添加的备注。广告客户可以修改备注,这会重置修改时间并更改说明。

JSON 表示法
{
  "editDateTime": string,
  "description": string
}
字段
editDateTime

string

仅限输出。潜在客户备注的修改日期时间。格式为“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、短信等

participantType

enum (ParticipantType)

仅限输出。潜在客户对话的参与者类型:ADVERTISER 或 CONSUMER。

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”前缀。此键可用于与汇总转化键执行按位 OR 运算符,以创建完整的汇总键,以检索 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

收到的来电次数 (phoneCall) 除以您的电话号码的展示次数 (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

广告展示后,任意营业地点 surface 上的致电按钮点击次数。此衡量指标来自基于素材资源的位置。

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)

星期几,例如 MONDAY。

device

enum (Device)

指标应用于的设备。

externalConversionSource

enum (ExternalConversionSource)

外部转化来源。

hotelCheckInDayOfWeek

enum (DayOfWeek)

酒店入住日(星期几)。

hotelDateSelectionType

enum (HotelDateSelectionType)

酒店日期选择类型。

hotelRateType

enum (HotelRateType)

酒店房价类型。

hotelPriceBucket

enum (HotelPriceBucket)

酒店价格范围。

keyword

object (Keyword)

关键字标准。

monthOfYear

enum (MonthOfYear)

一年中的月份,例如 1 月。

placeholderType

enum (PlaceholderType)

占位符类型。此字段仅适用于 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 显示的是未应用价值规则的转化的总记录价值。“ORIGINAL”显示已应用价值规则的转化的原始价值。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

提供旅行 activity 的状态。

externalActivityId

string

广告客户提供的活动 ID。

adGroup

string

广告组的资源名称。

assetGroup

string

素材资源组的资源名称。

auctionInsightDomain

string

“竞价分析”报告中竞价参与者的网域(显示网址)。

campaign

string

广告系列的资源名称。

conversionAction

string

转化操作的资源名称。

conversionActionName

string

转化操作名称。

conversionAdjustment

boolean

这会按原始转化次数和转化价值与转化次数(如果转化调整后)的增量细分您的转化列。假行包含最初所述的数据;而真行则包含现在的数据与最初所述的数据之间的增量。将两组数据相加后得到的调整后数据。

date

string

指标适用的日期。yyyy-MM-dd 格式,例如 2018-04-17。

geoTargetAirport

string

表示机场的地理位置定位常量的资源名称。

geoTargetCanton

string

表示州/省/自治区/直辖市的地理位置定位常量的资源名称。

geoTargetCity

string

表示城市的地理位置定位目标常量的资源名称。

geoTargetCountry

string

代表国家/地区的地理位置定位目标常量的资源名称。

geoTargetCounty

string

表示县的地理位置定位目标常量的资源名称。

geoTargetDistrict

string

表示地区的目标地理区域常量的资源名称。

geoTargetMetro

string

代表都市圈的地理位置定位目标常量的资源名称。

geoTargetMostSpecificLocation

string

代表最具体位置的地理位置定位目标常量的资源名称。

geoTargetPostalCode

string

表示邮政编码的地理位置定位常量的资源名称。

geoTargetProvince

string

代表省的地理位置定位目标常量的资源名称。

geoTargetRegion

string

代表区域的地理位置定位目标常量的资源名称。

geoTargetState

string

代表州的地理位置定位目标常量的资源名称。

hotelBookingWindowDays

string (int64 format)

酒店预订期限(以天为单位)。

hotelCenterId

string (int64 format)

Hotel Center ID。

hotelCheckInDate

string

酒店入住日期。格式为 yyyy-MM-dd。

hotelCity

string

酒店所在的城市。

hotelClass

integer

酒店星级。

hotelCountry

string

酒店所在的国家/地区。

hotelLengthOfStay

integer

酒店住宿晚数。

hotelRateRuleId

string

酒店房价规则 ID。

hotelState

string

酒店所在的省级行政区。

hour

integer

以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。

interactionOnThisExtension

boolean

仅适用于 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 年第二季度从 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 界面中显示为“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 完成转化的用户是广告客户的新客户,并且具有较高的生命周期价值。