- JSON 表示法
- AccountBudget
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AccountBudgetStatus
- PendingAccountBudgetProposal
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdGroupAdAssetCombinationView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AssetUsage
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdGroupAdAssetView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdGroupAdAssetPolicySummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdGroupAudienceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdGroupCriterionSimulation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SimulationType
- SimulationModificationMethod
- CpcBidSimulationPointList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CpcBidSimulationPoint
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- PercentCpcBidSimulationPointList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- PercentCpcBidSimulationPoint
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdGroupSimulation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CpvBidSimulationPointList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CpvBidSimulationPoint
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetCpaSimulationPointList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetCpaSimulationPoint
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetRoasSimulationPointList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetRoasSimulationPoint
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AgeRangeView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdScheduleView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DomainCategory
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AssetFieldTypeView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ChannelAggregateAssetView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CampaignAggregateAssetView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AssetGroupProductGroupView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AssetGroupTopCombinationView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AssetGroupAssetCombinationData
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AssetSetTypeView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- BiddingStrategySimulation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CallView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CallTrackingDisplayLocation
- CallType
- GoogleVoiceCallStatus
- CampaignAudienceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CampaignSearchTermInsight
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CampaignSimulation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetImpressionShareSimulationPointList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetImpressionShareSimulationPoint
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- BudgetSimulationPointList
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- BudgetSimulationPoint
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CarrierConstant
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ChangeEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ChangeEventResourceType
- ChangeClientType
- ChangedResource
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ResourceChangeOperation
- ChangeStatus
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ChangeStatusResourceType
- ChangeStatusOperation
- CombinedAudience
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CombinedAudienceStatus
- ClickView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ClickLocation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CurrencyConstant
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AccessibleBiddingStrategy
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MaximizeConversionValue
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MaximizeConversions
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetCpa
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetImpressionShare
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetRoas
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TargetSpend
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CustomerClient
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CustomerSearchTermInsight
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DetailPlacementView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- PlacementType
- DetailedDemographic
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CriterionCategoryAvailability
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CriterionCategoryChannelAvailability
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CriterionCategoryChannelAvailabilityMode
- CriterionCategoryLocaleAvailability
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CriterionCategoryLocaleAvailabilityMode
- DisplayKeywordView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DistanceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DistanceBucket
- DynamicSearchAdsSearchTermView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ExpandedLandingPageView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- FeedPlaceholderView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- GenderView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- GeographicView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- GeoTargetingType
- GroupPlacementView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- HotelGroupView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- HotelPerformanceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- HotelReconciliation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- HotelReconciliationStatus
- IncomeRangeView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- KeywordView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LandingPageView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LanguageConstant
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocationView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ManagedPlacementView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MediaFile
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MediaType
- MediaImage
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MediaBundle
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MediaAudio
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MediaVideo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalServicesEmployee
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalServicesEmployeeStatus
- LocalServicesEmployeeType
- UniversityDegree
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 居住地
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 伙伴关系
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalServicesVerificationArtifact
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalServicesVerificationArtifactStatus
- LocalServicesVerificationArtifactType
- BackgroundCheckVerificationArtifact
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- InsuranceVerificationArtifact
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalServicesInsuranceRejectionReason
- LocalServicesDocumentReadOnly
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LicenseVerificationArtifact
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalServicesLicenseRejectionReason
- BusinessRegistrationCheckVerificationArtifact
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalServicesBusinessRegistrationType
- LocalServicesBusinessRegistrationCheckRejectionReason
- BusinessRegistrationNumber
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- BusinessRegistrationDocument
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MobileAppCategoryConstant
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MobileDeviceConstant
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MobileDeviceType
- OfflineConversionUploadClientSummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- OfflineEventUploadClient
- OfflineConversionDiagnosticStatus
- OfflineConversionSummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- OfflineConversionAlert
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- OfflineConversionError
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CollectionSizeError
- ConversionAdjustmentUploadError
- ConversionUploadError
- DateError
- DistinctError
- FieldError
- MutateError
- NotAllowlistedError
- StringFormatError
- StringLengthError
- OfflineConversionUploadConversionActionSummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- OperatingSystemVersionConstant
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- OperatingSystemVersionOperatorType
- PaidOrganicSearchTermView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- QualifyingQuestion
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ParentalStatusView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- PerStoreView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ProductCategoryConstant
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ProductCategoryState
- ProductCategoryLocalization
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ProductGroupView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SearchTermView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SearchTermTargetingStatus
- ShoppingPerformanceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ShoppingProduct
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ProductAvailability
- ProductStatus
- ProductIssue
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ProductIssueSeverity
- SmartCampaignSearchTermView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ThirdPartyAppAnalyticsLink
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TopicView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TravelActivityGroupView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TravelActivityPerformanceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- UserInterest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- UserInterestTaxonomyType
- LifeEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- UserLocationView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TopicConstant
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 视频
- WebpageView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LeadFormSubmissionData
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LeadFormSubmissionField
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CustomLeadFormSubmissionField
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalServicesLead
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ContactDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LeadType
- LeadStatus
- 注意
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CreditDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CreditState
- LocalServicesLeadConversation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ConversationType
- ParticipantType
- PhoneCallDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- MessageDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AndroidPrivacySharedKeyGoogleAdGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AndroidPrivacyInteractionType
- AndroidPrivacyNetworkType
- AndroidPrivacySharedKeyGoogleCampaign
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AndroidPrivacySharedKeyGoogleNetworkType
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 指标
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- InteractionEventType
- SearchVolumeRange
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 细分
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdDestinationType
- AdFormatType
- AdNetworkType
- BudgetCampaignAssociationStatus
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- BudgetCampaignAssociationStatus
- ClickType
- ConversionAttributionEventType
- ConversionLagBucket
- ConversionOrAdjustmentLagBucket
- ExternalConversionSource
- HotelRateType
- HotelPriceBucket
- 关键字
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SearchEngineResultsPageType
- SearchTermMatchType
- 槽
- ConversionValueRulePrimaryDimension
- SkAdNetworkUserType
- SkAdNetworkAdEventType
- SkAdNetworkSourceApp
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SkAdNetworkAttributionCredit
- SkAdNetworkSourceType
- AssetInteractionTarget
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ConvertingUserPriorEngagementTypeAndLtvBucket
查询返回的行。
JSON 表示法 |
---|
{ "accountBudget": { object ( |
字段 | |
---|---|
accountBudget |
查询中的账号预算。 |
accountBudgetProposal |
查询中引用的账号预算提案。 |
accountLink |
查询中引用的 AccountLink。 |
ad |
查询中引用的广告。 |
adGroup |
查询中引用的广告组。 |
adGroupAd |
查询中引用的广告。 |
adGroupAdAssetCombinationView |
查询中的广告组广告素材资源组合视图。 |
adGroupAdAssetView |
查询中的广告组广告素材资源视图。 |
adGroupAdLabel |
查询中引用的广告组广告标签。 |
adGroupAsset |
查询中引用的广告组素材资源。 |
adGroupAssetSet |
查询中引用的广告组素材资源组。 |
adGroupAudienceView |
查询中引用的广告组受众群体视图。 |
adGroupBidModifier |
查询中引用的出价调节系数。 |
adGroupCriterion |
查询中引用的条件。 |
adGroupCriterionCustomizer |
查询中引用的广告组条件定制工具。 |
adGroupCriterionLabel |
查询中引用的广告组条件标签。 |
adGroupCriterionSimulation |
查询中引用的广告组条件模拟。 |
adGroupCustomizer |
查询中引用的广告组定制工具。 |
adGroupExtensionSetting |
查询中引用的广告组附加信息设置。 |
adGroupFeed |
查询中引用的广告组 Feed。 |
adGroupLabel |
查询中引用的广告组标签。 |
adGroupSimulation |
查询中引用的广告组模拟。 |
adParameter |
查询中引用的广告参数。 |
ageRangeView |
查询中引用的年龄段视图。 |
adScheduleView |
查询中引用的广告投放时间视图。 |
domainCategory |
查询中引用的网域类别。 |
asset |
查询中引用的资产。 |
assetFieldTypeView |
查询中引用的素材资源字段类型视图。 |
channelAggregateAssetView |
查询中引用的频道汇总资产视图。 |
campaignAggregateAssetView |
查询中引用的广告系列汇总素材资源视图。 |
assetGroupAsset |
查询中引用的素材资源组素材资源。 |
assetGroupSignal |
查询中引用的素材资源组信号。 |
assetGroupListingGroupFilter |
查询中引用的素材资源组产品信息组过滤条件。 |
assetGroupProductGroupView |
查询中引用的素材资源组产品组视图。 |
assetGroupTopCombinationView |
查询中引用的素材资源组顶级组合视图。 |
assetGroup |
查询中引用的素材资源组。 |
assetSetAsset |
查询中引用的素材资源组素材资源。 |
assetSet |
查询中引用的素材资源集。 |
assetSetTypeView |
查询中引用的素材资源组类型视图。 |
batchJob |
查询中引用的批量作业。 |
biddingDataExclusion |
查询中引用的出价数据排除项。 |
biddingSeasonalityAdjustment |
查询中引用的出价季节性调整。 |
biddingStrategy |
查询中引用的出价策略。 |
biddingStrategySimulation |
查询中引用的出价策略模拟。 |
billingSetup |
查询中引用的结算设置。 |
callView |
查询中引用的通话视图。 |
campaignBudget |
查询中引用的广告系列预算。 |
campaign |
查询中引用的广告系列。 |
campaignAsset |
查询中引用的广告系列素材资源。 |
campaignAssetSet |
查询中引用的广告系列素材资源集。 |
campaignAudienceView |
查询中引用的广告系列受众群体视图。 |
campaignBidModifier |
查询中引用的广告系列出价调节系数。 |
campaignConversionGoal |
查询中引用的 CampaignConversionGoal。 |
campaignCriterion |
查询中引用的广告系列条件。 |
campaignCustomizer |
查询中引用的广告系列定制工具。 |
campaignDraft |
查询中引用的广告系列草稿。 |
campaignExtensionSetting |
查询中引用的广告系列附加信息设置。 |
campaignFeed |
查询中引用的广告系列 Feed。 |
campaignGroup |
AWQL 查询中引用的广告系列组。 |
campaignLabel |
查询中引用的广告系列标签。 |
campaignLifecycleGoal |
查询中引用的广告系列生命周期目标。 |
campaignSearchTermInsight |
查询中引用的广告系列搜索字词数据分析。 |
campaignSharedSet |
AWQL 查询中引用的广告系列共享集。 |
campaignSimulation |
查询中引用的广告系列模拟。 |
carrierConstant |
查询中引用的运营商常量。 |
changeEvent |
查询中引用的 ChangeEvent。 |
changeStatus |
查询中引用的 ChangeStatus。 |
combinedAudience |
查询中引用的 CombinedAudience。 |
audience |
查询中引用的受众群体。 |
conversionAction |
查询中引用的转化操作。 |
conversionCustomVariable |
查询中引用的转化自定义变量。 |
conversionGoalCampaignConfig |
查询中引用的 ConversionGoalCampaignConfig。 |
conversionValueRule |
查询中引用的转化价值规则。 |
conversionValueRuleSet |
查询中引用的转化价值规则集。 |
clickView |
查询中引用的 ClickView。 |
currencyConstant |
查询中引用的货币常量。 |
customAudience |
查询中引用的 CustomAudience。 |
customConversionGoal |
查询中引用的 CustomConversionGoal。 |
customInterest |
查询中引用的 CustomInterest。 |
customer |
查询中提及的客户。 |
customerAsset |
查询中引用的客户素材资源。 |
customerAssetSet |
查询中引用的客户素材资源集。 |
accessibleBiddingStrategy |
查询中引用的可访问出价策略。 |
customerCustomizer |
查询中引用的客户定制工具。 |
customerManagerLink |
查询中引用的 CustomerManagerLink。 |
customerClientLink |
查询中引用的 CustomerClientLink。 |
customerClient |
查询中引用的 CustomerClient。 |
customerConversionGoal |
查询中引用的 CustomerConversionGoal。 |
customerExtensionSetting |
查询中引用的客户附加信息设置。 |
customerFeed |
查询中引用的客户 Feed。 |
customerLabel |
查询中引用的客户标签。 |
customerLifecycleGoal |
查询中引用的客户生命周期目标。 |
customerNegativeCriterion |
查询中引用的客户否定条件。 |
customerSearchTermInsight |
查询中引用的客户搜索字词数据分析。 |
customerUserAccess |
查询中引用的 CustomerUserAccess。 |
customerUserAccessInvitation |
查询中引用的 CustomerUserAccessInvitation。 |
customizerAttribute |
查询中引用的定制工具属性。 |
detailPlacementView |
查询中引用的展示位置详情视图。 |
detailedDemographic |
查询中引用的详细受众特征。 |
displayKeywordView |
查询中引用的展示广告网络关键字视图。 |
distanceView |
查询中引用的距离视图。 |
dynamicSearchAdsSearchTermView |
查询中引用的动态搜索广告搜索字词视图。 |
expandedLandingPageView |
查询中引用的扩展后着陆页视图。 |
extensionFeedItem |
查询中引用的附加信息 Feed 项。 |
feed |
查询中引用的 Feed。 |
feedItem |
查询中引用的 Feed 项。 |
feedItemSet |
查询中引用的 Feed 项集。 |
feedItemSetLink |
查询中引用的 Feed 项集链接。 |
feedItemTarget |
查询中引用的 Feed 项定位条件。 |
feedMapping |
查询中引用的 Feed 映射。 |
feedPlaceholderView |
查询中引用的 Feed 占位符视图。 |
genderView |
查询中引用的性别视图。 |
geoTargetConstant |
查询中引用的地理位置定位常量。 |
geographicView |
查询中引用的地理视图。 |
groupPlacementView |
查询中引用的组展示位置视图。 |
hotelGroupView |
查询中引用的酒店组视图。 |
hotelPerformanceView |
查询中引用的酒店效果视图。 |
hotelReconciliation |
查询中引用的酒店对账内容。 |
incomeRangeView |
查询中引用的收入范围视图。 |
keywordView |
查询中引用的关键字视图。 |
keywordPlan |
查询中引用的关键字方案。 |
keywordPlanCampaign |
查询中引用的关键字方案广告系列。 |
keywordPlanCampaignKeyword |
查询中引用的关键字方案广告系列关键字。 |
keywordPlanAdGroup |
查询中引用的关键字方案广告组。 |
keywordPlanAdGroupKeyword |
查询中引用的关键字方案广告组。 |
keywordThemeConstant |
查询中引用的关键字主题常量。 |
label |
查询中引用的标签。 |
landingPageView |
查询中引用的着陆页视图。 |
languageConstant |
查询中引用的语言常量。 |
locationView |
查询中引用的位置视图。 |
managedPlacementView |
查询中引用的自选展示位置视图。 |
mediaFile |
查询中引用的媒体文件。 |
localServicesEmployee |
查询中引用的本地服务员工。 |
localServicesVerificationArtifact |
查询中引用的本地服务验证工件。 |
mobileAppCategoryConstant |
查询中引用的移动应用类别常量。 |
mobileDeviceConstant |
查询中引用的移动设备常量。 |
offlineConversionUploadClientSummary |
客户一级的线下转化数据上传摘要。 |
offlineConversionUploadConversionActionSummary |
转化类型级别的线下转化数据上传摘要。 |
offlineUserDataJob |
查询中引用的线下用户数据作业。 |
operatingSystemVersionConstant |
查询中引用的操作系统版本常量。 |
paidOrganicSearchTermView |
查询中引用的付费自然搜索字词视图。 |
qualifyingQuestion |
查询中提及的甄别问题。 |
parentalStatusView |
查询中引用的生育情况视图。 |
perStoreView |
查询中引用的实体店视图。 |
productCategoryConstant |
查询中引用的商品类别。 |
productGroupView |
查询中引用的产品组视图。 |
productLink |
查询中引用的产品链接。 |
productLinkInvitation |
查询中的产品关联邀请。 |
recommendation |
查询中引用的建议。 |
recommendationSubscription |
查询中引用的推荐订阅。 |
searchTermView |
查询中引用的搜索字词视图。 |
sharedCriterion |
查询中引用的共享集。 |
sharedSet |
查询中引用的共享集。 |
smartCampaignSetting |
查询中引用的智能广告系列设置。 |
shoppingPerformanceView |
查询中引用的购物效果视图。 |
shoppingProduct |
查询中引用的购物产品。 |
smartCampaignSearchTermView |
查询中引用的智能广告系列搜索字词视图。 |
thirdPartyAppAnalyticsLink |
查询中引用的 AccountLink。 |
topicView |
查询中引用的主题视图。 |
travelActivityGroupView |
查询中引用的旅行活动组视图。 |
travelActivityPerformanceView |
查询中引用的旅行活动效果视图。 |
experiment |
查询中引用的实验。 |
experimentArm |
查询中引用的实验组。 |
userInterest |
查询中引用的用户兴趣。 |
lifeEvent |
查询中引用的人生大事。 |
userList |
查询中引用的用户名单。 |
userListCustomerType |
查询中的用户列表客户类型。 |
userLocationView |
查询中引用的用户位置视图。 |
remarketingAction |
查询中引用的再营销操作。 |
topicConstant |
查询中引用的主题常量。 |
video |
查询中引用的视频。 |
webpageView |
查询中引用的网页视图。 |
leadFormSubmissionData |
查询中引用的潜在客户表单用户提交内容。 |
localServicesLead |
查询中引用的本地服务潜在客户。 |
localServicesLeadConversation |
本地服务主导查询中引用的对话。 |
androidPrivacySharedKeyGoogleAdGroup |
查询中引用的 Android 隐私权共享键 Google 广告组。 |
androidPrivacySharedKeyGoogleCampaign |
查询中引用的 Android 隐私保护共享密钥 Google 广告系列。 |
androidPrivacySharedKeyGoogleNetworkType |
查询中引用的 Android 隐私共享密钥 Google 网络类型。 |
metrics |
指标。 |
segments |
细分受众群。 |
AccountBudget
账号级预算。其中包含有关预算本身的信息、最近批准的预算更改和待审批的提议更改。待批准的提议更改(如果有)可在“pendingProposal”中找到。有关预算的有效详细信息可在前缀为“已批准”和“调整_”的字段中找到和没有前缀的变体由于某些有效详细信息可能与用户最初请求的信息不同(例如支出限额),因此这些差异并排显示在“proposed_”“已批准”和“adjusted_”中,也可能是“adjusted_”字段。
该资源已使用 AccountBudgetProposal 进行变更,因此无法直接修改。在任意给定时间,一项预算最多只能有一个待处理的提案。将通过 pendingProposal 进行读取。
获得批准后,预算可能需要进行调整(例如贷记调整)。调整会导致“已批准”和“调整后”字段,这两个字段在其他方面是相同的。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。账号级预算的资源名称。AccountBudget 资源名称采用以下格式:
|
status |
仅限输出。此账号级预算的状态。 |
totalAdjustmentsMicros |
仅限输出。总调整金额。 礼节性赠送金额的一个例子就是调整项。 |
amountServedMicros |
仅限输出。已投放的广告的值,以微单位表示。 其中包括超额投放费用,在这种情况下,系统可能会自动向相应预算应用赠送金额(请参阅 totalAdjustmentsMicros)。 |
pendingProposal |
仅限输出。用于修改此预算的待处理提案(如果适用)。 |
id |
仅限输出。账号级预算的 ID。 |
billingSetup |
仅限输出。与此账号级预算关联的结算设置的资源名称。BillingSetup 资源名称采用以下格式:
|
name |
仅限输出。账号级预算的名称。 |
proposedStartDateTime |
仅限输出。账号级预算的提议开始时间,格式为 yyyy-MM-dd HH:mm:ss。如果建议的开始时间类型为 NOW,则此字段为请求时间。 |
approvedStartDateTime |
仅限输出。账号级预算的已批准开始时间,格式为 yyyy-MM-dd HH:mm:ss。 例如,如果新预算在建议的开始时间之后获得批准,那么获得批准的开始时间就是审批的时间。 |
purchaseOrderNumber |
仅限输出。采购订单编号是一个值,有助于用户在月度账单中参考此预算。 |
notes |
仅限输出。与预算相关的备注。 |
联合字段 proposed_end_time 。账号级预算的建议结束时间。proposed_end_time 只能是下列其中一项: |
|
proposedEndDateTime |
仅限输出。建议的结束时间,格式为 yyyy-MM-dd HH:mm:ss。 |
proposedEndTimeType |
仅限输出。建议的结束时间,采用明确定义的类型,例如 FOREVER。 |
联合字段 例如,如果预算的结束时间已更新,且提案在建议的结束时间之后获得批准,则批准的结束时间就是批准的时间。 |
|
approvedEndDateTime |
仅限输出。已获批准的结束时间,格式为 yyyy-MM-dd HH:mm:ss。 |
approvedEndTimeType |
仅限输出。已获批准的结束时间,采用明确定义的类型,例如 FOREVER。 |
联合字段 proposed_spending_limit 。建议的支出限额。proposed_spending_limit 只能是下列其中一项: |
|
proposedSpendingLimitMicros |
仅限输出。建议的支出限额(以微单位表示)。一百万个微单位为一个单位。 |
proposedSpendingLimitType |
仅限输出。建议的支出限额,采用明确定义的类型,例如 INFINITE。 |
联合字段 例如,如果在提案获得批准时账号已支出的金额超过了建议的支出限额,则已批准的支出限额将设置为已支出的金额。 |
|
approvedSpendingLimitMicros |
仅限输出。已获批准的支出限额(以微单位表示)。一百万个单位相当于一个单位。只有当建议的支出限额有限时,系统才会填充此字段,并且该限额会始终大于或等于建议的支出限额。 |
approvedSpendingLimitType |
仅限输出。已获批准的支出限额(明确定义类型),例如 INFINITE。仅当已获批准的支出限额为 INFINITE 时,此字段才会填充。 |
联合字段 此值是账号支出金额的最终决定因素。 |
|
adjustedSpendingLimitMicros |
仅限输出。调整后的支出限额(以微单位表示)。一百万个微单位为一个单位。 如果已获批准的支出限额有限,调整后的支出限额可能会因适用于此预算的调整项类型(如适用)而异。 要了解不同类型的调整项,请访问:https://support.google.com/google-ads/answer/1704323 例如,借记调整项会减少账号可以支出的金额。 |
adjustedSpendingLimitType |
仅限输出。经过调整的支出限额,采用明确定义的类型,例如 INFINITE。仅当调整后的支出限额为 INFINITE(如果已批准的支出限额为 INFINITE)时,系统才会填充此字段。 |
AccountBudgetStatus
AccountBudget 的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
PENDING |
账号预算正在等待审批。 |
APPROVED |
账号预算已获批准。 |
CANCELLED |
用户已取消账号预算。 |
PendingAccountBudgetProposal
与所属账号级预算关联的待处理提案(如果有)。
JSON 表示法 |
---|
{ "proposalType": enum ( |
字段 | |
---|---|
proposalType |
仅限输出。此提案的类型,例如 END(结束与此提案相关联的预算)。 |
accountBudgetProposal |
仅限输出。提案的资源名称。AccountBudgetProposal 资源名称采用以下格式:
|
name |
仅限输出。要分配给账号级预算的名称。 |
startDateTime |
仅限输出。开始时间,格式为 yyyy-MM-dd HH:mm:ss。 |
purchaseOrderNumber |
仅限输出。采购订单编号是一个值,有助于用户在月度账单中参考此预算。 |
notes |
仅限输出。与此预算相关的备注。 |
creationDateTime |
仅限输出。此账号级预算建议的创建时间。格式为 yyyy-MM-dd HH:mm:ss。 |
联合字段 end_time 。账号级预算的结束时间。end_time 只能是下列其中一项: |
|
endDateTime |
仅限输出。结束时间,格式为 yyyy-MM-dd HH:mm:ss。 |
endTimeType |
仅限输出。明确定义的类型的结束时间,例如 FOREVER。 |
联合字段 spending_limit 。支出限额。spending_limit 只能是下列其中一项: |
|
spendingLimitMicros |
仅限输出。支出限额(以微单位表示)。一百万个微单位为一个单位。 |
spendingLimitType |
仅限输出。支出限额,是明确定义的类型,例如 INFINITE。 |
AdGroupAdAssetCombinationView
广告组广告素材资源组合使用情况视图。现在,对于自适应搜索广告,我们仅支持 AdGroupAdAssetCombinationView,未来将支持更多广告类型。
JSON 表示法 |
---|
{
"resourceName": string,
"servedAssets": [
{
object ( |
字段 | |
---|---|
resourceName |
仅限输出。广告组广告素材资源组合视图的资源名称。组合 ID 的长度为 128 位,其中高 64 位存储在 asset_combination_id_high 中,低 64 位存储在 asset_combination_id_low 中。广告组广告素材资源组合视图资源名称采用以下格式: |
servedAssets[] |
仅限输出。投放的素材资源。 |
enabled |
仅限输出。素材资源组合与广告最新版本的状态。如果值为 true,则素材资源组合会关联到最新版本的广告。如果为 false,则表示该链接曾经存在,但已被移除,不再出现在最新版本的广告中。 |
AssetUsage
包含相应资产的使用情况信息。
JSON 表示法 |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
字段 | |
---|---|
asset |
资产的资源名称。 |
servedAssetFieldType |
素材资源的已投放字段类型。 |
AdGroupAdAssetView
AdGroupAd 与素材资源之间的关联。目前,对于应用广告系列和自适应搜索广告,我们仅支持 AdGroupAdAssetView。
JSON 表示法 |
---|
{ "resourceName": string, "fieldType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。广告组广告素材资源视图的资源名称。广告组广告素材资源视图资源名称采用以下形式(V4 之前):
广告组广告素材资源视图资源名称采用以下格式(从 V4 开始):
|
fieldType |
仅限输出。素材资源在广告中担任的角色。 |
policySummary |
仅限输出。广告组广告素材资源的政策信息。 |
performanceLabel |
仅限输出。素材资源关联的效果。 |
pinnedField |
仅限输出。固定字段。 |
source |
仅限输出。广告组广告素材资源的来源。 |
adGroupAd |
仅限输出。与素材资源相关联的广告组广告。 |
asset |
仅限输出。与广告组广告相关联的素材资源。 |
enabled |
仅限输出。素材资源与广告的最新版本之间的状态。如果值为 true,则素材资源会关联到广告的最新版本。如果为 false,则表示该链接曾经存在,但已被移除,不再出现在最新版本的广告中。 |
AdGroupAdAssetPolicySummary
包含某个广告组广告素材资源的政策信息。
JSON 表示法 |
---|
{ "policyTopicEntries": [ { object ( |
字段 | |
---|---|
policyTopicEntries[] |
仅限输出。广告组广告素材资源的政策发现结果列表。 |
reviewStatus |
仅限输出。此广告组广告素材资源处于审核流程的哪个阶段。 |
approvalStatus |
仅限输出。此广告组广告素材资源的总体审批状态,根据其各个政策主题条目的状态计算得出。 |
AdGroupAudienceView
广告组受众群体视图。包括来自展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据,在受众群体一级汇总。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式:
|
AdGroupCriterionSimulation
广告组条件模拟。下面分别详细介绍了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法组合。Hotel AdGroupCriterion 模拟操作从 V5 开始。
- 展示 - 关键字 - CPC_BID - 统一
- 搜索 - 关键字 - CPC_BID - UNIFORM
- 购物 - LISTING_GROUP - CPC_出价 - 统一
- 酒店 - LISTING_GROUP - CPC_BID - 统一
- 酒店 - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。广告组条件模拟的资源名称。广告组条件模拟资源名称采用以下格式:
|
type |
仅限输出。模拟所修改的字段。 |
modificationMethod |
仅限输出。模拟如何修改字段。 |
adGroupId |
仅限输出。模拟的广告组 ID。 |
criterionId |
仅限输出。模拟的条件 ID。 |
startDate |
仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。 |
endDate |
仅限输出。模拟所依据的最后一天,采用 YYYY-MM-DD 格式。 |
联合字段 point_list 。模拟点列表。point_list 只能是下列其中一项: |
|
cpcBidPointList |
仅限输出。如果模拟类型为 CPC_BID,则模拟数据点。 |
percentCpcBidPointList |
仅限输出。如果模拟类型为 PERCENT_CPC_BID,则模拟值为 PERCENT_CPC_BID。 |
SimulationType
描述模拟所修改字段的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
CPC_BID |
此模拟针对的是每次点击费用出价。 |
CPV_BID |
模拟的是每次视频播放费用出价。 |
TARGET_CPA |
该模拟针对的是 CPA 目标。 |
BID_MODIFIER |
模拟是针对出价调节系数。 |
TARGET_ROAS |
模拟的是广告支出回报率目标值。 |
PERCENT_CPC_BID |
模拟的是采用百分比形式的每次点击费用出价。 |
TARGET_IMPRESSION_SHARE |
此模拟针对的是展示次数份额目标。 |
BUDGET |
该模拟针对的是预算。 |
SimulationModificationMethod
描述模拟修改字段所用的方法的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
UNIFORM |
模拟中的值将值统一应用于给定资源的所有子项。未遵循对子资源的替换。 |
DEFAULT |
模拟中的值应用于指定资源。系统考虑了对子资源的替换,因此流量估算值未纳入这些资源。 |
SCALING |
模拟中的值均按相同系数进行了调整。例如,在模拟的 TargetCpa 广告系列中,广告系列目标和所有广告组目标都按 X 系数进行了调整。 |
CpcBidSimulationPointList
CPC_BID 类型的模拟的模拟点容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列每次点击费用出价金额的预计指标。 |
CpcBidSimulationPoint
特定每次点击费用出价金额的预计指标。
JSON 表示法 |
---|
{ "requiredBudgetAmountMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, // Union field |
字段 | |
---|---|
requiredBudgetAmountMicros |
广告客户为获得估算流量而必须设置的预计每日预算(以广告客户币种的微单位表示)。 |
biddableConversions |
预计可出价转化次数。 |
biddableConversionsValue |
可出价转化的预计总价值。 |
clicks |
预计点击次数。 |
costMicros |
以微单位表示的预计费用。 |
impressions |
预计展示次数。 |
topSlotImpressions |
预计页首广告位展示次数。只有搜索广告渠道类型支持此字段。 |
联合字段 cpc_simulation_key_value 。当 SimulationModificationMethod = UNIFORM 或 DEFAULT 时,系统会设置 cpc_bid_micros。当 SimulationModificationMethod = SCALING 时,系统会设置 cpc_bid_scaling_modifier。cpc_simulation_key_value 只能是下列其中一项: |
|
cpcBidMicros |
预计指标所依据的模拟每次点击费用出价。 |
cpcBidScalingModifier |
预测指标所依据的模拟缩放调节系数。与所模拟的实体相关的所有每次点击费用出价均按此系数调整。 |
PercentCpcBidSimulationPointList
PERCENT_CPC_BID 类型的模拟的模拟点容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列百分比形式的每次点击费用出价金额的预计指标。 |
PercentCpcBidSimulationPoint
特定百分比的每次点击费用金额的预计指标。只有酒店广告渠道类型支持此字段。
JSON 表示法 |
---|
{ "percentCpcBidMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
字段 | |
---|---|
percentCpcBidMicros |
预计指标所依据的模拟每次点击费用百分比。百分比形式的每次点击费用,表示为某些商品或服务的广告价格的一部分。此处存储的值为 1,000,000 * [分数]。 |
biddableConversions |
预计可出价转化次数。 |
biddableConversionsValue |
可出价转化的预计总价值(本地货币)。 |
clicks |
预计点击次数。 |
costMicros |
以微单位表示的预计费用。 |
impressions |
预计展示次数。 |
topSlotImpressions |
预计页首广告位展示次数。 |
AdGroupSimulation
广告组模拟。下面分别详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法组合。
- 搜索 - CPC_BID - 默认
- 搜索 - CPC_BID - UNIFORM
- 搜索广告 - 目标每次转化费用 - 统一
- 搜索广告系列 - 目标广告支出回报率 - 统一
- 展示 - CPC_BID - 默认
- 展示 - CPC_BID - 统一
- 展示广告 - 目标每次转化费用 - 统一
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。广告组模拟的资源名称。广告组模拟资源名称采用以下格式:
|
type |
仅限输出。模拟所修改的字段。 |
modificationMethod |
仅限输出。模拟如何修改字段。 |
adGroupId |
仅限输出。模拟的广告组 ID。 |
startDate |
仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。 |
endDate |
仅限输出。模拟最后一天,采用 YYYY-MM-DD 格式 |
联合字段 point_list 。模拟点列表。point_list 只能是下列其中一项: |
|
cpcBidPointList |
仅限输出。如果模拟类型为 CPC_BID,则模拟数据点。 |
cpvBidPointList |
仅限输出。如果模拟类型为 CPV_BID,则模拟值。 |
targetCpaPointList |
仅限输出。如果模拟类型为 TARGET_CPA,则模拟点。 |
targetRoasPointList |
仅限输出。如果模拟类型为 TARGET_ROAS,则模拟得分。 |
CpvBidSimulationPointList
“CPV_BID”类型的模拟所代表的模拟点的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列每次观看费用出价金额的预计指标。 |
CpvBidSimulationPoint
特定每次观看费用出价金额的预计指标。
JSON 表示法 |
---|
{ "cpvBidMicros": string, "costMicros": string, "impressions": string, "views": string } |
字段 | |
---|---|
cpvBidMicros |
每次观看费用的模拟出价,预测指标将根据此出价计算得出。 |
costMicros |
以微单位表示的预计费用。 |
impressions |
预计展示次数。 |
views |
预计观看次数。 |
TargetCpaSimulationPointList
“TARGET_CPA”类型的模拟的模拟点容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列目标每次转化费用金额的预计指标。 |
TargetCpaSimulationPoint
特定目标每次转化费用金额的预计指标。
JSON 表示法 |
---|
{ "requiredBudgetAmountMicros": string, "appInstalls": number, "inAppActions": number, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, "interactions": string, // Union field |
字段 | |
---|---|
requiredBudgetAmountMicros |
广告客户为获得估算流量而必须设置的预计每日预算(以广告客户币种的微单位表示)。 |
appInstalls |
预计应用安装次数。 |
inAppActions |
应用内操作次数的预计值。 |
biddableConversions |
预计可出价转化次数。 |
biddableConversionsValue |
可出价转化的预计总价值。 |
clicks |
预计点击次数。 |
costMicros |
以微单位表示的预计费用。 |
impressions |
预计展示次数。 |
topSlotImpressions |
预计页首广告位展示次数。只有搜索广告渠道类型支持此字段。 |
interactions |
预计互动次数。只有发现广告渠道类型支持此字段。 |
联合字段 target_cpa_simulation_key_value 。当 SimulationModificationMethod = UNIFORM 或 DEFAULT 时,系统会设置 target_cpa_micros。当 SimulationModificationMethod = SCALING 时,系统会设置 target_cpa_Scaling_modifier。target_cpa_simulation_key_value 只能是下列其中一项: |
|
targetCpaMicros |
预计指标所依据的模拟目标每次转化费用。 |
targetCpaScalingModifier |
预测指标所依据的模拟缩放调节系数。与模拟实体相关的所有每次转化费用目标值都将根据此修饰符进行调整。 |
TargetRoasSimulationPointList
包含“TARGET_ROAS”类型的模拟的模拟点的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列目标广告支出回报率金额的预计指标。 |
TargetRoasSimulationPoint
特定目标广告支出回报率金额的预计指标。
JSON 表示法 |
---|
{ "requiredBudgetAmountMicros": string, "targetRoas": number, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
字段 | |
---|---|
requiredBudgetAmountMicros |
广告客户为获得估算流量而必须设置的预计每日预算(以广告客户币种的微单位表示)。 |
targetRoas |
预计指标所依据的模拟目标广告支出回报率。 |
biddableConversions |
预计可出价转化次数。 |
biddableConversionsValue |
可出价转化的预计总价值。 |
clicks |
预计点击次数。 |
costMicros |
以微单位表示的预计费用。 |
impressions |
预计展示次数。 |
topSlotImpressions |
预计页首广告位展示次数。只有搜索广告渠道类型支持此字段。 |
AgeRangeView
年龄段视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。年龄段视图的资源名称。年龄段视图资源名称采用以下格式:
|
AdScheduleView
广告投放时间视图按 AdSchedule 条件汇总了广告系列的效果。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。广告投放时间视图的资源名称。AdSchedule 视图资源名称采用以下格式:
|
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 |
仅限输出。网域类别的资源名称。网域类别资源名称采用以下格式:
|
campaign |
仅限输出。建议为哪个广告系列添加此类别。 |
category |
仅限输出。为网站网域推荐的类别,例如,如果您有一个电子产品网站,则类别可以是“相机”、“电视”等。 |
languageCode |
仅限输出。用于指定网站语言的语言代码,例如“en”表示英语。您可以在动态搜索广告所需的 DynamicSearchAdsSetting 中指定语言。这是您希望 Google Ads 在您的网站中查找、制作广告并匹配搜索内容的网页所使用的语言。 |
domain |
仅限输出。网站的域名。可以在动态搜索广告所需的 DynamicSearchAdsSetting 中指定网域。 |
coverageFraction |
仅限输出。您网站上与此类别相符的网页所占的比例。 |
categoryRank |
仅限输出。此类别在类别集中的位置。数字越小表示网域匹配度越高。null 表示不推荐使用。 |
hasChildren |
仅限输出。指明此类别是否有子类别。 |
recommendedCpcBidMicros |
仅限输出。针对相应类别建议的每次点击费用。 |
AssetFieldTypeView
素材资源字段类型视图。当素材资源用作附加信息时,此视图会报告每种素材资源字段类型的非多计指标。
JSON 表示法 |
---|
{
"resourceName": string,
"fieldType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。资产字段类型视图的资源名称。素材资源字段类型视图资源名称采用以下格式:
|
fieldType |
仅限输出。资产字段类型视图的资产字段类型。 |
ChannelAggregateAssetView
渠道级汇总素材资源视图,显示素材资源的关联位置、效果和统计信息。
JSON 表示法 |
---|
{ "resourceName": string, "advertisingChannelType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。渠道汇总资产视图的资源名称。渠道汇总资产视图资源名称采用以下格式:
|
advertisingChannelType |
仅限输出。素材资源投放到的渠道。 |
asset |
仅限输出。资产的 ID。 |
assetSource |
仅限输出。素材资源链接的来源。 |
fieldType |
仅限输出。资产的 FieldType。 |
CampaignAggregateAssetView
广告系列级汇总素材资源视图,显示素材资源的关联位置、效果和统计信息。
JSON 表示法 |
---|
{ "resourceName": string, "campaign": string, "asset": string, "assetSource": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。广告系列汇总素材资源视图的资源名称。广告系列汇总素材资源视图资源名称采用以下格式:
|
campaign |
仅限输出。素材资源投放到的广告系列。 |
asset |
仅限输出。资产的 ID。 |
assetSource |
仅限输出。素材资源链接的来源。 |
fieldType |
仅限输出。资产的 FieldType。 |
AssetGroupProductGroupView
素材资源组的产品组视图。
JSON 表示法 |
---|
{ "resourceName": string, "assetGroup": string, "assetGroupListingGroupFilter": string } |
字段 | |
---|---|
resourceName |
仅限输出。素材资源组产品组视图的资源名称。素材资源组产品组视图资源名称采用以下格式:
|
assetGroup |
仅限输出。与产品信息组过滤条件相关联的素材资源组。 |
assetGroupListingGroupFilter |
仅限输出。素材资源组产品信息组过滤条件的资源名称。 |
AssetGroupTopCombinationView
广告组广告素材资源组合使用情况视图。
JSON 表示法 |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
字段 | |
---|---|
resourceName |
仅限输出。素材资源组顶级组合视图的资源名称。素材资源组热门组合视图资源名称采用以下格式:"customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}" |
assetGroupTopCombinations[] |
仅限输出。一起投放的效果最佳的素材资源组合。 |
AssetGroupAssetCombinationData
素材资源组的素材资源组合数据
JSON 表示法 |
---|
{
"assetCombinationServedAssets": [
{
object ( |
字段 | |
---|---|
assetCombinationServedAssets[] |
仅限输出。投放的素材资源。 |
AssetSetTypeView
素材资源集类型视图。此视图报告了每种素材资源集类型的未多计指标。此报告不包含子素材资源组类型。素材资源的统计信息将汇总到父级素材资源组类型下。
JSON 表示法 |
---|
{
"resourceName": string,
"assetSetType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。素材资源集类型视图的资源名称。素材资源组类型视图资源名称采用以下格式:
|
assetSetType |
仅限输出。素材资源集类型视图的素材资源集类型。 |
BiddingStrategySimulation
出价策略模拟。下面分别详细介绍了支持的模拟类型和模拟修改方法组合。
- 目标每次转化费用 - 统一
- 目标广告支出回报率 - 统一
JSON 表示法 |
---|
{ "resourceName": string, "biddingStrategyId": string, "type": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。出价策略模拟的资源名称。出价策略模拟资源名称采用以下格式:
|
biddingStrategyId |
仅限输出。模拟的出价策略共享集 ID。 |
type |
仅限输出。模拟所修改的字段。 |
modificationMethod |
仅限输出。模拟如何修改字段。 |
startDate |
仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。 |
endDate |
仅限输出。模拟最后一天,采用 YYYY-MM-DD 格式 |
联合字段 point_list 。模拟点列表。point_list 只能是下列其中一项: |
|
targetCpaPointList |
仅限输出。如果模拟类型为 TARGET_CPA,则模拟点。 |
targetRoasPointList |
仅限输出。如果模拟类型为 TARGET_ROAS,则模拟得分。 |
CallView
一种来电视图,其中包含来电专用广告或附加电话信息的来电跟踪数据。
JSON 表示法 |
---|
{ "resourceName": string, "callerCountryCode": string, "callerAreaCode": string, "callDurationSeconds": string, "startCallDateTime": string, "endCallDateTime": string, "callTrackingDisplayLocation": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。通话视图的资源名称。调用视图资源名称采用以下格式:
|
callerCountryCode |
仅限输出。来电者的国家/地区代码。 |
callerAreaCode |
仅限输出。呼叫者的区号。如果通话时长短于 15 秒,则为 null。 |
callDurationSeconds |
仅限输出。广告客户提供的通话时长(以秒为单位)。 |
startCallDateTime |
仅限输出。广告客户提供的通话开始日期和时间。 |
endCallDateTime |
仅限输出。广告客户提供的通话结束日期时间。 |
callTrackingDisplayLocation |
仅限输出。通话跟踪显示位置。 |
type |
仅限输出。调用的类型。 |
callStatus |
仅限输出。通话的状态。 |
CallTrackingDisplayLocation
可能的来电跟踪展示广告位置。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AD |
通过广告拨打的电话。 |
LANDING_PAGE |
从着陆页广告拨打的电话所指向的号码。 |
CallType
可能从中进行调用的属性类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MANUALLY_DIALED |
已手动拨打此电话。 |
HIGH_END_MOBILE_SEARCH |
该电话采用移动点击通话。 |
GoogleVoiceCallStatus
Google Voice 通话的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MISSED |
错过了来电。 |
RECEIVED |
接到来电。 |
CampaignAudienceView
广告系列受众群体视图。包括展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 中的效果数据,按广告系列和受众群体条件汇总。此视图仅包含在广告系列一级添加的受众群体。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。广告系列受众群体视图的资源名称。广告系列受众群体视图资源名称采用以下格式:
|
CampaignSearchTermInsight
广告系列搜索字词视图。历史数据从 2023 年 3 月开始提供。
JSON 表示法 |
---|
{ "resourceName": string, "categoryLabel": string, "id": string, "campaignId": string } |
字段 | |
---|---|
resourceName |
仅限输出。广告系列级搜索字词数据分析的资源名称。广告系列级搜索字词数据分析资源名称采用以下格式:
|
categoryLabel |
仅限输出。搜索类别的标签。空字符串表示不属于其他类别的搜索字词的综合类别。 |
id |
仅限输出。数据分析的 ID。 |
campaignId |
仅限输出。广告系列的 ID。 |
CampaignSimulation
广告系列模拟。下面分别详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法组合。
- 搜索 - CPC_BID - UNIFORM
- 搜索 - CPC_BID - 扩展
- 搜索广告 - 目标每次转化费用 - 统一
- 搜索广告系列 - 目标每次转化费用 - 扩展
- 搜索广告系列 - 目标广告支出回报率 - 统一
- 搜索 - 目标展示次数份额 - 统一
- 搜索广告系列 - 预算 - 统一
- 购物广告系列 - 预算 - 统一
- 购物 - 目标广告支出回报率 - 统一
- 多渠道 - 目标每次转化费用 - 统一
- 多渠道 - 目标广告支出回报率 - 统一
- 发现广告系列 - 目标每次转化费用 - 默认
- 展示广告 - 目标每次转化费用 - 统一
- 效果最大化 - 目标每次转化费用 - 统一
- 效果最大化 - 目标广告支出回报率 - 统一
- PERFORMANCE_MAX - 预算 - UNIFORM
JSON 表示法 |
---|
{ "resourceName": string, "campaignId": string, "type": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。广告系列模拟的资源名称。广告系列模拟资源名称采用以下格式:
|
campaignId |
仅限输出。模拟的广告系列 ID。 |
type |
仅限输出。模拟所修改的字段。 |
modificationMethod |
仅限输出。模拟如何修改字段。 |
startDate |
仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。 |
endDate |
仅限输出。模拟最后一天,采用 YYYY-MM-DD 格式 |
联合字段 point_list 。模拟点列表。point_list 只能是下列其中一项: |
|
cpcBidPointList |
仅限输出。如果模拟类型为 CPC_BID,则模拟数据点。 |
targetCpaPointList |
仅限输出。如果模拟类型为 TARGET_CPA,则模拟点。 |
targetRoasPointList |
仅限输出。如果模拟类型为 TARGET_ROAS,则模拟得分。 |
targetImpressionSharePointList |
仅限输出。如果模拟类型为 TARGET_IMPRESSION_SHARE,则模拟点。 |
budgetPointList |
仅限输出。如果模拟类型为 BUDGET,则模拟得分。 |
BudgetSimulationPointList
预算类型模拟的模拟点容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列预算金额的预计指标。 |
BudgetSimulationPoint
特定预算金额的预计指标。
JSON 表示法 |
---|
{ "budgetAmountMicros": string, "requiredCpcBidCeilingMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, "interactions": string } |
字段 | |
---|---|
budgetAmountMicros |
预计指标所依据的模拟预算。 |
requiredCpcBidCeilingMicros |
为实现此模拟,广告客户必须设置预计的每日每次点击费用出价上限(以广告客户币种的微单位表示)。只有采用“目标支出”出价策略的广告系列才支持此字段。 |
biddableConversions |
预计可出价转化次数。 |
biddableConversionsValue |
可出价转化的预计总价值。 |
clicks |
预计点击次数。 |
costMicros |
以微单位表示的预计费用。 |
impressions |
预计展示次数。 |
topSlotImpressions |
预计页首广告位展示次数。只有搜索广告渠道类型支持此字段。 |
interactions |
预计互动次数。只有发现广告渠道类型支持此字段。 |
CarrierConstant
可在广告系列定位中使用的运营商条件。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "countryCode": string } |
字段 | |
---|---|
resourceName |
仅限输出。运营商标准的资源名称。运营商条件资源名称采用以下格式:
|
id |
仅限输出。运营商标准的 ID。 |
name |
仅限输出。运营商的英文全称。 |
countryCode |
仅限输出。运营商所在国家/地区的国家/地区代码,例如“AR”、“FR”等。 |
ChangeEvent
描述特定资源类型的返回资源的精细变化。包含过去 30 天内通过界面或 API 所做的更改。系统会显示更改后的字段的旧值和新值。ChangeEvent 最多延迟 3 分钟才能反映新的更改。
JSON 表示法 |
---|
{ "resourceName": string, "changeDateTime": string, "changeResourceType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。更改事件的资源名称。更改事件资源名称采用以下格式:
|
changeDateTime |
仅限输出。对此资源提交更改的时间。 |
changeResourceType |
仅限输出。发生更改的资源的类型。该参数指示要在 oldResource 和 newResource 中设置哪些资源。 |
changeResourceName |
仅限输出。发生此更改的 Simple 资源。 |
clientType |
仅限输出。完成更改的地方。 |
userEmail |
仅限输出。执行此项更改的用户的电子邮件地址。 |
oldResource |
仅限输出。更改前的旧资源。系统只会填充已更改的字段。 |
newResource |
仅限输出。更改后的新资源。系统只会填充已更改的字段。 |
resourceChangeOperation |
仅限输出。对已更改的资源执行的操作。 |
changedFields |
仅限输出。所返回资源中发生更改的字段列表。 这是完全限定字段名称的逗号分隔列表。示例: |
campaign |
仅限输出。受此更改影响的广告系列。 |
adGroup |
仅限输出。受此更改影响的广告组。 |
feed |
仅限输出。受此更改影响的 Feed。 |
feedItem |
仅限输出。受此更改影响的 FeedItem。 |
asset |
仅限输出。受此更改影响的资产。 |
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 同步所做的更改。 |
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 |
仅限输出。在 changeResourceType == AD 时设置。 |
adGroup |
仅限输出。在 changeResourceType == AD_GROUP 时设置。 |
adGroupCriterion |
仅限输出。在 changeResourceType == AD_GROUP_CRITERION 时设置。 |
campaign |
仅限输出。在 changeResourceType == CAMPAIGN 时设置。 |
campaignBudget |
仅限输出。在 changeResourceType == CAMPAIGN_BUDGET 时设置。 |
adGroupBidModifier |
仅限输出。在 changeResourceType == AD_GROUP_BID_MODIFIER 时设置。 |
campaignCriterion |
仅限输出。在 changeResourceType == CAMPAIGN_CRITERION 时设置。 |
feed |
仅限输出。在 changeResourceType == FEED 时设置。 |
feedItem |
仅限输出。在 changeResourceType == FEED_ITEM 时设置。 |
campaignFeed |
仅限输出。在 changeResourceType == CAMPAIGN_FEED 时设置。 |
adGroupFeed |
仅限输出。在 changeResourceType == AD_GROUP_FEED 时设置。 |
adGroupAd |
仅限输出。在 changeResourceType == AD_GROUP_AD 时设置。 |
asset |
仅限输出。在 changeResourceType == ASSET 时设置。 |
customerAsset |
仅限输出。在 changeResourceType == CUSTOMER_ASSET 时设置。 |
campaignAsset |
仅限输出。在 changeResourceType == CAMPAIGN_ASSET 时设置。 |
adGroupAsset |
仅限输出。在 changeResourceType == AD_GROUP_ASSET 时设置。 |
assetSet |
仅限输出。在 changeResourceType == ASSET_SET 时设置。 |
assetSetAsset |
仅限输出。在 changeResourceType == ASSET_SET_ASSET 时设置。 |
campaignAssetSet |
仅限输出。在 changeResourceType == CAMPAIGN_ASSET_SET 时设置。 |
ResourceChangeOperation
对 changeEvent 资源中已更改的资源的操作。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的未分类操作。 |
CREATE |
资源已创建。 |
UPDATE |
资源已修改。 |
REMOVE |
已移除资源。 |
ChangeStatus
描述所返回资源的状态。ChangeStatus 最多可能延迟 3 分钟才能反映新的更改。
JSON 表示法 |
---|
{ "resourceName": string, "resourceType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。更改状态的资源名称。更改状态资源名称采用以下格式:
|
resourceType |
仅限输出。表示已更改资源的类型。该参数指示将设置哪些字段。例如,对于 AD_GROUP,系统会设置 campaign 和 adGroup 字段。 |
resourceStatus |
仅限输出。表示已更改的资源的状态。 |
sharedSet |
仅限输出。受此更改影响的 SharedSet。 |
campaignSharedSet |
仅限输出。受此更改影响的 CampaignSharedSet。 |
asset |
仅限输出。受此更改影响的资产。 |
customerAsset |
仅限输出。受此更改影响的 CustomerAsset。 |
campaignAsset |
仅限输出。受此更改影响的 CampaignAsset。 |
adGroupAsset |
仅限输出。受此更改影响的 AdGroupAsset。 |
combinedAudience |
仅限输出。受此更改影响的 CombinedAudience。 |
assetGroup |
仅限输出。受此更改影响的 AssetGroup。 |
lastChangeDateTime |
仅限输出。此资源上发生最新更改的时间。 |
campaign |
仅限输出。受此更改影响的广告系列。 |
adGroup |
仅限输出。受此更改影响的广告组。 |
adGroupAd |
仅限输出。受此更改影响的 AdGroupAd。 |
adGroupCriterion |
仅限输出。受此更改影响的 AdGroupCriterion。 |
campaignCriterion |
仅限输出。受此更改影响的 CampaignCriterion。 |
feed |
仅限输出。受此更改影响的 Feed。 |
feedItem |
仅限输出。受此更改影响的 FeedItem。 |
adGroupFeed |
仅限输出。受此更改影响的 AdGroupFeed。 |
campaignFeed |
仅限输出。受此更改影响的 CampaignFeed。 |
adGroupBidModifier |
仅限输出。受此更改影响的 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 |
Asset 资源更改。 |
CUSTOMER_ASSET |
CustomerAsset 资源发生了更改。 |
CAMPAIGN_ASSET |
CampaignAsset 资源更改。 |
AD_GROUP_ASSET |
更改了 AdGroupAsset 资源。 |
COMBINED_AUDIENCE |
CombinedAudience 资源更改。 |
ASSET_GROUP |
AssetGroup 资源发生更改。 |
ChangeStatusOperation
已更改的资源的状态
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的未分类资源。 |
ADDED |
资源已创建。 |
CHANGED |
资源已修改。 |
REMOVED |
已移除资源。 |
CombinedAudience
为包含不同受众群体的组合受众群体描述资源。
JSON 表示法 |
---|
{
"resourceName": string,
"id": string,
"status": enum ( |
字段 | |
---|---|
resourceName |
不可变。组合的受众群体的资源名称。组合的受众群体名称采用以下格式:
|
id |
仅限输出。组合的受众群体的 ID。 |
status |
仅限输出。此组合受众群体的状态。指明组合的受众群体是已启用还是已移除。 |
name |
仅限输出。组合的受众群体的名称。它在所有组合的受众群体中应该是唯一的。 |
description |
仅限输出。此组合受众群体的说明。 |
CombinedAudienceStatus
包含可能的组合受众群体状态类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
“已启用”状态 - 组合的受众群体已启用,可进行定位。 |
REMOVED |
“已移除”状态 - 组合的受众群体已移除,无法用于定位。 |
ClickView
点击视图,其中包含每个点击级别的汇总指标,包括有效点击次数和无效点击。对于非搜索广告系列,metrics.clicks 表示有效和无效互动次数。包含 ClickView 的查询必须具有将结果限制在一天的过滤器,并且可请求日期早于请求时间 90 天内的结果。
JSON 表示法 |
---|
{ "resourceName": string, "areaOfInterest": { object ( |
字段 | |
---|---|
resourceName |
仅限输出。点击视图的资源名称。点击视图资源名称采用以下格式:
|
areaOfInterest |
仅限输出。与相应展示相关联的关注区域相匹配的地理位置条件。 |
locationOfPresence |
仅限输出。与相应展示所关联的广告展示地理位置相匹配的地理位置条件。 |
keyword |
仅限输出。相关关键字(如果存在),并且点击对应于搜索渠道。 |
keywordInfo |
仅限输出。有关相关关键字的基本信息(如果存在)。 |
gclid |
仅限输出。Google 点击 ID。 |
pageNumber |
仅限输出。展示广告的页面在搜索结果中的页码。 |
adGroupAd |
仅限输出。关联的广告。 |
campaignLocationTarget |
仅限输出。关联的广告系列地理位置定位目标(如果存在)。 |
userList |
仅限输出。关联的用户列表(如果存在)。 |
ClickLocation
与点击相关联的地理位置条件。
JSON 表示法 |
---|
{ "city": string, "country": string, "metro": string, "mostSpecific": string, "region": string } |
字段 | |
---|---|
city |
与展示相关联的城市地理位置条件。 |
country |
与展示相关联的国家/地区地理位置条件。 |
metro |
与展示相关联的都市圈地理位置条件。 |
mostSpecific |
与展示相关联的最具体的地理位置条件。 |
region |
与展示相关联的区域位置条件。 |
CurrencyConstant
货币常量。
JSON 表示法 |
---|
{ "resourceName": string, "code": string, "name": string, "symbol": string, "billableUnitMicros": string } |
字段 | |
---|---|
resourceName |
仅限输出。货币常量的资源名称。货币常量资源名称采用以下格式:
|
code |
仅限输出。由三个字母组成的 ISO 4217 货币代码,例如“USD” |
name |
仅限输出。货币的英文全称。 |
symbol |
仅限输出。用于描述此货币的标准符号,例如“$”代表美元。 |
billableUnitMicros |
仅限输出。此币种的可结算单位。结算金额应为此值的倍数。 |
AccessibleBiddingStrategy
表示客户拥有并与客户共享的 BiddingStrategies 视图。
与 BiddingStrategy 相比,该资源除了包含该客户拥有的策略之外,还包含该客户拥有并与该客户共享的策略。此资源不提供指标,而且仅公开了部分 BiddingStrategy 属性。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。可访问的出价策略的资源名称。AccessibleBidStrategy 资源名称采用以下格式:
|
id |
仅限输出。出价策略的 ID。 |
name |
仅限输出。出价策略的名称。 |
type |
仅限输出。出价策略的类型。 |
ownerCustomerId |
仅限输出。拥有出价策略的客户的 ID。 |
ownerDescriptiveName |
仅限输出。拥有该出价策略的客户的描述性名称。 |
联合字段 您只能设置一个。 |
|
maximizeConversionValue |
仅限输出。这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。 |
maximizeConversions |
仅限输出。这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。 |
targetCpa |
仅限输出。一种出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。 |
targetImpressionShare |
仅限输出。一种出价策略,可自动针对选定百分比的展示次数进行优化。 |
targetRoas |
仅限输出。一种出价策略,可帮助您最大限度地提高收入,同时使平均广告支出回报率达到特定的目标值。 |
targetSpend |
仅限输出。这种出价策略会为您设置出价,帮助您在预算范围内争取尽可能多的点击。 |
MaximizeConversionValue
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。
JSON 表示法 |
---|
{ "targetRoas": number } |
字段 | |
---|---|
targetRoas |
仅限输出。目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。 |
MaximizeConversions
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
字段 | |
---|---|
targetCpaMicros |
仅限输出。目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。 |
TargetCpa
这是一种自动出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
字段 | |
---|---|
targetCpaMicros |
仅限输出。平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。 |
TargetRoas
这是一种自动出价策略,可帮助您尽可能提高收入,同时确保达到平均广告支出回报率。
JSON 表示法 |
---|
{ "targetRoas": number } |
字段 | |
---|---|
targetRoas |
仅限输出。所选单位支出的收入(基于转化数据)。 |
TargetSpend
这是一种自动出价策略,可为您设置适当的出价,助您在不超出预算的前提下为您争取尽可能多的点击。
JSON 表示法 |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
字段 | |
---|---|
targetSpendMicros |
仅限输出。尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 此字段已弃用,不应再使用。如需了解详情,请参阅 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。 |
cpcBidCeilingMicros |
仅限输出。可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。 |
CustomerClient
指定客户与客户之间的关联。CustomerClients 仅适用于经理账号。该数据会涵盖所有直接和间接客户客户,以及经理本身。
JSON 表示法 |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。客户客户的资源名称。CustomerClient 资源名称的格式为: |
appliedLabels[] |
仅限输出。发出请求的客户所拥有的标签的资源名称,这些标签应用于客户客户。标签资源名称采用以下格式:
|
status |
仅限输出。客户客户的状态。只读。 |
clientCustomer |
仅限输出。与指定客户相关联的客户-客户的资源名称。只读。 |
level |
仅限输出。指定客户与客户之间的距离。对于自链接,级别值为 0。只读。 |
timeZone |
仅限输出。客户端时区的通用语言区域数据代码库 (CLDR) 字符串表示法,例如 America/Los_Angeles。只读。 |
testAccount |
仅限输出。指明客户是否为测试账号。只读。 |
manager |
仅限输出。指明客户是否为经理。只读。 |
descriptiveName |
仅限输出。客户的描述性名称。只读。 |
currencyCode |
仅限输出。客户的货币代码(例如“USD”“EUR”)。只读。 |
id |
仅限输出。客户的 ID。只读。 |
CustomerSearchTermInsight
客户搜索字词视图。历史数据从 2023 年 3 月开始提供。
JSON 表示法 |
---|
{ "resourceName": string, "categoryLabel": string, "id": string } |
字段 | |
---|---|
resourceName |
仅限输出。客户级搜索字词数据分析的资源名称。客户级搜索字词数据分析资源名称采用以下格式:
|
categoryLabel |
仅限输出。搜索类别的标签。空字符串表示不属于其他类别的搜索字词的综合类别。 |
id |
仅限输出。数据分析的 ID。 |
DetailPlacementView
包含按广告组和网址或 YouTube 视频汇总的指标的视图。
JSON 表示法 |
---|
{
"resourceName": string,
"placementType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。展示位置详情视图的资源名称。详细展示位置视图资源名称采用以下格式:
|
placementType |
仅限输出。展示位置的类型,例如网站、YouTube 视频和移动应用。 |
placement |
仅限输出。详细一级的系统推荐的展示位置字符串,例如g.网站网址、移动应用 ID 或 YouTube 视频 ID。 |
displayName |
仅限输出。显示名称是网站的网址名称、YouTube 视频的 YouTube 视频名称,以及移动应用的翻译后的移动应用名称。 |
groupPlacementTargetUrl |
仅限输出。组展示位置的网址,例如网域、指向应用商店中移动应用的链接或 YouTube 频道网址。 |
targetUrl |
仅限输出。展示位置的网址,例如网站、应用商店中移动应用的链接或 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 ( |
字段 | |
---|---|
resourceName |
仅限输出。详细受众特征的资源名称。详细受众特征资源名称采用以下格式:
|
id |
仅限输出。详细受众特征的 ID。 |
name |
仅限输出。详细受众特征的名称。例如,“最高教育程度” |
parent |
仅限输出。详细受众特征的父级。 |
launchedToAll |
仅限输出。如果详细受众特征已面向所有频道和语言区域发布,则为“true”。 |
availabilities[] |
仅限输出。详细受众特征的适用范围信息。 |
CriterionCategoryAvailability
每个广告渠道的类别可用情况信息。
JSON 表示法 |
---|
{ "channel": { object ( |
字段 | |
---|---|
channel |
此类别可用的频道类型和子类型。 |
locale[] |
适用于频道类别的语言区域。 |
CriterionCategoryChannelAvailability
提供某个类别的广告渠道类型和子类型的信息。
JSON 表示法 |
---|
{ "availabilityMode": enum ( |
字段 | |
---|---|
availabilityMode |
频道可用性的格式。可以是 ALL_CHANNELS(不设置其余字段)、CHANNEL_TYPE(只设置 advertisingChannelType 类型,类别可供其下的所有子类型使用)或 CHANNEL_TYPE_AND_SUBTYPES(advertisingChannelType、advertisingChannelSubType 和 includeDefaultChannelSubType 都会设置)。 |
advertisingChannelType |
该类别可用的频道类型。 |
advertisingChannelSubType[] |
相应类别所能提供的频道类型下的频道子类型。 |
includeDefaultChannelSubType |
是否包含默认频道子类型。例如,如果 advertisingChannelType 为 DISPLAY 且 includeDefaultChannelSubType 为 false,则表示未设置渠道子类型的默认展示广告系列不包含在此可用性配置中。 |
CriterionCategoryChannelAvailabilityMode
包含可能的 CriterionCategoryChannelAvailabilityMode 的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ALL_CHANNELS |
该类别适用于所有渠道类型和子类型的广告系列。 |
CHANNEL_TYPE_AND_ALL_SUBTYPES |
该类别适用于具有特定渠道类型(包括其下所有子类型)的广告系列。 |
CHANNEL_TYPE_AND_SUBSET_SUBTYPES |
此类别适用于具有特定渠道类型和子类型的广告系列。 |
CriterionCategoryLocaleAvailability
有关某个类别适用于哪些语言区域的信息。
JSON 表示法 |
---|
{
"availabilityMode": enum ( |
字段 | |
---|---|
availabilityMode |
语言区域可用性的格式。可为 LAUNCHED_TO_ALL(国家/地区和语言均为空)、COUNTRY(仅设置国家/地区)、LANGUAGE(仅设置语言)、COUNTRY_AND_LANGUAGE(同时设置国家/地区和语言)。 |
countryCode |
与类别相关联的 ISO-3166-1 alpha-2 国家/地区代码。 |
languageCode |
与类别相关联的语言的 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 |
仅限输出。展示广告网络关键字视图的资源名称。展示广告网络关键字视图资源名称采用以下格式:
|
DistanceView
距离视图,其中的指标按用户与广告客户附加地址信息之间的距离进行汇总。每个 DistanceBucket 均包含在其距离范围内的所有展示,一次展示将影响所有包含用户距离的 DistanceBucket 的指标。
JSON 表示法 |
---|
{
"resourceName": string,
"distanceBucket": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。距离视图的资源名称。距离视图资源名称采用以下格式:
|
distanceBucket |
仅限输出。附加地址信息中的用户距离分组。 |
metricSystem |
仅限输出。如果 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 |
仅限输出。动态搜索广告搜索字词视图的资源名称。动态搜索广告搜索字词视图资源名称采用以下格式:
|
searchTerm |
仅限输出。搜索字词 此字段为只读字段。 |
headline |
仅限输出。动态搜索广告动态生成的标题。 此字段为只读字段。 |
landingPage |
仅限输出。为展示动态选择的着陆页网址。 此字段为只读字段。 |
pageUrl |
仅限输出。为展示机会投放的页面 Feed 项的网址。 此字段为只读字段。 |
hasNegativeKeyword |
仅限输出。如果查询与否定关键字匹配,则为 true。 此字段为只读字段。 |
hasMatchingKeyword |
仅限输出。如果查询已添加到指定关键字,则为“true”。 此字段为只读字段。 |
hasNegativeUrl |
仅限输出。如果查询与排除网址匹配,则返回 true。 此字段为只读字段。 |
ExpandedLandingPageView
着陆页视图,其中包含在扩展后的最终到达网址一级汇总的指标。
JSON 表示法 |
---|
{ "resourceName": string, "expandedFinalUrl": string } |
字段 | |
---|---|
resourceName |
仅限输出。展开后的着陆页视图的资源名称。扩展后的着陆页视图资源名称采用以下格式:
|
expandedFinalUrl |
仅限输出。点击的最终到达网址。 |
FeedPlaceholderView
Feed 占位符视图。
JSON 表示法 |
---|
{
"resourceName": string,
"placeholderType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。Feed 占位符视图的资源名称。Feed 占位符视图资源名称采用以下格式:
|
placeholderType |
仅限输出。Feed 占位符视图的占位符类型。 |
GenderView
性别视图。genderView 资源反映的是有效的投放状态,而非添加的条件。默认情况下,没有性别条件的广告组会面向所有性别展示,因此所有性别都会显示在 genderView 中及统计信息。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。性别视图的资源名称。性别视图资源名称采用以下格式:
|
GeographicView
地理视图。
地理位置视图包含国家/地区级别的所有汇总指标,每个国家/地区占一行。它会报告用户实际所处的位置或感兴趣的区域的指标。如果使用了其他细分字段,每个国家/地区可能会占多行。
JSON 表示法 |
---|
{
"resourceName": string,
"locationType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。地理视图的资源名称。地理位置视图资源名称采用以下格式:
|
locationType |
仅限输出。广告系列的地理位置定位类型。 |
countryCriterionId |
仅限输出。国家/地区的条件 ID。 |
GeoTargetingType
可能的地理位置定位类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
AREA_OF_INTEREST |
执行查询时用户感兴趣的地理位置。 |
LOCATION_OF_PRESENCE |
发出查询的用户的位置。 |
GroupPlacementView
组展示位置视图。
JSON 表示法 |
---|
{
"resourceName": string,
"placementType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。组展示位置视图的资源名称。组展示位置视图资源名称采用以下格式:
|
placementType |
仅限输出。展示位置的类型,例如网站、YouTube 频道、移动应用。 |
placement |
仅限输出。组级别的系统推荐的展示位置字符串,例如网域、移动应用 ID 或 YouTube 频道 ID。 |
displayName |
仅限输出。网站域名和 YouTube 频道的 YouTube 频道名称。 |
targetUrl |
仅限输出。组展示位置的网址,例如网域、指向应用商店中移动应用的链接或 YouTube 频道网址。 |
HotelGroupView
酒店组视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。酒店组视图的资源名称。酒店组视图资源名称采用以下格式:
|
HotelPerformanceView
酒店效果视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。酒店效果视图的资源名称。酒店效果视图资源名称采用以下格式:
|
HotelReconciliation
酒店对账。它包含酒店预订的转化信息,以便与广告客户记录进行对账。您可以在结算前通过“批量上传”功能更新或取消这些行。
JSON 表示法 |
---|
{
"resourceName": string,
"commissionId": string,
"orderId": string,
"campaign": string,
"hotelCenterId": string,
"hotelId": string,
"checkInDate": string,
"checkOutDate": string,
"reconciledValueMicros": string,
"billed": boolean,
"status": enum ( |
字段 | |
---|---|
resourceName |
不可变。酒店对账的资源名称。酒店对账资源名称采用以下格式:
|
commissionId |
必需。仅限输出。佣金 ID 是指 Google 用于此项预订的 ID。系统会为每个预订事件分配佣金 ID,以便您将其与房客入住对应起来。 |
orderId |
仅限输出。订单 ID 是此预订的标识符,如“transaction_id”参数的值。 |
campaign |
仅限输出。与转化相关联的广告系列的资源名称。 |
hotelCenterId |
仅限输出。Hotel Center 账号的标识符,用于为酒店广告系列提供房价。 |
hotelId |
仅限输出。已预订房源的唯一标识符,由 Hotel Center Feed 提供。酒店 ID 来自“ID”参数的值。 |
checkInDate |
仅限输出。在预订时记录的入住日期。如果入住日期在对账时被修改,修改后的日期将取代此列中的原始日期。格式为 YYYY-MM-DD。 |
checkOutDate |
仅限输出。在预订时记录的退房日期。如果入住日期在对账时被修改,修改后的日期将取代此列中的原始日期。格式为 YYYY-MM-DD。 |
reconciledValueMicros |
必需。仅限输出。已对账值是指房客支付的最终预订价值。如果原始预订价值因任何原因(例如行程变更或客房追加销售)而发生变化,已对账值应是所收取的最终全额。如果预订被取消,已对账值应包含所有取消费用或已收取且无法退款的晚数。值以基本单位货币的百万分之一为单位。例如,12.35 美元将表示为 12350000。货币单位采用默认的客户货币。 |
billed |
仅限输出。指定的预订是否已结算。结算后,便无法再修改预订。 |
status |
必需。仅限输出。预订的当前状态,与对账和结算有关。应在退房日期后 45 天内对预订进行对账。任何未在 45 天内对账的预订都将按其原始价值结算。 |
HotelReconciliationStatus
酒店预订对账的状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
RESERVATION_ENABLED |
预订针对的是未来的日期,或者已经入住但还未过退房日期的情形。处于有效状态的预订无法进行对账。 |
RECONCILIATION_NEEDED |
已经退房,或者预订日期已过且未取消。未在退房日期后 45 天内对账的预订会按照原来的预订价格结算费用。 |
RECONCILED |
这些预订已经对账。已对账的预订将在退房日期后 45 天结算费用。 |
CANCELED |
此预订已标记为取消。如果已取消预订的入住天数大于零(因设有最低入住天数规则或取消费用),系统会在退房日期后 45 天结算费用。 |
IncomeRangeView
收入范围视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。收入范围视图的资源名称。收入范围视图资源名称采用以下格式:
|
KeywordView
关键字视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。关键字视图的资源名称。关键字视图资源名称采用以下格式:
|
LandingPageView
一次着陆页浏览,其中包含在未展开的最终到达网址一级汇总的指标。
JSON 表示法 |
---|
{ "resourceName": string, "unexpandedFinalUrl": string } |
字段 | |
---|---|
resourceName |
仅限输出。着陆页视图的资源名称。着陆页视图资源名称采用以下格式:
|
unexpandedFinalUrl |
仅限输出。广告主指定的最终到达网址。 |
LanguageConstant
一种语言。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
字段 | |
---|---|
resourceName |
仅限输出。语言常量的资源名称。语言常量资源名称采用以下格式:
|
id |
仅限输出。语言常量的 ID。 |
code |
仅限输出。语言代码,例如“en_US”、“en_AU”、“es”、“fr”等。 |
name |
仅限输出。语言的英语全名,例如“英语(美国)”“西班牙语”等。 |
targetable |
仅限输出。语言是否可定位。 |
LocationView
地理位置视图按地理位置条件汇总了广告系列的效果。如果未设置 Location 条件,则不会返回任何结果;对于访问者位置数据,请使用 geoView 或 userLocationView。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。营业地点视图的资源名称。位置视图资源名称采用以下格式:
|
ManagedPlacementView
自选展示位置视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。自选展示位置视图的资源名称。自选展示位置视图资源名称采用以下格式:
|
MediaFile
媒体文件。
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resourceName |
不可变。媒体文件的资源名称。媒体文件资源名称采用以下格式:
|
type |
不可变。媒体文件的类型。 |
mimeType |
仅限输出。媒体文件的 MIME 类型。 |
id |
仅限输出。媒体文件的 ID。 |
sourceUrl |
不可变。原始媒体文件的下载网址(或文件名)。仅用于 AUDIO 和 IMAGE 类型的媒体。 |
name |
不可变。媒体文件的名称。客户端可以使用此名称来帮助识别之前上传的媒体。 |
fileSize |
仅限输出。媒体文件的大小(以字节为单位)。 |
联合字段 mediatype 。媒体文件的特定类型。mediatype 只能是下列其中一项: |
|
image |
不可变。封装图像。 |
mediaBundle |
不可变。内容包含 HTML5 素材资源的 ZIP 归档媒体。 |
audio |
仅限输出。封装音频。 |
video |
不可变。封装视频。 |
MediaType
媒体的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定媒体类型。 |
UNKNOWN |
接收的值在此版本中未知。 这是一个仅用于响应的值。 |
IMAGE |
静态图片,用于图片广告。 |
ICON |
小图片,用于地图广告。 |
MEDIA_BUNDLE |
ZIP 文件,用于模板广告字段。 |
AUDIO |
音频文件。 |
VIDEO |
视频文件。 |
DYNAMIC_IMAGE |
动画图片,例如动画 GIF。 |
MediaImage
封装图像。
JSON 表示法 |
---|
{ "data": string, "fullSizeImageUrl": string, "previewSizeImageUrl": string } |
字段 | |
---|---|
data |
不可变。原始图片数据。 使用 base64 编码的字符串。 |
fullSizeImageUrl |
仅限输出。指向完整尺寸图片的网址。 |
previewSizeImageUrl |
仅限输出。指向图片的预览尺寸版本的网址。 |
MediaBundle
表示内容包含 HTML5 素材资源的 ZIP 归档媒体内容。
JSON 表示法 |
---|
{ "data": string, "url": string } |
字段 | |
---|---|
data |
不可变。原始压缩数据。 使用 base64 编码的字符串。 |
url |
仅限输出。用于访问上传的压缩数据的网址。例如 https://tpc.googlesyndication.com/simgad/123。此字段为只读字段。 |
MediaAudio
封装音频。
JSON 表示法 |
---|
{ "adDurationMillis": string } |
字段 | |
---|---|
adDurationMillis |
仅限输出。音频的时长(以毫秒为单位)。 |
MediaVideo
封装视频。
JSON 表示法 |
---|
{ "adDurationMillis": string, "youtubeVideoId": string, "advertisingIdCode": string, "isciCode": string } |
字段 | |
---|---|
adDurationMillis |
仅限输出。视频的时长(以毫秒为单位)。 |
youtubeVideoId |
不可变。YouTube 视频 ID(如 YouTube 网址中所示)。添加前缀“https://www.youtube.com/watch?v=”使用此 ID 将获取该视频的 YouTube 流式传输网址。 |
advertisingIdCode |
仅限输出。此视频的广告数字标识代码,由美国广告代理协会定义,主要用于电视商业广告。 |
isciCode |
仅限输出。此视频的行业标准商业广告标识符代码,主要用于电视商业广告。 |
LocalServicesEmployee
本地服务员工资源。
JSON 表示法 |
---|
{ "resourceName": string, "creationDateTime": string, "status": enum ( |
字段 | |
---|---|
resourceName |
不可变。本地生活服务验证的资源名称。本地生活服务验证资源名称采用以下格式:
|
creationDateTime |
仅限输出。员工创建的时间戳。格式为“YYYY-MM-DD HH:MM:SS”(以 Google Ads 账号所在的时区为准)。例如:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
status |
仅限输出。员工状态,例如 DELETED 或 ENABLED。 |
type |
仅限输出。员工类型。 |
universityDegrees[] |
仅限输出。该员工已获得并希望授予的学位的列表。 |
residencies[] |
仅限输出。员工已完成居住地的机构。 |
fellowships[] |
仅限输出。员工在其中完成了学业的机构。 |
languagesSpoken[] |
仅限输出。员工使用的语言(以 https://developers.google.com/admin-sdk/directory/v1/languages 中的语言标记表示) |
categoryIds[] |
仅限输出。员工的类别。如需查看本地生活服务类别 ID 的列表,请访问 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids。 |
id |
仅限输出。员工的 ID。 |
jobTitle |
仅限输出。此员工的职位,例如“高级合作伙伴”这个领域非常重要 |
yearStartedPracticing |
仅限输出。该员工开始从事此领域的年份。 |
nationalProviderIdNumber |
仅限输出。与员工关联的 NPI ID。 |
emailAddress |
仅限输出。员工的电子邮件地址。 |
firstName |
仅限输出。员工的名字。 |
middleName |
仅限输出。员工的中间名。 |
lastName |
仅限输出。员工的姓氏。 |
LocalServicesEmployeeStatus
描述本地服务员工状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
未移除员工,且员工状态为有效。 |
REMOVED |
已移除员工。用于从商家中删除员工。 |
LocalServicesEmployeeType
描述本地服务员工类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BUSINESS_OWNER |
表示商家的所有者。 |
EMPLOYEE |
代表商家的员工。 |
UniversityDegree
该员工已获得并希望授予的学位的列表。
JSON 表示法 |
---|
{ "institutionName": string, "degree": string, "graduationYear": integer } |
字段 | |
---|---|
institutionName |
仅限输出。获得学位的大学名称。 |
degree |
仅限输出。所获学位的名称。 |
graduationYear |
仅限输出。毕业年份。 |
住所
员工的住院医师实习详细信息。住院医师教育是医学研究生教育的一个阶段,在高级临床医生的监督下,合格的医疗专业人员需执业。
JSON 表示法 |
---|
{ "institutionName": string, "completionYear": integer } |
字段 | |
---|---|
institutionName |
仅限输出。已完成驻留的机构的名称。 |
completionYear |
仅限输出。完成年份。 |
奖学金
员工的医疗奖金的详细信息。奖学金是专业人员在完成住院医师实习后接受的医疗培训期限。
JSON 表示法 |
---|
{ "institutionName": string, "completionYear": integer } |
字段 | |
---|---|
institutionName |
仅限输出。接受研究学金的机构的名称。 |
completionYear |
仅限输出。完成年份。 |
LocalServicesVerificationArtifact
本地生活服务验证资源。
JSON 表示法 |
---|
{ "resourceName": string, "creationDateTime": string, "status": enum ( |
字段 | |
---|---|
resourceName |
不可变。本地生活服务验证的资源名称。本地生活服务验证资源名称采用以下格式:
|
creationDateTime |
仅限输出。创建此验证工件时的时间戳。格式为“YYYY-MM-DD HH:MM:SS”(以 Google Ads 账号所在的时区为准)。例如:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
status |
仅限输出。验证制品的状态。 |
artifactType |
仅限输出。验证工件的类型。 |
id |
仅限输出。验证工件的 ID。 |
联合字段 artifact_data 。验证信息的类型。artifact_data 只能是下列其中一项: |
|
backgroundCheckVerificationArtifact |
仅限输出。背景调查验证工件。 |
insuranceVerificationArtifact |
仅限输出。保险验证工件。 |
licenseVerificationArtifact |
仅限输出。许可验证工件。 |
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 |
仅限输出。用于访问后台大小写的网址。 |
finalAdjudicationDateTime |
仅限输出。对此背景调查案例结果做出判定的时间戳。格式为“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 ( |
字段 | |
---|---|
amountMicros |
仅限输出。保险金额。此指标以“微单位”为单位保险文件中提到的货币。 |
rejectionReason |
仅限输出。保险单据遭拒原因。 |
insuranceDocumentReadonly |
仅限输出。包含已上传保险文档信息的只读字段。 |
expirationDateTime |
仅限输出。此保险到期的时间戳。格式为“YYYY-MM-DD HH:MM:SS”(以 Google Ads 账号所在的时区为准)。例如:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
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 |
用于访问已上传的本地生活服务文档的网址。 |
LicenseVerificationArtifact
包含本地服务许可专属信息的 proto。
JSON 表示法 |
---|
{ "licenseType": string, "licenseNumber": string, "licenseeFirstName": string, "licenseeLastName": string, "rejectionReason": enum ( |
字段 | |
---|---|
licenseType |
仅限输出。许可类型 / 名称。 |
licenseNumber |
仅限输出。执照号。 |
licenseeFirstName |
仅限输出。被许可人的名字。 |
licenseeLastName |
仅限输出。被许可人的姓氏。 |
rejectionReason |
仅限输出。许可遭拒原因。 |
licenseDocumentReadonly |
仅限输出。包含已上传许可文档信息的只读字段。 |
expirationDateTime |
仅限输出。此许可到期时的时间戳。格式为“YYYY-MM-DD HH:MM:SS”(以 Google Ads 账号所在的时区为准)。例如:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
LocalServicesLicenseRejectionReason
描述本地服务许可验证制品可能遭拒原因的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BUSINESS_NAME_MISMATCH |
商家名称与本地生活服务广告的商家名称不一致。 |
UNAUTHORIZED |
许可未经授权或已被撤消。 |
EXPIRED |
许可已过期。 |
POOR_QUALITY |
许可质量低劣 - 图片模糊、难以辨认等... |
UNVERIFIABLE |
由于图片不合法,无法验证许可。 |
WRONG_DOCUMENT_OR_ID |
许可不是所请求的文档类型或包含无效的 ID。 |
OTHER |
许可存在其他未明确列出的缺陷。 |
BusinessRegistrationCheckVerificationArtifact
包含本地生活服务商业登记核查特定信息的 proto。
JSON 表示法 |
---|
{ "registrationType": enum ( |
字段 | |
---|---|
registrationType |
仅限输出。工商登记支票的类型(编号、文件)。 |
checkId |
仅限输出。支票的 ID,例如代表“增值税号”的 vat_tax_id。 |
rejectionReason |
仅限输出。注册文件遭拒原因。 |
联合字段 business_registration 。工商登记注册信息。根据不同国家/地区的要求,该表单为以下表单之一。business_registration 只能是下列其中一项: |
|
registrationNumber |
仅限输出。存储由政府签发的商家号码的邮件。 |
registrationDocument |
仅限输出。存储商家文档信息的消息。 |
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 |
仅限输出。由政府签发的企业号码。 |
BusinessRegistrationDocument
包含本地生活服务企业注册文件专属信息的协议。
JSON 表示法 |
---|
{
"documentReadonly": {
object ( |
字段 | |
---|---|
documentReadonly |
仅限输出。包含已上传工商登记证件的信息的只读字段。 |
MobileAppCategoryConstant
移动应用类别常量。
JSON 表示法 |
---|
{ "resourceName": string, "id": integer, "name": string } |
字段 | |
---|---|
resourceName |
仅限输出。移动应用类别常量的资源名称。移动应用类别常量资源名称采用以下格式:
|
id |
仅限输出。移动应用类别常量的 ID。 |
name |
仅限输出。移动应用类别名称。 |
MobileDeviceConstant
移动设备常量。
JSON 表示法 |
---|
{
"resourceName": string,
"type": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。移动设备常量的资源名称。移动设备常量资源名称采用以下格式:
|
type |
仅限输出。移动设备的类型。 |
id |
仅限输出。移动设备常量的 ID。 |
name |
仅限输出。移动设备的名称。 |
manufacturerName |
仅限输出。移动设备的制造商。 |
operatingSystemName |
仅限输出。移动设备的操作系统。 |
MobileDeviceType
移动设备的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MOBILE |
手机。 |
TABLET |
平板电脑。 |
OfflineConversionUploadClientSummary
客户一级的线下转化数据上传摘要。
JSON 表示法 |
---|
{ "resourceName": string, "client": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。客户级线下转化数据上传摘要的资源名称。线下转化上传客户端摘要资源名称采用以下格式:
|
client |
仅限输出。上传事件的客户端类型。 |
status |
仅限输出。线下转化客户的总体状态摘要。状态是根据包含上传统计信息的最近一个日历日生成的。 |
totalEventCount |
仅限输出。上传的事件总数。 |
successfulEventCount |
仅限输出。成功上传的事件总数。 |
successRate |
仅限输出。成功率。 |
pendingEventCount |
仅限输出。已上传的待处理事件总数。 |
pendingRate |
仅限输出。待处理事件总数与事件总数的比率。 |
lastUploadDateTime |
仅限输出。最近一次批量上传的日期。该日期的格式为“yyyy-mm-dd hh:mm:ss”,采用 Google Ads 账号所设的时区。 |
dailySummaries[] |
仅限输出。最近 N 天的历史记录统计信息摘要。 |
jobSummaries[] |
仅限输出。按最后 N 个作业的历史记录统计信息摘要。 |
alerts[] |
仅限输出。每个错误代码的详细信息。提醒生成自包含上传统计信息的最近日历日。 |
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, "pendingCount": string, // Union field |
字段 | |
---|---|
successfulCount |
仅限输出。成功事件总数。 |
failedCount |
仅限输出。失败事件的总数。 |
pendingCount |
仅限输出。已上传的待处理事件总数。 |
联合字段 dimension_key 。摘要的维度键。dimension_key 只能是下列其中一项: |
|
jobId |
仅限输出。最近 N 个作业的维度键。 |
uploadDate |
仅限输出。过去 N 天的维度键。 |
OfflineConversionAlert
关于线下转化客户摘要的提醒。
JSON 表示法 |
---|
{
"error": {
object ( |
字段 | |
---|---|
error |
仅限输出。线下转化客户端提醒出错。 |
errorPercentage |
仅限输出。错误百分比,此字段的范围应为 [0, 1.0]。 |
OfflineConversionError
线下转化客户端摘要可能出现的错误。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 error_code 。说明有误。error_code 只能是下列其中一项: |
|
collectionSizeError |
仅限输出。收藏集大小错误。 |
conversionAdjustmentUploadError |
仅限输出。转化调整项上传错误。 |
conversionUploadError |
仅限输出。转化数据上传错误。 |
dateError |
仅限输出。日期错误。 |
distinctError |
仅限输出。明显错误。 |
fieldError |
仅限输出。字段错误。 |
mutateError |
仅限输出。转变错误。 |
notAllowlistedError |
仅限输出。“未列入许可名单”错误。 |
stringFormatError |
仅限输出。字符串格式错误。 |
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 |
调整请求中指定的转化操作类型不支持上传调整项。RETRACTION 或 RESTATEMENT 类型的转化调整项只能用于 SALESFORCE 、UPLOAD_CLICK 或 WEBPAGE 类型的转化操作。ENHANCEMENT 类型的转化调整项只能用于 WEBPAGE 类型的转化操作。 |
ConversionUploadError
描述可能存在的转化上传错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
TOO_MANY_CONVERSIONS_IN_REQUEST |
在单个请求中上传的事件数量应少于 2,001 个。 |
UNPARSEABLE_GCLID |
无法对导入的 GCLID 进行解码。确保您没有修改点击 ID。 |
CONVERSION_PRECEDES_EVENT |
导入的事件在点击之前有 conversionDateTime 。请确保您的conversionDateTime 正确无误,然后重试。 |
EXPIRED_EVENT |
此项转化的点击时间早于其点击型转化时间范围,因此无法记录导入的事件。请确保您导入的是最新数据。 |
TOO_RECENT_EVENT |
与给定标识符或 iOS 网址参数相关联的点击发生的时间还不到 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 |
过长。 |
OfflineConversionUploadConversionActionSummary
转化操作一级的线下转化数据上传摘要。
JSON 表示法 |
---|
{ "resourceName": string, "client": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。转化操作级别的线下转化数据上传摘要的资源名称。线下转化数据上传转化操作摘要资源名称采用以下格式:
|
client |
仅限输出。上传事件的客户端类型。 |
conversionActionId |
仅限输出。转化操作 ID。 |
conversionActionName |
仅限输出。转化操作的名称。 |
status |
仅限输出。线下转化上传转化操作摘要的总体状态。状态是根据包含上传统计信息的最近一个日历日生成的。 |
totalEventCount |
仅限输出。上传的事件总数。 |
successfulEventCount |
仅限输出。成功上传的事件总数。 |
pendingEventCount |
仅限输出。已上传的待处理事件总数。 |
lastUploadDateTime |
仅限输出。最近一次批量上传的日期。该日期的格式为“yyyy-mm-dd hh:mm:ss”,采用 Google Ads 账号所设的时区。 |
dailySummaries[] |
仅限输出。最近 N 天的历史记录统计信息摘要。 |
jobSummaries[] |
仅限输出。按最后 N 个作业的历史记录统计信息摘要。 |
alerts[] |
仅限输出。每个错误代码的详细信息。提醒生成自包含上传统计信息的最近日历日。 |
OperatingSystemVersionConstant
移动操作系统版本或一系列版本,具体取决于 operatorType
。如需查看可用移动平台的列表,请访问 https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
JSON 表示法 |
---|
{
"resourceName": string,
"operatorType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。操作系统版本常量的资源名称。操作系统版本常量资源名称采用以下格式:
|
operatorType |
仅限输出。确定此常量是表示单个版本还是一个版本范围。 |
id |
仅限输出。操作系统版本的 ID。 |
name |
仅限输出。操作系统名称。 |
osMajorVersion |
仅限输出。操作系统主要版本号。 |
osMinorVersion |
仅限输出。操作系统次要版本号。 |
OperatingSystemVersionOperatorType
操作系统版本的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
EQUALS_TO |
等于指定的版本。 |
GREATER_THAN_EQUALS_TO |
大于或等于指定的版本。 |
PaidOrganicSearchTermView
付费自然搜索字词视图,提供广告组一级的广告和自然搜索结果的搜索统计信息(按搜索字词汇总)。
JSON 表示法 |
---|
{ "resourceName": string, "searchTerm": string } |
字段 | |
---|---|
resourceName |
仅限输出。搜索字词视图的资源名称。搜索字词视图资源名称采用以下格式:
|
searchTerm |
仅限输出。搜索字词。 |
QualifyingQuestion
为潜在客户表单提出甄别问题。
JSON 表示法 |
---|
{ "resourceName": string, "qualifyingQuestionId": string, "locale": string, "text": string } |
字段 | |
---|---|
resourceName |
仅限输出。甄别问题的资源名称。 “qualifyingQuestions/{qualifyingQuestionId}” |
qualifyingQuestionId |
仅限输出。甄别问题的 ID。 |
locale |
仅限输出。资格问题的区域。 |
text |
仅限输出。甄别问题。 |
ParentalStatusView
生育情况视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。生育情况视图的资源名称。育儿状况视图资源名称采用以下格式:
|
PerStoreView
实体店视图。此视图提供广告主按商店划分的展示覆盖面和本地操作转化统计信息。
JSON 表示法 |
---|
{ "resourceName": string, "placeId": string } |
字段 | |
---|---|
resourceName |
仅限输出。各商店视图的资源名称。每个商店视图资源名称采用以下格式:
|
placeId |
仅限输出。各商店视图的地点 ID。 |
ProductCategoryConstant
产品类别。
JSON 表示法 |
---|
{ "resourceName": string, "categoryId": string, "level": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。商品类别的资源名称。产品类别资源名称采用以下格式:
|
categoryId |
仅限输出。商品类别的 ID。 此 ID 相当于 https://support.google.com/merchants/answer/6324436 一文中所述的 google_product_category ID。 |
level |
仅限输出。商品类别的级别。 |
state |
仅限输出。商品类别的状态。 |
localizations[] |
仅限输出。商品类别的所有可用本地化版本的列表。 |
productCategoryConstantParent |
仅限输出。父级商品类别的资源名称。 |
ProductCategoryState
描述商品类别状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
该类别已启用。 |
OBSOLETE |
此类别已过时。仅用于报告目的。 |
ProductCategoryLocalization
商品类别的本地化版本。
JSON 表示法 |
---|
{ "regionCode": string, "languageCode": string, "value": string } |
字段 | |
---|---|
regionCode |
仅限输出。本地化类别的 ISO 3166-1 国家/地区代码(由两个大写字母组成)。 |
languageCode |
仅限输出。本地化类别的双字母 ISO 639-1 语言代码。 |
value |
仅限输出。指定语言区域中的类别名称。 |
ProductGroupView
产品组视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。产品组视图的资源名称。产品组视图资源名称采用以下格式:
|
SearchTermView
搜索字词视图,显示广告组一级按搜索字词汇总的指标。
JSON 表示法 |
---|
{
"resourceName": string,
"status": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。搜索字词视图的资源名称。搜索字词视图资源名称采用以下格式:
|
status |
仅限输出。指明搜索字词目前是否属于已定位或已排除的关键字。 |
searchTerm |
仅限输出。搜索字词。 |
adGroup |
仅限输出。搜索字词所在的广告组。 |
SearchTermTargetingStatus
指明搜索字词是否属于您定位或排除的关键字。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ADDED |
搜索字词已添加到指定关键字中。 |
EXCLUDED |
搜索字词与否定关键字匹配。 |
ADDED_EXCLUDED |
已添加和排除了搜索字词。 |
NONE |
既未定位也未排除搜索字词。 |
ShoppingPerformanceView
购物广告效果视图。提供多个产品维度级别的购物广告系列统计信息。Merchant Center 中的产品维度值(例如品牌、类别、自定义属性、产品使用情况和产品类型)将反映每个维度截至记录相应事件的日期和时间的状态。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。购物效果视图的资源名称。购物效果视图资源名称采用以下格式: |
ShoppingProduct
可通过广告系列宣传的 Google Merchant Center 中的购物产品。
该资源会返回与客户相关联的 Google Merchant Center 账号中目前现有的产品。广告系列通过在 ShoppingSetting
中指定相应商品的商家 ID(或商家的多客户账号 ID(如果有))来添加商品,并可限定为仅包含具有指定 Feed 标签的商品。标准购物广告系列还可以通过campaignCriterion.listing_scope
来限制纳入情况。
针对此资源的查询会指定一个范围:账号:- 未指定广告系列或广告组的过滤条件。- 返回关联的 Google Merchant Center 账号中的所有产品。- 指标和部分字段(请参阅各字段的文档)是在包含相应产品的所有购物广告系列和效果最大化广告系列的汇总值。广告系列:- 指定了 campaign
的相等性过滤条件。支持的广告系列类型包括购物广告系列、效果最大化广告系列、需求开发广告系列、视频广告系列。- 仅返回指定广告系列包含的产品。- 指标和某些字段(请参阅各字段的文档)仅限于指定的广告系列。广告组:- 针对 ad group
和 campaign
指定了相等性过滤条件。支持的广告系列类型包括购物广告系列、需求开发广告系列、视频广告系列。- 仅返回指定广告系列包含的产品。- 指标和某些字段(请参阅各字段的文档)仅限于指定的广告组。请注意,不允许使用按日期细分,将返回 UNSUPPORTED_DATE_SEGMENTATION 错误。另一方面,系统允许按日期细分进行过滤。
JSON 表示法 |
---|
{ "resourceName": string, "merchantCenterId": string, "channel": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。购物产品的资源名称。购物产品资源名称采用以下格式:
|
merchantCenterId |
仅限输出。拥有相应商品的商家的 ID。 |
channel |
仅限输出。描述商品所在地区的商品渠道。 |
languageCode |
仅限输出。商家提供的语言代码,采用 BCP 47 格式。 |
feedLabel |
仅限输出。商家提供的商品 Feed 标签。 |
itemId |
仅限输出。商家提供的商品的商品 ID。 |
targetCountries[] |
仅限输出。要在广告中展示商品的区域的 ISO 3166-1 代码(由两个大写字母组成)。 |
status |
仅限输出。指明商品是否可以在广告中展示的状态。此字段的值限制为查询中指定的范围,请参阅资源文档。此字段最多可能需要 24 小时才会更新。 |
issues[] |
仅限输出。影响商品能否在广告中展示的问题列表。此字段的值限制为查询中指定的范围,请参阅资源文档。此字段最多可能需要 24 小时才会更新。 |
multiClientAccountId |
仅限输出。商家的多客户账号 ID(如果存在)。 |
title |
仅限输出。商家提供的商品名。 |
brand |
仅限输出。商家提供的商品品牌。 |
priceMicros |
仅限输出。商品价格,以商家提供的微单位和 |
currencyCode |
仅限输出。商家提供的货币代码,采用 ISO 4217 格式。 |
channelExclusivity |
仅限输出。商家提供的商品的渠道独家性。 |
condition |
仅限输出。商家提供的商品使用情况。 |
availability |
仅限输出。商家提供的商品的库存状况。 |
customAttribute0 |
仅限输出。商家提供的商品的自定义属性 0。 |
customAttribute1 |
仅限输出。商家提供的商品的自定义属性 1。 |
customAttribute2 |
仅限输出。商家提供的商品的自定义属性 2。 |
customAttribute3 |
仅限输出。商家提供的商品的自定义属性 3。 |
customAttribute4 |
仅限输出。商家提供的商品的自定义属性 4。 |
categoryLevel1 |
仅限输出。商品的类别级别 1。 |
categoryLevel2 |
仅限输出。商品的类别级别 2。 |
categoryLevel3 |
仅限输出。商品的类别级别 3。 |
categoryLevel4 |
仅限输出。商品的类别级别 4。 |
categoryLevel5 |
仅限输出。商品的类别级别 5。 |
productTypeLevel1 |
仅限输出。商家提供的 1 级商品类型。 |
productTypeLevel2 |
仅限输出。商家提供的 2 级商品类型。 |
productTypeLevel3 |
仅限输出。商家提供的 3 级商品类型。 |
productTypeLevel4 |
仅限输出。商家提供的 4 级商品类型。 |
productTypeLevel5 |
仅限输出。商家提供的 5 级商品类型。 |
effectiveMaxCpcMicros |
仅限输出。产品的有效最高每次点击费用。只有当查询指定了广告系列或广告组的范围,并且广告系列使用人工出价时,此字段才可用。该值是指在所有已启用的广告组中,针对相应产品在产品组中设置的最高出价。该金额表示您愿意为每次广告点击支付的最高金额。此字段最多可能需要 24 小时才会更新。 |
campaign |
仅限输出。包含相应产品的广告系列。此字段只能在广告系列范围内选择,因此广告系列范围需要对 |
adGroup |
仅限输出。包含相应产品的广告系列中的广告组。此字段只能在广告组范围内选择,而广告组范围需要对 |
ProductAvailability
商品库存状况。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
IN_STOCK |
产品有货。 |
OUT_OF_STOCK |
此商品缺货。 |
PREORDER |
商品可以预订。 |
ProductStatus
描述商品状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
NOT_ELIGIBLE |
该商品无法在广告中展示。 |
ELIGIBLE_LIMITED |
商品可以在广告中展示,但由于已发现的问题,其展示位置和时间可能会受到限制。 |
ELIGIBLE |
商品可以在广告中展示。 |
ProductIssue
影响商品能否在广告中展示的问题。
JSON 表示法 |
---|
{
"errorCode": string,
"adsSeverity": enum ( |
字段 | |
---|---|
errorCode |
仅限输出。用于标识问题的错误代码。 |
adsSeverity |
仅限输出。Google Ads 中问题的严重程度。 |
description |
仅限输出。用英语对问题的简短说明。 |
detail |
仅限输出。问题的详细说明(以英语表示)。 |
documentation |
仅限输出。与该问题相关的帮助中心文章的网址。 |
affectedRegions[] |
仅限输出。受问题影响的区域的 ISO 3166-1 代码列表(由两个大写字母组成)。如果留空,则所有区域都会受到影响。 |
attributeName |
仅限输出。触发问题的商品属性名称(如果有)。 |
ProductIssueSeverity
商品问题的严重程度。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
WARNING |
该问题会限制商品在广告中的表现。 |
ERROR |
该问题会导致商品无法在广告中展示。 |
SmartCampaignSearchTermView
智能广告系列搜索字词视图。
JSON 表示法 |
---|
{ "resourceName": string, "searchTerm": string, "campaign": string } |
字段 | |
---|---|
resourceName |
仅限输出。智能广告系列搜索字词视图的资源名称。智能广告系列搜索字词视图资源名称采用以下格式:
|
searchTerm |
仅限输出。搜索字词。 |
campaign |
仅限输出。包含搜索字词的智能广告系列。 |
ThirdPartyAppAnalyticsLink
数据共享连接,允许将第三方应用分析数据导入 Google Ads 客户。
JSON 表示法 |
---|
{ "resourceName": string, "shareableLinkId": string } |
字段 | |
---|---|
resourceName |
不可变。第三方应用分析工具关联的资源名称。第三方应用分析关联资源名称采用以下格式:
|
shareableLinkId |
仅限输出。设置应用分析工具时应向第三方提供的共享关联 ID。可以使用 ThirdPartyAppAnalyticsLinkService 中的 regenerate 方法重新生成此 ID。 |
TopicView
主题视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。主题视图的资源名称。主题视图资源名称采用以下格式:
|
TravelActivityGroupView
旅行活动组视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。旅行活动组视图的资源名称。旅游活动组视图资源名称采用以下格式:
|
TravelActivityPerformanceView
旅行活动效果视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。旅行活动效果视图的资源名称。旅行活动效果视图资源名称采用以下格式:
|
UserInterest
用户兴趣:要定位的特定基于兴趣的行业。
JSON 表示法 |
---|
{ "resourceName": string, "taxonomyType": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。用户兴趣的资源名称。用户兴趣资源名称采用以下格式:
|
taxonomyType |
仅限输出。用户兴趣的类目类型。 |
availabilities[] |
仅限输出。用户兴趣的可用性信息。 |
userInterestId |
仅限输出。用户兴趣的 ID。 |
name |
仅限输出。用户兴趣的名称。 |
userInterestParent |
仅限输出。用户兴趣的父级。 |
launchedToAll |
仅限输出。如果用户兴趣面向所有渠道和语言区域发布,则为“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 ( |
字段 | |
---|---|
resourceName |
仅限输出。人生大事的资源名称。人生大事资源名称采用以下格式:
|
id |
仅限输出。人生大事的 ID。 |
name |
仅限输出。人生大事的名称,例如“最近搬家” |
parent |
仅限输出。LifeEvent 的父级。 |
launchedToAll |
仅限输出。如果人生大事面向所有渠道和语言区域发布,则为“true”。 |
availabilities[] |
仅限输出。人生大事的空闲情况信息。 |
UserLocationView
用户地理位置视图。
用户地理位置视图包含国家/地区级别的所有汇总指标,每个国家/地区占一行。它会按已定位或未定位的地理位置报告用户实际所处的地理位置的指标。如果使用了其他细分字段,每个国家/地区可能会占多行。
JSON 表示法 |
---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
字段 | |
---|---|
resourceName |
仅限输出。用户营业地点视图的资源名称。UserLocation 视图资源名称采用以下格式:
|
countryCriterionId |
仅限输出。国家/地区的条件 ID。 |
targetingLocation |
仅限输出。指明是否已定位地理位置。 |
TopicConstant
根据展示位置所属的类别(例如“宠物与动物/宠物/狗”),使用主题在 Google 展示广告网络中定位或排除展示位置。
JSON 表示法 |
---|
{ "resourceName": string, "path": [ string ], "id": string, "topicConstantParent": string } |
字段 | |
---|---|
resourceName |
仅限输出。主题常量的资源名称。主题常量资源名称采用以下格式:
|
path[] |
仅限输出。要定位或排除的类别。数组中的每个后续元素都描述了一个更具体的子类别。例如,{"Pets &“Animals”、“Pets”、“Dogs"}”表示“动物/宠物/狗”类别。如需查看可用主题类别的列表,请访问 https://developers.google.com/google-ads/api/reference/data/verticals |
id |
仅限输出。主题的 ID。 |
topicConstantParent |
仅限输出。主题常量的父级的资源名称。 |
视频
视频。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "channelId": string, "durationMillis": string, "title": string } |
字段 | |
---|---|
resourceName |
仅限输出。视频的资源名称。视频资源名称采用以下格式:
|
id |
仅限输出。视频的 ID。 |
channelId |
仅限输出。视频的所有者频道 ID。 |
durationMillis |
仅限输出。视频的时长(以毫秒为单位)。 |
title |
仅限输出。视频的标题。 |
WebpageView
网页浏览。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resourceName |
仅限输出。网页视图的资源名称。网页视图资源名称采用以下格式:
|
LeadFormSubmissionData
来自潜在客户表单提交的数据。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "asset": string, "campaign": string, "leadFormSubmissionFields": [ { object ( |
字段 | |
---|---|
resourceName |
仅限输出。潜在客户表单提交数据的资源名称。潜在客户表单提交数据资源名称的表单如下:
|
id |
仅限输出。此次潜在客户表单提交的 ID。 |
asset |
仅限输出。与所提交的潜在客户表单相关联的素材资源。 |
campaign |
仅限输出。与所提交的潜在客户表单相关联的广告系列。 |
leadFormSubmissionFields[] |
仅限输出。与潜在客户表单相关联的提交数据。 |
customLeadFormSubmissionFields[] |
仅限输出。与自定义潜在客户表单相关联的提交数据。 |
adGroup |
仅限输出。与所提交的潜在客户表单相关联的广告组。 |
adGroupAd |
仅限输出。与所提交的潜在客户表单相关联的 AdGroupAd。 |
gclid |
仅限输出。与提交的潜在客户表单相关联的 Google 点击 ID。 |
submissionDateTime |
仅限输出。潜在客户表单的提交日期和时间。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |
LeadFormSubmissionField
已提交的潜在客户表单中的字段。
JSON 表示法 |
---|
{
"fieldType": enum ( |
字段 | |
---|---|
fieldType |
仅限输出。潜在客户表单字段的字段类型。 |
fieldValue |
仅限输出。潜在客户表单字段的字段值。 |
CustomLeadFormSubmissionField
已提交的自定义问题中的字段
JSON 表示法 |
---|
{ "questionText": string, "fieldValue": string } |
字段 | |
---|---|
questionText |
仅限输出。自定义问题的问题文本,最多 300 个字符。 |
fieldValue |
仅限输出。用于自定义问题回答的字段值,最大字符数为 70。 |
LocalServicesLead
本地生活服务主管提供的数据。包含用户致电、发送消息或为广告主预订服务时生成的潜在客户的详细信息。有关详情,请访问:https://ads.google.com/local-services-ads
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "categoryId": string, "serviceId": string, "contactDetails": { object ( |
字段 | |
---|---|
resourceName |
仅限输出。本地生活服务潜在客户数据的资源名称。本地生活服务潜在客户资源名称采用以下形式
|
id |
仅限输出。此潜在客户的 ID。 |
categoryId |
仅限输出。潜在客户的服务类别。例如: |
serviceId |
仅限输出。相应类别的服务。例如: |
contactDetails |
仅限输出。潜在客户的详细联系信息。 |
leadType |
仅限输出。本地生活服务潜在客户的类型:电话、消息、预订等 |
leadStatus |
仅限输出。潜在客户的当前状态。 |
creationDateTime |
仅限输出。本地生活服务广告创建潜在客户的日期时间。格式为“YYYY-MM-DD HH:MM:SS”(以 Google Ads 账号所在的时区为准)。例如:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
locale |
仅限输出。与潜在客户关联的本地生活服务提供商所使用的语言。请参阅 https://developers.google.com/google-ads/api/data/codes-formats#locales |
leadCharged |
仅限输出。如果向广告客户收取了潜在客户费用,则为“true”。 |
note |
仅限输出。广告客户为潜在客户添加的备注。 |
creditDetails |
仅限输出。潜在客户的信用详细信息。 |
ContactDetails
包含消费者详细联系信息的字段。
JSON 表示法 |
---|
{ "phoneNumber": string, "email": string, "consumerName": string } |
字段 | |
---|---|
phoneNumber |
仅限输出。E164 格式的消费者电话号码。 |
email |
仅限输出。消费者电子邮件地址。 |
consumerName |
仅限输出。消费者姓名(如果消费者在 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 |
仅限输出。潜在客户备注的修改日期时间。格式为“YYYY-MM-DD HH:MM:SS”(以 Google Ads 账号所在的时区为准)。例如:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
description |
仅限输出。潜在客户备注的内容。 |
CreditDetails
表示潜在客户的信用详细信息。
JSON 表示法 |
---|
{
"creditState": enum ( |
字段 | |
---|---|
creditState |
仅限输出。潜在客户的信用状态。 |
creditStateLastUpdateDateTime |
仅限输出。上次更新潜在客户信用状态的日期时间。格式为“YYYY-MM-DD HH:MM:SS”(以 Google Ads 账号所在的时区为准)。例如:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
CreditState
潜在客户可能的信用状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
PENDING |
抵用金处于待处理状态。 |
CREDITED |
已完成退款申请。 |
LocalServicesLeadConversation
数据来自本地生活服务潜在客户对话。包含用户致电、发送消息或预约广告主提供的服务时生成的潜在客户对话详细信息。系统会将这些信息附加到潜在客户信息。有关详情,请访问:https://ads.google.com/local-services-ads
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "conversationChannel": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。本地生活服务潜在客户对话数据的资源名称。本地生活服务潜在客户对话资源名称采用以下格式
|
id |
仅限输出。此潜在客户对话的 ID。 |
conversationChannel |
仅限输出。GLS 潜在客户对话的类型,如 EMAIL、MESSAGE、PHONE_CALL、短信等。 |
participantType |
仅限输出。潜在客户对话的参与者类型:ADVERTISER 或 CONSUMER。 |
lead |
仅限输出。与潜在客户对话相关联的潜在客户的资源名称。 |
eventDateTime |
仅限输出。本地生活服务广告创建潜在客户对话的日期时间。格式为“YYYY-MM-DD HH:MM:SS”(以 Google Ads 账号所在的时区为准)。例如:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
phoneCallDetails |
仅限输出。PHONE_CALL 中的通话对话详情。 |
messageDetails |
仅限输出。邮件对话详情(如 EMAIL、MESSAGE 或短信)。 |
ConversationType
可能的潜在客户对话类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
EMAIL |
电子邮件潜在客户对话。 |
MESSAGE |
消息类潜在客户对话。 |
PHONE_CALL |
来电潜在客户对话。 |
SMS |
短信潜在客户对话。 |
BOOKING |
预订潜在客户对话。 |
WHATSAPP |
WhatsApp 潜在客户对话。 |
ADS_API |
通过 Google Ads API 创建的潜在客户对话。 |
ParticipantType
可能的潜在客户对话参与者类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ADVERTISER |
本地生活服务广告提供商参与方。 |
CONSUMER |
本地生活服务广告消费者参与方。 |
PhoneCallDetails
表示通话对话的详细信息。
JSON 表示法 |
---|
{ "callDurationMillis": string, "callRecordingUrl": string } |
字段 | |
---|---|
callDurationMillis |
仅限输出。通话(端到端)的时长(以毫秒为单位)。 |
callRecordingUrl |
仅限输出。通话录音音频文件的网址。 |
MessageDetails
表示文本消息的详细信息(如果是电子邮件、消息或短信)。
JSON 表示法 |
---|
{ "text": string, "attachmentUrls": [ string ] } |
字段 | |
---|---|
text |
仅限输出。消息的文本内容。 |
attachmentUrls[] |
仅限输出。短信或电子邮件附件的网址。这些网址可用于通过开发者令牌下载附件内容。 |
AndroidPrivacyInteractionType
枚举互动类型
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
CLICK |
实际点击互动类型。 |
ENGAGED_VIEW |
时长为 10 秒的感兴趣的观看互动类型。 |
VIEW |
观看(广告展示)互动类型。 |
AndroidPrivacyNetworkType
枚举网络类型
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
SEARCH |
搜索网络。 |
DISPLAY |
展示广告网络。 |
YOUTUBE |
YouTube 网络。 |
指标
指标数据。
JSON 表示法 |
---|
{ "historicalCreativeQualityScore": enum ( |
字段 | |
---|---|
historicalCreativeQualityScore |
广告素材的历史质量得分。 |
historicalLandingPageQualityScore |
历史着陆页体验的质量。 |
historicalSearchPredictedCtr |
历史搜索预测的点击率 (CTR)。 |
interactionEventTypes[] |
付费和免费互动的类型。 |
skAdNetworkInstalls |
iOS Store Kit 广告网络转化次数。 |
skAdNetworkTotalConversions |
iOS Store Kit 广告网络转化的总次数。 |
publisherPurchasedClicks |
来自并非由发布商所拥有的媒体资源的点击,其流量是由发布商付费或通过奖励活动获得的 |
publisherOrganicClicks |
来自以下媒体资源的点击次数:发布商未通过利诱性活动支付流量或未获取的流量 |
publisherUnknownClicks |
来自未被标为“发布商购买”的流量的点击次数或“发布商自然搜索” |
linkedSampleEntities[] |
一个列表,其中包含使用了相应素材资源的示例关联资源(最多 20 个)。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。 |
sampleBestPerformanceEntities[] |
一个列表,包含过去 30 天内带有 AssetPerformanceLabel.BEST 效果标签且具有展示次数的关联资源(最多 20 个)示例。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。 |
sampleGoodPerformanceEntities[] |
一个列表,包含过去 30 天内曾有展示次数且素材资源带有 AssetPerformanceLabel.GOOD 效果标签的关联资源(最多 20 个)。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。 |
sampleLowPerformanceEntities[] |
一个列表,包含过去 30 天内有过展示次数的素材资源具有 AssetPerformanceLabel.LOW 效果标签,但最多包含 20 个示例关联资源。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。 |
sampleLearningPerformanceEntities[] |
一个列表,包含过去 30 天内带有 AssetPerformanceLabel.LEARNING 效果标签且具有展示次数的关联资源(最多 20 个)示例。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。 |
sampleUnratedPerformanceEntities[] |
一个包含最多 20 个示例已关联资源且在过去 30 天内获得了展示次数的样本,这些资源的 AssetPerformanceLabel 效果标签不是“BEST”“GOOD”“LOW”和“LEARNING”。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。 |
absoluteTopImpressionPercentage |
“搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。 |
activeViewCpm |
可见展示次数的平均费用 ( |
activeViewCtr |
Active View 可衡量点击次数除以 Active View 可见展示次数。 系统仅针对展示广告网络报告此指标。 |
activeViewImpressions |
衡量广告在展示广告网络网站上的可见频率。 |
activeViewMeasurability |
Active View 可衡量的展示次数与投放展示次数之比。 |
activeViewMeasurableCostMicros |
Active View 可衡量的您获得的展示费用。 |
activeViewMeasurableImpressions |
广告出现在可见位置中的展示位置的次数。 |
activeViewViewability |
广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 |
allConversionsFromInteractionsRate |
互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 |
allConversionsValue |
所有转化的值。 |
allConversionsValueByConversionDate |
所有转化的价值。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/google-ads/answer/9549009。 |
allNewCustomerLifetimeValue |
所有新客户的生命周期价值如果您已在账号一级或广告系列一级设置了客户获取目标,那么对于可出价和不可出价转化,该目标都会包括新客户的额外转化价值。如果您的广告系列采用了客户获取目标并选择“针对新客户提高出价”,这些值将会纳入到“allConversionsValue”中。请参阅 https://support.google.com/google-ads/answer/12080169 了解详情。 |
allConversions |
转化总次数。这包含所有转化,无论 includeInConversionsMetric 的值如何。 |
allConversionsByConversionDate |
转化总次数。这包含所有转化,无论 includeInConversionsMetric 的值如何。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/google-ads/answer/9549009。 |
allConversionsValuePerCost |
所有转化的价值除以广告互动(例如文字广告获得的点击或视频广告获得的观看)的总费用。 |
allConversionsFromClickToCall |
用户点击“致电”的次数按钮,在用户点击广告后或是在点击广告后致电商店。此数值不考虑通话是否接通,也不考虑通话时长。 此指标仅适用于 Feed 项。 |
allConversionsFromDirections |
用户点击“查询路线”的次数按钮,用户在点击广告后导航到商店。 此指标仅适用于 Feed 项。 |
allConversionsFromInteractionsValuePerInteraction |
互动带来的所有转化的价值除以总互动次数。 |
allConversionsFromMenu |
用户在点击广告后,点击链接查看相应商店菜单的次数。 此指标仅适用于 Feed 项。 |
allConversionsFromOrder |
用户点击广告后在商店下单的次数。 此指标仅适用于 Feed 项。 |
allConversionsFromOtherEngagement |
用户点击广告后发生的其他转化(例如,发布对商店的评价或保存该商店的营业地点)的次数。 此指标仅适用于 Feed 项。 |
allConversionsFromStoreVisit |
用户在点击广告后光顾商店的估算次数。 此指标仅适用于 Feed 项。 |
allConversionsFromStoreWebsite |
用户点击广告后进入商店网址的次数。 此指标仅适用于 Feed 项。 |
auctionInsightSearchAbsoluteTopImpressionPercentage |
此指标是竞价分析报告的一部分,用于表明其他参与者的广告在搜索结果页最显眼的位置展示的频率。此百分比的计算依据仅局限于您在网页中出现的竞价。 此指标尚未公开发布。 |
auctionInsightSearchImpressionShare |
此指标是竞价分析报告的一部分,显示其他参与者获得的展示次数在您的广告有资格获得的总展示次数中所占的百分比。任何低于 0.1 的值都会报告为 0.0999。 此指标尚未公开发布。 |
auctionInsightSearchOutrankingShare |
此指标是竞价分析报告的一部分,用于说明在您的广告有资格获得的总展示次数中,您的广告在排名上胜过(如上文所示)的展示次数所占的百分比。任何低于 0.1 的值都会报告为 0.0999。 此指标尚未公开发布。 |
auctionInsightSearchOverlapRate |
此指标是竞价分析报告的一部分,用于表明在您的广告获得展示机会的同时,其他参与者的广告也获得展示机会的频率。 此指标尚未公开发布。 |
auctionInsightSearchPositionAboveRate |
此指标是竞价分析报告的一部分,可以表明当您的两个广告在同一网页上展示时,其他参与者的广告排名高于您的广告的频率。 此指标尚未公开发布。 |
auctionInsightSearchTopImpressionPercentage |
此指标是竞价分析报告的一部分,用于表明另一参与者的广告在顶部自然搜索结果邻近位置展示的频率。此百分比的计算依据仅局限于您在网页中出现的竞价。 此指标尚未公开发布。 |
averageCost |
您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。 |
averageCpc |
所有点击总费用除以获得的总点击次数。 |
averageCpe |
您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 |
averageCpm |
平均每千次展示费用 (CPM)。 |
averageCpv |
每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 |
averagePageViews |
每个会话浏览网页的平均次数。 |
averageTimeOnSite |
所有会话的总时长(以秒为单位)/会话数。自 Google Analytics 导入。 |
benchmarkAverageMaxCpc |
可以反映其他广告客户对类似产品的出价情况。 |
biddableAppInstallConversions |
应用安装次数。 |
biddableAppPostInstallConversions |
应用内操作次数。 |
benchmarkCtr |
有关其他广告客户的类似产品的购物广告的效果取决于看到广告的用户点击该广告的频率。 |
bounceRate |
用户只访问了网站上的单个网页时使用的点击次数所占百分比。自 Google Analytics 导入。 |
clicks |
点击次数。 |
combinedClicks |
您的广告或网站的商品详情在未付费结果中的点击次数。如需了解详情,请访问帮助页面:https://support.google.com/google-ads/answer/3097241。 |
combinedClicksPerQuery |
您的广告或您的网站在非付费搜索结果中获得点击的次数 (combinedClicks) 除以合并查询次数。如需了解详情,请访问帮助页面:https://support.google.com/google-ads/answer/3097241。 |
combinedQueries |
在未付费结果中返回您的网站的网页或展示一个文字广告的搜索次数。如需了解详情,请访问帮助页面:https://support.google.com/google-ads/answer/3097241。 |
contentBudgetLostImpressionShare |
您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意:内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
contentImpressionShare |
您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
conversionLastReceivedRequestDateTime |
此转化操作的转化跟踪代码上次成功触发并出现在 Google Ads 中的日期/时间。此触发事件可能不是可归因的转化的结果(例如,因为代码是通过浏览器触发的,而之前没有点击过来自相应广告客户的广告)。日期/时间采用客户所在的时区。 |
conversionLastConversionDate |
此转化操作的最近转化的日期。日期采用客户所在的时区。 |
contentRankLostImpressionShare |
您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
conversionsFromInteractionsRate |
互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversionsValue |
转化价值。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversionsValueByConversionDate |
转化价值。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价策略,您的出价策略将以促成这些转化为目标进行优化。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/google-ads/answer/9549009。 |
newCustomerLifetimeValue |
新客户生命周期价值如果您已在账号一级或广告系列一级设置了客户获取目标,则目标将包括新客户带来的额外转化价值(以促成可出价转化)。如果您的广告系列采用了客户获取目标并选择“针对新客户提高出价”,这些值将纳入到“conversionsValue”中进行优化。请参阅 https://support.google.com/google-ads/answer/12080169 了解详情。 |
conversionsValuePerCost |
转化价值除以广告互动费用。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversionsFromInteractionsValuePerInteraction |
互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversions |
转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversionsByConversionDate |
转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价策略,您的出价策略将以促成这些转化为目标进行优化。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/google-ads/answer/9549009。 |
costMicros |
在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
costPerAllConversions |
广告互动费用除以所有转化次数。 |
costPerConversion |
广告互动费用除以转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
costPerCurrentModelAttributedConversion |
广告互动费用除以当前模型归因转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
crossDeviceConversions |
客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化次数已包含在 allConversions 中。 |
crossDeviceConversionsValueMicros |
跨设备转化的总价值,以微单位表示。 |
ctr |
广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
currentModelAttributedConversions |
显示历史转化数据在您目前选择的归因模型下的情况。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
currentModelAttributedConversionsFromInteractionsRate |
当前模型将互动带来的转化次数除以广告互动(例如文字广告获得的点击或视频广告获得的观看)次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
currentModelAttributedConversionsFromInteractionsValuePerInteraction |
当前模型中由互动促成的转化的价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
currentModelAttributedConversionsValue |
当前模型归因的转化价值。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
currentModelAttributedConversionsValuePerCost |
当前模型归因的转化的价值除以广告互动的费用。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
engagementRate |
在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 |
engagements |
深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 |
hotelAverageLeadValueMicros |
基于点击次数的平均潜在客户价值。 |
hotelCommissionRateMicros |
佣金出价率(以微单位表示)。20% 的佣金表示为 200,000。 |
hotelExpectedCommissionCost |
预期的佣金费用。佣金值乘以 Hotel_commission_rate [广告客户币种] 的结果。 |
hotelPriceDifferencePercentage |
报告酒店广告客户提供的价格与参与竞争的广告客户提供的最低价格之间的平均价格差。 |
hotelEligibleImpressions |
酒店合作伙伴本可以因其 Feed 效果而获得的展示次数。 |
historicalQualityScore |
历史质量得分。 |
gmailForwards |
广告以邮件形式转发给其他人的次数。 |
gmailSaves |
某人将 Gmail 广告以邮件形式保存到收件箱的次数。 |
gmailSecondaryClicks |
Gmail 广告展开状态下的着陆页点击次数。 |
impressionsFromStoreReach |
商店特定营业点的广告所展示的次数。 此指标仅适用于 Feed 项。 |
impressions |
广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
interactionRate |
在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 |
interactions |
互动次数。互动是指与某种广告格式关联的主用户操作:对于文字广告和购物广告而言是点击,对于视频广告而言是观看,诸如此类。 |
invalidClickRate |
报告期内从总点击次数(过滤后 + 未过滤的点击次数)过滤出的点击次数所占的百分比。 |
invalidClicks |
Google 认为不合规定且不向您收费的点击次数。 |
messageChats |
为“点击发短信”展示发起的符合消息跟踪条件的短信聊天数量。 |
messageImpressions |
符合消息跟踪条件的“点击发短信”展示次数。 |
messageChatRate |
发起的消息聊天数 (messageChats) 除以消息展示次数 (messageImpressions)。在启用了消息选项和消息跟踪功能的情况下,用户通过广告展示发起消息聊天的比率。请注意,对于指定的短信展示,此比率可能会大于 1.0。 |
mobileFriendlyClicksPercentage |
适合移动设备的页面的移动点击次数所占的百分比。 |
optimizationScoreUplift |
所有建议带来的优化得分总提升幅度。 |
optimizationScoreUrl |
Google Ads 网页界面中优化得分页面的网址。该指标可从“ |
organicClicks |
某人针对特定查询点击未付费结果中您的网站的商品详情的次数。如需了解详情,请访问帮助页面:https://support.google.com/google-ads/answer/3097241。 |
organicClicksPerQuery |
用户在非付费搜索结果中点击您网站的次数 (organicClicks) 除以从您的网站返回网页的总搜索次数 (organicqueries)。如需了解详情,请访问帮助页面:https://support.google.com/google-ads/answer/3097241。 |
organicImpressions |
未付费搜索结果中您的网站的商品详情数。如需了解详情,请访问帮助页面:https://support.google.com/google-ads/answer/3097241。 |
organicImpressionsPerQuery |
您网站的网页出现在非付费搜索结果的次数 (organicImpressions) 除以在非付费结果中返回您网站的商家信息的搜索次数 (organicqueries)。如需了解详情,请访问帮助页面:https://support.google.com/google-ads/answer/3097241。 |
organicQueries |
在未付费结果中返回您的网站的商品详情的总搜索次数。如需了解详情,请访问帮助页面:https://support.google.com/google-ads/answer/3097241。 |
percentNewVisitors |
首次会话数(来自之前从未访问过您的网站的用户)所占的百分比。自 Google Analytics 导入。 |
phoneCalls |
离线通话次数。 |
phoneImpressions |
离线电话号码展示次数。 |
phoneThroughRate |
收到的来电次数 (phoneCall) 除以您的电话号码的展示次数 (phoneImpressions)。 |
relativeCtr |
您的点击率 (Ctr) 除以展示您的广告的网站上所有广告主的平均点击率。衡量您的广告与同一网站上的其他广告相比在展示广告网络中的效果。 |
searchAbsoluteTopImpressionShare |
在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请参阅 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。 |
searchBudgetLostAbsoluteTopImpressionShare |
此数字是一个估算值,用于估算您的广告因预算不足而未能在搜索结果中作为头条广告进行展示的频率。注意:搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
searchBudgetLostImpressionShare |
您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
searchBudgetLostTopImpressionShare |
此数字是一个估算值,用于估算您的广告因预算不足而未能在顶部自然搜索结果邻近位置展示的频率。注意:搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
searchClickShare |
您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意:搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
searchExactMatchImpressionShare |
对于与关键字完全匹配(或是关键字的紧密变体形式)的搜索字词,此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意:搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
searchImpressionShare |
您在搜索网络中获得的展示次数除以您有资格获得的估算展示次数。注意:在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
searchRankLostAbsoluteTopImpressionShare |
此数字是一个估算值,用于估算您的广告因广告评级较低而未能在搜索结果中作为头条广告进行展示的频率。注意:搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
searchRankLostImpressionShare |
您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
searchRankLostTopImpressionShare |
此数字是一个估算值,表示您的广告因广告评级较低而未能在顶部自然搜索结果邻近位置展示的频率。注意:搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
searchTopImpressionShare |
您在页首广告中实际获得的展示次数除以您有资格在页首广告中获得的估算展示次数所得到的百分比。注意:搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 页首广告通常展示在顶部自然搜索结果上方,但在某些查询中,页首广告可能会展示在顶部自然搜索结果下方。 |
searchVolume |
搜索字词数据分析类别的搜索量范围。 |
speedScore |
衡量点击移动广告后网页加载的速度。得分范围介于 1 到 10 之间,10 是最快的。 |
averageTargetCpaMicros |
平均目标每次转化费用,如果未提供,请取消设置(例如,广告系列的流量来自组合出价策略或非目标每次转化费用)。 |
averageTargetRoas |
平均目标广告支出回报率,如果未提供,请未设置(例如,对于流量来自组合出价策略或非目标广告支出回报率的广告系列)。 |
topImpressionPercentage |
在顶部自然搜索结果邻近位置展示的广告展示次数所占的百分比。 |
validAcceleratedMobilePagesClicksPercentage |
到达有效 AMP 网页的 Accelerated Mobile Pages (AMP) 着陆页的广告点击次数所占百分比。 |
valuePerAllConversions |
所有转化的价值除以所有转化的次数。 |
valuePerAllConversionsByConversionDate |
所有转化的价值除以所有转化次数。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/google-ads/answer/9549009。 |
valuePerConversion |
转化价值除以转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
valuePerConversionsByConversionDate |
转化价值除以转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价策略,您的出价策略将以促成这些转化为目标进行优化。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/google-ads/answer/9549009。 |
valuePerCurrentModelAttributedConversion |
当前模型归因转化的价值除以转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
videoQuartileP100Rate |
观看者观看了您的所有视频时使用的展示次数所占百分比。 |
videoQuartileP25Rate |
观看者观看了 25% 的视频时使用的展示次数所占百分比。 |
videoQuartileP50Rate |
观看者观看了 50% 的视频时使用的展示次数所占百分比。 |
videoQuartileP75Rate |
观看者观看了 75% 的视频时使用的展示次数所占百分比。 |
videoViewRate |
TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 |
videoViews |
视频广告的观看次数。 |
viewThroughConversions |
浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
allConversionsFromLocationAssetClickToCall |
付费广告事件(点击或展示)发生后,任意营业地点界面的致电按钮点击次数。此衡量指标来自基于素材资源的位置。 |
allConversionsFromLocationAssetDirections |
付费广告事件(点击或展示)发生后,任意营业地点界面获得的行车路线点击次数。此衡量指标来自基于素材资源的位置。 |
allConversionsFromLocationAssetMenu |
付费广告事件(点击或展示)发生后,任意位置平台获得的菜单链接点击次数。此衡量指标来自基于素材资源的位置。 |
allConversionsFromLocationAssetOrder |
付费广告事件(点击或展示)发生后,任意营业地点平台的订单点击次数。此衡量指标来自基于素材资源的位置。 |
allConversionsFromLocationAssetOtherEngagement |
付费广告事件(点击或展示)发生后,任意位置平台上其他类型的本地操作点击次数。此衡量指标来自基于素材资源的位置。 |
allConversionsFromLocationAssetStoreVisits |
在付费广告事件(点击或展示)发生后,实体店光顾次数的估算值。此衡量指标来自基于素材资源的位置。 |
allConversionsFromLocationAssetWebsite |
付费广告事件(点击或展示)发生后,任意营业地点平台上的网站网址获得的点击次数。此衡量指标来自基于素材资源的位置。 |
eligibleImpressionsFromLocationAssetStoreReach |
展示实体店营业地点或使用营业地点进行定位的展示次数。此衡量指标来自基于素材资源的位置。 |
viewThroughConversionsFromLocationAssetClickToCall |
广告展示后,任意营业地点 surface 上的致电按钮点击次数。此衡量指标来自基于素材资源的位置。 |
viewThroughConversionsFromLocationAssetDirections |
广告展示后,任意营业地点界面获得的行车路线点击次数。此衡量指标来自基于素材资源的位置。 |
viewThroughConversionsFromLocationAssetMenu |
广告展示后,任意营业地点表面上菜单链接获得的点击次数。此衡量指标来自基于素材资源的位置。 |
viewThroughConversionsFromLocationAssetOrder |
广告展示后任意营业地点平台上的订单点击次数。此衡量指标来自基于素材资源的位置。 |
viewThroughConversionsFromLocationAssetOtherEngagement |
广告展示后,任意营业地点表面上其他类型的本地操作点击次数。此衡量指标来自基于素材资源的位置。 |
viewThroughConversionsFromLocationAssetStoreVisits |
广告展示后实体店光顾次数的估算值。此衡量指标来自基于素材资源的位置。 |
viewThroughConversionsFromLocationAssetWebsite |
广告展示后,任意营业地点平台上的网站网址获得的点击次数。此衡量指标来自基于素材资源的位置。 |
orders |
“订单数”是指广告为您带来的购买转化总次数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果转化归因于用户以前与广告进行的互动(对文字广告或购物广告来说是点击,对视频广告来说是观看),那么这种转化就会被计为一次订单。示例:某个用户点击了宣传帽子的购物广告,然后在您的网站上下单购买了同款帽子和一件衬衫。虽然该用户购买了 2 件商品,但仍会计为 1 笔订单。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
averageOrderValueMicros |
“平均订单价值”是指广告促成的每笔订单带来的平均收入。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。“平均订单价值”的计算方法为:订单带来的总收入除以订单总数。示例:您收到了 3 笔订单,它们分别带来了 10 美元、15 美元和 20 美元的收入。平均订单价值为 15 美元,计算方法为:(10 美元 + 15 美元 + 20 美元)/3。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
averageCartSize |
“平均购物车内商品数量”是指广告带来的每个订单的平均产品数量。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。平均购物车内商品数量的计算方法是:用所售商品总数除以您收到的订单总数。示例:您获得了 2 个订单,第一个订单包含 3 件商品,第二个订单包含 2 件商品。平均购物车内商品数量为 2.5 件商品,计算方法为:(3+2)/2。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
costOfGoodsSoldMicros |
销货成本 (COGS) 是指广告促成的订单中售出产品的总费用。运作方式:您可以在 Merchant Center 中为每个产品添加销货成本价值。如果您报告含购物车数据的转化,系统就会将您销售的商品与其销货成本价值进行匹配,并据此计算每笔订单的毛利润。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。那么,这笔订单的销货成本就是:8 美元 = 3 美元 + 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
grossProfitMicros |
毛利润是指扣除销货成本 (COGS) 后,归因于广告的订单所产生的利润。运作方式:毛利润是指扣除销货成本后,归因于广告的销售所带来的收益。计算毛利润时,只会纳入 Merchant Center 中具有销货成本价值的产品。示例:某个用户点击了宣传帽子的购物广告,然后在您的网站上下单购买了同款帽子和一件衬衫。帽子的价格为 10 美元,衬衫的价格为 20 美元。帽子的销货成本值为 3 美元,但衬衫没有销货成本值。在计算此订单的毛利润时,仅会考虑帽子,因此毛利润为 7 美元 = 10 美元 - 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
grossProfitMargin |
“毛利润率”是指在扣除销货成本 (COGS) 后,广告促成的订单带来的毛利润所占的百分比。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。毛利润率是指用所得毛利润除以总收入,然后再乘 100%,计算得出的值。计算毛利润率时,只会纳入 Merchant Center 中具有销货成本价值的产品。示例:某个用户在您的网站上下单购买了帽子和衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。衬衫的价格为 20 美元,但没有销货成本价值。这笔订单中只有帽子有销货成本价值,因此计算毛利润率时只会将帽子考虑在内,即 70% =(10 美元 - 3 美元)/10 美元 x 100%。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
revenueMicros |
“收入”是指您从广告促成的订单中赚到的总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。广告促成的所有订单的总价值减去所有折扣即为收入。示例:某个用户点击了宣传帽子的购物广告,然后在您的网站上下单购买了同款帽子和一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。整个订单有 5 美元的折扣。这笔订单的收入为:25 美元 =(10 美元 + 20 美元)- 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
unitsSold |
“售出数量”是指广告促成的订单中的售出产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。“售出数量”是指广告促成的所有订单中的售出产品的总数。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,售出数量为 3。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
crossSellCostOfGoodsSoldMicros |
“作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。作为交叉销售产品时的销货成本是指并未通过广告宣传售出的产品的总费用。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的销货成本为 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
crossSellGrossProfitMicros |
“作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的其他产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的毛利润”是指广告促成的交叉销售所产生的收入减去销货成本。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。衬衫的价格为 20 美元,其销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的毛利润就是:15 美元 = 20 美元 - 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
crossSellRevenueMicros |
“作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售给您带来的收入总和。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为交叉销售产品时的收入为 20 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
crossSellUnitsSold |
“作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
leadCostOfGoodsSoldMicros |
“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品(请参阅购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些产品的成本会计入“作为主推产品时的销货成本”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为主推产品时的销货成本为 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
leadGrossProfitMicros |
“作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的同一产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您通过这些销售获得的收入减去销货成本即为您的主打产品的毛利润。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。在这笔订单中,作为主推产品时的毛利润就是:7 美元 = 10 美元 - 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
leadRevenueMicros |
“作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您因销售这些产品而获得的总价值会计入“作为主推产品时的收入”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为主推产品时的收入为 10 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
leadUnitsSold |
“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些售出产品的总数会计入“作为主推产品时的销量”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
uniqueUsers |
在指定的时间段内看到您的广告的唯一身份用户数。该指标无法进行汇总,且只能请求日期范围不超过 92 天的数据。此指标适用于以下广告系列类型:展示广告系列、视频广告系列、发现广告系列和应用广告系列。 |
averageImpressionFrequencyPerUser |
唯一身份用户在请求的时间段内看到您的广告的平均次数。该指标无法进行汇总,且只能请求日期范围不超过 92 天的数据。此指标适用于以下广告系列类型:展示广告系列、视频广告系列、发现广告系列和应用广告系列。 |
linkedEntitiesCount |
使用了该素材资源的关联资源的数量。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。 |
assetPinnedTotalCount |
固定资产的总使用次数。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetPinnedAsHeadlinePositionOneCount |
素材资源固定到标题 1 的实体数量。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetPinnedAsHeadlinePositionTwoCount |
素材资源固定到标题 2 的实体数量。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetPinnedAsHeadlinePositionThreeCount |
素材资源固定到标题 3 的实体数量。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetPinnedAsDescriptionPositionOneCount |
素材资源固定到广告内容描述 1 的实体数量。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetPinnedAsDescriptionPositionTwoCount |
素材资源固定到广告内容描述 2 的实体数量。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetBestPerformanceImpressionPercentage |
素材资源在带有 AssetPerformanceLabel.BEST 的广告中获得的展示次数所占的百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetGoodPerformanceImpressionPercentage |
素材资源在带有 AssetPerformanceLabel.GOOD 的广告中获得的展示次数所占的百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetLowPerformanceImpressionPercentage |
素材资源在具有 AssetPerformanceLabel.LOW 的广告中获得的展示次数所占的百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetLearningPerformanceImpressionPercentage |
带有 AssetPerformanceLabel.LEARNING 的广告中素材资源获得的展示次数所占的百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetUnratedPerformanceImpressionPercentage |
素材资源在带有 AssetPerformanceLabel(BEST、GOOD、LOW 和 LEARNING)以外的广告的展示次数中所占的百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。仅搜索渠道支持此指标。 |
assetBestPerformanceCostPercentage |
带有 AssetPerformanceLabel.BEST 的广告中素材资源的费用百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。只有效果最大化广告系列渠道支持此指标。 |
assetGoodPerformanceCostPercentage |
带有 AssetPerformanceLabel.GOOD 的广告中素材资源的费用百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。只有效果最大化广告系列渠道支持此指标。 |
assetLowPerformanceCostPercentage |
带有 AssetPerformanceLabel.LOW 的广告中素材资源的费用百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。只有效果最大化广告系列渠道支持此指标。 |
assetLearningPerformanceCostPercentage |
带有 AssetPerformanceLabel.LEARNING 的广告中素材资源的费用百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。只有效果最大化广告系列渠道支持此指标。 |
assetUnratedPerformanceCostPercentage |
带有 AssetPerformanceLabel(BEST、GOOD、LOW 和 LEARNING 除外)的广告中素材资源的费用百分比。该指标只能通过 ChannelAggregateAssetView 和 CampaignAggregateAssetView 来选择。只有效果最大化广告系列渠道支持此指标。 |
InteractionEventType
描述可能的付费互动和免费互动类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
CLICK |
点击访问网站。在大多数情况下,这种互动会导航到外部位置,通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。 |
ENGAGEMENT |
用户在原位置与广告互动的明确意向。 |
VIDEO_VIEW |
用户观看了一个视频广告。 |
NONE |
广告转化事件的默认 InteractionEventType。当广告转化行没有指明免费互动(例如广告转化)应该“推广”时,系统会使用此方法作为核心指标的一部分进行报告这些都属于其他(广告)转化。 |
SearchVolumeRange
搜索量范围。实际搜索量在此范围内。
JSON 表示法 |
---|
{ "min": string, "max": string } |
字段 | |
---|---|
min |
搜索量的下限。 |
max |
搜索量的上限。 |
细分
仅限细分字段。
JSON 表示法 |
---|
{ "adDestinationType": enum ( |
字段 | |
---|---|
adDestinationType |
广告目标页面类型。 |
adFormatType |
广告格式类型。 |
adNetworkType |
广告网络类型。 |
budgetCampaignAssociationStatus |
预算广告系列关联状态。 |
clickType |
点击类型。 |
conversionActionCategory |
转化操作类别。 |
conversionAttributionEventType |
转化归因事件类型。 |
conversionLagBucket |
一个枚举值,表示展示和转化之间相隔的天数。 |
conversionOrAdjustmentLagBucket |
一个枚举值,表示从展示到转化,或者从展示到转化调整之间的天数。 |
dayOfWeek |
星期几,例如 MONDAY。 |
device |
指标应用于的设备。 |
externalConversionSource |
外部转化来源。 |
hotelCheckInDayOfWeek |
酒店入住日(星期几)。 |
hotelDateSelectionType |
酒店日期选择类型。 |
hotelRateType |
酒店房价类型。 |
hotelPriceBucket |
酒店价格范围。 |
keyword |
关键字标准。 |
monthOfYear |
月份,例如 1 月。 |
placeholderType |
占位符类型。此维度只能与 Feed 项指标一起使用。 |
productChannel |
商品的渠道。 |
productChannelExclusivity |
商品的渠道独占性。 |
productCondition |
商品的使用情况。 |
recommendationType |
建议类型。 |
searchEngineResultsPageType |
搜索引擎结果页 (SERP) 的类型。 |
searchTermMatchType |
触发广告的关键字(包括变体)的匹配类型。 |
slot |
广告的位置。 |
conversionValueRulePrimaryDimension |
应用的转化价值规则的主要维度。NO_RULE_APPLIED 显示的是未应用价值规则的转化的总记录价值。“ORIGINAL”显示已应用价值规则的转化的原始价值。GEO_LOCATION、DEVICE、AUDIENCE 显示应用价值规则后的净调整。 |
skAdNetworkUserType |
iOS Store Kit 广告网络用户类型。 |
skAdNetworkAdEventType |
iOS Store Kit 广告网络广告事件类型。 |
skAdNetworkAttributionCredit |
iOS Store Kit 广告网络归因功劳 |
skAdNetworkCoarseConversionValue |
iOS Store Kit 广告网络的粗略转化价值。 |
skAdNetworkSourceType |
促成 iOS Store Kit Ad Network 安装的广告的来源类型。Null 值表示此细分不适用(例如非 iOS 广告系列),或者 Apple 发送的任何回传中都不存在来源网域和来源应用。 |
newVersusReturningCustomers |
适用于按用户是新客户还是回头客来细分转化数据。此细分通常用于衡量客户获取目标的影响。 |
activityAccountId |
活动账号 ID。 |
activityCity |
开展旅行活动的城市。 |
activityCountry |
开展旅行活动的国家/地区。 |
activityRating |
活动评分。 |
activityState |
提供旅游 activity 的状态。 |
externalActivityId |
广告客户提供的活动 ID。 |
adGroup |
广告组的资源名称。 |
assetGroup |
素材资源组的资源名称。 |
auctionInsightDomain |
竞价分析报告中参与者的域名(可见网址)。 |
campaign |
广告系列的资源名称。 |
conversionAction |
转化操作的资源名称。 |
conversionActionName |
转化操作名称。 |
conversionAdjustment |
这会按原始转化次数和转化价值与转化次数(如果转化调整后)的增量细分您的转化列。假行包含最初所述的数据;实际行的数据与原先的数据之间存在增量。将两组数据相加后得到的调整后数据。 |
date |
指标适用的日期。yyyy-MM-dd 格式,例如 2018-04-17。 |
geoTargetAirport |
表示机场的地理位置定位常量的资源名称。 |
geoTargetCanton |
表示州/省/自治区/直辖市的地理位置定位常量的资源名称。 |
geoTargetCity |
表示城市的地理位置定位目标常量的资源名称。 |
geoTargetCountry |
表示国家/地区的地理位置定位常量的资源名称。 |
geoTargetCounty |
表示国家/地区的地理位置定位常量的资源名称。 |
geoTargetDistrict |
表示地区的目标地理区域常量的资源名称。 |
geoTargetMetro |
代表都市圈的地理位置定位目标常量的资源名称。 |
geoTargetMostSpecificLocation |
代表最具体位置的地理位置定位目标常量的资源名称。 |
geoTargetPostalCode |
表示邮政编码的地理位置定位常量的资源名称。 |
geoTargetProvince |
表示省/自治区/直辖市的地理位置定位常量的资源名称。 |
geoTargetRegion |
代表区域的地理位置定位目标常量的资源名称。 |
geoTargetState |
表示州/省/自治区/直辖市的地理位置定位常量的资源名称。 |
hotelBookingWindowDays |
酒店预订天数。 |
hotelCenterId |
Hotel Center ID。 |
hotelCheckInDate |
酒店入住日期。格式为 yyyy-MM-dd。 |
hotelCity |
酒店所在的城市。 |
hotelClass |
酒店星级。 |
hotelCountry |
酒店所在的国家/地区。 |
hotelLengthOfStay |
酒店住宿晚数。 |
hotelRateRuleId |
酒店房价规则 ID。 |
hotelState |
酒店所在的省级行政区。 |
hour |
以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 |
interactionOnThisExtension |
只能与 Feed 项指标一起使用。指明互动指标是出现在 Feed 项本身还是其他附加信息或广告单元上。 |
month |
由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 |
partnerHotelId |
合作伙伴酒店 ID。 |
productAggregatorId |
商品的集合商家 ID。 |
productCategoryLevel1 |
产品的类别(级别 1)。 |
productCategoryLevel2 |
产品的类别(级别 2)。 |
productCategoryLevel3 |
产品的类别(级别 3)。 |
productCategoryLevel4 |
产品的类别(级别 4)。 |
productCategoryLevel5 |
产品的类别(级别 5)。 |
productBrand |
商品的品牌。 |
productCountry |
商品目标销售国家/地区的地理位置定位目标常量的资源名称。 |
productCustomAttribute0 |
商品的自定义属性 0。 |
productCustomAttribute1 |
商品的自定义属性 1。 |
productCustomAttribute2 |
商品的自定义属性 2。 |
productCustomAttribute3 |
商品的自定义属性 3。 |
productCustomAttribute4 |
商品的自定义属性 4。 |
productFeedLabel |
产品的 Feed 标签。 |
productItemId |
商品的项目 ID。 |
productLanguage |
商品语言的语言常量的资源名称。 |
productMerchantId |
产品的商家 ID。 |
productStoreId |
商品的商店 ID。 |
productTitle |
商品的名称。 |
productTypeL1 |
商品的类型(第 1 级)。 |
productTypeL2 |
商品的类型(第 2 级)。 |
productTypeL3 |
商品的类型(第 3 级)。 |
productTypeL4 |
商品的类型(第 4 级)。 |
productTypeL5 |
商品的类型(第 5 级)。 |
quarter |
由一个季度第一天的日期表示的季度。针对季度使用日历年,例如,2018 年第二季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 |
searchSubcategory |
搜索字词子类别。空字符串表示无法归入其他子类别的搜索字词的综合子类别。 |
searchTerm |
搜索字词。 |
webpage |
表示网页条件的广告组条件的资源名称。 |
week |
定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 |
year |
年份,格式为 yyyy。 |
skAdNetworkFineConversionValue |
iOS Store Kit 广告网络转化价值。值为 null 表示此细分不适用,例如,不适用于非 iOS 广告系列。 |
skAdNetworkRedistributedFineConversionValue |
iOS Store Kit 广告网络重新分配的精确转化价值。 Google 根据观测到的转化价值(从 Apple 获得)根据模型估算转化,以返回 NULL 的 SKAN 回传计算转化次数。此列显示的是根据模型估算的转化价值与观测到的转化价值之和。请访问 https://support.google.com/google-ads/answer/14892597 了解详情。 |
skAdNetworkSourceApp |
应用,展示 iOS Store Kit Ad Network 安装广告的广告。Null 值表示此细分不适用(例如,非 iOS 广告系列),或不存在于 Apple 发送的任何回传中。 |
skAdNetworkSourceDomain |
促成 iOS Store Kit Ad Network 安装的广告的网站。Null 值表示此细分不适用(例如,非 iOS 广告系列),或不存在于 Apple 发送的任何回传中。 |
skAdNetworkPostbackSequenceIndex |
iOS Store Kit 广告网络回传序列索引。 |
skAdNetworkVersion |
使用的 SKAdNetwork API 版本。 |
assetInteractionTarget |
仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标一起使用。指明互动指标是出现在素材资源本身上,还是出现在其他素材资源或广告单元上。当投放的广告的所有部分(例如广告本身以及站内链接等其他组件)一起投放时,系统会统计互动(例如点击次数)。如果 interactionOnThisAsset 为 true,则表示互动发生在此特定素材资源上;如果 InteractionOnThisAsset 为 false,则表示互动并非针对该特定素材资源,而是在已投放此素材资源的广告的其他部分。 |
AdDestinationType
枚举 Google Ads 目标类型
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
NOT_APPLICABLE |
广告不打算将用户从广告引导至其他目标页面 |
WEBSITE |
网站 |
APP_DEEP_LINK |
应用深层链接 |
APP_STORE |
iOS App Store 或 Play Store |
PHONE_CALL |
呼叫拨号器 |
MAP_DIRECTIONS |
地图应用 |
LOCATION_LISTING |
位置专用页面 |
MESSAGE |
短信 |
LEAD_FORM |
潜在客户发掘表单 |
YOUTUBE |
YouTube |
UNMODELED_FOR_CONVERSIONS |
键未知的广告目标页面 |
AdFormatType
枚举 Google Ads 格式类型。
请注意,此细分仅适用于视频广告系列和发现广告系列。素材资源仅支持视频素材资源。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
OTHER |
分配给在视频广告系列和发现广告系列中不支持格式细分的格式(例如实验性格式)。 请注意,将来这些格式可能会更改类别(例如,如果展示了实验性格式或添加了新格式)。我们强烈建议您在制定长期决策时不要依赖此字段。 |
UNSEGMENTED |
为 TrueView 行动号召视频广告系列统计信息指定的值。 请注意,具有此值的统计信息将来可能会更改类别,例如,如果新的广告系列类型支持格式细分的话。我们强烈建议您在制定长期决策时不要依赖此字段。 |
INSTREAM_SKIPPABLE |
可跳过的插播广告。 |
INSTREAM_NON_SKIPPABLE |
不可跳过的插播广告。 |
INFEED |
在信息流界面(例如 Google 探索信息流、YouTube 首页等)上投放的 YouTube 信息流广告或发现图片广告。 |
BUMPER |
不可跳过的短(不到 7 秒)插播的 YouTube 广告。 |
OUTSTREAM |
外播广告。 |
MASTHEAD |
标头广告。 |
AUDIO |
音频广告。 |
SHORTS |
在 YouTube Shorts 上投放的竖屏全屏视频广告或发现图片广告,或作为 YouTube Shorts 自然 Shorts 广告投放的 BrandConnect 广告。 |
AdNetworkType
枚举 Google Ads 广告网络类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
SEARCH |
Google 搜索。 |
SEARCH_PARTNERS |
搜索网络合作伙伴。 |
CONTENT |
展示广告网络。 |
MIXED |
跨广告网络。 |
YOUTUBE |
YouTube |
GOOGLE_TV |
Google TV |
BudgetCampaignAssociationStatus
BudgetCampaignAssociationStatus 细分。
JSON 表示法 |
---|
{
"status": enum ( |
字段 | |
---|---|
status |
预算广告系列关联状态。 |
campaign |
广告系列资源名称。 |
BudgetCampaignAssociationStatus
预算与广告系列关联的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
广告系列目前正在使用该预算。 |
REMOVED |
此广告系列已不再使用该预算。 |
ClickType
枚举 Google Ads 点击类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
APP_DEEPLINK |
应用互动广告的深层链接。 |
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 |
购物 - 商品 - 在线。 |
SITELINKS |
站内链接。 |
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 |
网站。 |
VISUAL_SITELINKS |
视觉化附加链接。 |
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 上销售。 |
PRODUCT_AD_APP_DEEPLINK |
购物 - 商品 - 应用互动广告深层链接。 |
SHOWCASE_AD_CATEGORY_LINK |
购物 - 橱窗 - 类别。 |
SHOWCASE_AD_LOCAL_STOREFRONT_LINK |
购物 - 橱窗 - 本地店面。 |
SHOWCASE_AD_ONLINE_PRODUCT_LINK |
购物 - 橱窗 - 在线产品。 |
SHOWCASE_AD_LOCAL_PRODUCT_LINK |
购物 - 橱窗 - 本地商品。 |
PROMOTION_EXTENSION |
附加促销信息。 |
SWIPEABLE_GALLERY_AD_HEADLINE |
广告标题。 |
SWIPEABLE_GALLERY_AD_SWIPES |
滑动。 |
SWIPEABLE_GALLERY_AD_SEE_MORE |
了解详情。 |
SWIPEABLE_GALLERY_AD_SITELINK_ONE |
站内链接 1. |
SWIPEABLE_GALLERY_AD_SITELINK_TWO |
站内链接 2. |
SWIPEABLE_GALLERY_AD_SITELINK_THREE |
站内链接 3. |
SWIPEABLE_GALLERY_AD_SITELINK_FOUR |
站内链接 4. |
SWIPEABLE_GALLERY_AD_SITELINK_FIVE |
附加链接 5. |
HOTEL_PRICE |
酒店价格。 |
PRICE_EXTENSION |
附加价格信息。 |
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION |
“通过 Google 预订”酒店房间选择。 |
SHOPPING_COMPARISON_LISTING |
购物 - 购物比较服务详情。 |
CROSS_NETWORK |
跨广告网络。通过效果最大化广告系列和发现广告系列。 |
AD_IMAGE |
广告映像。 |
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 ( |
字段 | |
---|---|
info |
关键字信息。 |
adGroupCriterion |
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 |
促成 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 |
资产资源名称。 |
interactionOnThisAsset |
仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标一起使用。指明互动指标是出现在素材资源本身上,还是出现在其他素材资源或广告单元上。 |
ConvertingUserPriorEngagementTypeAndLtvBucket
枚举转化用户之前的互动类型和生命周期价值范围
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
NEW |
完成转化的用户是广告主的新用户。 |
RETURNING |
完成转化的用户是回访广告客户。不同转化类型的退货率定义不尽相同,例如第二次实体店光顾和第二次网上购买。 |
NEW_AND_HIGH_LTV |
完成转化的用户是广告主的新用户,具有较高的生命周期价值。 |