- JSON 表示法
- AccountBudget
- AccountBudgetStatus
- PendingAccountBudgetProposal
- AdGroupAdAssetCombinationView
- AssetUsage
- AdGroupAdAssetView
- AdGroupAdAssetPolicySummary
- AdGroupAudienceView
- AdGroupCriterionSimulation
- SimulationType
- SimulationModificationMethod
- CpcBidSimulationPointList
- CpcBidSimulationPoint
- PercentCpcBidSimulationPointList
- PercentCpcBidSimulationPoint
- AdGroupSimulation
- CpvBidSimulationPointList
- CpvBidSimulationPoint
- TargetCpaSimulationPointList
- TargetCpaSimulationPoint
- TargetRoasSimulationPointList
- TargetRoasSimulationPoint
- AgeRangeView
- AdScheduleView
- DomainCategory
- AssetFieldTypeView
- AssetGroupProductGroupView
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetSetTypeView
- BiddingStrategySimulation
- CallView
- CallTrackingDisplayLocation
- CallType
- GoogleVoiceCallStatus
- CampaignAudienceView
- CampaignSearchTermInsight
- CampaignSimulation
- TargetImpressionShareSimulationPointList
- TargetImpressionShareSimulationPoint
- BudgetSimulationPointList
- BudgetSimulationPoint
- CarrierConstant
- ChangeEvent
- ChangeEventResourceType
- ChangeClientType
- ChangedResource
- ResourceChangeOperation
- ChangeStatus
- ChangeStatusResourceType
- ChangeStatusOperation
- CombinedAudience
- CombinedAudienceStatus
- ClickView
- ClickLocation
- CurrencyConstant
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerClient
- CustomerSearchTermInsight
- DetailPlacementView
- PlacementType
- DetailedDemographic
- CriterionCategoryAvailability
- CriterionCategoryChannelAvailability
- CriterionCategoryChannelAvailabilityMode
- CriterionCategoryLocaleAvailability
- CriterionCategoryLocaleAvailabilityMode
- DisplayKeywordView
- DistanceView
- DistanceBucket
- DynamicSearchAdsSearchTermView
- ExpandedLandingPageView
- FeedPlaceholderView
- GenderView
- GeographicView
- GeoTargetingType
- GroupPlacementView
- HotelGroupView
- HotelPerformanceView
- HotelReconciliation
- HotelReconciliationStatus
- IncomeRangeView
- KeywordView
- LandingPageView
- LanguageConstant
- LocationView
- ManagedPlacementView
- MediaFile
- MediaType
- MediaImage
- MediaBundle
- MediaAudio
- MediaVideo
- LocalServicesEmployee
- LocalServicesEmployeeStatus
- LocalServicesEmployeeType
- UniversityDegree
- 居住地
- 奖学金
- LocalServicesVerificationArtifact
- LocalServicesVerificationArtifactStatus
- LocalServicesVerificationArtifactType
- BackgroundCheckVerificationArtifact
- InsuranceVerificationArtifact
- LocalServicesInsuranceRejectionReason
- LocalServicesDocumentReadOnly
- LicenseVerificationArtifact
- LocalServicesLicenseRejectionReason
- BusinessRegistrationCheckVerificationArtifact
- LocalServicesBusinessRegistrationType
- LocalServicesBusinessRegistrationCheckRejectionReason
- BusinessRegistrationNumber
- BusinessRegistrationDocument
- MobileAppCategoryConstant
- MobileDeviceConstant
- MobileDeviceType
- OfflineConversionUploadClientSummary
- OfflineEventUploadClient
- OfflineConversionDiagnosticStatus
- OfflineConversionSummary
- OfflineConversionAlert
- OfflineConversionError
- CollectionSizeError
- ConversionAdjustmentUploadError
- ConversionUploadError
- DateError
- DistinctError
- FieldError
- MutateError
- NotAllowlistedError
- StringFormatError
- StringLengthError
- OperatingSystemVersionConstant
- OperatingSystemVersionOperatorType
- PaidOrganicSearchTermView
- QualifyingQuestion
- ParentalStatusView
- PerStoreView
- ProductCategoryConstant
- ProductCategoryState
- ProductCategoryLocalization
- ProductGroupView
- SearchTermView
- SearchTermTargetingStatus
- ShoppingPerformanceView
- SmartCampaignSearchTermView
- ThirdPartyAppAnalyticsLink
- TopicView
- TravelActivityGroupView
- TravelActivityPerformanceView
- UserInterest
- UserInterestTaxonomyType
- LifeEvent
- UserLocationView
- TopicConstant
- 视频
- WebpageView
- LeadFormSubmissionData
- LeadFormSubmissionField
- CustomLeadFormSubmissionField
- LocalServicesLead
- ContactDetails
- LeadType
- LeadStatus
- 注意
- CreditDetails
- CreditState
- LocalServicesLeadConversation
- ConversationType
- ParticipantType
- PhoneCallDetails
- MessageDetails
- AndroidPrivacySharedKeyGoogleAdGroup
- AndroidPrivacyInteractionType
- AndroidPrivacyNetworkType
- AndroidPrivacySharedKeyGoogleCampaign
- AndroidPrivacySharedKeyGoogleNetworkType
- 指标
- InteractionEventType
- SearchVolumeRange
- 细分
- AdDestinationType
- AdNetworkType
- BudgetCampaignAssociationStatus
- BudgetCampaignAssociationStatus
- ClickType
- ConversionAttributionEventType
- ConversionLagBucket
- ConversionOrAdjustmentLagBucket
- ExternalConversionSource
- HotelRateType
- HotelPriceBucket
- 关键字
- SearchEngineResultsPageType
- SearchTermMatchType
- 槽
- ConversionValueRulePrimaryDimension
- SkAdNetworkUserType
- SkAdNetworkAdEventType
- SkAdNetworkSourceApp
- SkAdNetworkAttributionCredit
- SkAdNetworkSourceType
- AssetInteractionTarget
- ConvertingUserPriorEngagementTypeAndLtvBucket
从查询中返回的行。
JSON 表示法 |
---|
{ "accountBudget": { object ( |
字段 | |
---|---|
accountBudget |
查询中的帐号预算。 |
accountBudgetProposal |
查询中引用的帐号预算提案。 |
accountLink |
查询中引用的 AccountLink。 |
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 |
查询中引用的素材资源字段类型视图。 |
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 |
线下转化数据上传客户端摘要。 |
offlineUserDataJob |
查询中引用的离线用户数据作业。 |
operatingSystemVersionConstant |
查询中引用的操作系统版本常量。 |
paidOrganicSearchTermView |
查询中引用的付费自然搜索字词视图。 |
qualifyingQuestion |
查询中引用的限定问题。 |
parentalStatusView |
查询中引用的生育情况视图。 |
perStoreView |
查询中引用的按商店视图。 |
productCategoryConstant |
查询中引用的商品类别。 |
productGroupView |
查询中引用的产品组视图。 |
productLink |
查询中引用的产品链接。 |
productLinkInvitation |
查询中的产品关联邀请。 |
recommendation |
查询中引用的建议。 |
recommendationSubscription |
查询中引用的推荐订阅。 |
searchTermView |
查询中引用的搜索字词视图。 |
sharedCriterion |
查询中引用的共享集。 |
sharedSet |
查询中引用的共享集。 |
smartCampaignSetting |
查询中引用的智能广告系列设置。 |
shoppingPerformanceView |
查询中引用的购物效果视图。 |
smartCampaignSearchTermView |
查询中引用的智能广告系列搜索字词视图。 |
thirdPartyAppAnalyticsLink |
查询中引用的 AccountLink。 |
topicView |
查询中引用的主题视图。 |
travelActivityGroupView |
查询中引用的旅行活动组视图。 |
travelActivityPerformanceView |
查询中引用的旅行活动表现视图。 |
experiment |
查询中引用的实验。 |
experimentArm |
查询中引用的实验组。 |
userInterest |
查询中引用的用户兴趣。 |
lifeEvent |
查询中引用的人生大事。 |
userList |
查询中引用的用户名单。 |
userLocationView |
查询中引用的用户地理位置视图。 |
remarketingAction |
查询中引用的再营销操作。 |
topicConstant |
查询中引用的主题常量。 |
video |
查询中引用的视频。 |
webpageView |
查询中引用的网页视图。 |
leadFormSubmissionData |
查询中引用的潜在客户表单用户提交内容。 |
localServicesLead |
查询中引用的本地生活服务潜在客户。 |
localServicesLeadConversation |
本地生活服务主导查询中提及的对话。 |
androidPrivacySharedKeyGoogleAdGroup |
查询中引用的 Android 隐私共享关键 Google 广告组。 |
androidPrivacySharedKeyGoogleCampaign |
查询中引用的 Android 隐私共享密钥 Google 广告系列。 |
androidPrivacySharedKeyGoogleNetworkType |
查询中引用的 Android 隐私共享密钥 Google 网络类型。 |
metrics |
指标。 |
segments |
细分。 |
AccountBudget
帐号级预算。其中包含有关预算本身的信息,以及最近批准的预算更改和待审批的建议更改。可以在“pendingProposal”中找到待审批的建议更改(如果有)。有关预算的有效详情,请参见前缀为“Approved_”“adjusted_”的字段以及不带前缀的字段。由于一些有效细节可能会与用户最初请求的内容(例如支出限额)有所不同,因此这些差异会并排显示:“proposed_”“Approved_”和可能的“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,则保证为 true。 |
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
广告组广告与素材资源之间的关联。目前,我们仅支持将 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
广告组条件模拟。下面分别列出了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法组合。从 V5 开始执行酒店 IDFA 模拟操作。
- 展示广告 - 关键字 - 每次点击费用出价 - 统一
- 搜索广告 - 关键字 - 每次点击费用出价 - 统一
- 购物广告系列 - LISTING_GROUP - 每次点击费用出价 - 统一
- 酒店 - LISTING_GROUP - CPC_bid - UNIFORM
- 酒店 - 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,则模拟点数。 |
SimulationType
描述模拟所修改字段的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
CPC_BID |
模拟时使用的是每次点击费用出价。 |
CPV_BID |
模拟时使用的是每次观看费用出价。 |
TARGET_CPA |
模拟时采用的是每次转化费用目标值。 |
BID_MODIFIER |
模拟是针对出价调节系数的。 |
TARGET_ROAS |
该模拟针对的是广告支出回报率目标值。 |
PERCENT_CPC_BID |
模拟显示的是百分比形式的每次点击费用出价。 |
TARGET_IMPRESSION_SHARE |
模拟的对象是展示次数份额目标。 |
BUDGET |
模拟是针对预算的。 |
SimulationModificationMethod
描述模拟修改字段所用的方法的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
UNIFORM |
模拟中的值会统一应用于给定资源的所有子级。系统未遵循对子资源的替换。 |
DEFAULT |
模拟中的值已应用于给定资源。系统会遵循子资源的覆盖设置,流量估算值不包括这些资源。 |
SCALING |
模拟中的所有值均按相同系数进行了缩放。例如,在模拟的 TargetCpa 广告系列中,广告系列目标和所有广告组目标都按 X 的系数进行了缩放。 |
CpcBidSimulationPointList
用于表示 CPC_Bid 类型的模拟点的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
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 - 默认
- 展示广告 - 每次点击费用出价 - 统一
- 展示广告系列 - 目标每次转化费用 - 统一
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 |
仅限输出。资产字段类型视图的资产字段类型。 |
AssetGroupProductGroupView
素材资源组产品组视图。
JSON 表示法 |
---|
{ "resourceName": string, "assetGroup": string, "assetGroupListingGroupFilter": string } |
字段 | |
---|---|
resourceName |
仅限输出。素材资源组产品组视图的资源名称。素材资源组产品组视图资源名称采用以下格式:
|
assetGroup |
仅限输出。与产品信息组过滤条件相关联的素材资源组。 |
assetGroupListingGroupFilter |
仅限输出。素材资源组产品信息组过滤条件的资源名称。 |
AssetGroupTopCombinationView
广告组广告素材资源组合使用情况视图。
JSON 表示法 |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
字段 | |
---|---|
resourceName |
仅限输出。素材资源组顶部组合视图的资源名称。AssetGroup 顶部组合视图资源名称的格式如下:"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{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 语音通话的可能状态。
枚举 | |
---|---|
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
广告系列模拟。下面分别详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法组合。
- 搜索广告 - 每次点击费用出价 - 统一
- 搜索广告系列 - 每次点击费用出价 - 扩展
- 搜索广告系列 - 目标每次转化费用 - 统一
- 搜索广告系列 - 目标每次转化费用 - 扩展
- 搜索广告系列 - 目标广告支出回报率 - 统一
- 搜索广告系列 - 目标展示次数份额 - 统一
- 搜索广告系列 - 预算 - 统一
- 购物广告 - 预算 - 统一
- 购物广告系列 - 目标广告支出回报率 - 统一
- 多渠道 - 目标每次转化费用 - 统一
- 多渠道 - 目标广告支出回报率 - 统一
- 发现广告系列 - 目标每次转化费用 - 默认
- 展示广告系列 - 目标每次转化费用 - 统一
- 效果最大化广告系列 - 目标每次转化费用 - 统一
- 效果最大化广告系列 - 目标广告支出回报率 - 统一
- PERFORMANCE_MAX - 预算 - 统一
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
用于存储类型为 BUDGET 的模拟的模拟点的容器。
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 |
仅限输出。发生此更改的只是资源。 |
clientType |
仅限输出。进行更改的位置。 |
userEmail |
仅限输出。进行此项更改的用户的电子邮件地址。 |
oldResource |
仅限输出。更改前的旧资源。只有已更改的字段才会填充。 |
newResource |
仅限输出。更改后的新资源。只有已更改的字段才会填充。 |
resourceChangeOperation |
仅限输出。对已更改的资源执行的操作。 |
changedFields |
仅限输出。返回的资源中发生更改的字段列表。 这是以英文逗号分隔的完全限定字段名称列表。示例: |
campaign |
仅限输出。受此更改影响的广告系列。 |
adGroup |
仅限输出。受此更改影响的广告组。 |
feed |
仅限输出。受此更改影响的 Feed。 |
feedItem |
仅限输出。受此更改影响的 FeedItem。 |
asset |
仅限输出。受此更改影响的资产。 |
ChangeEventResourceType
列出 ChangeEvent 资源支持的资源类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的未分类资源。 |
AD |
广告素材资源更改。 |
AD_GROUP |
广告组资源更改。 |
AD_GROUP_CRITERION |
CocoaPods 资源更改。 |
CAMPAIGN |
广告系列资源更改。 |
CAMPAIGN_BUDGET |
CampaignBudget 资源更改。 |
AD_GROUP_BID_MODIFIER |
广告组 BidModifier 资源更改。 |
CAMPAIGN_CRITERION |
Campaigncriteria 资源发生变化。 |
FEED |
Feed 资源发生变化。 |
FEED_ITEM |
FeedItem 资源发生变化。 |
CAMPAIGN_FEED |
CampaignFeed 资源发生变化。 |
AD_GROUP_FEED |
广告组 Feed 资源更改。 |
AD_GROUP_AD |
广告组广告资源更改。 |
ASSET |
一项资产资源更改。 |
CUSTOMER_ASSET |
CustomerAsset 资源变更。 |
CAMPAIGN_ASSET |
CampaignAsset 资源发生更改。 |
AD_GROUP_ASSET |
广告组素材资源资源更改。 |
ASSET_SET |
AssetSet 资源更改。 |
ASSET_SET_ASSET |
AssetSetAsset 资源更改。 |
CAMPAIGN_ASSET_SET |
CampaignAssetSet 资源发生更改。 |
ChangeClientType
changeEvent 资源的来源。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的未分类客户端类型。 |
GOOGLE_ADS_WEB_CLIENT |
通过“ads.google.com”所做的更改。例如,通过广告系列管理所做的更改。 |
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。 |
lastChangeDateTime |
仅限输出。此资源最近更改发生的时间。 |
campaign |
仅限输出。受此更改影响的广告系列。 |
adGroup |
仅限输出。受此更改影响的广告组。 |
adGroupAd |
仅限输出。受此更改影响的 AdGroupAd。 |
adGroupCriterion |
仅限输出。受此更改影响的 CocoaPods。 |
campaignCriterion |
仅限输出。受此更改影响的 CampaignCondition。 |
feed |
仅限输出。受此更改影响的 Feed。 |
feedItem |
仅限输出。受此更改影响的 FeedItem。 |
adGroupFeed |
仅限输出。受此更改影响的 AdGroupFeed。 |
campaignFeed |
仅限输出。受此更改影响的 CampaignFeed。 |
adGroupBidModifier |
仅限输出。受此更改影响的 AdGroupBidModifier。 |
ChangeStatusResourceType
列出 ChangeStatus 资源支持的资源类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的未分类资源。 |
AD_GROUP |
广告组资源更改。 |
AD_GROUP_AD |
广告组广告资源更改。 |
AD_GROUP_CRITERION |
CocoaPods 资源更改。 |
CAMPAIGN |
广告系列资源更改。 |
CAMPAIGN_CRITERION |
Campaigncriteria 资源发生变化。 |
FEED |
Feed 资源发生变化。 |
FEED_ITEM |
FeedItem 资源发生变化。 |
AD_GROUP_FEED |
广告组 Feed 资源更改。 |
CAMPAIGN_FEED |
CampaignFeed 资源发生变化。 |
AD_GROUP_BID_MODIFIER |
广告组 BidModifier 资源更改。 |
SHARED_SET |
SharedSet 资源变更。 |
CAMPAIGN_SHARED_SET |
CampaignSharedSet 资源发生更改。 |
ASSET |
一项资产资源更改。 |
CUSTOMER_ASSET |
CustomerAsset 资源变更。 |
CAMPAIGN_ASSET |
CampaignAsset 资源发生更改。 |
AD_GROUP_ASSET |
广告组素材资源资源更改。 |
COMBINED_AUDIENCE |
一项 CombinedAudience 资源更改。 |
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
表示归客户所有并与客户共享的出价策略的视图。
与 BiddingStrategy 相反,该资源还包含该客户拥有的策略以及归该客户的经理所有并已共享给该客户的策略。该资源不提供指标,仅公开了一部分 BiddingStrategy 属性。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
字段 | |
---|---|
resourceName |
仅限输出。可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称采用以下格式:
|
id |
仅限输出。出价策略的 ID。 |
name |
仅限输出。出价策略的名称。 |
type |
仅限输出。出价策略的类型。 |
ownerCustomerId |
仅限输出。拥有出价策略的客户的 ID。 |
ownerDescriptiveName |
仅限输出。拥有出价策略的客户的描述性名称。 |
联合字段 只能设置一个。 |
|
maximizeConversionValue |
仅限输出。一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。 |
maximizeConversions |
仅限输出。一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。 |
targetCpa |
仅限输出。这种出价策略会设置适当的出价,在将每次转化费用 (CPA) 控制在您设定的目标水平的前提下,帮助您争取尽可能多的转化。 |
targetImpressionShare |
仅限输出。一种出价策略,可自动针对选定百分比的展示次数进行优化。 |
targetRoas |
仅限输出。一种出价策略,可帮助您最大限度地提高收入,同时确保平均达到特定目标广告支出回报率 (ROAS)。 |
targetSpend |
仅限输出。一种出价策略,用于为您设置适当的出价,在不超出预算的前提下为您争取尽可能多的点击。 |
MaximizeConversionValue
一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。
JSON 表示法 |
---|
{ "targetRoas": number } |
字段 | |
---|---|
targetRoas |
仅限输出。目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。 |
MaximizeConversions
一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
字段 | |
---|---|
targetCpaMicros |
仅限输出。目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。 |
TargetCpa
一种自动出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
字段 | |
---|---|
targetCpaMicros |
仅限输出。平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。 |
TargetRoas
一种自动出价策略,可帮助您尽可能提高收入,同时确保平均达到特定目标广告支出回报率 (ROAS)。
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
指定客户与现有客户之间的关联。只有经理客户才能拥有 CustomerClient。包括所有直接和间接客户以及经理本身。
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 |
仅限输出。详细级别的系统推荐的展示位置字符串,例如网站网址、移动应用 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 |
仅限输出。详细受众特征的名称。例如“Highest Level of Educational Attainment” |
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
包含可能的 CriteriaCategoryChannelAvailabilityMode 的枚举。
枚举 | |
---|---|
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
包含可能的 CriteriaCategoryLocaleAvailabilityMode 的枚举。
枚举 | |
---|---|
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 |
仅限输出。语言的英文全称,例如“English (US)”“Spanish”等。 |
targetable |
仅限输出。语言是否可定位。 |
LocationView
地理位置视图按地理位置条件总结广告系列的效果。如果未设置“地理位置”条件,系统将不会返回任何结果;而是会改用 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 |
不可变。一个 ZIP 归档文件,其中包含 HTML5 素材资源。 |
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 网址中看到)。向此 ID 添加前缀“https://www.youtube.com/watch?v=”将获得该视频的 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 |
仅限输出。员工状态,例如“已删除”或“已启用”。 |
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 |
仅限输出。只读字段,包含已上传的保险文档的信息。 |
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 |
仅限输出。包含已上传许可文档信息的只读字段。 |
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
包含本地生活服务工商登记特定信息的 proto。
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 |
仅限输出。成功率。 |
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, // Union field |
字段 | |
---|---|
successfulCount |
仅限输出。成功事件的总数。 |
failedCount |
仅限输出。失败事件的总数。 |
联合字段 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 |
仅限输出。Mutate 错误。 |
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.enhanced_conversions_for_leads_enabled 来检查设置。 |
INVALID_JOB_ID |
请求中提供的职位 ID 不在允许范围内。职位 ID 必须是 [1, 2^31] 范围内的正整数。 |
NO_CONVERSION_ACTION_FOUND |
找不到上传请求中指定的转化操作。请确保该转化操作可在此账号中使用。 |
INVALID_CONVERSION_ACTION_TYPE |
上传请求中指定的转化操作未设置为上传相应转化数据。 |
DateError
描述可能的日期错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
INVALID_FIELD_VALUES_IN_DATE |
指定的字段值与有效日期不符。 |
INVALID_FIELD_VALUES_IN_DATE_TIME |
指定的字段值与有效的日期时间不符。 |
INVALID_STRING_DATE |
该字符串日期格式应为 yyyy-mm-dd。 |
INVALID_STRING_DATE_TIME_MICROS |
该字符串日期时间格式应为 yyyy-mm-dd hh:mm:ss.ssssss。 |
INVALID_STRING_DATE_TIME_SECONDS |
该字符串日期时间格式应为 yyyy-mm-dd hh:mm:ss。 |
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET |
字符串日期时间格式应为 yyyy-mm-dd hh:mm:ss+|-hh:mm。 |
EARLIER_THAN_MINIMUM_DATE |
日期早于允许的最早日期。 |
LATER_THAN_MAXIMUM_DATE |
日期晚于允许的最晚日期。 |
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE |
构成日期范围的下限日期晚于相应的上限日期。 |
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL |
构成日期范围的上限与下限日期都为 Null。 |
DistinctError
描述可能存在的不同错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
DUPLICATE_ELEMENT |
元素重复。 |
DUPLICATE_TYPE |
重复类型。 |
FieldError
描述可能的字段错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
REQUIRED |
必填字段不存在。 |
IMMUTABLE_FIELD |
尝试更改的字段不可变。 |
INVALID_VALUE |
此字段的值无效。 |
VALUE_MUST_BE_UNSET |
无法设置该字段。 |
REQUIRED_NONEMPTY_LIST |
必填的重复字段为空。 |
FIELD_CANNOT_BE_CLEARED |
无法清除此字段。 |
BLOCKED_VALUE |
该字段的值在此字段的拒绝名单中。 |
FIELD_CAN_ONLY_BE_CLEARED |
除非清除,否则无法修改此字段的值。 |
MutateError
描述可能的 mutate 错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
RESOURCE_NOT_FOUND |
找不到所请求的资源。 |
ID_EXISTS_IN_MULTIPLE_MUTATES |
不能在一个请求中对同一资源执行两次更改。 |
INCONSISTENT_FIELD_VALUES |
该字段的内容与表示相同数据的其他字段不匹配。 |
MUTATE_NOT_ALLOWED |
不允许对请求的资源进行 mutate 操作。 |
RESOURCE_NOT_IN_GOOGLE_ADS |
资源不在 Google Ads 中。属于其他广告系统。 |
RESOURCE_ALREADY_EXISTS |
要创建的资源已存在。 |
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY |
该资源不能与“validateOnly”搭配使用。 |
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE |
此操作无法与“partialFailure”一起使用。 |
RESOURCE_READ_ONLY |
尝试写入只读字段。 |
NotAllowlistedError
描述可能的“未列入许可名单”错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE |
客户未列入可使用该功能的许可名单。 |
StringFormatError
描述可能的字符串格式错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
ILLEGAL_CHARS |
输入的字符串值包含不允许使用的字符。 |
INVALID_FORMAT |
对于关联字段,输入的字符串值无效。 |
StringLengthError
描述可能的字符串长度错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
EMPTY |
指定的字段中应至少包含一个非空白字符。 |
TOO_SHORT |
名称过短。 |
TOO_LONG |
名称过长。 |
OperatingSystemVersionConstant
移动操作系统版本或一系列版本,具体取决于 operatorType
。可用的移动平台列表:https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
JSON 表示法 |
---|
{
"resourceName": string,
"operatorType": enum ( |
字段 | |
---|---|
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 |
仅限输出。甄别问题的资源名称。 “qualificationQuestions/{qualifiedQuestionId}” |
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 相当于 google_product_category [Google 商品类别] ID,如 https://support.google.com/merchants/answer/6324436 一文中所述。 |
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 |
仅限输出。购物效果视图的资源名称。购物效果视图资源名称采用以下格式: |
SmartCampaignSearchTermView
智能广告系列搜索字词视图。
JSON 表示法 |
---|
{ "resourceName": string, "searchTerm": string, "campaign": string } |
字段 | |
---|---|
resourceName |
仅限输出。智能广告系列搜索字词视图的资源名称。智能广告系列搜索字词视图资源名称采用以下格式:
|
searchTerm |
仅限输出。搜索字词。 |
campaign |
仅限输出。在其中投放搜索字词的智能广告系列。 |
ThirdPartyAppAnalyticsLink
数据共享连接,允许将第三方应用分析工具导入 Google Ads 客户。
JSON 表示法 |
---|
{ "resourceName": string, "shareableLinkId": string } |
字段 | |
---|---|
resourceName |
不可变。第三方应用分析工具关联的资源名称。第三方应用分析工具关联资源名称的格式如下:
|
shareableLinkId |
仅限输出。在设置应用分析工具时应向第三方提供的共享关联 ID。这可以使用 ThirdPartyAppAnalyticsLinkService 中的 regenerate 方法重新生成。 |
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
包含可能的 UserInterestTaxonomyType 的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
AFFINITY |
此用户兴趣的相似性。 |
IN_MARKET |
此用户兴趣的市场。 |
MOBILE_APP_INSTALL_USER |
已知安装了指定类别的应用的用户。 |
VERTICAL_GEO |
用户兴趣行业所在的地理位置。 |
NEW_SMART_PHONE_USER |
智能手机新用户的用户兴趣条件。 |
LifeEvent
人生大事:一种基于兴趣的特定行业,旨在覆盖面临人生重大事件的用户。
JSON 表示法 |
---|
{
"resourceName": string,
"id": string,
"name": string,
"parent": string,
"launchedToAll": boolean,
"availabilities": [
{
object ( |
字段 | |
---|---|
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 或 SMS 消息的消息对话详情。 |
ConversationType
可能的潜在客户对话类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
EMAIL |
通过电子邮件潜在客户对话。 |
MESSAGE |
消息类潜在客户对话。 |
PHONE_CALL |
来电潜在客户对话。 |
SMS |
短信潜在客户对话。 |
BOOKING |
预订潜在客户对话。 |
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 表示法 |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionsValueByConversionDate": number, "conversionsByConversionDate": number, "historicalCreativeQualityScore": enum ( |
字段 | |
---|---|
allConversionsValueByConversionDate |
所有转化的价值。如果选择了此列和日期,日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
allConversionsByConversionDate |
转化总次数。此指标会纳入所有转化次数,而不考虑 includeInConversionMetric 的值。如果选择了此列和日期,日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
conversionsValueByConversionDate |
转化价值。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价策略,您的出价策略将以促成这些转化为目标进行优化。如果选择了此列和日期,日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
conversionsByConversionDate |
转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价策略,您的出价策略将以促成这些转化为目标进行优化。如果选择了此列和日期,日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
historicalCreativeQualityScore |
广告素材的历史质量得分。 |
historicalLandingPageQualityScore |
历史着陆页体验的质量。 |
historicalSearchPredictedCtr |
历史搜索网络预测点击率 (CTR)。 |
interactionEventTypes[] |
付费和免费互动的类型。 |
skAdNetworkInstalls |
iOS Store Kit 广告网络转化次数。 |
skAdNetworkTotalConversions |
iOS Store Kit 广告网络的总转化次数。 |
publisherPurchasedClicks |
来自并非由发布商所拥有的媒体资源的点击,其流量是由发布商付费或通过奖励活动获得的 |
publisherOrganicClicks |
发布商未因激励活动付费或通过激励活动获得的流量的媒体资源带来的点击 |
publisherUnknownClicks |
来自未被标识为“发布商购买”或“发布商自然”的流量的点击次数 |
absoluteTopImpressionPercentage |
“搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。 |
activeViewCpm |
可见展示的平均费用 ( |
activeViewCtr |
Active View 可衡量点击次数除以 Active View 可见展示次数。 系统仅针对展示广告网络报告此指标。 |
activeViewImpressions |
衡量广告在展示广告网络网站上的可见频率。 |
activeViewMeasurability |
Active View 可衡量的展示次数与投放展示次数之比。 |
activeViewMeasurableCostMicros |
Active View 可衡量的您获得的展示费用。 |
activeViewMeasurableImpressions |
广告出现在可见位置中的展示位置的次数。 |
activeViewViewability |
广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 |
allConversionsFromInteractionsRate |
互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 |
allConversionsValue |
所有转化的值。 |
allNewCustomerLifetimeValue |
所有新客户的生命周期价值。如果您已在账号一级或广告系列一级设置客户获取目标,则对于可出价和不可出价转化,新客户获取的额外转化价值都会包括在内。如果您的广告系列已采用客户获取目标,并选择“针对新客户提高出价”,这些值将包含在“allConversionValue”。请参阅 https://support.google.com/google-ads/answer/12080169 了解详情。 |
allConversions |
转化总次数。此指标会纳入所有转化次数,而不考虑 includeInConversionMetric 的值。 |
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) 除以 mergeQuery 次数。如需了解详情,请参阅帮助页面: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 |
互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversionsValue |
转化价值。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
newCustomerLifetimeValue |
新客户的生命周期价值。如果您已在账号一级或广告系列一级设置客户获取目标,则对于可出价转化,新客户获取的额外转化价值也会包含在内。如果您的广告系列已采用客户获取目标,并选择“针对新客户提高出价”,这些值将会纳入到“conversionsValue”以进行优化。请参阅 https://support.google.com/google-ads/answer/12080169 了解详情。 |
conversionsValuePerCost |
转化价值除以广告互动费用。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversionsFromInteractionsValuePerInteraction |
互动带来的转化价值除以广告互动次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversions |
转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
costMicros |
在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
costPerAllConversions |
广告互动费用除以所有转化次数。 |
costPerConversion |
广告互动费用除以转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
costPerCurrentModelAttributedConversion |
广告互动费用除以当前模型归因转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
crossDeviceConversions |
客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 allConversion 中。 |
crossDeviceConversionsValueMicros |
跨设备转化价值的总和(以微单位表示)。 |
ctr |
广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
currentModelAttributedConversions |
显示历史转化数据在您目前选择的归因模型下的情况。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
currentModelAttributedConversionsFromInteractionsRate |
当前模型根据互动带来的转化次数除以广告互动的次数(例如,对文字广告来说是点击次数,对视频广告来说就是观看)。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
currentModelAttributedConversionsFromInteractionsValuePerInteraction |
当前模型归因转化的价值除以广告互动次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
currentModelAttributedConversionsValue |
当前模型归因转化的价值。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
currentModelAttributedConversionsValuePerCost |
当前模型归因转化的价值除以广告互动的费用。这只包括 includeInConversionMetric 属性设置为 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 |
发起的消息聊天次数 (messageChat) 除以消息展示次数 (messageImpressions)。在启用了消息选项和消息跟踪的情况下,用户在广告展示中发起消息聊天的时间间隔。请注意,对于指定的消息展示,此比率可能会大于 1.0。 |
mobileFriendlyClicksPercentage |
适合移动设备的页面的移动点击次数所占的百分比。 |
optimizationScoreUplift |
所有建议带来的优化得分总提升幅度。 |
optimizationScoreUrl |
Google Ads 网页界面中“优化得分”页面的网址。您可以从 |
organicClicks |
某人针对特定查询点击未付费结果中您的网站的商品详情的次数。如需了解详情,请参阅帮助页面:https://support.google.com/google-ads/answer/3097241。 |
organicClicksPerQuery |
用户在非付费搜索结果中点击您网站的商家信息的次数 (organicClicks) 除以返回了您网站网页的搜索总次数 (organicQuery)。如需了解详情,请参阅帮助页面:https://support.google.com/google-ads/answer/3097241。 |
organicImpressions |
未付费搜索结果中您的网站的商品详情数。如需了解详情,请参阅帮助页面:https://support.google.com/google-ads/answer/3097241。 |
organicImpressionsPerQuery |
您网站中的网页在非付费搜索结果中列出的次数 (organicImpression) 除以在非付费搜索结果中返回网站列表的搜索次数 (organicQuery)。如需了解详情,请参阅帮助页面:https://support.google.com/google-ads/answer/3097241。 |
organicQueries |
在未付费结果中返回您的网站的商品详情的总搜索次数。如需了解详情,请参阅帮助页面:https://support.google.com/google-ads/answer/3097241。 |
percentNewVisitors |
首次会话数(来自之前从未访问过您的网站的用户)所占的百分比。自 Google Analytics(分析)导入。 |
phoneCalls |
离线通话次数。 |
phoneImpressions |
离线电话号码展示次数。 |
phoneThroughRate |
接到的来电次数(通话次数)除以电话号码的展示次数 (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 |
转化价值除以转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
valuePerConversionsByConversionDate |
转化价值除以转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价策略,您的出价策略将以促成这些转化为目标进行优化。如果选择了此列和日期,日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
valuePerCurrentModelAttributedConversion |
当前模型归因转化的价值除以转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
videoQuartileP100Rate |
观看者观看了您的所有视频时使用的展示次数所占百分比。 |
videoQuartileP25Rate |
观看者观看了 25% 的视频时使用的展示次数所占百分比。 |
videoQuartileP50Rate |
观看者观看了 50% 的视频时使用的展示次数所占百分比。 |
videoQuartileP75Rate |
观看者观看了 75% 的视频时使用的展示次数所占百分比。 |
videoViewRate |
TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 |
videoViews |
视频广告的观看次数。 |
viewThroughConversions |
浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
allConversionsFromLocationAssetClickToCall |
付费广告事件(点击或展示)发生后,营业地点表面的“致电”按钮获得的点击次数。此衡量依据的是基于素材资源的地理位置。 |
allConversionsFromLocationAssetDirections |
发生收费广告事件(点击或展示)后,任意位置表面上的行车路线点击次数。此衡量依据的是基于素材资源的地理位置。 |
allConversionsFromLocationAssetMenu |
付费广告事件(点击或展示)发生后,营业地点表面上获得的菜单链接点击次数。此衡量依据的是基于素材资源的地理位置。 |
allConversionsFromLocationAssetOrder |
发生付费广告事件(点击或展示)后,任意位置表面上的订单点击次数。此衡量依据的是基于素材资源的地理位置。 |
allConversionsFromLocationAssetOtherEngagement |
付费广告事件(点击或展示)发生后,任意营业地点平台上其他类型的本地操作获得的点击次数。此衡量依据的是基于素材资源的地理位置。 |
allConversionsFromLocationAssetStoreVisits |
付费广告事件(点击或展示)发生后的实体店光顾次数估算值。此衡量依据的是基于素材资源的地理位置。 |
allConversionsFromLocationAssetWebsite |
发生收费广告事件(点击或展示)后,任意位置呈现的网站网址点击次数。此衡量依据的是基于素材资源的地理位置。 |
eligibleImpressionsFromLocationAssetStoreReach |
展示实体店营业地点或使用该地理位置进行定位的展示次数。此衡量依据的是基于素材资源的地理位置。 |
viewThroughConversionsFromLocationAssetClickToCall |
广告展示后,营业地点平台上的“致电”按钮获得的点击次数。此衡量依据的是基于素材资源的地理位置。 |
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 天的数据。该指标适用于以下广告系列类型:展示广告系列、视频广告系列、发现广告系列和应用广告系列。 |
InteractionEventType
描述可能的应付和免费互动类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
CLICK |
点击访问网站。在大多数情况下,这种互动会导航至外部位置,通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。 |
ENGAGEMENT |
用户表达的意向就地与广告互动。 |
VIDEO_VIEW |
用户观看了一则视频广告。 |
NONE |
广告转化事件的默认 InteractionEventType。如果广告转化行没有指明免费互动(例如广告转化)应“推广”并作为核心指标的一部分进行报告,则使用此方法。这些只是其他(广告)转化。 |
SearchVolumeRange
搜索量范围。实际搜索量在此范围内。
JSON 表示法 |
---|
{ "min": string, "max": string } |
字段 | |
---|---|
min |
搜索量的下限。 |
max |
搜索量上限。 |
路段
仅限细分的字段。
JSON 表示法 |
---|
{ "adDestinationType": enum ( |
字段 | |
---|---|
adDestinationType |
广告目标页面类型。 |
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 |
相应的旅行活动适用的州/省/自治区/直辖市。 |
externalActivityId |
广告客户提供的活动 ID。 |
adGroup |
广告组的资源名称。 |
assetGroup |
素材资源组的资源名称。 |
auctionInsightDomain |
竞价分析报告中参与者的域名(可见网址)。 |
campaign |
广告系列的资源名称。 |
conversionAction |
转化操作的资源名称。 |
conversionActionName |
转化操作名称。 |
conversionAdjustment |
这会按原始转化次数和转化价值与增量(如果转化经过调整)对转化列进行细分。False 行包含最初陈述的数据;而 true 行包含当前数据与最初所述数据之间的增量。将两者相加的结果调整后数据。 |
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-04-01 开始。格式为 yyyy-MM-dd。 |
searchSubcategory |
搜索字词子类别。空字符串表示不能归入其他子类别的搜索字词的无限别名子类别。 |
searchTerm |
搜索字词。 |
webpage |
表示网页条件的广告组条件的资源名称。 |
week |
定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 |
year |
年份,格式为 yyyy。 |
skAdNetworkConversionValue |
iOS Store Kit 广告网络转化价值。null 值表示此细分不适用,例如,非 iOS 广告系列。 |
skAdNetworkSourceApp |
促成 iOS Store Kit Ad Network 安装的广告所在的应用。null 值表示此细分不适用(例如非 iOS 广告系列),或不存在于 Apple 发送的任何回传中。 |
skAdNetworkSourceDomain |
促成 iOS Store Kit Ad Network 安装的广告所在的网站。null 值表示此细分不适用(例如非 iOS 广告系列),或不存在于 Apple 发送的任何回传中。 |
skAdNetworkPostbackSequenceIndex |
iOS Store Kit 广告网络回传序列索引。 |
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 商店 |
PHONE_CALL |
呼叫拨号器 |
MAP_DIRECTIONS |
地图应用 |
LOCATION_LISTING |
位置专用页面 |
MESSAGE |
短信 |
LEAD_FORM |
潜在客户发掘表单 |
YOUTUBE |
YouTube |
UNMODELED_FOR_CONVERSIONS |
键未知的转化的广告目标页面 |
AdNetworkType
枚举 Google Ads 广告网络类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
在此版本中,此值未知。 |
SEARCH |
Google 搜索。 |
SEARCH_PARTNERS |
搜索网络合作伙伴。 |
CONTENT |
展示广告网络。 |
MIXED |
跨广告网络。 |
YOUTUBE |
YouTube |
GOOGLE_TV |
Google TV |
BudgetCampaignAssociationStatus
PriceCampaignAssociationStatus 细分。
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 |
跨广告网络。来自效果最大化广告系列和发现广告系列。 |
ConversionAttributionEventType
归因到的转化类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
表示此版本中的未知值。 |
IMPRESSION |
转化归因于某次展示。 |
INTERACTION |
转化归因于某次互动。 |
ConversionLagBucket
表示从展示到转化所经过的天数的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
LESS_THAN_ONE_DAY |
转化延迟时间范围为 0 到 1 天。包含 0 天,不包含 1 天。 |
ONE_TO_TWO_DAYS |
转化延迟时间范围为 1 天到 2 天。包含 1 天,不包括 2 天。 |
TWO_TO_THREE_DAYS |
转化延迟时间范围为 2 天到 3 天。包含 2 天,不包含 3 天。 |
THREE_TO_FOUR_DAYS |
转化延迟时间范围为 3 天到 4 天。包括 3 天,不包括 4 天。 |
FOUR_TO_FIVE_DAYS |
转化延迟时间范围为 4 天到 5 天。包含 4 天,不包含 5 天。 |
FIVE_TO_SIX_DAYS |
转化延迟时间范围为 5 天到 6 天。包括 5 天,不包括 6 天。 |
SIX_TO_SEVEN_DAYS |
转化延迟时间范围为 6 天到 7 天。包括 6 天,不包括 7 天。 |
SEVEN_TO_EIGHT_DAYS |
转化延迟时间范围为 7 天至 8 天。包括 7 天,不包括 8 天。 |
EIGHT_TO_NINE_DAYS |
转化延迟时间范围为 8 天到 9 天。包含 8 天,不包含 9 天。 |
NINE_TO_TEN_DAYS |
转化延迟时间范围为 9 天到 10 天。包括 9 天,不包括 10 天。 |
TEN_TO_ELEVEN_DAYS |
转化延迟时间范围从 10 天到 11 天。包括 10 天,不包括 11 天。 |
ELEVEN_TO_TWELVE_DAYS |
转化延迟时间范围从 11 天到 12 天。包括 11 天,不包括 12 天。 |
TWELVE_TO_THIRTEEN_DAYS |
转化延迟时间范围从 12 天到 13 天。包括 12 天,不包括 13 天。 |
THIRTEEN_TO_FOURTEEN_DAYS |
转化延迟时间范围为 13 天至 14 天。包括 13 天,不包括 14 天。 |
FOURTEEN_TO_TWENTY_ONE_DAYS |
转化延迟时间范围从 14 天到 21 天。包括 14 天,不包括 21 天。 |
TWENTY_ONE_TO_THIRTY_DAYS |
转化延迟时间范围为 21 天到 30 天。包括 21 天,不包括 30 天。 |
THIRTY_TO_FORTY_FIVE_DAYS |
转化延迟时间范围为 30 天至 45 天。包括 30 天,不包括 45 天。 |
FORTY_FIVE_TO_SIXTY_DAYS |
转化延迟时间范围为 45 天至 60 天。包括 45 天,不包括 60 天。 |
SIXTY_TO_NINETY_DAYS |
转化延迟时间范围为 60 天到 90 天。包括 60 天,不包括 90 天。 |
ConversionOrAdjustmentLagBucket
表示展示和转化之间或者展示和转化调整之间相隔的天数。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
CONVERSION_LESS_THAN_ONE_DAY |
转化延迟时间范围为 0 到 1 天。包含 0 天,不包含 1 天。 |
CONVERSION_ONE_TO_TWO_DAYS |
转化延迟时间范围为 1 天到 2 天。包含 1 天,不包括 2 天。 |
CONVERSION_TWO_TO_THREE_DAYS |
转化延迟时间范围为 2 天到 3 天。包含 2 天,不包含 3 天。 |
CONVERSION_THREE_TO_FOUR_DAYS |
转化延迟时间范围为 3 天到 4 天。包括 3 天,不包括 4 天。 |
CONVERSION_FOUR_TO_FIVE_DAYS |
转化延迟时间范围为 4 天到 5 天。包含 4 天,不包含 5 天。 |
CONVERSION_FIVE_TO_SIX_DAYS |
转化延迟时间范围为 5 天到 6 天。包括 5 天,不包括 6 天。 |
CONVERSION_SIX_TO_SEVEN_DAYS |
转化延迟时间范围为 6 天到 7 天。包括 6 天,不包括 7 天。 |
CONVERSION_SEVEN_TO_EIGHT_DAYS |
转化延迟时间范围为 7 天至 8 天。包括 7 天,不包括 8 天。 |
CONVERSION_EIGHT_TO_NINE_DAYS |
转化延迟时间范围为 8 天到 9 天。包含 8 天,不包含 9 天。 |
CONVERSION_NINE_TO_TEN_DAYS |
转化延迟时间范围为 9 天到 10 天。包括 9 天,不包括 10 天。 |
CONVERSION_TEN_TO_ELEVEN_DAYS |
转化延迟时间范围从 10 天到 11 天。包括 10 天,不包括 11 天。 |
CONVERSION_ELEVEN_TO_TWELVE_DAYS |
转化延迟时间范围从 11 天到 12 天。包括 11 天,不包括 12 天。 |
CONVERSION_TWELVE_TO_THIRTEEN_DAYS |
转化延迟时间范围从 12 天到 13 天。包括 12 天,不包括 13 天。 |
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS |
转化延迟时间范围为 13 天至 14 天。包括 13 天,不包括 14 天。 |
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS |
转化延迟时间范围从 14 天到 21 天。包括 14 天,不包括 21 天。 |
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS |
转化延迟时间范围为 21 天到 30 天。包括 21 天,不包括 30 天。 |
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS |
转化延迟时间范围为 30 天至 45 天。包括 30 天,不包括 45 天。 |
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS |
转化延迟时间范围为 45 天至 60 天。包括 45 天,不包括 60 天。 |
CONVERSION_SIXTY_TO_NINETY_DAYS |
转化延迟时间范围为 60 天到 90 天。包括 60 天,不包括 90 天。 |
ADJUSTMENT_LESS_THAN_ONE_DAY |
转化调整延迟时间范围为 0 到 1 天。包含 0 天,不包含 1 天。 |
ADJUSTMENT_ONE_TO_TWO_DAYS |
转化调整延迟时间范围为 1 天到 2 天。包含 1 天,不包括 2 天。 |
ADJUSTMENT_TWO_TO_THREE_DAYS |
转化调整延迟时间范围为 2 天到 3 天。包含 2 天,不包含 3 天。 |
ADJUSTMENT_THREE_TO_FOUR_DAYS |
转化调整延迟时间范围为 3 天到 4 天。包括 3 天,不包括 4 天。 |
ADJUSTMENT_FOUR_TO_FIVE_DAYS |
转化调整延迟时间范围为 4 天到 5 天。包含 4 天,不包含 5 天。 |
ADJUSTMENT_FIVE_TO_SIX_DAYS |
转化调整延迟时间范围为 5 天到 6 天。包括 5 天,不包括 6 天。 |
ADJUSTMENT_SIX_TO_SEVEN_DAYS |
转化调整延迟时间范围为 6 天到 7 天。包括 6 天,不包括 7 天。 |
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS |
转化调整延迟时间范围为 7 天到 8 天。包括 7 天,不包括 8 天。 |
ADJUSTMENT_EIGHT_TO_NINE_DAYS |
转化调整延迟时间范围为 8 天到 9 天。包含 8 天,不包含 9 天。 |
ADJUSTMENT_NINE_TO_TEN_DAYS |
转化调整延迟时间范围为 9 天到 10 天。包括 9 天,不包括 10 天。 |
ADJUSTMENT_TEN_TO_ELEVEN_DAYS |
转化调整延迟时间范围为 10 天到 11 天。包括 10 天,不包括 11 天。 |
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS |
转化调整延迟时间范围为 11 天到 12 天。包括 11 天,不包括 12 天。 |
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS |
转化调整延迟时间范围为 12 天到 13 天。包括 12 天,不包括 13 天。 |
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS |
转化调整延迟时间范围为 13 天到 14 天。包括 13 天,不包括 14 天。 |
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS |
转化调整延迟时间范围为 14 天到 21 天。包括 14 天,不包括 21 天。 |
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS |
转化调整延迟时间范围为 21 天到 30 天。包括 21 天,不包括 30 天。 |
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS |
转化调整延迟时间范围为 30 天到 45 天。包括 30 天,不包括 45 天。 |
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS |
转化调整延迟时间范围为 45 天到 60 天。包括 45 天,不包括 60 天。 |
ADJUSTMENT_SIXTY_TO_NINETY_DAYS |
转化调整延迟时间范围为 60 天到 90 天。包括 60 天,不包括 90 天。 |
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS |
转化调整延迟时间范围为 90 天到 145 天。包括 90 天,不包括 145 天。 |
CONVERSION_UNKNOWN |
转化延迟时间范围未知。这是指 Google Ads 提供转化延迟时间范围之前的日期。 |
ADJUSTMENT_UNKNOWN |
转化调整延迟时间范围未知。这是指 Google Ads 提供转化调整延迟时间范围之前的日期。 |
ExternalConversionSource
与 ConversionAction 相关联的外部转化来源。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
表示此版本中的未知值。 |
WEBPAGE |
用户在观看广告后转到特定网页时发生的转化;在 Google Ads 界面中显示为“网站”。 |
ANALYTICS |
来自关联的 Google Analytics(分析)目标或交易的转化;在 Google Ads 界面中显示为“Google Analytics(分析”)。 |
UPLOAD |
通过 ConversionUploadService 上传的网站转化;在 Google Ads 界面中显示为“导入点击后发生的转化”。 |
AD_CALL_METRICS |
用户直接点击广告中的附加电话信息发生的转化;在 Google Ads 界面中显示为“直接从广告中拨打的来电”。 |
WEBSITE_CALL_METRICS |
用户在点击广告后从广告客户的网站上拨打动态生成的电话号码(通过安装的 JavaScript)即发生的转化;在 Google Ads 界面中显示为“从网站致电”。 |
STORE_VISITS |
用户点击 Google 广告后造访广告客户的零售店,即视为转化;在 Google Ads 界面中显示为“实体店光顾”。 |
ANDROID_IN_APP |
当用户执行应用内操作(如在 Android 应用中购买)时发生的转化;在 Google Ads 界面中显示为“Android 应用内操作”。 |
IOS_IN_APP |
当用户执行应用内操作(例如在 iOS 应用中购买)时发生的转化;在 Google Ads 界面中显示为“iOS 应用内操作”。 |
IOS_FIRST_OPEN |
用户首次打开 iOS 应用时发生的转化;在 Google Ads 界面中显示为“iOS 应用安装(首次打开)”。 |
APP_UNSPECIFIED |
未提供 AppPlatform 的旧版应用转化;在 Google Ads 界面中显示为“移动应用”。 |
ANDROID_FIRST_OPEN |
用户首次打开 Android 应用时发生的转化;在 Google Ads 界面中显示为“Android 应用安装(首次打开)”。 |
UPLOAD_CALLS |
通过 ConversionUploadService 上传的致电转化;在 Google Ads 界面中显示为“导入致电后发生的转化”。 |
FIREBASE |
由关联的 Firebase 事件促成的转化;在 Google Ads 界面中显示为“Firebase”。 |
CLICK_TO_CALL |
用户点击手机号码时发生的转化;在 Google Ads 界面中显示为“电话号码点击”事件。 |
SALESFORCE |
来自 Salesforce 的转化;在 Google Ads 界面中显示为“Salesforce.com”。 |
STORE_SALES_CRM |
由 CRM 记录的实体店购买带来的转化;在 Google Ads 界面中显示为“实体店销售(数据合作伙伴)”。 |
STORE_SALES_PAYMENT_NETWORK |
源自付款网络的实体店内购买的转化;在 Google Ads 界面中显示为“实体店销售(付款网络)”。 |
GOOGLE_PLAY |
无代码 Google Play 转化;在 Google Ads 界面中显示为“Google Play”。 |
THIRD_PARTY_APP_ANALYTICS |
由关联的第三方应用分析事件促成的转化;在 Google Ads 界面中显示为“第三方应用分析工具”。 |
GOOGLE_ATTRIBUTION |
由 Google 归因工具控制的转化。 |
STORE_SALES_DIRECT_UPLOAD |
基于第一方或第三方商家数据上传的实体店销售转化。在 Google Ads 界面中显示为“实体店销售(直接上传)”。 |
STORE_SALES |
基于第一方或第三方商家数据上传的实体店销售转化以及/或者使用付款网络的卡片进行的实体店购买。在 Google Ads 界面中显示为“实体店销售”。 |
SEARCH_ADS_360 |
从 Search Ads 360 Floodlight 数据导入的转化数据。 |
GOOGLE_HOSTED |
用于跟踪用户与广告互动后用户在 Google 产品和服务中完成本地操作的转化。 |
FLOODLIGHT |
Floodlight 代码报告的转化。 |
ANALYTICS_SEARCH_ADS_360 |
由 Google Analytics(分析)专门针对 Search Ads 360 带来的转化。在 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 |
完成转化的用户是广告客户的新客户,具有很高的生命周期价值。 |