- 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 ( |
字段 | |
---|---|
account |
查询中的账号预算。 |
account |
查询中引用的账号预算提案。 |
account |
查询中引用的 AccountLink。 |
ad |
查询中引用的广告组。 |
ad |
查询中引用的广告。 |
ad |
查询中的广告组广告素材资源组合视图。 |
ad |
查询中的广告组广告素材资源视图。 |
ad |
查询中引用的广告组广告标签。 |
ad |
查询中引用的广告组素材资源。 |
ad |
查询中引用的广告组素材资源集。 |
ad |
查询中引用的广告组受众群体视图。 |
ad |
查询中引用的出价调节系数。 |
ad |
查询中引用的条件。 |
ad |
查询中引用的广告组条件定制参数。 |
ad |
查询中引用的广告组条件标签。 |
ad |
查询中引用的广告组条件模拟。 |
ad |
查询中引用的广告组定制参数。 |
ad |
查询中引用的广告组附加信息设置。 |
ad |
查询中引用的广告组 Feed。 |
ad |
查询中引用的广告组标签。 |
ad |
查询中引用的广告组模拟。 |
ad |
查询中引用的广告参数。 |
age |
查询中引用的年龄段视图。 |
ad |
查询中引用的广告投放时间表视图。 |
domain |
查询中引用的网域类别。 |
asset |
查询中引用的资产。 |
asset |
查询中引用的素材资源字段类型视图。 |
asset |
查询中引用的素材资源组素材资源。 |
asset |
查询中引用的素材资源组信号。 |
asset |
查询中引用的素材资源组产品信息组过滤条件。 |
asset |
查询中引用的素材资源组产品组视图。 |
asset |
查询中引用的素材资源组“效果最佳的组合”视图。 |
asset |
查询中引用的素材资源组。 |
asset |
查询中引用的素材资源组素材资源。 |
asset |
查询中引用的素材资源集。 |
asset |
查询中引用的资产集类型视图。 |
batch |
查询中引用的批处理作业。 |
bidding |
查询中引用的出价数据排除对象。 |
bidding |
查询中引用的出价季节性调整。 |
bidding |
查询中引用的出价策略。 |
bidding |
查询中引用的出价策略模拟。 |
billing |
查询中引用的结算设置。 |
call |
查询中引用的调用视图。 |
campaign |
查询中引用的广告系列预算。 |
campaign |
查询中引用的广告系列。 |
campaign |
查询中引用的广告系列素材资源。 |
campaign |
查询中引用的广告系列素材资源组。 |
campaign |
查询中引用的广告系列受众群体视图。 |
campaign |
查询中引用的广告系列出价调节系数。 |
campaign |
查询中引用的 CampaignConversionGoal。 |
campaign |
查询中引用的广告系列定位条件。 |
campaign |
查询中引用的广告系列自定义参数。 |
campaign |
查询中引用的广告系列草稿。 |
campaign |
查询中引用的广告系列附加信息设置。 |
campaign |
查询中引用的广告系列 Feed。 |
campaign |
AWQL 查询中引用的广告系列组。 |
campaign |
查询中引用的广告系列标签。 |
campaign |
查询中引用的广告系列生命周期目标。 |
campaign |
查询中引用的广告系列搜索字词数据洞见。 |
campaign |
AWQL 查询中引用的广告系列共享集。 |
campaign |
查询中引用的广告系列模拟。 |
carrier |
查询中引用的运营商常量。 |
change |
查询中引用的 ChangeEvent。 |
change |
查询中引用的 ChangeStatus。 |
combined |
查询中引用的 CombinedAudience。 |
audience |
查询中引用的受众群体。 |
conversion |
查询中引用的转化操作。 |
conversion |
查询中引用的转化自定义变量。 |
conversion |
查询中引用的 ConversionGoalCampaignConfig。 |
conversion |
查询中引用的转化价值规则。 |
conversion |
查询中引用的转化价值规则集。 |
click |
查询中引用的 ClickView。 |
currency |
查询中引用的货币常量。 |
custom |
查询中引用的 CustomAudience。 |
custom |
查询中引用的 CustomConversionGoal。 |
custom |
查询中引用的自定义兴趣。 |
customer |
查询中引用的客户。 |
customer |
查询中引用的客户素材资源。 |
customer |
查询中引用的客户素材资源集。 |
accessible |
查询中引用的可用出价策略。 |
customer |
查询中引用的客户自定义参数。 |
customer |
查询中引用的 CustomerManagerLink。 |
customer |
查询中引用的 CustomerClientLink。 |
customer |
查询中引用的 CustomerClient。 |
customer |
查询中引用的 CustomerConversionGoal。 |
customer |
查询中引用的客户扩展设置。 |
customer |
查询中引用的客户 Feed。 |
customer |
查询中引用的客户标签。 |
customer |
查询中引用的客户生命周期目标。 |
customer |
查询中引用的客户排除条件。 |
customer |
查询中引用的客户搜索字词数据分析。 |
customer |
查询中引用的 CustomerUserAccess。 |
customer |
查询中引用的 CustomerUserAccessInvitation。 |
customizer |
查询中引用的定制参数属性。 |
detail |
查询中引用的详细展示位置视图。 |
detailed |
查询中引用的详细受众特征。 |
display |
查询中引用的展示广告关键字视图。 |
distance |
查询中引用的距离视图。 |
dynamic |
查询中引用的动态搜索广告搜索字词视图。 |
expanded |
查询中引用的展开后的着陆页视图。 |
extension |
查询中引用的附加信息 Feed 项。 |
feed |
查询中引用的 Feed。 |
feed |
查询中引用的 Feed 项。 |
feed |
查询中引用的 Feed 项集。 |
feed |
查询中引用的 Feed 项集链接。 |
feed |
查询中引用的 Feed 项目标。 |
feed |
查询中引用的 Feed 映射。 |
feed |
查询中引用的 Feed 占位符视图。 |
gender |
查询中引用的性别视图。 |
geo |
查询中引用的地理位置定位目标常量。 |
geographic |
查询中引用的地理视图。 |
group |
查询中引用的组展示位置视图。 |
hotel |
查询中引用的酒店组视图。 |
hotel |
查询中引用的酒店效果视图。 |
hotel |
查询中引用的酒店对账。 |
income |
查询中引用的收入范围视图。 |
keyword |
查询中引用的关键字视图。 |
keyword |
查询中引用的关键字方案。 |
keyword |
查询中引用的关键字方案广告系列。 |
keyword |
查询中引用的关键字方案广告系列关键字。 |
keyword |
查询中引用的关键字方案广告组。 |
keyword |
查询中引用的关键字方案广告组。 |
keyword |
查询中引用的关键字主题常量。 |
label |
查询中引用的标签。 |
landing |
查询中引用的着陆页视图。 |
language |
查询中引用的语言常量。 |
location |
查询中引用的位置视图。 |
managed |
查询中引用的自选展示位置视图。 |
media |
查询中引用的媒体文件。 |
local |
查询中引用的本地生活服务员工。 |
local |
查询中引用的本地生活服务验证工件。 |
mobile |
查询中引用的移动应用类别常量。 |
mobile |
查询中引用的移动设备常量。 |
offline |
客户级别的线下转化数据上传摘要。 |
offline |
查询中引用的离线用户数据作业。 |
operating |
查询中引用的操作系统版本常量。 |
paid |
查询中引用的付费自然搜索字词视图。 |
qualifying |
查询中引用的甄别问题。 |
parental |
查询中引用的育儿状况视图。 |
per |
查询中引用的按商店划分的视图。 |
product |
查询中引用的商品类别。 |
product |
查询中引用的产品组视图。 |
product |
查询中引用的商品链接。 |
product |
询问中的产品关联邀请。 |
recommendation |
查询中引用的建议。 |
recommendation |
查询中引用的推荐订阅。 |
search |
查询中引用的搜索字词视图。 |
shared |
查询中引用的共享集。 |
shared |
查询中引用的共享集。 |
smart |
查询中引用的智能广告系列设置。 |
shopping |
查询中引用的购物广告效果视图。 |
smart |
查询中引用的智能广告系列搜索字词视图。 |
third |
查询中引用的 AccountLink。 |
topic |
查询中引用的主题视图。 |
travel |
查询中引用的旅行活动组视图。 |
travel |
查询中引用的旅行活动效果视图。 |
experiment |
查询中引用的实验。 |
experiment |
查询中引用的实验组。 |
user |
查询中提及的用户兴趣。 |
life |
查询中引用的人生大事。 |
user |
查询中引用的用户列表。 |
user |
查询中引用的用户位置视图。 |
remarketing |
查询中引用的再营销操作。 |
topic |
查询中引用的主题常量。 |
video |
查询中引用的视频。 |
webpage |
查询中引用的网页视图。 |
lead |
查询中提及的潜在客户表单用户提交内容。 |
local |
查询中引用的本地生活服务潜在客户。 |
local |
查询中提及的本地生活服务潜在客户对话。 |
android |
查询中引用的 Android 隐私权共享键 Google 广告组。 |
android |
查询中引用的 Android 隐私权共享键 Google 广告系列。 |
android |
查询中引用的 Android 隐私权共享密钥 Google 网络类型。 |
metrics |
指标。 |
segments |
细分。 |
AccountBudget
账号级预算。其中包含有关预算本身的信息,以及最近批准的预算更改和待审批的预算更改建议。您可以在“pendingProposal”中找到待审批的建议更改(如果有)。有关预算的有效详细信息位于前缀为“approved_”“adjusted_”和不带前缀的字段中。由于某些有效详细信息可能会与用户最初请求的信息不同(例如支出限额),因此这些差异会通过“proposed_”“approved_”和可能的“adjusted_”字段并排显示。
此资源是使用 AccountBudgetProposal 进行更改的,无法直接更改。在任何给定时间,预算最多只能有一个待处理的提案。通过 pendingProposal 读取。
预算获得批准后,可能会发生调整,例如赠送金额调整。调整会导致“已批准”字段和“已调整”字段之间出现差异,否则这两个字段将完全相同。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resource |
仅限输出。账号级预算的资源名称。AccountBudget 资源名称的格式为:
|
status |
仅限输出。此账号级预算的状态。 |
total |
仅限输出。调整项总金额。 调整项的示例包括礼节性赠送金额。 |
amount |
仅限输出。已投放的广告的价值,以微秒为单位。 这包括超额投放费用,在这种情况下,系统可能会自动向预算返还相应金额(请参阅 totalAdjustmentsMicros)。 |
pending |
仅限输出。修改此预算的待处理提案(如果适用)。 |
id |
仅限输出。账号级预算的 ID。 |
billing |
仅限输出。与此账号级预算关联的结算设置的资源名称。BillingSetup 资源名称的格式为:
|
name |
仅限输出。账号级预算的名称。 |
proposed |
仅限输出。账号级预算的建议开始时间,格式为 yyyy-MM-dd HH:mm:ss。如果提议的开始时间类型为“NOW”,则此字段为请求时间。 |
approved |
仅限输出。账号级预算的已获批准的开始时间,格式为 yyyy-MM-dd HH:mm:ss。 例如,如果新预算在建议的开始时间之后获得批准,则批准的开始时间为批准时间。 |
purchase |
仅限输出。采购订单编号是一个值,可帮助用户在月度账单中引用此预算。 |
notes |
仅限输出。与预算相关联的备注。 |
联合字段 proposed_end_time 。账号级预算的建议结束时间。proposed_end_time 只能是下列其中一项: |
|
proposed |
仅限输出。建议的结束时间,格式为 yyyy-MM-dd HH:mm:ss。 |
proposed |
仅限输出。建议的结束时间(采用明确定义的类型,例如 FOREVER)。 |
联合字段 例如,如果预算的结束时间已更新,并且提案在提议的结束时间之后获得批准,则批准的结束时间为批准时间。 |
|
approved |
仅限输出。已获批准的结束时间,采用 yyyy-MM-dd HH:mm:ss 格式。 |
approved |
仅限输出。已获批准的结束时间,采用明确定义的类型,例如 FOREVER。 |
联合字段 proposed_spending_limit 。建议的支出限额。proposed_spending_limit 只能是下列其中一项: |
|
proposed |
仅限输出。建议的支出限额(以微单位表示)。一百万个微单位为一个单位。 |
proposed |
仅限输出。以明确定义的类型(例如 INFINITE)提供建议的支出限额。 |
联合字段 例如,如果账号在方案获得批准时已支出的金额超过了拟议的支出限额,则批准的支出限额会设为已支出的金额。 |
|
approved |
仅限输出。已获批准的支出限额(以微单位表示)。一百万等同于一个单位。只有在建议的支出限额是有限的值时,系统才会填充此值,并且此值始终大于或等于建议的支出限额。 |
approved |
仅限输出。已获批准的支出限额,采用明确定义的类型,例如 INFINITE。只有在获批的支出限额为“无限”时,系统才会填充此字段。 |
联合字段 此值对账号的支出金额具有最终决定权。 |
|
adjusted |
仅限输出。调整后的支出限额(以微为单位)。一百万个微单位为一个单位。 如果已获批的支出限额是有限的,则调整后的支出限额可能会因应用于此预算的调整类型(如果适用)而异。 如需了解不同类型的调整,请参阅以下网址:https://support.google.com/google-ads/answer/1704323 例如,借记调整会减少账号的支出限额。 |
adjusted |
仅限输出。调整后的支出限额,应为定义明确的类型,例如 INFINITE。只有当调整后的支出上限为 INFINITE 时,系统才会填充此字段。如果获批的支出上限为 INFINITE,则此字段一定为 true。 |
AccountBudgetStatus
AccountBudget 的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
PENDING |
账号预算正在等待批准。 |
APPROVED |
账号预算已获批准。 |
CANCELLED |
用户已取消账号预算。 |
PendingAccountBudgetProposal
与封闭的账号级预算相关联的待处理提案(如果适用)。
JSON 表示法 |
---|
{ "proposalType": enum ( |
字段 | |
---|---|
proposal |
仅限输出。此提案的类型,例如 END,表示结束与此提案关联的预算。 |
account |
仅限输出。提案的资源名称。AccountBudgetProposal 资源名称的格式为:
|
name |
仅限输出。要为账号级预算分配的名称。 |
start |
仅限输出。开始时间,采用 yyyy-MM-dd HH:mm:ss 格式。 |
purchase |
仅限输出。采购订单编号是一个值,可帮助用户在月度账单中引用此预算。 |
notes |
仅限输出。与此预算关联的备注。 |
creation |
仅限输出。此账号级预算提案的创建时间。格式为 yyyy-MM-dd HH:mm:ss。 |
联合字段 end_time 。账号级预算的结束时间。end_time 只能是下列其中一项: |
|
end |
仅限输出。结束时间(采用 yyyy-MM-dd HH:mm:ss 格式)。 |
end |
仅限输出。结束时间(采用明确定义的类型,例如 FOREVER)。 |
联合字段 spending_limit 。支出限额。spending_limit 只能是下列其中一项: |
|
spending |
仅限输出。支出限额(以微单位表示)。一百万个微单位为一个单位。 |
spending |
仅限输出。支出限额作为明确定义的类型,例如 INFINITE。 |
AdGroupAdAssetCombinationView
广告组广告素材资源组合的使用情况。目前,我们仅支持针对自适应搜索广告使用 AdGroupAdAssetCombinationView,但计划在未来支持更多广告类型。
JSON 表示法 |
---|
{
"resourceName": string,
"servedAssets": [
{
object ( |
字段 | |
---|---|
resource |
仅限输出。广告组广告素材资源组合视图的资源名称。组合 ID 的长度为 128 位,其中高 64 位存储在 asset_combination_id_high 中,低 64 位存储在 asset_combination_id_low 中。AdGroupAd 素材资源组合视图资源名称采用以下格式: |
served |
仅限输出。投放的素材资源。 |
enabled |
仅限输出。素材资源组合与最新版广告之间的状态。如果为 true,则素材资源组合会与最新版本的广告相关联。如果为 false,则表示该链接曾经存在,但已被移除,并且在最新版本的广告中不再显示。 |
AssetUsage
包含资源的使用信息。
JSON 表示法 |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
字段 | |
---|---|
asset |
资产的资源名称。 |
served |
素材资源的投放字段类型。 |
AdGroupAdAssetView
将 AdGroupAd 与素材资源相关联。目前,我们仅支持针对应用广告和自适应搜索广告使用 AdGroupAdAssetView。
JSON 表示法 |
---|
{ "resourceName": string, "fieldType": enum ( |
字段 | |
---|---|
resource |
仅限输出。广告组广告素材资源视图的资源名称。广告组广告素材资源视图资源名称的格式如下(在 v4 之前):
广告组广告素材资源视图资源名称的格式如下(从 v4 开始):
|
field |
仅限输出。素材资源在广告中的角色。 |
policy |
仅限输出。广告组广告素材资源的政策信息。 |
performance |
仅限输出。素材资源关联的效果。 |
pinned |
仅限输出。固定字段。 |
source |
仅限输出。广告组广告素材资源的来源。 |
ad |
仅限输出。素材资源关联到的广告组广告。 |
asset |
仅限输出。与广告组广告相关联的素材资源。 |
enabled |
仅限输出。素材资源与最新版广告之间的状态。如果为 true,则表示素材资源与最新版本的广告相关联。如果为 false,则表示该链接曾经存在,但已被移除,并且在最新版本的广告中不再显示。 |
AdGroupAdAssetPolicySummary
包含广告组广告素材资源的政策信息。
JSON 表示法 |
---|
{ "policyTopicEntries": [ { object ( |
字段 | |
---|---|
policy |
仅限输出。广告组广告素材资源的政策违规问题列表。 |
review |
仅限输出。此广告组广告素材资源在审核流程的哪个阶段。 |
approval |
仅限输出。此广告组广告素材资源的整体审批状态,根据其各个政策主题条目的状态计算得出。 |
AdGroupAudienceView
广告组受众群体视图。包括在受众群体一级汇总的展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式:
|
AdGroupCriterionSimulation
广告组条件模拟。下文分别详细介绍了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法组合。从 v5 开始,酒店 AdGroupCriterion 模拟操作。
- 展示广告 - 关键字 - CPC_BID - UNIFORM
- 搜索广告 - 关键字 - CPC_BID - UNIFORM
- SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
- HOTEL - LISTING_GROUP - CPC_BID - UNIFORM
- HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resource |
仅限输出。广告组条件模拟的资源名称。广告组条件模拟资源名称采用以下格式:
|
type |
仅限输出。模拟修改的字段。 |
modification |
仅限输出。模拟如何修改字段。 |
ad |
仅限输出。模拟的广告组 ID。 |
criterion |
仅限输出。模拟的条件 ID。 |
start |
仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。 |
end |
仅限输出。模拟数据所依据的最后一天,采用 YYYY-MM-DD 格式。 |
联合字段 point_list 。模拟点列表。point_list 只能是下列其中一项: |
|
cpc |
仅限输出。如果模拟类型为 CPC_BID,则为模拟得分。 |
percent |
仅限输出。如果模拟类型为 PERCENT_CPC_BID,则为模拟得分。 |
SimulationType
用于描述模拟修改的字段的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
CPC_BID |
模拟的是每次点击费用出价。 |
CPV_BID |
模拟结果适用于每次观看费用出价。 |
TARGET_CPA |
模拟结果适用于目标每次转化费用。 |
BID_MODIFIER |
此模拟针对的是出价调节系数。 |
TARGET_ROAS |
模拟结果适用于广告支出回报率目标。 |
PERCENT_CPC_BID |
模拟的是百分比形式的每次点击费用出价。 |
TARGET_IMPRESSION_SHARE |
此模拟适用于展示次数份额目标。 |
BUDGET |
模拟的是预算。 |
SimulationModificationMethod
用于描述模拟修改字段的方法的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
UNIFORM |
模拟中的值会统一应用于给定资源的所有子项。系统未遵循子资源的替换项。 |
DEFAULT |
模拟中的值已应用于给定资源。系统会遵循对子资源的替换项,并且流量估算值不包括这些资源。 |
SCALING |
模拟中的值均按相同的系数缩放。例如,在模拟的“每次转化费用目标”广告系列中,广告系列目标和所有广告组目标均按 X 的系数进行缩放。 |
CpcBidSimulationPointList
用于 CPC_BID 类型模拟的模拟点的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列每次点击费用出价金额的预测指标。 |
CpcBidSimulationPoint
特定每次点击费用出价金额的预测指标。
JSON 表示法 |
---|
{ "requiredBudgetAmountMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, // Union field |
字段 | |
---|---|
required |
广告客户必须设置的预计所需每日预算才能获得预计流量,以广告客户币种为单位,以微为单位。 |
biddable |
预计可出价的转化次数。 |
biddable |
可出价转化的预计总价值。 |
clicks |
预计点击次数。 |
cost |
预计费用(以百万分之一表示)。 |
impressions |
预计的展示次数。 |
top |
预计的顶部广告位展示次数。只有搜索广告渠道类型支持此字段。 |
联合字段 cpc_simulation_key_value 。当 SimulationModificationMethod 为 UNIFORM 或 DEFAULT 时,系统会设置 cpc_bid_micros。当 SimulationModificationMethod = SCALING 时,系统会设置 cpc_bid_scaling_modifier。cpc_simulation_key_value 只能是下列其中一项: |
|
cpc |
预测指标所依据的模拟每次点击费用出价。 |
cpc |
预测指标所依据的模拟缩放修饰符。与模拟实体相关的所有 CPC 出价都会按此调节系数进行缩放。 |
PercentCpcBidSimulationPointList
用于存储类型为 PERCENT_CPC_BID 的模拟的点的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列每次点击费用百分比出价金额的预测指标。 |
PercentCpcBidSimulationPoint
针对特定每次点击费用百分比的预测指标。只有“酒店”广告渠道类型支持此字段。
JSON 表示法 |
---|
{ "percentCpcBidMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
字段 | |
---|---|
percent |
预测指标所依据的模拟每次点击费用百分比。每次点击费用百分比,表示为某商品或服务的广告价格的一部分。此处存储的值为 1,000,000 * [fraction]。 |
biddable |
预计可出价的转化次数。 |
biddable |
可出价转化的预计总价值(以本地货币表示)。 |
clicks |
预计点击次数。 |
cost |
预计费用(以百万分之一表示)。 |
impressions |
预计的展示次数。 |
top |
预计的顶部广告位展示次数。 |
AdGroupSimulation
广告组模拟。下面分别详细介绍了广告渠道类型、模拟类型和模拟修改方法的支持组合。
- 搜索广告 - CPC_BID - 默认
- 搜索 - CPC_BID - UNIFORM
- 搜索广告 - TARGET_CPA - UNIFORM
- 搜索广告系列 - TARGET_ROAS - UNIFORM
- 展示广告 - CPC_BID - 默认
- 展示广告 - CPC_BID - UNIFORM
- 展示广告 - 目标每次转化费用 - 统一
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resource |
仅限输出。广告组模拟的资源名称。广告组模拟资源名称的格式如下:
|
type |
仅限输出。模拟修改的字段。 |
modification |
仅限输出。模拟如何修改字段。 |
ad |
仅限输出。模拟的广告组 ID。 |
start |
仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。 |
end |
仅限输出。模拟数据所依据的最后一天,采用 YYYY-MM-DD 格式 |
联合字段 point_list 。模拟点列表。point_list 只能是下列其中一项: |
|
cpc |
仅限输出。如果模拟类型为 CPC_BID,则为模拟得分。 |
cpv |
仅限输出。如果模拟类型为 CPV_BID,则为模拟得分。 |
target |
仅限输出。如果模拟类型为 TARGET_CPA,则为模拟得分。 |
target |
仅限输出。如果模拟类型为 TARGET_ROAS,则为模拟得分。 |
CpvBidSimulationPointList
用于存放类型为 CPV_BID 的模拟的模拟点的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列每次观看费用出价金额的预测指标。 |
CpvBidSimulationPoint
特定每次转化费用出价金额的预测指标。
JSON 表示法 |
---|
{ "cpvBidMicros": string, "costMicros": string, "impressions": string, "views": string } |
字段 | |
---|---|
cpv |
预测指标所依据的模拟每次观看费用出价。 |
cost |
预计费用(以百万分之一表示)。 |
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 |
字段 | |
---|---|
required |
广告客户必须设置的预计所需每日预算才能获得预计流量,以广告客户币种为单位,以微为单位。 |
app |
预计应用安装次数。 |
in |
预计应用内操作次数。 |
biddable |
预计可出价的转化次数。 |
biddable |
可出价转化的预计总价值。 |
clicks |
预计点击次数。 |
cost |
预计费用(以百万分之一表示)。 |
impressions |
预计的展示次数。 |
top |
预计的顶部广告位展示次数。只有搜索广告渠道类型支持此字段。 |
interactions |
预计互动次数。只有发现广告渠道类型支持此字段。 |
联合字段 target_cpa_simulation_key_value 。当 SimulationModificationMethod 为 UNIFORM 或 DEFAULT 时,系统会设置 target_cpa_micros。当 SimulationModificationMethod 设为 SCALING 时,系统会设置 target_cpa_scaling_modifier。target_cpa_simulation_key_value 只能是下列其中一项: |
|
target |
预测指标所依据的模拟目标每次操作费用。 |
target |
预测指标所依据的模拟缩放修饰符。与模拟实体相关的所有每次转化费用目标值都会按此修饰符进行缩放。 |
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 } |
字段 | |
---|---|
required |
广告客户必须设置的预计所需每日预算才能获得预计流量,以广告客户币种为单位,以微为单位。 |
target |
预测指标所依据的模拟目标广告支出回报率。 |
biddable |
预计可出价的转化次数。 |
biddable |
可出价转化的预计总价值。 |
clicks |
预计点击次数。 |
cost |
预计费用(以百万分之一表示)。 |
impressions |
预计的展示次数。 |
top |
预计的顶部广告位展示次数。只有搜索广告渠道类型支持此字段。 |
AgeRangeView
年龄段视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。年龄段视图的资源名称。年龄段视图资源名称采用以下格式:
|
AdScheduleView
“广告投放时间”视图会按 AdSchedule 条件汇总广告系列的效果。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。广告时间表视图的资源名称。广告时间表视图资源名称采用以下格式:
|
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 } |
字段 | |
---|---|
resource |
仅限输出。网域类别的资源名称。网域类别资源名称的格式为:
|
campaign |
仅限输出。此类别推荐用于的广告系列。 |
category |
仅限输出。为网站网域推荐的类别。例如,如果您有一个电子产品网站,则类别可以是“相机”“电视”等。 |
language |
仅限输出。用于指定网站语言的语言代码,例如“en”表示英语。您可以在动态搜索广告所需的 DynamicSearchAdsSetting 中指定语言。这是您希望 Google Ads 查找的网页的语言,为网页制作广告并将搜索与之匹配。 |
domain |
仅限输出。网站的域名。您可以在动态搜索广告所需的 DynamicSearchAdsSetting 中指定网域。 |
coverage |
仅限输出。与此类别匹配的您网站上网页所占的百分比。 |
category |
仅限输出。此类别在类别集中的位置。数字越小,与网域的匹配度越高。null 表示不建议。 |
has |
仅限输出。指示此类别是否有子类别。 |
recommended |
仅限输出。相应类别的建议每次点击费用。 |
AssetFieldTypeView
素材资源字段类型视图。当素材资源用作附加信息时,此视图会报告每种素材资源字段类型的非重复统计指标。
JSON 表示法 |
---|
{
"resourceName": string,
"fieldType": enum ( |
字段 | |
---|---|
resource |
仅限输出。素材资源字段类型视图的资源名称。资产字段类型视图资源名称的格式为:
|
field |
仅限输出。素材资源字段类型视图的素材资源字段类型。 |
AssetGroupProductGroupView
素材资源组产品组视图。
JSON 表示法 |
---|
{ "resourceName": string, "assetGroup": string, "assetGroupListingGroupFilter": string } |
字段 | |
---|---|
resource |
仅限输出。素材资源组商品组视图的资源名称。素材资源组产品组视图资源名称采用以下格式:
|
asset |
仅限输出。与产品信息组过滤条件关联的素材资源组。 |
asset |
仅限输出。素材资源组产品信息组过滤条件的资源名称。 |
AssetGroupTopCombinationView
广告组广告素材资源组合使用情况的视图。
JSON 表示法 |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
字段 | |
---|---|
resource |
仅限输出。素材资源组“效果最佳的组合”视图的资源名称。素材资源组热门组合视图资源名称采用以下格式:“customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}” |
asset |
仅限输出。一起投放的效果最佳的素材资源组合。 |
AssetGroupAssetCombinationData
素材资源组素材资源组合数据
JSON 表示法 |
---|
{
"assetCombinationServedAssets": [
{
object ( |
字段 | |
---|---|
asset |
仅限输出。投放的素材资源。 |
AssetSetTypeView
素材资源组类型视图。此视图会报告每种素材资源组类型的未过量统计指标。此报告不包含子素材资源集类型。其统计信息会汇总到父级素材资源集类型下。
JSON 表示法 |
---|
{
"resourceName": string,
"assetSetType": enum ( |
字段 | |
---|---|
resource |
仅限输出。资产集类型视图的资源名称。资产集类型视图资源名称的格式为:
|
asset |
仅限输出。素材资源组类型视图的素材资源组类型。 |
BiddingStrategySimulation
出价策略模拟。下面分别详细介绍了支持的模拟类型和模拟修改方法组合。
- TARGET_CPA - UNIFORM
- TARGET_ROAS - UNIFORM
JSON 表示法 |
---|
{ "resourceName": string, "biddingStrategyId": string, "type": enum ( |
字段 | |
---|---|
resource |
仅限输出。出价策略模拟的资源名称。出价策略模拟资源名称的格式为:
|
bidding |
仅限输出。模拟的出价策略共享集 ID。 |
type |
仅限输出。模拟修改的字段。 |
modification |
仅限输出。模拟如何修改字段。 |
start |
仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。 |
end |
仅限输出。模拟数据所依据的最后一天,采用 YYYY-MM-DD 格式 |
联合字段 point_list 。模拟点列表。point_list 只能是下列其中一项: |
|
target |
仅限输出。如果模拟类型为 TARGET_CPA,则为模拟得分。 |
target |
仅限输出。如果模拟类型为 TARGET_ROAS,则为模拟得分。 |
CallView
来电视图,其中包含来电专用广告或附加电话信息的来电跟踪数据。
JSON 表示法 |
---|
{ "resourceName": string, "callerCountryCode": string, "callerAreaCode": string, "callDurationSeconds": string, "startCallDateTime": string, "endCallDateTime": string, "callTrackingDisplayLocation": enum ( |
字段 | |
---|---|
resource |
仅限输出。通话视图的资源名称。通话视图资源名称的格式为:
|
caller |
仅限输出。来电者的国家/地区代码。 |
caller |
仅限输出。来电者的区号。如果通话时长短于 15 秒,则为 null。 |
call |
仅限输出。广告客户提供的通话时长(以秒为单位)。 |
start |
仅限输出。广告客户提供的通话开始日期时间。 |
end |
仅限输出。广告客户提供的通话结束日期时间。 |
call |
仅限输出。来电跟踪的显示位置。 |
type |
仅限输出。通话类型。 |
call |
仅限输出。通话的状态。 |
CallTrackingDisplayLocation
可能的来电跟踪显示位置。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AD |
通过广告拨打的电话。 |
LANDING_PAGE |
通过广告指向的着陆页拨打的电话。 |
CallType
发起调用的可能媒体资源类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MANUALLY_DIALED |
电话是手动拨打的。 |
HIGH_END_MOBILE_SEARCH |
相应通话是通过移动设备点击致电功能发起的。 |
GoogleVoiceCallStatus
Google Voice 通话的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MISSED |
您错过了来电。 |
RECEIVED |
我们已收到该通话。 |
CampaignAudienceView
广告系列受众群体视图。包括展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据,按广告系列和受众群体条件汇总。此视图仅包含在广告系列一级附加的受众群体。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。广告系列受众群体视图的资源名称。广告系列受众群体视图资源名称采用以下格式:
|
CampaignSearchTermInsight
“广告系列搜索字词”视图。历史数据从 2023 年 3 月开始提供。
JSON 表示法 |
---|
{ "resourceName": string, "categoryLabel": string, "id": string, "campaignId": string } |
字段 | |
---|---|
resource |
仅限输出。广告系列级搜索字词数据分析的资源名称。广告系列级搜索字词数据分析资源名称的格式如下:
|
category |
仅限输出。搜索类别的标签。空字符串表示不属于其他类别的搜索字词的统称类别。 |
id |
仅限输出。数据分析的 ID。 |
campaign |
仅限输出。广告系列的 ID。 |
CampaignSimulation
广告系列模拟。下面分别详细介绍了广告渠道类型、模拟类型和模拟修改方法的支持组合。
- 搜索 - CPC_BID - UNIFORM
- 搜索 - CPC_BID - 缩放
- 搜索广告 - TARGET_CPA - UNIFORM
- 搜索广告 - 目标每次转化费用 - 扩展
- 搜索广告系列 - TARGET_ROAS - UNIFORM
- 搜索广告 - TARGET_IMPRESSION_SHARE - UNIFORM
- 搜索 - 预算 - 统一
- 购物 - 预算 - 制服
- 购物 - TARGET_ROAS - UNIFORM
- MULTI_CHANNEL - TARGET_CPA - UNIFORM
- MULTI_CHANNEL - TARGET_ROAS - UNIFORM
- 发现广告系列 - 目标每次转化费用 - 默认
- 展示广告 - 目标每次转化费用 - 统一
- PERFORMANCE_MAX - TARGET_CPA - UNIFORM
- PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
- PERFORMANCE_MAX - BUDGET - UNIFORM
JSON 表示法 |
---|
{ "resourceName": string, "campaignId": string, "type": enum ( |
字段 | |
---|---|
resource |
仅限输出。广告系列模拟的资源名称。广告系列模拟资源名称的格式如下:
|
campaign |
仅限输出。模拟的广告系列 ID。 |
type |
仅限输出。模拟修改的字段。 |
modification |
仅限输出。模拟如何修改字段。 |
start |
仅限输出。模拟所依据的第一天,采用 YYYY-MM-DD 格式。 |
end |
仅限输出。模拟数据所依据的最后一天,采用 YYYY-MM-DD 格式 |
联合字段 point_list 。模拟点列表。point_list 只能是下列其中一项: |
|
cpc |
仅限输出。如果模拟类型为 CPC_BID,则为模拟得分。 |
target |
仅限输出。如果模拟类型为 TARGET_CPA,则为模拟得分。 |
target |
仅限输出。如果模拟类型为 TARGET_ROAS,则为模拟得分。 |
target |
仅限输出。如果模拟类型为 TARGET_IMPRESSION_SHARE,则为模拟数据点。 |
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 } |
字段 | |
---|---|
budget |
预测指标所依据的模拟预算。 |
required |
广告客户必须设置的预计所需每日 CPC 出价上限,以广告客户币种的微单位表示,用于实现此模拟。只有采用“目标支出”出价策略的广告系列支持此字段。 |
biddable |
预计可出价的转化次数。 |
biddable |
可出价转化的预计总价值。 |
clicks |
预计点击次数。 |
cost |
预计费用(以百万分之一表示)。 |
impressions |
预计的展示次数。 |
top |
预计的顶部广告位展示次数。只有搜索广告渠道类型支持此字段。 |
interactions |
预计互动次数。只有发现广告渠道类型支持此字段。 |
CarrierConstant
可用于广告系列定位条件的运营商定位条件。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "countryCode": string } |
字段 | |
---|---|
resource |
仅限输出。运营商条件的资源名称。运营商条件资源名称采用以下格式:
|
id |
仅限输出。运营商条件的 ID。 |
name |
仅限输出。运营商的英文全名。 |
country |
仅限输出。运营商所在国家/地区的国家/地区代码,例如“AR”“FR”等。 |
ChangeEvent
描述特定资源类型的返回资源的精细更改。其中包括过去 30 天内通过界面或 API 进行的更改。系统会显示更改的字段的旧值和新值。ChangeEvent 最长可能需要 3 分钟才能反映出新更改。
JSON 表示法 |
---|
{ "resourceName": string, "changeDateTime": string, "changeResourceType": enum ( |
字段 | |
---|---|
resource |
仅限输出。更改事件的资源名称。更改事件资源名称的格式为:
|
change |
仅限输出。对此资源提交更改的时间。 |
change |
仅限输出。更改的资源的类型。这决定了将在 oldResource 和 newResource 中设置哪些资源。 |
change |
仅限输出。发生更改的 Simply 资源。 |
client |
仅限输出。更改的途径。 |
user |
仅限输出。做出此更改的用户的电子邮件地址。 |
old |
仅限输出。更改前的旧资源。系统只会填充更改后的字段。 |
new |
仅限输出。更改后的新资源。系统只会填充更改后的字段。 |
resource |
仅限输出。对更改的资源执行的操作。 |
changed |
仅限输出。返回的资源中已更改的字段的列表。 这是完全限定字段名称的逗号分隔列表。示例: |
campaign |
仅限输出。受此次变更影响的广告系列。 |
ad |
仅限输出。受此更改影响的广告组。 |
feed |
仅限输出。受此更改影响的 Feed。 |
feed |
仅限输出。受此更改影响的 FeedItem。 |
asset |
仅限输出。受此更改影响的资产。 |
ChangeEventResourceType
列出 ChangeEvent 资源支持的资源类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的分类资源。 |
AD |
广告资源更改。 |
AD_GROUP |
AdGroup 资源更改。 |
AD_GROUP_CRITERION |
AdGroupCriterion 资源更改。 |
CAMPAIGN |
广告系列资源更改。 |
CAMPAIGN_BUDGET |
CampaignBudget 资源更改。 |
AD_GROUP_BID_MODIFIER |
AdGroupBidModifier 资源更改。 |
CAMPAIGN_CRITERION |
CampaignCriterion 资源更改。 |
FEED |
Feed 资源更改。 |
FEED_ITEM |
FeedItem 资源更改。 |
CAMPAIGN_FEED |
CampaignFeed 资源更改。 |
AD_GROUP_FEED |
AdGroupFeed 资源更改。 |
AD_GROUP_AD |
AdGroupAd 资源更改。 |
ASSET |
资产资源更改。 |
CUSTOMER_ASSET |
CustomerAsset 资源更改。 |
CAMPAIGN_ASSET |
CampaignAsset 资源更改。 |
AD_GROUP_ASSET |
AdGroupAsset 资源更改。 |
ASSET_SET |
AssetSet 资源更改。 |
ASSET_SET_ASSET |
AssetSetAsset 资源更改。 |
CAMPAIGN_ASSET_SET |
CampaignAssetSet 资源更改。 |
ChangeClientType
创建 changeEvent 资源的来源。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的未分类客户端类型。 |
GOOGLE_ADS_WEB_CLIENT |
通过“ads.google.com”进行的更改。例如,通过广告系列管理工具进行的更改。 |
GOOGLE_ADS_AUTOMATED_RULE |
通过 Google Ads 自动规则进行的更改。 |
GOOGLE_ADS_SCRIPTS |
通过 Google Ads 脚本进行的更改。 |
GOOGLE_ADS_BULK_UPLOAD |
通过 Google Ads 批量上传功能进行的更改。 |
GOOGLE_ADS_API |
Google Ads API 所做的更改。 |
GOOGLE_ADS_EDITOR |
由 Google Ads 编辑器所做的更改。此值为占位符。该 API 不会返回这些更改。 |
GOOGLE_ADS_MOBILE_APP |
通过 Google Ads 移动应用进行的更改。 |
GOOGLE_ADS_RECOMMENDATIONS |
通过 Google Ads 建议进行的更改。 |
SEARCH_ADS_360_SYNC |
通过 Search Ads 360 Sync 进行的更改。 |
SEARCH_ADS_360_POST |
通过 Search Ads 360 Post 进行的更改。 |
INTERNAL_TOOL |
通过内部工具进行的更改。例如,当用户在广告系列等实体上设置网址模板时,系统会自动将其封装在 SA360 Clickserver 网址中。 |
OTHER |
未分类的更改类型,例如通过 Google Ads 兑换优惠券所做的更改。 |
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION |
订阅 Google Ads 建议后所做的更改。 |
ChangedResource
用于呈现所有受支持资源的封装容器 proto。系统只会设置 changeResourceType 的资源。
JSON 表示法 |
---|
{ "ad": { object ( |
字段 | |
---|---|
ad |
仅限输出。如果 changeResourceType == AD,则设置。 |
ad |
仅限输出。如果 changeResourceType == AD_GROUP,则设置此属性。 |
ad |
仅限输出。如果 changeResourceType == AD_GROUP_CRITERION,则进行设置。 |
campaign |
仅限输出。如果 changeResourceType == CAMPAIGN,则进行设置。 |
campaign |
仅限输出。如果 changeResourceType == CAMPAIGN_BUDGET,则进行设置。 |
ad |
仅限输出。如果 changeResourceType == AD_GROUP_BID_MODIFIER,则设置。 |
campaign |
仅限输出。如果 changeResourceType == CAMPAIGN_CRITERION,则进行设置。 |
feed |
仅限输出。如果 changeResourceType == FEED,则设置。 |
feed |
仅限输出。如果 changeResourceType == FEED_ITEM,则设置。 |
campaign |
仅限输出。如果 changeResourceType == CAMPAIGN_FEED,则进行设置。 |
ad |
仅限输出。如果 changeResourceType == AD_GROUP_FEED,则设置此属性。 |
ad |
仅限输出。如果 changeResourceType == AD_GROUP_AD,则设置此属性。 |
asset |
仅限输出。如果 changeResourceType == ASSET,则设置。 |
customer |
仅限输出。如果 changeResourceType == CUSTOMER_ASSET,则设置。 |
campaign |
仅限输出。如果 changeResourceType == CAMPAIGN_ASSET,则进行设置。 |
ad |
仅限输出。如果 changeResourceType == AD_GROUP_ASSET,则进行设置。 |
asset |
仅限输出。如果 changeResourceType == ASSET_SET,则设置。 |
asset |
仅限输出。如果 changeResourceType == ASSET_SET_ASSET,则设置。 |
campaign |
仅限输出。如果 changeResourceType == CAMPAIGN_ASSET_SET,则设置此属性。 |
ResourceChangeOperation
changeEvent 资源中对更改的资源执行的操作。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的分类操作。 |
CREATE |
资源已创建。 |
UPDATE |
资源已修改。 |
REMOVE |
资源已被移除。 |
ChangeStatus
描述返回资源的状态。ChangeStatus 最长可能需要 3 分钟才能反映出新的更改。
JSON 表示法 |
---|
{ "resourceName": string, "resourceType": enum ( |
字段 | |
---|---|
resource |
仅限输出。更改状态的资源名称。更改状态资源名称的格式为:
|
resource |
仅限输出。表示更改的资源的类型。这决定了要设置哪些字段。例如,对于 AD_GROUP,系统会设置 campaign 和 adGroup 字段。 |
resource |
仅限输出。表示更改后的资源的状态。 |
shared |
仅限输出。受此变更影响的 SharedSet。 |
campaign |
仅限输出。受此次变更影响的 CampaignSharedSet。 |
asset |
仅限输出。受此更改影响的资产。 |
customer |
仅限输出。受此变更影响的 CustomerAsset。 |
campaign |
仅限输出。受此次变更影响的 CampaignAsset。 |
ad |
仅限输出。受此变更影响的 AdGroupAsset。 |
combined |
仅限输出。受此次变更影响的 CombinedAudience。 |
last |
仅限输出。此资源最近发生更改的时间。 |
campaign |
仅限输出。受此次变更影响的广告系列。 |
ad |
仅限输出。受此更改影响的广告组。 |
ad |
仅限输出。受此变更影响的 AdGroupAd。 |
ad |
仅限输出。受此更改影响的 AdGroupCriterion。 |
campaign |
仅限输出。受此次变更影响的 CampaignCriterion。 |
feed |
仅限输出。受此更改影响的 Feed。 |
feed |
仅限输出。受此更改影响的 FeedItem。 |
ad |
仅限输出。受此变更影响的 AdGroupFeed。 |
campaign |
仅限输出。受此次变更影响的 CampaignFeed。 |
ad |
仅限输出。受此变更影响的 AdGroupBidModifier。 |
ChangeStatusResourceType
列出 ChangeStatus 资源支持的资源类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的分类资源。 |
AD_GROUP |
AdGroup 资源更改。 |
AD_GROUP_AD |
AdGroupAd 资源更改。 |
AD_GROUP_CRITERION |
AdGroupCriterion 资源更改。 |
CAMPAIGN |
广告系列资源更改。 |
CAMPAIGN_CRITERION |
CampaignCriterion 资源更改。 |
FEED |
Feed 资源更改。 |
FEED_ITEM |
FeedItem 资源更改。 |
AD_GROUP_FEED |
AdGroupFeed 资源更改。 |
CAMPAIGN_FEED |
CampaignFeed 资源更改。 |
AD_GROUP_BID_MODIFIER |
AdGroupBidModifier 资源更改。 |
SHARED_SET |
SharedSet 资源更改。 |
CAMPAIGN_SHARED_SET |
CampaignSharedSet 资源更改。 |
ASSET |
资产资源更改。 |
CUSTOMER_ASSET |
CustomerAsset 资源更改。 |
CAMPAIGN_ASSET |
CampaignAsset 资源更改。 |
AD_GROUP_ASSET |
AdGroupAsset 资源更改。 |
COMBINED_AUDIENCE |
CombinedAudience 资源更改。 |
ChangeStatusOperation
更改后的资源的状态
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的分类资源。 |
ADDED |
资源已创建。 |
CHANGED |
资源已修改。 |
REMOVED |
资源已被移除。 |
CombinedAudience
说明包含不同受众群体的组合受众群体的资源。
JSON 表示法 |
---|
{
"resourceName": string,
"id": string,
"status": enum ( |
字段 | |
---|---|
resource |
不可变。组合受众群体的资源名称。组合的受众群体名称的格式如下:
|
id |
仅限输出。组合受众群体的 ID。 |
status |
仅限输出。此组合受众群体的状态。指示组合受众群体是处于启用还是移除状态。 |
name |
仅限输出。组合受众群体的名称。它在所有组合的受众群体中都应是唯一的。 |
description |
仅限输出。此组合受众群体的说明。 |
CombinedAudienceStatus
包含可能的组合受众群体状态类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
已启用状态 - 组合的受众群体已启用,可以定位到。 |
REMOVED |
已移除状态 - 组合受众群体已移除,无法用于定位。 |
ClickView
点击视图,其中包含在每个点击级别汇总的指标,包括有效和无效点击。对于非搜索广告系列,metrics.clicks 表示有效互动和无效互动的数量。包含 ClickView 的查询必须包含一个过滤条件,将结果限制为一天,并且可以请求查询请求时间前 90 天内的数据。
JSON 表示法 |
---|
{ "resourceName": string, "areaOfInterest": { object ( |
字段 | |
---|---|
resource |
仅限输出。点击视图的资源名称。点击视图资源名称采用以下格式:
|
area |
仅限输出。与展示所关联的兴趣区域相匹配的地理位置条件。 |
location |
仅限输出。与展示机会相关联的营业地点所对应的地理位置条件。 |
keyword |
仅限输出。关联的关键字(如果存在且相应点击属于“搜索”渠道)。 |
keyword |
仅限输出。与关联的关键字(如果有)相关的基本信息。 |
gclid |
仅限输出。Google 点击 ID。 |
page |
仅限输出。展示广告的页面在搜索结果中的页码。 |
ad |
仅限输出。关联的广告。 |
campaign |
仅限输出。关联的广告系列地理位置定位条件(如果有)。 |
user |
仅限输出。关联的用户列表(如果有)。 |
ClickLocation
与点击相关联的地理位置条件。
JSON 表示法 |
---|
{ "city": string, "country": string, "metro": string, "mostSpecific": string, "region": string } |
字段 | |
---|---|
city |
与展示相关联的城市地理位置条件。 |
country |
与展示次数相关联的国家/地区位置条件。 |
metro |
与展示相关联的都会区地理位置条件。 |
most |
与展示相关联的最具体的地理位置条件。 |
region |
与展示相关的地区地理位置条件。 |
CurrencyConstant
货币常量。
JSON 表示法 |
---|
{ "resourceName": string, "code": string, "name": string, "symbol": string, "billableUnitMicros": string } |
字段 | |
---|---|
resource |
仅限输出。货币常量的资源名称。货币常量资源名称的格式为:
|
code |
仅限输出。符合 ISO 4217 标准、由 3 个字母组成的货币代码,例如“USD” |
name |
仅限输出。相应币种的英文全称。 |
symbol |
仅限输出。用于描述此币种的标准符号,例如,美元为“$”。 |
billable |
仅限输出。此币种的计费单位。结算金额应为此值的倍数。 |
AccessibleBiddingStrategy
表示由客户拥有并与客户共享的出价策略的视图。
与 BiddingStrategy 不同,此资源除了包含客户拥有的策略之外,还包含客户经理拥有并与客户共享的策略。此资源不提供指标,并且仅公开一部分出价策略属性。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
字段 | |
---|---|
resource |
仅限输出。可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称的格式为:
|
id |
仅限输出。出价策略的 ID。 |
name |
仅限输出。出价策略的名称。 |
type |
仅限输出。出价策略的类型。 |
owner |
仅限输出。拥有出价策略的客户的 ID。 |
owner |
仅限输出。拥有出价策略的客户的 descriptiveName。 |
联合字段 只能设置一个。 |
|
maximize |
仅限输出。这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。 |
maximize |
仅限输出。这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。 |
target |
仅限输出。一种出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。 |
target |
仅限输出。一种出价策略,可自动针对所选的展示次数百分比进行优化。 |
target |
仅限输出。这种出价策略有助于您在尽可能提高收入的同时,尽可能使平均广告支出回报率等于您设置的目标回报率。 |
target |
仅限输出。一种出价策略,会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。 |
MaximizeConversionValue
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。
JSON 表示法 |
---|
{ "targetRoas": number } |
字段 | |
---|---|
target |
仅限输出。目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。 |
MaximizeConversions
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
字段 | |
---|---|
target |
仅限输出。目标每次转化费用 (CPA) 选项。这是指您愿意为每次转化支付的平均金额。 |
TargetCpa
一种自动出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
字段 | |
---|---|
target |
仅限输出。平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。 |
TargetRoas
这是一种自动出价策略,可帮助您在达到特定目标广告支出回报率 (ROAS) 平均值的同时,尽可能提高收入。
JSON 表示法 |
---|
{ "targetRoas": number } |
字段 | |
---|---|
target |
仅限输出。每单位支出所选择的收入(基于转化数据)。 |
TargetSpend
这是一种自动出价策略,使用该策略,系统会自动为您设置适当的出价,助您在不超出预算的前提下为您争取尽可能多的点击。
JSON 表示法 |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
字段 | |
---|---|
targetSpendMicros |
仅限输出。尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 此字段已废弃,不应再使用。如需了解详情,请访问 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。 |
cpc |
仅限输出。可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。 |
CustomerClient
给定客户与客户客户之间的关联。CustomerClient 仅适用于经理客户。包括所有直接客户和间接客户,以及经理本人。
JSON 表示法 |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
字段 | |
---|---|
resource |
仅限输出。客户端的资源名称。CustomerClient 资源名称采用以下格式: |
applied |
仅限输出。请求方客户拥有的标签的资源名称,这些标签应用于客户客户。标签资源名称采用以下格式:
|
status |
仅限输出。客户客户的状态。只读。 |
client |
仅限输出。与指定客户关联的客户端-客户资源的名称。只读。 |
level |
仅限输出。给定客户与客户之间的距离。对于自链接,级别值为 0。只读。 |
time |
仅限输出。客户端时区的通用区域设置数据库 (CLDR) 字符串表示法,例如 America/Los_Angeles。只读。 |
test |
仅限输出。用于确定客户是否为测试账号。只读。 |
manager |
仅限输出。用于标识客户端是否为经理。只读。 |
descriptive |
仅限输出。客户端的描述性名称。只读。 |
currency |
仅限输出。客户的币种代码(例如“USD”“EUR”)。只读。 |
id |
仅限输出。客户客户的 ID。只读。 |
CustomerSearchTermInsight
“客户搜索字词”视图。历史数据从 2023 年 3 月开始提供。
JSON 表示法 |
---|
{ "resourceName": string, "categoryLabel": string, "id": string } |
字段 | |
---|---|
resource |
仅限输出。客户级搜索字词数据分析的资源名称。客户级搜索字词数据分析资源名称采用以下格式:
|
category |
仅限输出。搜索类别的标签。空字符串表示不属于其他类别的搜索字词的统称类别。 |
id |
仅限输出。数据分析的 ID。 |
DetailPlacementView
此视图会按广告组和网址或 YouTube 视频汇总指标。
JSON 表示法 |
---|
{
"resourceName": string,
"placementType": enum ( |
字段 | |
---|---|
resource |
仅限输出。详细展示位置视图的资源名称。详细展示位置视图资源名称采用以下格式:
|
placement |
仅限输出。展示位置的类型,例如网站、YouTube 视频和移动应用。 |
placement |
仅限输出。详细级别的系统推荐的展示位置字符串,例如网站网址、移动应用 ID 或 YouTube 视频 ID。 |
display |
仅限输出。显示名称是指网站的网址名称、YouTube 视频的 YouTube 视频名称,以及移动应用的译名。 |
group |
仅限输出。组展示位置的网址,例如网域、指向应用商店中的移动应用的链接或 YouTube 频道网址。 |
target |
仅限输出。展示位置的网址,例如网站、应用商店中移动应用的链接或 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 ( |
字段 | |
---|---|
resource |
仅限输出。详细受众特征的资源名称。详细受众特征资源名称采用以下格式:
|
id |
仅限输出。详细受众特征的 ID。 |
name |
仅限输出。详细受众特征的名称。例如“最高教育程度” |
parent |
仅限输出。detailedDemographic 的父级。 |
launched |
仅限输出。如果详细受众特征面向所有渠道和语言区域发布,则为 true。 |
availabilities[] |
仅限输出。详细受众特征的可用性信息。 |
CriterionCategoryAvailability
每个广告渠道的类别可用性信息。
JSON 表示法 |
---|
{ "channel": { object ( |
字段 | |
---|---|
channel |
相应类别可用的渠道类型和子类型。 |
locale[] |
频道类别可用的语言区域。 |
CriterionCategoryChannelAvailability
类别适用的广告渠道类型和子类型的相关信息。
JSON 表示法 |
---|
{ "availabilityMode": enum ( |
字段 | |
---|---|
availability |
频道播出信息的格式。可以是 ALL_CHANNELS(系统不会设置其余字段)、CHANNEL_TYPE(系统只会设置 advertisingChannelType 类型,此类别适用于其下的所有子类型)或 CHANNEL_TYPE_AND_SUBTYPES(系统会设置 advertisingChannelType、advertisingChannelSubType 和 includeDefaultChannelSubType)。 |
advertising |
此类别适用的渠道类型。 |
advertising |
该类别适用的渠道类型下的渠道子类型。 |
include |
是否包含默认频道子类型。例如,如果 advertisingChannelType 为 DISPLAY 且 includeDefaultChannelSubType 为 false,则表示未设置渠道子类型的默认展示广告系列不包含在此适用性配置中。 |
CriterionCategoryChannelAvailabilityMode
包含可能的 CriterionCategoryChannelAvailabilityMode 的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ALL_CHANNELS |
此类别适用于所有渠道类型和子类型的广告系列。 |
CHANNEL_TYPE_AND_ALL_SUBTYPES |
此类别适用于特定渠道类型的广告系列,包括该渠道类型下的所有子类型。 |
CHANNEL_TYPE_AND_SUBSET_SUBTYPES |
此类别适用于特定渠道类型和子类型的广告系列。 |
CriterionCategoryLocaleAvailability
有关类别在哪些语言区域提供的信息。
JSON 表示法 |
---|
{
"availabilityMode": enum ( |
字段 | |
---|---|
availability |
语言区域可用性格式。可以是 LAUNCHED_TO_ALL(国家/地区和语言均为空),COUNTRY(仅设置国家/地区)、LANGUAGE(仅设置语言)、COUNTRY_AND_LANGUAGE(同时设置国家/地区和语言)。 |
country |
与类别关联的 ISO-3166-1 alpha-2 国家/地区代码。 |
language |
与类别关联的语言的 ISO 639-1 代码。 |
CriterionCategoryLocaleAvailabilityMode
包含可能的 CriterionCategoryLocaleAvailabilityMode 的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ALL_LOCALES |
此类别适用于所有语言区域的广告系列。 |
COUNTRY_AND_ALL_LANGUAGES |
此类别适用于列表中国家/地区的广告系列,无论其语言为何。 |
LANGUAGE_AND_ALL_COUNTRIES |
此类别适用于支持的语言列表中的广告系列,不限国家/地区。 |
COUNTRY_AND_LANGUAGE |
此类别适用于国家/地区-语言对列表中的广告系列。 |
DisplayKeywordView
展示广告网络关键字视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。展示广告关键字视图的资源名称。展示广告关键字视图资源名称采用以下格式:
|
DistanceView
距离视图,其中的指标按用户与广告客户的附加地址信息之间的距离进行汇总。每个 DistanceBucket 都包含其距离范围内的所有展示,并且一次展示都会计入包含用户距离的所有 DistanceBucket 的指标。
JSON 表示法 |
---|
{
"resourceName": string,
"distanceBucket": enum ( |
字段 | |
---|---|
resource |
仅限输出。距离视图的资源名称。距离视图资源名称采用以下格式:
|
distance |
仅限输出。附加地址信息中的用户距离分组。 |
metric |
仅限输出。如果 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 } |
字段 | |
---|---|
resource |
仅限输出。动态搜索广告搜索字词视图的资源名称。动态搜索广告搜索字词视图资源名称的格式为:
|
search |
仅限输出。搜索字词 此字段为只读字段。 |
headline |
仅限输出。动态搜索广告的动态生成标题。 此字段为只读字段。 |
landing |
仅限输出。展示的动态选择的着陆页网址。 此字段为只读字段。 |
page |
仅限输出。为展示投放的网页 Feed 项的网址。 此字段为只读字段。 |
has |
仅限输出。如果查询与否定关键字匹配,则为 true。 此字段为只读字段。 |
has |
仅限输出。如果查询已添加到定位关键字,则为 true。 此字段为只读字段。 |
has |
仅限输出。如果查询与否定网址匹配,则为 true。 此字段为只读字段。 |
ExpandedLandingPageView
着陆页视图,其中的指标在展开后的最终到达网址一级进行汇总。
JSON 表示法 |
---|
{ "resourceName": string, "expandedFinalUrl": string } |
字段 | |
---|---|
resource |
仅限输出。展开式着陆页视图的资源名称。展开式着陆页视图资源名称的格式为:
|
expanded |
仅限输出。点击后会转到的最终到达网址。 |
FeedPlaceholderView
Feed 占位符视图。
JSON 表示法 |
---|
{
"resourceName": string,
"placeholderType": enum ( |
字段 | |
---|---|
resource |
仅限输出。Feed 占位符视图的资源名称。Feed 占位符视图资源名称的格式为:
|
placeholder |
仅限输出。Feed 占位符视图的占位符类型。 |
GenderView
性别视图。genderView 资源反映的是有效的投放状态,而不是添加了哪些条件。默认情况下,不设定性别条件的广告组会向所有性别的用户展示,因此所有性别都会显示在 genderView 中并带有统计信息。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。性别视图的资源名称。性别视图资源名称采用以下格式:
|
GeographicView
地理视图。
“地理位置”视图包含在国家/地区一级汇总的所有指标,每个国家/地区对应一行。它会报告用户实际所处位置或感兴趣区域的指标。如果使用其他细分受众群字段,则每个国家/地区可能会有多个行。
JSON 表示法 |
---|
{
"resourceName": string,
"locationType": enum ( |
字段 | |
---|---|
resource |
仅限输出。地理视图的资源名称。地理位置视图资源名称采用以下格式:
|
location |
仅限输出。广告系列的地理位置定位类型。 |
country |
仅限输出。国家/地区的条件 ID。 |
GeoTargetingType
可能的地理位置定位类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
AREA_OF_INTEREST |
用户在发出查询时感兴趣的地点。 |
LOCATION_OF_PRESENCE |
发出查询的用户所在的位置。 |
GroupPlacementView
组展示位置视图。
JSON 表示法 |
---|
{
"resourceName": string,
"placementType": enum ( |
字段 | |
---|---|
resource |
仅限输出。组展示位置视图的资源名称。组展示位置视图资源名称采用以下格式:
|
placement |
仅限输出。展示位置的类型,例如网站、YouTube 频道、移动应用。 |
placement |
仅限输出。组级别的系统推荐的展示位置字符串,例如网域、移动应用 ID 或 YouTube 频道 ID。 |
display |
仅限输出。对于网站,请输入域名;对于 YouTube 频道,请输入 YouTube 频道名称。 |
target |
仅限输出。组展示位置的网址,例如网域、指向应用商店中的移动应用的链接或 YouTube 频道网址。 |
HotelGroupView
酒店组视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。酒店集团视图的资源名称。酒店集团视图资源名称采用以下格式:
|
HotelPerformanceView
酒店广告效果视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。酒店效果视图的资源名称。酒店效果视图资源名称采用以下格式:
|
HotelReconciliation
酒店对账。其中包含酒店预订的转化信息,以便与广告客户记录进行对账。在通过批量上传功能结算之前,这些行可能会更新或取消。
JSON 表示法 |
---|
{
"resourceName": string,
"commissionId": string,
"orderId": string,
"campaign": string,
"hotelCenterId": string,
"hotelId": string,
"checkInDate": string,
"checkOutDate": string,
"reconciledValueMicros": string,
"billed": boolean,
"status": enum ( |
字段 | |
---|---|
resource |
不可变。酒店对账的资源名称。酒店对账资源名称的格式为:
|
commission |
必需。仅限输出。佣金 ID 是指 Google 用于此项预订的 ID。系统会为每个预订事件分配佣金 ID,以便您将其与房客入住对应起来。 |
order |
仅限输出。订单 ID 是指转化跟踪代码的“transaction_id”参数中提供的此预订的标识符。 |
campaign |
仅限输出。与转化相关联的广告系列的资源名称。 |
hotel |
仅限输出。为酒店广告系列提供房价信息的 Hotel Center 账号的标识符。 |
hotel |
仅限输出。标识已预订房源的唯一标识符,如 Hotel Center Feed 中所提供。酒店 ID 来自转化跟踪代码的“ID”参数。 |
check |
仅限输出。在预订时记录的入住日期。如果入住日期在对账时有修改,则修改后的日期将取代此列中的原始日期。格式为 YYYY-MM-DD。 |
check |
仅限输出。在预订时登记的退房日期。如果入住日期在对账时有修改,则修改后的日期将取代此列中的原始日期。格式为 YYYY-MM-DD。 |
reconciled |
必需。仅限输出。已对账值是指房客支付的最终预订价值。如果原始预订价值因任何原因(例如行程变更或客房追加销售)而发生变化,已对账值应是所收取的最终全额。如果预订被取消,已对账值应包含所有取消费用或已收取且无法退款的数晚房费。值以基本单位货币的百万分之一表示。例如,12.35 美元将表示为 12350000。币种单位采用默认的客户币种。 |
billed |
仅限输出。给定预订是否已结算。结算后,便无法再修改预订。 |
status |
必需。仅限输出。一项预订的当前状态,与对账和结算有关。应在退房日期后 45 天内对预订进行对账。任何未在 45 天内对账的预订都将按其原始价值结算。 |
HotelReconciliationStatus
酒店预订对账的状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
RESERVATION_ENABLED |
预订针对的是未来的日期,或者已经入住但还未过退房日期的情形。处于有效状态的预订无法进行对账。 |
RECONCILIATION_NEEDED |
已经退房,或者预订日期已过且未取消。未在退房日期后 45 天内对账的预订会按照原来的预订价格结算费用。 |
RECONCILED |
这些预订已经对账。已对账的预订将在退房日期后 45 天结算费用。 |
CANCELED |
此预订已标记为取消。如果已取消预订的入住天数大于零(因设有最低入住天数规则或取消费用),系统会在退房日期后 45 天结算费用。 |
IncomeRangeView
收入范围视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。收入范围视图的资源名称。收入范围视图资源名称采用以下格式:
|
KeywordView
关键字视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。关键字视图的资源名称。关键字视图资源名称采用以下格式:
|
LandingPageView
着陆页视图,其中的指标在未展开的最终到达网址一级进行汇总。
JSON 表示法 |
---|
{ "resourceName": string, "unexpandedFinalUrl": string } |
字段 | |
---|---|
resource |
仅限输出。着陆页视图的资源名称。着陆页视图资源名称采用以下格式:
|
unexpanded |
仅限输出。广告主指定的最终到达网址。 |
LanguageConstant
一种语言。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
字段 | |
---|---|
resource |
仅限输出。语言常量的资源名称。语言常量资源名称的格式为:
|
id |
仅限输出。语言常量的 ID。 |
code |
仅限输出。语言代码,例如“en_US”“en_AU”“es”“fr”等。 |
name |
仅限输出。相应语言的全称(英语),例如“英语(美国)”“西班牙语”等。 |
targetable |
仅限输出。相应语言是否可定位。 |
LocationView
“地理位置”视图会按地理位置条件汇总广告系列的效果。如果未设置任何位置条件,则系统不会返回任何结果;而是使用 geographicView 或 userLocationView 来获取访问者位置数据。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。位置视图的资源名称。营业地点视图资源名称采用以下格式:
|
ManagedPlacementView
自选展示位置视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。受管型展示位置视图的资源名称。受管理的展示位置视图资源名称的格式为:
|
MediaFile
媒体文件。
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resource |
不可变。媒体文件的资源名称。媒体文件资源名称的格式为:
|
type |
不可变。媒体文件的类型。 |
mime |
仅限输出。媒体文件的 MIME 类型。 |
id |
仅限输出。媒体文件的 ID。 |
source |
不可变。原始媒体文件的下载来源网址(或文件名)。仅适用于类型为 AUDIO 和 IMAGE 的媒体。 |
name |
不可变。媒体文件的名称。客户端可以使用此名称来帮助识别之前上传的媒体。 |
file |
仅限输出。媒体文件的大小(以字节为单位)。 |
联合字段 mediatype 。媒体文件的具体类型。mediatype 只能是下列其中一项: |
|
image |
不可变。封装 Image。 |
media |
不可变。内容包含 HTML5 素材资源的 ZIP 压缩文件媒体。 |
audio |
仅限输出。封装音频。 |
video |
不可变。封装视频。 |
MediaType
媒体的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定媒体类型。 |
UNKNOWN |
此版本中未知收到的值。 这是仅限响应的值。 |
IMAGE |
静态图片,用于图片广告。 |
ICON |
小图片,用于地图广告。 |
MEDIA_BUNDLE |
ZIP 文件,用于模板广告的字段。 |
AUDIO |
音频文件。 |
VIDEO |
视频文件。 |
DYNAMIC_IMAGE |
动画图片,例如 GIF 动画。 |
MediaImage
封装 Image。
JSON 表示法 |
---|
{ "data": string, "fullSizeImageUrl": string, "previewSizeImageUrl": string } |
字段 | |
---|---|
data |
不可变。原始图片数据。 使用 base64 编码的字符串。 |
full |
仅限输出。指向图片全尺寸版本的网址。 |
preview |
仅限输出。图片的预览大小版本的网址。 |
MediaBundle
表示内容包含 HTML5 素材资源的 ZIP 归档媒体。
JSON 表示法 |
---|
{ "data": string, "url": string } |
字段 | |
---|---|
data |
不可变。压缩的原始数据。 使用 base64 编码的字符串。 |
url |
仅限输出。用于访问上传的压缩数据的网址。例如,https://tpc.googlesyndication.com/simgad/123。此字段为只读字段。 |
MediaAudio
封装音频。
JSON 表示法 |
---|
{ "adDurationMillis": string } |
字段 | |
---|---|
ad |
仅限输出。音频的时长(以毫秒为单位)。 |
MediaVideo
封装视频。
JSON 表示法 |
---|
{ "adDurationMillis": string, "youtubeVideoId": string, "advertisingIdCode": string, "isciCode": string } |
字段 | |
---|---|
ad |
仅限输出。视频的时长(以毫秒为单位)。 |
youtube |
不可变。YouTube 视频 ID(如 YouTube 网址中所示)。将前缀“https://www.youtube.com/watch?v=" 添加到此 ID 后,即可获得此视频的 YouTube 在线播放网址。 |
advertising |
仅限输出。此视频的广告数字标识代码,由美国广告代理协会定义,主要用于电视广告。 |
isci |
仅限输出。此视频的业界标准商业标识符代码,主要用于电视广告。 |
LocalServicesEmployee
本地生活服务员工资源。
JSON 表示法 |
---|
{ "resourceName": string, "creationDateTime": string, "status": enum ( |
字段 | |
---|---|
resource |
不可变。本地服务验证的资源名称。Local Services Verification 资源名称采用以下格式:
|
creation |
仅限输出。员工创建时间戳。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
status |
仅限输出。员工状态,例如“已删除”或“已启用”。 |
type |
仅限输出。员工类型。 |
university |
仅限输出。此员工已获得且希望展示的学位列表。 |
residencies[] |
仅限输出。员工完成住院培训的机构。 |
fellowships[] |
仅限输出。员工完成了哪些机构的奖学金项目。 |
languages |
仅限输出。员工所说的语言,表示为 https://developers.google.com/admin-sdk/directory/v1/languages 中的语言代码 |
category |
仅限输出。员工类别。如需查看本地生活服务类别 ID 列表,请访问 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids。 |
id |
仅限输出。员工的 ID。 |
job |
仅限输出。此员工的职位,例如法律行业中的“高级合伙人”。 |
year |
仅限输出。此员工开始从事此领域工作的年份。 |
national |
仅限输出。与员工关联的 NPI ID。 |
email |
仅限输出。员工的电子邮件地址。 |
first |
仅限输出。员工的名字。 |
middle |
仅限输出。员工的中间名字。 |
last |
仅限输出。员工的姓氏。 |
LocalServicesEmployeeStatus
用于描述本地生活服务员工状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
员工未被移除,且员工状态为有效。 |
REMOVED |
员工被移除。用于从商家中删除员工。 |
LocalServicesEmployeeType
用于描述本地生活服务员工类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BUSINESS_OWNER |
表示商家的所有者。 |
EMPLOYEE |
表示商家的员工。 |
UniversityDegree
此员工已获得且希望展示的学位列表。
JSON 表示法 |
---|
{ "institutionName": string, "degree": string, "graduationYear": integer } |
字段 | |
---|---|
institution |
仅限输出。获得学位的大学的名称。 |
degree |
仅限输出。所获学位的名称。 |
graduation |
仅限输出。毕业年份。 |
住所
有关员工医疗住院的详细信息。住院医师是高等医学教育的一个阶段,在该阶段,符合条件的医务专业人员在高级临床医生的监督下执业。
JSON 表示法 |
---|
{ "institutionName": string, "completionYear": integer } |
字段 | |
---|---|
institution |
仅限输出。完成住院工作的机构的名称。 |
completion |
仅限输出。完成年份。 |
团契
有关员工医学奖学金的详细信息。研究员是指专业人士在完成住院医师培训后接受的一段医学培训。
JSON 表示法 |
---|
{ "institutionName": string, "completionYear": integer } |
字段 | |
---|---|
institution |
仅限输出。完成该奖学金的机构的名称。 |
completion |
仅限输出。完成年份。 |
LocalServicesVerificationArtifact
本地服务验证资源。
JSON 表示法 |
---|
{ "resourceName": string, "creationDateTime": string, "status": enum ( |
字段 | |
---|---|
resource |
不可变。本地服务验证的资源名称。Local Services Verification 资源名称采用以下格式:
|
creation |
仅限输出。创建此验证工件时的时间戳。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
status |
仅限输出。验证工件的状态。 |
artifact |
仅限输出。验证工件的类型。 |
id |
仅限输出。验证工件的 ID。 |
联合字段 artifact_data 。验证信息的类型。artifact_data 只能是以下类型之一: |
|
background |
仅限输出。背景调查验证工件。 |
insurance |
仅限输出。保险验证工件。 |
license |
仅限输出。许可验证工件。 |
business |
仅限输出。工商登记核查验证工件。 |
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 } |
字段 | |
---|---|
case |
仅限输出。用于访问后台支持请求的网址。 |
final |
仅限输出。此背景调查案例结果的判定时间戳。格式为“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 ( |
字段 | |
---|---|
amount |
仅限输出。保险金额。此值以保险文件中所述币种的“微”为单位。 |
rejection |
仅限输出。保险单据的拒绝原因。 |
insurance |
仅限输出。包含上传的保险文件信息的只读字段。 |
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 } |
字段 | |
---|---|
document |
用于访问已上传的本地生活服务文档的网址。 |
LicenseVerificationArtifact
用于存储特定于本地服务许可的相关信息的 proto。
JSON 表示法 |
---|
{ "licenseType": string, "licenseNumber": string, "licenseeFirstName": string, "licenseeLastName": string, "rejectionReason": enum ( |
字段 | |
---|---|
license |
仅限输出。许可类型 / 名称。 |
license |
仅限输出。许可证号。 |
licensee |
仅限输出。许可人姓氏。 |
licensee |
仅限输出。许可人姓氏。 |
rejection |
仅限输出。许可遭拒原因。 |
license |
仅限输出。包含上传的许可证文档信息的只读字段。 |
LocalServicesLicenseRejectionReason
枚举,用于描述本地生活服务许可验证工件可能被拒的原因。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BUSINESS_NAME_MISMATCH |
商家名称与本地生活服务广告的商家名称不一致。 |
UNAUTHORIZED |
许可未经授权或已被撤消。 |
EXPIRED |
许可已过期。 |
POOR_QUALITY |
许可证质量较差 - 图片模糊不清、难以辨认等 |
UNVERIFIABLE |
由于图片不合法,因此无法验证许可。 |
WRONG_DOCUMENT_OR_ID |
执照不是请求的证件类型,或者包含无效的身份证件。 |
OTHER |
许可中存在未明确列出的其他缺陷。 |
BusinessRegistrationCheckVerificationArtifact
一个 proto,用于存储与本地生活服务商家注册核查相关的信息。
JSON 表示法 |
---|
{ "registrationType": enum ( |
字段 | |
---|---|
registration |
仅限输出。企业注册核查类型(编号、证件)。 |
check |
仅限输出。检查的 ID,例如 vat_tax_id,表示“增值税号”要求。 |
rejection |
仅限输出。注册证件遭拒原因。 |
联合字段 business_registration 。企业注册的注册信息。具体形式取决于不同国家/地区的要求,可能是以下任一形式。business_registration 只能是下列其中一项: |
|
registration |
仅限输出。用于存储商家由政府签发的号码的消息。 |
registration |
仅限输出。用于存储商家文档信息的消息。 |
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 ( |
字段 | |
---|---|
document |
仅限输出。包含上传的企业注册证件的相关信息的只读字段。 |
MobileAppCategoryConstant
移动应用类别常量。
JSON 表示法 |
---|
{ "resourceName": string, "id": integer, "name": string } |
字段 | |
---|---|
resource |
仅限输出。移动应用类别常量的资源名称。移动应用类别常量资源名称的格式为:
|
id |
仅限输出。移动应用类别常量的 ID。 |
name |
仅限输出。移动应用类别名称。 |
MobileDeviceConstant
移动设备常量。
JSON 表示法 |
---|
{
"resourceName": string,
"type": enum ( |
字段 | |
---|---|
resource |
仅限输出。移动设备常量的资源名称。移动设备常量资源名称采用以下格式:
|
type |
仅限输出。移动设备的类型。 |
id |
仅限输出。移动设备常量的 ID。 |
name |
仅限输出。移动设备的名称。 |
manufacturer |
仅限输出。移动设备的制造商。 |
operating |
仅限输出。移动设备的操作系统。 |
MobileDeviceType
移动设备的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MOBILE |
手机。 |
TABLET |
平板电脑。 |
OfflineConversionUploadClientSummary
客户级别的线下转化数据上传摘要。
JSON 表示法 |
---|
{ "resourceName": string, "client": enum ( |
字段 | |
---|---|
resource |
仅限输出。客户级别的线下转化数据上传摘要的资源名称。线下转化数据上传客户摘要资源名称采用以下格式:
|
client |
仅限输出。上传事件的客户端类型。 |
status |
仅限输出。线下转化客户摘要的整体状态。状态是根据包含上传统计数据的最近日历日生成的。 |
total |
仅限输出。上传的事件总数。 |
successful |
仅限输出。成功上传的事件总数。 |
success |
仅限输出。成功率。 |
last |
仅限输出。最近一次上传批次的日期。格式为“yyyy-mm-dd hh:mm:ss”,并采用 Google Ads 账号的时区。 |
daily |
仅限输出。过去 N 天的历史统计数据摘要。 |
job |
仅限输出。按过去 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 |
字段 | |
---|---|
successful |
仅限输出。成功事件的总数。 |
failed |
仅限输出。失败事件的总数。 |
联合字段 dimension_key 。摘要的维度键。dimension_key 只能是下列其中一项: |
|
job |
仅限输出。最后 N 个作业的维度键。 |
upload |
仅限输出。过去 N 天的维度键。 |
OfflineConversionAlert
线下转化客户摘要的提醒。
JSON 表示法 |
---|
{
"error": {
object ( |
字段 | |
---|---|
error |
仅限输出。线下转化客户提醒出错。 |
error |
仅限输出。错误百分比,此字段的范围应为 [0, 1.0]。 |
OfflineConversionError
线下转化客户端摘要可能出现的错误。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 error_code 。说明有误。error_code 只能是下列其中一项: |
|
collection |
仅限输出。集合大小错误。 |
conversion |
仅限输出。转化调整上传出错。 |
conversion |
仅限输出。转化数据上传出错。 |
date |
仅限输出。日期错误。 |
distinct |
仅限输出。不重复错误。 |
field |
仅限输出。字段错误。 |
mutate |
仅限输出。出现 Mutate 错误。 |
not |
仅限输出。未列入许可名单错误。 |
string |
仅限输出。字符串格式错误。 |
string |
仅限输出。字符串长度错误。 |
CollectionSizeError
用于描述可能的集合大小错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
TOO_FEW |
太少了。 |
TOO_MANY |
太多了。 |
ConversionAdjustmentUploadError
用于描述可能出现的转化调整上传错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
TOO_RECENT_CONVERSION_ACTION |
无法将事件导入刚刚创建的转化操作。请在 6 小时后再次尝试导入。 |
CONVERSION_ALREADY_RETRACTED |
转化已撤消。此调整未得到处理。 |
CONVERSION_NOT_FOUND |
找不到此转化操作和转化标识符对应的转化数据。请确保您的转化标识符与正确的转化操作相关联,然后重试。 |
CONVERSION_EXPIRED |
无法对早于 54 天前发生的转化进行调整。 |
ADJUSTMENT_PRECEDES_CONVERSION |
调整的 adjustmentDateTime 发生在关联的转化之前。请确保您的 adjustmentDateTime 正确无误,然后重试。 |
MORE_RECENT_RESTATEMENT_FOUND |
已为关联的转化报告了更近期的调整 adjustmentDateTime 。请确保您的调整 adjustmentDateTime 正确无误,然后重试。 |
TOO_RECENT_CONVERSION |
由于转化时间过近,因此无法记录调整项。请尝试调整至少 24 小时前发生的转化。 |
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE |
无法对设置为使用默认价值的转化进行调整。请检查您的转化操作价值设置,然后重试。 |
TOO_MANY_ADJUSTMENTS_IN_REQUEST |
请尝试在单个 API 请求中上传少于 2,001 个调整项。 |
TOO_MANY_ADJUSTMENTS |
转化已调整到次数上限。请确保您仅对现有转化做出必要的调整。 |
RESTATEMENT_ALREADY_EXISTS |
转化先前已有相同 adjustmentDateTime 的重报。请确保调整项的 adjustmentDateTime 正确无误且唯一,然后重试。 |
DUPLICATE_ADJUSTMENT_IN_REQUEST |
导入的调整项包含具有相同 adjustmentDateTime 的重复转化调整项。请确保您的调整项具有正确的 adjustmentDateTime ,然后重试。 |
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS |
请确保您已在转化设置中同意客户数据处理条款,然后重试。 |
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT |
无法将增强型转化与指定的转化操作搭配使用。 |
INVALID_USER_IDENTIFIER |
请务必使用 SHA-256 算法对用户提供的数据进行哈希处理,并确保您已按照相关准则进行规范化处理。 |
UNSUPPORTED_USER_IDENTIFIER |
使用使用 SHA-256 算法对用户提供的数据(例如电子邮件地址或电话号码)进行哈希处理,然后重试。 |
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET |
不能同时设置 gclidDateTimePair 和 orderId。请仅使用其中一种类型,然后重试。 |
CONVERSION_ALREADY_ENHANCED |
增强型转化已经包含相同订单 ID 和转化操作。请确保您的数据配置正确无误,然后重试。 |
DUPLICATE_ENHANCEMENT_IN_REQUEST |
多项增强功能具有相同的转化操作和订单 ID。请确保您的数据配置正确无误,然后重试。 |
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT |
由于 Google 客户数据政策,此账号无法使用增强型转化。请与您的 Google 代表联系。 |
MISSING_ORDER_ID_FOR_WEBPAGE |
调整网站转化需要提供订单 ID(即交易 ID)。请确保您的网站代码能够获取订单 ID,并且您在进行调整时发送相同的订单 ID。 |
ORDER_ID_CONTAINS_PII |
无法对包含个人身份信息 (PII) 的订单 ID 使用调整。 |
INVALID_JOB_ID |
请求中提供的职位 ID 不在允许范围内。作业 ID 必须是 [1, 2^31] 这个范围内的正整数。 |
NO_CONVERSION_ACTION_FOUND |
找不到调整请求中指定的转化操作。请确保该转化操作可在此账号中使用。 |
INVALID_CONVERSION_ACTION_TYPE |
调整请求中指定的转化操作类型不支持上传调整项。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 |
请确保您已在转化设置中同意客户数据处理条款,然后重试。您可以通过对 Customer 查询 conversionTrackingSetting.accepted_customer_data_terms 来检查您的设置。 |
ORDER_ID_CONTAINS_PII |
事件的订单 ID 包含个人身份信息 (PII),因此无法导入。 |
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS |
请确保您已在转化设置中启用增强型潜在客户转化,然后重试。您可以通过查询“客户”中的 conversionTrackingSetting.enhanced_conversions_for_leads_enabled 来检查您的设置。 |
INVALID_JOB_ID |
请求中提供的职位 ID 不在允许范围内。作业 ID 必须是 [1, 2^31] 这个范围内的正整数。 |
NO_CONVERSION_ACTION_FOUND |
找不到上传请求中指定的转化操作。请确保该转化操作可在此账号中使用。 |
INVALID_CONVERSION_ACTION_TYPE |
上传请求中指定的转化操作未设置为上传相应转化数据。 |
DateError
用于描述可能的日期错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
INVALID_FIELD_VALUES_IN_DATE |
指定的字段值与有效日期不符。 |
INVALID_FIELD_VALUES_IN_DATE_TIME |
指定的字段值不对应于有效的日期时间。 |
INVALID_STRING_DATE |
字符串日期的格式应为 yyyy-mm-dd。 |
INVALID_STRING_DATE_TIME_MICROS |
字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss.ssssss。 |
INVALID_STRING_DATE_TIME_SECONDS |
字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss。 |
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET |
字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss+|-hh:mm。 |
EARLIER_THAN_MINIMUM_DATE |
日期早于允许的最早日期。 |
LATER_THAN_MAXIMUM_DATE |
日期晚于允许的最晚日期。 |
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE |
构成日期范围的下限日期晚于相应的上限日期。 |
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL |
构成日期范围的上限与下限日期都为 Null。 |
DistinctError
用于描述可能的不同错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
DUPLICATE_ELEMENT |
元素重复。 |
DUPLICATE_TYPE |
重复类型。 |
FieldError
用于描述可能的字段错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
REQUIRED |
缺少必填字段。 |
IMMUTABLE_FIELD |
尝试进行更改的字段是不可变的。 |
INVALID_VALUE |
该字段的值无效。 |
VALUE_MUST_BE_UNSET |
无法设置该字段。 |
REQUIRED_NONEMPTY_LIST |
必填的重复字段为空。 |
FIELD_CANNOT_BE_CLEARED |
此字段无法清除。 |
BLOCKED_VALUE |
字段的值在此字段的拒绝列表中。 |
FIELD_CAN_ONLY_BE_CLEARED |
除清除外,无法修改此字段的值。 |
MutateError
用于描述可能的更改错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
RESOURCE_NOT_FOUND |
找不到所请求的资源。 |
ID_EXISTS_IN_MULTIPLE_MUTATES |
在一个请求中,不能对同一资源进行两次更改。 |
INCONSISTENT_FIELD_VALUES |
字段的内容与表示相同数据的另一个字段不匹配。 |
MUTATE_NOT_ALLOWED |
不允许对请求的资源进行更改。 |
RESOURCE_NOT_IN_GOOGLE_ADS |
资源不在 Google Ads 中。它属于其他广告系统。 |
RESOURCE_ALREADY_EXISTS |
要创建的资源已存在。 |
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY |
此资源不能与“validateOnly”搭配使用。 |
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE |
此操作不能与“partialFailure”搭配使用。 |
RESOURCE_READ_ONLY |
尝试写入只读字段。 |
NotAllowlistedError
用于描述可能未列入许可名单的错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE |
客户未列入可使用该功能的许可名单。 |
StringFormatError
用于描述可能的字符串格式错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
ILLEGAL_CHARS |
输入字符串值包含不允许使用的字符。 |
INVALID_FORMAT |
关联字段的输入字符串值无效。 |
StringLengthError
用于描述可能的字符串长度错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
EMPTY |
指定的字段应包含至少一个非空白字符。 |
TOO_SHORT |
太短。 |
TOO_LONG |
过长。 |
OperatingSystemVersionConstant
移动操作系统版本或版本范围,具体取决于 operatorType
。可用移动平台列表:https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
JSON 表示法 |
---|
{
"resourceName": string,
"operatorType": enum ( |
字段 | |
---|---|
resource |
仅限输出。操作系统版本常量的资源名称。操作系统版本常量资源名称采用以下形式:
|
operator |
仅限输出。确定此常量是代表单个版本还是版本范围。 |
id |
仅限输出。操作系统版本的 ID。 |
name |
仅限输出。操作系统的名称。 |
os |
仅限输出。操作系统主要版本号。 |
os |
仅限输出。操作系统次要版本号。 |
OperatingSystemVersionOperatorType
操作系统版本的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
EQUALS_TO |
等于指定的版本。 |
GREATER_THAN_EQUALS_TO |
大于或等于指定的版本。 |
PaidOrganicSearchTermView
“付费自然搜索字词”视图会按广告组级别汇总广告和自然搜索结果的搜索统计信息,以便您一目了然。
JSON 表示法 |
---|
{ "resourceName": string, "searchTerm": string } |
字段 | |
---|---|
resource |
仅限输出。搜索字词视图的资源名称。搜索字词视图资源名称采用以下格式:
|
search |
仅限输出。搜索字词。 |
QualifyingQuestion
潜在客户表单的甄别问题。
JSON 表示法 |
---|
{ "resourceName": string, "qualifyingQuestionId": string, "locale": string, "text": string } |
字段 | |
---|---|
resource |
仅限输出。限定问题的资源名称。 'qualifyingQuestions/{qualifyingQuestionId}' |
qualifying |
仅限输出。甄别问题的 ID。 |
locale |
仅限输出。甄别问题的语言区域。 |
text |
仅限输出。甄别问题。 |
ParentalStatusView
育儿状况视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。家长控制状态视图的资源名称。家长控制状态视图资源名称的格式为:
|
PerStoreView
按商店的视图。此视图可为广告客户提供按商店划分的展示次数覆盖面和本地操作转化统计信息。
JSON 表示法 |
---|
{ "resourceName": string, "placeId": string } |
字段 | |
---|---|
resource |
仅限输出。按实体店视图的资源名称。每家商店视图资源名称的格式如下:
|
place |
仅限输出。按实体店查看时所需的地点 ID。 |
ProductCategoryConstant
商品类别。
JSON 表示法 |
---|
{ "resourceName": string, "categoryId": string, "level": enum ( |
字段 | |
---|---|
resource |
仅限输出。商品类别的资源名称。商品类别资源名称采用以下格式:
|
category |
仅限输出。商品类别的 ID。 此 ID 相当于本文中所述的 google_product_category ID:https://support.google.com/merchants/answer/6324436。 |
level |
仅限输出。商品类别的级别。 |
state |
仅限输出。商品类别的状态。 |
localizations[] |
仅限输出。商品类别的所有可用本地化版本的列表。 |
product |
仅限输出。父级商品类别的资源名称。 |
ProductCategoryState
用于描述商品类别状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
相应类别已启用。 |
OBSOLETE |
此类别已过时。仅用于生成报告。 |
ProductCategoryLocalization
商品类别的本地化。
JSON 表示法 |
---|
{ "regionCode": string, "languageCode": string, "value": string } |
字段 | |
---|---|
region |
仅限输出。本地化类别的 ISO 3166-1 国家/地区代码(两个字母,采用大写形式)。 |
language |
仅限输出。本地化类别的 ISO 639-1 双字母语言代码。 |
value |
仅限输出。指定语言区域中的类别名称。 |
ProductGroupView
产品组视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。商品组视图的资源名称。产品组视图资源名称采用以下格式:
|
SearchTermView
搜索字词视图,其中包含按搜索字词在广告组一级汇总的指标。
JSON 表示法 |
---|
{
"resourceName": string,
"status": enum ( |
字段 | |
---|---|
resource |
仅限输出。搜索字词视图的资源名称。搜索字词视图资源名称采用以下格式:
|
status |
仅限输出。指示搜索字词目前是定位关键字还是排除关键字。 |
search |
仅限输出。搜索字词。 |
ad |
仅限输出。搜索字词投放到的广告组。 |
SearchTermTargetingStatus
指示搜索字词是您的定位关键字还是排除关键字。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ADDED |
搜索字词会添加到指定关键字中。 |
EXCLUDED |
搜索字词与否定关键字匹配。 |
ADDED_EXCLUDED |
搜索字词已同时添加和排除。 |
NONE |
搜索字词既未定位到,也未排除。 |
ShoppingPerformanceView
购物广告效果视图。提供按多个产品维度级别汇总的购物广告系列统计信息。Merchant Center 中的商品维度值(例如品牌、类别、自定义属性、商品状况和商品类型)将反映相应事件记录的日期和时间各个维度的状态。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。购物广告效果视图的资源名称。购物广告效果视图资源名称采用以下格式: |
SmartCampaignSearchTermView
智能广告系列的搜索字词视图。
JSON 表示法 |
---|
{ "resourceName": string, "searchTerm": string, "campaign": string } |
字段 | |
---|---|
resource |
仅限输出。智能广告系列搜索字词视图的资源名称。智能型广告系列搜索字词视图资源名称采用以下格式:
|
search |
仅限输出。搜索字词。 |
campaign |
仅限输出。投放搜索字词的智能广告系列。 |
ThirdPartyAppAnalyticsLink
一种数据共享关联,可将第三方应用分析数据导入 Google Ads 客户账号。
JSON 表示法 |
---|
{ "resourceName": string, "shareableLinkId": string } |
字段 | |
---|---|
resource |
不可变。第三方应用分析工具关联的资源名称。第三方应用分析关联资源名称的格式如下:
|
shareable |
仅限输出。设置应用分析时应向第三方提供的可共享关联 ID。您可以使用 ThirdPartyAppAnalyticsLinkService 中的 regenerate 方法重新生成此 ID。 |
TopicView
主题视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。主题视图的资源名称。主题视图资源名称采用以下格式:
|
TravelActivityGroupView
旅行活动组视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。旅行活动组视图的资源名称。旅游活动组视图资源名称采用以下格式:
|
TravelActivityPerformanceView
旅行活动效果视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。旅行活动效果视图的资源名称。旅行活动效果视图资源名称的格式为:
|
UserInterest
用户兴趣:要定位到的特定兴趣细分行业。
JSON 表示法 |
---|
{ "resourceName": string, "taxonomyType": enum ( |
字段 | |
---|---|
resource |
仅限输出。用户兴趣的资源名称。用户兴趣资源名称的格式为:
|
taxonomy |
仅限输出。用户兴趣的类目类型。 |
availabilities[] |
仅限输出。用户兴趣的空闲时间信息。 |
user |
仅限输出。用户兴趣的 ID。 |
name |
仅限输出。用户兴趣的名称。 |
user |
仅限输出。用户兴趣的父级。 |
launched |
仅限输出。如果用户兴趣面向所有渠道和语言区域发布,则为 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 ( |
字段 | |
---|---|
resource |
仅限输出。人生大事的资源名称。生命事件资源名称的格式为:
|
id |
仅限输出。人生大事的 ID。 |
name |
仅限输出。人生大事的名称,例如“最近搬家” |
parent |
仅限输出。lifeEvent 的父级。 |
launched |
仅限输出。如果直播活动面向所有频道和语言区域发布,则为 true。 |
availabilities[] |
仅限输出。人生大事的可用性信息。 |
UserLocationView
用户位置信息视图。
“用户所在位置”视图包含在国家/地区一级汇总的所有指标,每个国家/地区一行。它会按定位到或未定位到的位置报告用户实际所处位置的指标。如果使用其他细分受众群字段,则每个国家/地区可能会有多个行。
JSON 表示法 |
---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
字段 | |
---|---|
resource |
仅限输出。用户位置信息视图的资源名称。UserLocation 视图资源名称采用以下格式:
|
country |
仅限输出。国家/地区的条件 ID。 |
targeting |
仅限输出。指明是否定位到地理位置。 |
TopicConstant
您可以使用主题,根据展示位置所属的类别(例如“宠物和动物/宠物/狗”)来定位或排除 Google 展示广告网络中的展示位置。
JSON 表示法 |
---|
{ "resourceName": string, "path": [ string ], "id": string, "topicConstantParent": string } |
字段 | |
---|---|
resource |
仅限输出。主题常量的资源名称。主题常量资源名称的格式为:
|
path[] |
仅限输出。要定位或排除的类别。数组中的每个后续元素都描述了更具体的子类别。例如,{"Pets & Animals", "Pets", "Dogs"} 表示“宠物与动物/宠物/狗”类别。可用主题类别列表:https://developers.google.com/google-ads/api/reference/data/verticals |
id |
仅限输出。主题的 ID。 |
topic |
仅限输出。主题常量的父级资源名称。 |
视频
视频。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "channelId": string, "durationMillis": string, "title": string } |
字段 | |
---|---|
resource |
仅限输出。视频的资源名称。视频资源名称的格式为:
|
id |
仅限输出。视频的 ID。 |
channel |
仅限输出。视频的所有者频道 ID。 |
duration |
仅限输出。视频的时长(以毫秒为单位)。 |
title |
仅限输出。视频的标题。 |
WebpageView
网页浏览。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
仅限输出。网页视图的资源名称。网页视图资源名称采用以下格式:
|
LeadFormSubmissionData
潜在客户表单提交数据。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "asset": string, "campaign": string, "leadFormSubmissionFields": [ { object ( |
字段 | |
---|---|
resource |
仅限输出。潜在客户表单提交数据的资源名称。潜在客户表单提交数据资源名称采用以下格式:
|
id |
仅限输出。此潜在客户表单提交内容的 ID。 |
asset |
仅限输出。与提交的潜在客户表单相关联的素材资源。 |
campaign |
仅限输出。与提交的潜在客户表单相关联的广告系列。 |
lead |
仅限输出。与潜在客户表单相关联的提交数据。 |
custom |
仅限输出。与自定义潜在客户表单关联的提交数据。 |
ad |
仅限输出。与提交的潜在客户表单关联的广告组。 |
ad |
仅限输出。与提交的潜在客户表单相关联的 AdGroupAd。 |
gclid |
仅限输出。与未填写的潜在客户表单相关联的 Google 点击 ID。 |
submission |
仅限输出。潜在客户表单的提交日期和时间。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |
LeadFormSubmissionField
提交的潜在客户表单中的字段。
JSON 表示法 |
---|
{
"fieldType": enum ( |
字段 | |
---|---|
field |
仅限输出。潜在客户表单字段的字段类型。 |
field |
仅限输出。潜在客户表单字段的字段值。 |
CustomLeadFormSubmissionField
提交的自定义问题中的字段
JSON 表示法 |
---|
{ "questionText": string, "fieldValue": string } |
字段 | |
---|---|
question |
仅限输出。自定义题目的题目文本,字符数上限为 300。 |
field |
仅限输出。自定义问题回答的字段值,字符数上限为 70。 |
LocalServicesLead
来自本地生活服务潜在客户的数据。包含潜在客户的详细信息。潜在客户是在用户向广告客户致电、发送消息或预约服务时生成的。了解详情:https://ads.google.com/local-services-ads
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "categoryId": string, "serviceId": string, "contactDetails": { object ( |
字段 | |
---|---|
resource |
仅限输出。本地服务潜在客户数据的资源名称。本地生活服务潜在客户资源名称的格式为
|
id |
仅限输出。此潜在客户的 ID。 |
category |
仅限输出。潜在客户的服务类别。例如: |
service |
仅限输出。相应类别的服务。例如: |
contact |
仅限输出。潜在客户的详细联系信息。 |
lead |
仅限输出。本地生活服务潜在客户的类型:来电、短信、预约等 |
lead |
仅限输出。潜在客户的当前状态。 |
creation |
仅限输出。本地生活服务广告创建潜在客户的日期时间。格式为“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 |
lead |
仅限输出。如果广告客户为潜在客户支付了费用,则为 true。 |
note |
仅限输出。广告客户为潜在客户添加的备注。 |
credit |
仅限输出。潜在客户的赠金详情。 |
ContactDetails
包含消费者详细联系信息的字段。
JSON 表示法 |
---|
{ "phoneNumber": string, "email": string, "consumerName": string } |
字段 | |
---|---|
phone |
仅限输出。采用 E.164 格式的消费者电话号码。 |
email |
仅限输出。消费者的电子邮件地址。 |
consumer |
仅限输出。如果消费者在 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 } |
字段 | |
---|---|
edit |
仅限输出。潜在客户备注的修改日期时间。格式为“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 ( |
字段 | |
---|---|
credit |
仅限输出。潜在客户的信用状态。 |
credit |
仅限输出。潜在客户的信用状态上次更新的日期时间。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
CreditState
潜在客户的可能功劳状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
PENDING |
赠送金额已提交,正在由 Google Ads 后端处理,但尚未应用于账号。 |
CREDITED |
赠金已发放至 Google Ads 账号。 |
LocalServicesLeadConversation
来自本地生活服务潜在客户对话的数据。包含潜在客户对话的详细信息,这些信息是在用户向广告客户致电、发送消息或预约服务时生成的。这些信息会附加到潜在客户中。了解详情:https://ads.google.com/local-services-ads
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "conversationChannel": enum ( |
字段 | |
---|---|
resource |
仅限输出。本地生活服务潜在客户对话数据的资源名称。本地生活服务潜在客户对话资源名称采用以下格式
|
id |
仅限输出。此潜在客户对话的 ID。 |
conversation |
仅限输出。GLS 潜在客户对话类型,例如 EMAIL、MESSAGE、PHONE_CALL、SMS 等 |
participant |
仅限输出。潜在对话中的参与者类型,即广告客户或消费者。 |
lead |
仅限输出。与潜在客户对话关联的潜在客户的资源名称。 |
event |
仅限输出。本地生活服务广告创建潜在客户对话的日期时间。格式为“YYYY-MM-DD HH:MM:SS”,采用 Google Ads 账号所在时区。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
phone |
仅限输出。如果是 PHONE_CALL,则包含通话对话的详细信息。 |
message |
仅限输出。如果是电子邮件、消息或短信,请提供消息对话的详细信息。 |
ConversationType
可能的潜在客户对话类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
EMAIL |
电子邮件潜在客户对话。 |
MESSAGE |
短信咨询的潜在客户对话。 |
PHONE_CALL |
来电潜在客户对话。 |
SMS |
短信潜在客户对话。 |
BOOKING |
预约潜在客户对话。 |
ParticipantType
主要对话参与者的可能类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ADVERTISER |
本地生活服务广告提供商参与者。 |
CONSUMER |
本地生活服务广告消费者参与者。 |
PhoneCallDetails
表示通话对话的详细信息。
JSON 表示法 |
---|
{ "callDurationMillis": string, "callRecordingUrl": string } |
字段 | |
---|---|
call |
仅限输出。通话时长(端到端,以毫秒为单位)。 |
call |
仅限输出。通话录音音频文件的网址。 |
MessageDetails
表示电子邮件、消息或短信的文本消息详情。
JSON 表示法 |
---|
{ "text": string, "attachmentUrls": [ string ] } |
字段 | |
---|---|
text |
仅限输出。消息的文本内容。 |
attachment |
仅限输出。短信或电子邮件附件的网址。您可以使用开发者令牌通过这些网址下载附件的相应内容。 |
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 ( |
字段 | |
---|---|
all |
所有转化的价值。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
all |
转化总次数。包括所有转化,无论 includeInConversionsMetric 的值如何。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
conversions |
转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
conversions |
转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
historical |
广告素材的历史质量得分。 |
historical |
历史着陆页体验的质量。 |
historical |
历史搜索的预测点击率 (CTR)。 |
interaction |
付费和免费互动的类型。 |
sk |
iOS Store Kit 广告联盟转化次数。 |
sk |
iOS Store Kit 广告联盟转化的总次数。 |
publisher |
来自并非由发布商所拥有的媒体资源的点击,其流量是由发布商付费或通过奖励活动获得的 |
publisher |
来自媒体资源的点击,其流量不是由发布商付费或通过奖励活动获得的 |
publisher |
来自未被标识为“发布商购买”或“发布商自然”的流量的点击 |
absolute |
“搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。 |
active |
可见展示的平均费用 ( |
active |
Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 |
active |
衡量广告在展示广告网络网站上的可见频率。 |
active |
Active View 可衡量的展示次数与投放展示次数之比。 |
active |
Active View 可衡量的您获得的展示费用。 |
active |
广告出现在可见位置中的展示位置的次数。 |
active |
广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 |
all |
互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 |
all |
所有转化的值。 |
all |
所有新客户的生命周期转化价值。如果您在账号一级或广告系列一级设置了“新客户获取”目标,则此指标将包括可出价和不可出价转化带来的新客户额外转化价值。如果您的广告系列采用了“客户获取”目标,并选择了“针对新客户提高出价”,则这些价值将包含在“allConversionsValue”中。如需了解详情,请参阅 https://support.google.com/google-ads/answer/12080169。 |
all |
转化总次数。包括所有转化,无论 includeInConversionsMetric 的值如何。 |
all |
所有转化的价值除以广告互动(例如文字广告的点击次数或视频广告的观看次数)的总费用。 |
all |
用户在广告展示过程中或点击广告后,点击“致电”按钮向相应实体店致电的次数。此数值不考虑致电是否接通,也不考虑通话时长。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后,点击“查询路线”按钮导航到相应实体店的次数。 此指标仅适用于 Feed 项。 |
all |
互动带来的所有转化价值除以互动总次数。 |
all |
用户在点击广告后,点击链接查看相应实体店的菜单的次数。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后,在相应商店下单的次数。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后发生的其他转化(例如,发布对商店的评价或保存该商店的地理位置)的次数。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后光顾相应商店的次数估算值。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后,转到相应商店网址的次数。 此指标仅适用于 Feed 项。 |
auction |
此指标属于“竞价分析”报告的一部分,用于显示其他参与者的广告在搜索结果页上最醒目的位置展示的频率。此百分比仅根据您在网页中展示的竞价计算得出。 此指标不公开。 |
auction |
此指标属于“竞价分析”报告的一部分,表示其他参与者获得的展示次数占您广告有资格获得的总展示次数的百分比。任何低于 0.1 的值都会报告为 0.0999。 此指标不公开。 |
auction |
此指标属于“竞价分析”报告的一部分,表示您的广告在竞价中胜过(展示在)其他参与者的广告的展示次数占您广告有资格获得的总展示次数的百分比。任何低于 0.1 的值都会报告为 0.0999。 此指标不公开。 |
auction |
此指标属于“竞价分析”报告,用于反映在您的广告获得展示机会的同时,其他参与者的广告也获得展示机会的频率。 此指标不公开。 |
auction |
此指标是竞价分析报告的一部分,用于显示当您与其他参与者的广告同时在同一网页上展示时,该参与者的广告在排名上高过您的频率。 此指标不公开。 |
auction |
此指标属于“竞价分析”报告的一部分,用于显示其他参与者的广告在顶部自然搜索结果邻近位置展示的频率。此百分比仅根据您在网页中展示的竞价计算得出。 此指标不公开。 |
average |
您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。 |
average |
所有点击总费用除以获得的总点击次数。 |
average |
您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 |
average |
平均每千次展示费用 (CPM)。 |
average |
每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 |
average |
每个会话浏览网页的平均次数。 |
average |
所有会话的总时长(以秒为单位)/会话数。自 Google Analytics 导入。 |
benchmark |
显示其他广告客户对类似商品的出价情况。 |
biddable |
应用安装次数。 |
biddable |
应用内操作次数。 |
benchmark |
一种指标,用于衡量其他广告客户针对类似商品投放的购物广告的效果,具体依据是看到广告的用户点击广告的频率。 |
bounce |
用户只访问了网站上的单个网页时使用的点击次数所占百分比。自 Google Analytics 导入。 |
clicks |
点击次数。 |
combined |
您的广告或网站的商品详情在未付费结果中的点击次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 |
combined |
您的广告或网站的商品详情在未付费结果中的点击次数 (combinedClicks) 除以 combinedQueries。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 |
combined |
在未付费结果中返回您的网站的网页或展示一个文字广告的搜索次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 |
content |
您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意:内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
content |
您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
conversion |
此转化操作的转化跟踪代码上次成功触发并被 Google Ads 检测到的时间。此触发事件可能不是可归因转化的结果(例如,因为代码是从之前未点击相应广告客户的广告的浏览器触发的)。日期/时间采用客户的时区。 |
conversion |
此转化操作的最近一次转化日期。日期采用客户所在的时区。 |
content |
您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
conversions |
互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversions |
转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
new |
新客户的生命周期转化价值。如果您在账号一级或广告系列一级设置了客户获取目标,则此指标将包含可出价转化带来的新客户的额外转化价值。如果您的广告系列采用了“客户获取”目标,并选择了“针对新客户提高出价”,系统会将这些价值纳入“conversionsValue”中进行优化。如需了解详情,请参阅 https://support.google.com/google-ads/answer/12080169。 |
conversions |
转化价值除以广告互动费用。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversions |
互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversions |
转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
cost |
在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
cost |
广告互动费用除以所有转化次数。 |
cost |
广告互动费用除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
cost |
广告互动费用除以当前模型归因转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
cross |
客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 allConversions 中。 |
cross |
跨设备转化的价值的总和(以微单位表示)。 |
ctr |
广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
current |
显示历史转化数据在您目前选择的归因模型下的情况。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
current |
当前模型归因的互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
current |
当前模型归因的互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
current |
当前模型归因转化的价值。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
current |
当前模型归因转化的价值除以广告互动费用。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
engagement |
在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 |
engagements |
深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 |
hotel |
基于点击次数计算的平均潜在客户价值。 |
hotel |
佣金出价率(以微单位表示)。20% 的佣金表示为 200,000。 |
hotel |
预计佣金费用。佣金金额乘以广告客户币种的 hotel_commission_rate 的结果。 |
hotel |
举报酒店广告客户提供的价格与竞争广告客户提供的最低价格之间的平均差价。 |
hotel |
酒店合作伙伴本可获得的展示次数(根据其 Feed 效果)。 |
historical |
历史质量得分。 |
gmail |
广告以邮件形式转发给其他人的次数。 |
gmail |
某人将 Gmail 广告以邮件形式保存到收件箱的次数。 |
gmail |
Gmail 广告展开状态下的着陆页点击次数。 |
impressions |
商店特定营业点的广告所展示的次数。 此指标仅适用于 Feed 项。 |
impressions |
广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
interaction |
在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 |
interactions |
互动次数。互动是指与某种广告格式关联的主用户操作:对于文字广告和购物广告而言是点击,对于视频广告而言是观看,诸如此类。 |
invalid |
报告期内从总点击次数(过滤后 + 未过滤的点击次数)过滤出的点击次数所占的百分比。 |
invalid |
Google 认为不合规定且不向您收费的点击次数。 |
message |
针对符合消息跟踪条件的“点击即可发消息”展示次数发起的消息聊天数量。 |
message |
符合消息跟踪条件的“点击即可发消息”展示次数。 |
message |
发起的消息聊天次数 (messageChats) 除以消息展示次数 (messageImpressions)。在启用了消息功能和消息跟踪的广告展示中,用户发起消息聊天所占的比率。请注意,给定消息展示的点击率可能高于 1.0。 |
mobile |
适合移动设备的页面的移动点击次数所占的百分比。 |
optimization |
采纳所有建议后的优化得分总提升幅度。 |
optimization |
Google Ads 网页界面中优化得分页面的网址。此指标可从 |
organic |
某人针对特定查询点击未付费结果中您的网站的商品详情的次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 |
organic |
某人点击未付费结果中您网站的商品详情的次数 (organicClicks) 除以返回您网站的网页的总搜索次数 (organicQueries)。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 |
organic |
未付费搜索结果中您的网站的商品详情数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 |
organic |
您的网站的网页在未付费搜索结果中列出的次数 (organicImpressions) 除以在未付费结果中返回您的网站的商品详情的搜索次数 (organicQueries)。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 |
organic |
在未付费结果中返回您的网站的商品详情的总搜索次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 |
percent |
首次会话数(来自之前从未访问过您的网站的用户)所占的百分比。自 Google Analytics 导入。 |
phone |
离线通话次数。 |
phone |
离线电话号码展示次数。 |
phone |
接听的电话次数 (phoneCalls) 除以电话号码展示次数 (phoneImpressions)。 |
relative |
您的点击率 (Ctr) 除以展示您的广告的网站上所有广告主的平均点击率。衡量您的广告与同一网站上的其他广告相比在展示广告网络中的效果。 |
search |
在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请参阅 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。 |
search |
此数字用于估算您的广告因预算不足而未能在搜索结果中的页首广告中作为头条广告进行展示的频率。注意:搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
search |
您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
search |
此数字用于估算您的广告因预算低而未能在顶部自然搜索结果邻近位置展示的频率。注意:搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
search |
您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意:搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
search |
对于与关键字完全匹配(或是关键字的紧密变体形式)的搜索字词,此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意:搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
search |
您在搜索网络中获得的展示次数除以您有资格获得的估算展示次数。注意:在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
search |
此数字用于估算您的广告因广告评级较低而未能在搜索结果中的页首广告中作为头条广告进行展示的频率。注意:搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
search |
您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
search |
此数字用于估算您的广告因广告评级差而未能在顶部自然搜索结果邻近位置展示的频率。注意:搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
search |
您在页首广告中实际获得的展示次数除以您有资格获得的估算展示次数所得到的百分比。注意:搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 页首广告通常展示在顶部自然搜索结果上方,但在某些查询中,页首广告可能会展示在顶部自然搜索结果下方。 |
search |
搜索字词数据分析类别的搜索量范围。 |
speed |
衡量点击移动广告后网页加载的速度。得分范围介于 1 到 10 之间,10 是最快的。 |
average |
平均目标每次转化费用,如果不可用则不设置(例如,对于获得了组合出价策略或非目标每次转化费用出价策略带来的流量的广告系列)。 |
average |
平均目标广告支出回报率,如果不适用,则不设置(例如,对于获得了组合出价策略或非目标广告支出回报率出价策略带来的流量的广告系列)。 |
top |
广告在邻近顶部自然搜索结果的位置展示的次数所占百分比。 |
valid |
到达有效 AMP 网页的 Accelerated Mobile Pages (AMP) 着陆页的广告点击次数所占百分比。 |
value |
所有转化的价值除以所有转化的次数。 |
value |
所有转化的价值除以所有转化的次数。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
value |
转化价值除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
value |
转化价值除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/google-ads/answer/9549009。 |
value |
当前模型归因转化的价值除以转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
video |
观看者观看了您的所有视频时使用的展示次数所占百分比。 |
video |
观看者观看了 25% 的视频时使用的展示次数所占百分比。 |
video |
观看者观看了 50% 的视频时使用的展示次数所占百分比。 |
video |
观看者观看了 75% 的视频时使用的展示次数所占百分比。 |
video |
TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 |
video |
视频广告的观看次数。 |
view |
浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
all |
在可计费的广告事件(点击或展示)后,在任何营业地点途径上点击“致电”按钮的次数。此衡量标准来自基于素材资源的地理位置。 |
all |
在可计费广告事件(点击或展示)后,在任何位置信息途径上查询路线的点击次数。此衡量标准来自基于素材资源的地理位置。 |
all |
在可计费的广告事件(点击或展示)后,在任何位置途径上点击菜单链接的次数。此衡量标准来自基于素材资源的地理位置。 |
all |
在可计费的广告事件(点击或展示)后,在任何营业地点途径上获得的下单点击次数。此衡量标准来自基于素材资源的地理位置。 |
all |
在可计费的广告事件(点击或展示)后,在任何位置途径上发生的其他类型的本地操作点击次数。此衡量标准来自基于素材资源的地理位置。 |
all |
在可计费广告事件(点击或展示)后光顾实体店的用户数量估算数据。此衡量标准来自基于素材资源的地理位置。 |
all |
在可付费的广告事件(点击或展示)后,任何营业地点途径获得的网站网址点击次数。此衡量标准来自基于素材资源的地理位置。 |
eligible |
展示了商店营业地点或将该地点用作定位条件的展示次数。此衡量标准来自基于素材资源的地理位置。 |
view |
在获得展示后,在任何营业地点途径上获得的致电按钮点击次数。此衡量标准来自基于素材资源的地理位置。 |
view |
在任何营业地点展示后,用户点击行车路线的次数。此衡量标准来自基于素材资源的地理位置。 |
view |
在展示后,用户在任何位置途径上点击菜单链接的次数。此衡量标准来自基于素材资源的地理位置。 |
view |
在获得展示后,在任何营业地点途径获得的订单点击次数。此衡量标准来自基于素材资源的地理位置。 |
view |
在展示后,在任何营业地点途径上获得的其他类型的本地操作点击次数。此衡量标准来自基于素材资源的地理位置。 |
view |
展示后光顾实体店的用户数量估算值。此衡量标准来自基于素材资源的地理位置。 |
view |
在任何营业地点展示面上获得展示后,网站网址获得的点击次数。此衡量标准来自基于素材资源的地理位置。 |
orders |
“订单数”是指广告为您带来的购买转化总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果某次转化是由于用户之前与您广告的互动(点击文字广告或购物广告、观看视频广告等)带来的,系统会将其计为一笔订单。示例:某用户点击了宣传一款帽子的购物广告,然后在您的网站上下单购买了该帽子和一件衬衫。虽然该用户购买了 2 件商品,但仍会计为 1 笔订单。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
average |
“平均订单价值”是指广告促成的每笔订单带来的平均收入。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。系统会用订单带来的总收入除以订单总数,计算出平均订单价值。示例:您收到了 3 笔订单,它们分别带来了 10 美元、15 美元和 20 美元的收入。平均订单价值为 15 美元,计算方法为:(10 美元 + 15 美元 + 20 美元)/3。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
average |
“平均购物车内商品数量”是指广告带来的每个订单的平均商品数量。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。系统会用所售商品总数除以您获得的订单总数,计算出平均购物车内商品数量。示例:您获得了 2 个订单,第一个订单包含 3 件商品,第二个订单包含 2 件商品。平均购物车内商品数量即为 2.5 件商品,计算方法为:(3+2)/2。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
cost |
“所售商品的成本”(COGS) 是指广告促成的订单中所售产品的总成本。运作方式:您可以在 Merchant Center 中为每个产品添加销货成本价值。如果您报告含购物车数据的转化,系统会将所售产品与其销货成本价值进行匹配,并可据此计算每笔订单的毛利润。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。那么,这笔订单的销货成本就是:8 美元 = 3 美元 + 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
gross |
毛利润是指扣除销货成本 (COGS) 后,归因于广告的订单所产生的利润。运作方式:毛利润是指扣除销货成本后,归因于广告的销售所带来的收益。在计算毛利润时,只会涵盖在 Merchant Center 中具有销货成本值的产品。示例:客户点击了宣传某款帽子的购物广告,然后在您的网站上下单购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,衬衫的价格为 20 美元。帽子的销货成本值为 3 美元,但衬衫没有销货成本值。在计算此订单的毛利润时,仅会考虑帽子,因此毛利润为 7 美元(10 美元 - 3 美元)。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
gross |
“毛利润率”是指在扣除销货成本 (COGS) 后,广告促成的订单带来的毛利润所占的百分比。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。毛利润率是指用所得毛利润除以总收入,然后再乘 100%,计算得出的值。计算毛利润率时,只会纳入 Merchant Center 中具有销货成本价值的产品。示例:客户在您的网站上下单购买了帽子和衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。衬衫的价格为 20 美元,但没有销货成本价值。这笔订单中只有帽子有销货成本价值,因此计算毛利润率时只会将帽子考虑在内,也就是 70% =(10 美元 - 3 美元)/10 美元 x 100%。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
revenue |
“收入”是指您从广告促成的订单中赚到的总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。广告促成的所有订单的总价值减去所有折扣即为收入。示例:客户点击了宣传某款帽子的购物广告,然后在您的网站上下单购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。整个订单有 5 美元的折扣。那么,这笔订单的收入就是:25 美元 =(10 美元 + 20 美元)- 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
units |
“售出数量”是指广告促成的订单中的售出产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。“售出数量”是指广告促成的所有订单中的售出产品的总数。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,售出数量为 3。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
cross |
“作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的销货成本为 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
cross |
“作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的其他产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。衬衫的价格为 20 美元,其销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的毛利润就是:15 美元 = 20 美元 - 5 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
cross |
“作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售所产生的总价值。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为交叉销售产品时的收入为 20 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
cross |
“作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
lead |
“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些货品的成本会计入“作为主推产品时的销货成本”。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为主推产品时的销货成本为 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
lead |
“作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的同一产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。在这笔订单中,作为主推产品时的毛利润就是:7 美元 = 10 美元 - 3 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
lead |
“作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为主推产品时的收入为 10 美元。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
lead |
“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些售出产品的总数会计入“作为主推产品时的销量”。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
unique |
在指定时间段内看到您广告的唯一身份用户数。此指标无法汇总,并且只能针对 92 天以内的日期范围进行请求。此指标适用于以下广告系列类型:展示广告系列、视频广告系列、发现广告系列和应用广告系列。 |
average |
在指定时间段内,唯一身份用户看到您广告的平均次数。此指标无法汇总,并且只能针对 92 天以内的日期范围进行请求。此指标适用于以下广告系列类型:展示广告系列、视频广告系列、发现广告系列和应用广告系列。 |
InteractionEventType
用于描述可能的付费和免费互动类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
CLICK |
点击即可访问网站。在大多数情况下,此互动会导航到外部位置,通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。 |
ENGAGEMENT |
用户表达的意图,即在原地与广告互动。 |
VIDEO_VIEW |
用户观看了视频广告。 |
NONE |
广告转化事件的默认 InteractionEventType。如果广告转化行未指明应将非付费互动(例如广告转化)“提升”为核心指标并报告,则应使用此值。这些转化只是“其他(广告)转化”。 |
SearchVolumeRange
搜索量范围。实际搜索量在此范围内。
JSON 表示法 |
---|
{ "min": string, "max": string } |
字段 | |
---|---|
min |
搜索量的下限。 |
max |
搜索量的上限。 |
细分
仅细分字段。
JSON 表示法 |
---|
{ "adDestinationType": enum ( |
字段 | |
---|---|
ad |
广告目标类型。 |
ad |
广告网络类型。 |
budget |
预算与广告系列的关联状态。 |
click |
点击类型。 |
conversion |
转化操作类别。 |
conversion |
转化归因事件类型。 |
conversion |
一个枚举值,表示展示和转化之间的天数。 |
conversion |
一个枚举值,表示从展示到转化或从展示到调整转化所需的天数。 |
day |
星期几,例如星期一。 |
device |
指标应用于的设备。 |
external |
外部转化来源。 |
hotel |
酒店入住日(星期几)。 |
hotel |
酒店日期选择类型。 |
hotel |
酒店房价类型。 |
hotel |
酒店价格范围。 |
keyword |
关键字条件。 |
month |
一年中的月份,例如 1 月。 |
placeholder |
占位符类型。此字段仅适用于 Feed 项指标。 |
product |
商品的渠道。 |
product |
商品的渠道独占性。 |
product |
商品的使用情况。 |
recommendation |
推荐类型。 |
search |
搜索引擎结果页 (SERP) 的类型。 |
search |
触发广告展示的关键字的匹配类型,包括变体。 |
slot |
广告的位置。 |
conversion |
应用的转化价值规则的主要维度。NO_RULE_APPLIED 显示未应用价值规则的转化记录的总价值。“原始价值”显示已应用价值规则的转化的原始价值。GEO_LOCATION、DEVICE、AUDIENCE 会显示应用价值规则后的净调整值。 |
sk |
iOS Store Kit 广告网络用户类型。 |
sk |
iOS Store Kit 广告网络广告事件类型。 |
sk |
iOS Store Kit 广告联盟归因功劳 |
sk |
iOS Store Kit 广告网络粗略转化价值。 |
sk |
促成 iOS Store Kit Ad Network 安装的广告的展示来源类型。值为 null 表示此细分不适用,例如非 iOS 广告系列,或者 Apple 发送的任何回传中都没有来源网域或来源应用。 |
new |
此维度用于按用户是新客户还是回头客对转化进行细分。此细分通常用于衡量“获取客户”目标的影响。 |
activity |
活动账号 ID。 |
activity |
相应旅行活动的提供城市。 |
activity |
相应旅行活动可供使用的国家/地区。 |
activity |
活动评分。 |
activity |
相应旅行活动可供使用的州。 |
external |
广告客户提供的活动 ID。 |
ad |
广告组的资源名称。 |
asset |
素材资源组的资源名称。 |
auction |
“竞价分析”报告中竞价参与者的网域(显示网址)。 |
campaign |
广告系列的资源名称。 |
conversion |
转化操作的资源名称。 |
conversion |
转化操作名称。 |
conversion |
此维度会按原始转化次数和转化价值与调整后的转化次数和转化价值的差异对转化列进行细分。“False”行包含原始声明的数据;而“True”行包含当前数据与原始声明的数据之间的差异。将这两者相加即可得出调整后的数据。 |
date |
指标适用的日期。yyyy-MM-dd 格式,例如 2018-04-17。 |
geo |
表示机场的地理位置定位目标常量的资源名称。 |
geo |
表示州的地理位置定位目标常量的资源名称。 |
geo |
表示城市的地理位置定位目标常量的资源名称。 |
geo |
代表国家/地区的地理位置定位目标常量的资源名称。 |
geo |
表示县的地理位置定位目标常量的资源名称。 |
geo |
代表行政区/郡的地理位置定位目标常量的资源名称。 |
geo |
代表都市圈的地理位置定位目标常量的资源名称。 |
geo |
代表最具体位置的地理位置定位目标常量的资源名称。 |
geo |
表示邮政编码的地理位置定位目标常量的资源名称。 |
geo |
代表省的地理位置定位目标常量的资源名称。 |
geo |
代表区域的地理位置定位目标常量的资源名称。 |
geo |
代表州的地理位置定位目标常量的资源名称。 |
hotel |
酒店预订期限(以天为单位)。 |
hotel |
Hotel Center ID。 |
hotel |
酒店入住日期。格式为 yyyy-MM-dd。 |
hotel |
酒店所在的城市。 |
hotel |
酒店星级。 |
hotel |
酒店所在的国家/地区。 |
hotel |
酒店住宿晚数。 |
hotel |
酒店房价规则 ID。 |
hotel |
酒店所在的省级行政区。 |
hour |
以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 |
interaction |
仅适用于 Feed 项指标。指示互动指标是发生在 Feed 项本身还是其他附加信息或广告单元中。 |
month |
由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 |
partner |
合作伙伴酒店 ID。 |
product |
商品的集合商家 ID。 |
product |
商品的类别(第 1 级)。 |
product |
商品的类别(第 2 级)。 |
product |
商品的类别(第 3 级)。 |
product |
商品的类别(第 4 级)。 |
product |
商品的类别(第 5 级)。 |
product |
商品的品牌。 |
product |
商品目标销售国家/地区的地理位置定位目标常量的资源名称。 |
product |
商品的自定义属性 0。 |
product |
商品的自定义属性 1。 |
product |
商品的自定义属性 2。 |
product |
商品的自定义属性 3。 |
product |
商品的自定义属性 4。 |
product |
商品的 Feed 标签。 |
product |
商品的项目 ID。 |
product |
商品语言的语言常量的资源名称。 |
product |
商品的商家 ID。 |
product |
商品的商店 ID。 |
product |
商品的名称。 |
product |
商品的类型(第 1 级)。 |
product |
商品的类型(第 2 级)。 |
product |
商品的类型(第 3 级)。 |
product |
商品的类型(第 4 级)。 |
product |
商品的类型(第 5 级)。 |
quarter |
由一个季度第一天的日期表示的季度。对季度使用日历年,例如 2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 |
search |
搜索字词子类别。空字符串表示不属于其他子类别的搜索字词的统称子类别。 |
search |
搜索字词。 |
webpage |
表示网页条件的广告组条件的资源名称。 |
week |
定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 |
year |
年份,格式为 yyyy。 |
sk |
iOS Store Kit 广告网络转化价值。值为 null 表示此细分不适用,例如非 iOS 广告系列。 |
sk |
促成 iOS Store Kit Ad Network 安装的广告所展示的应用。值为 null 表示此细分受众群体不适用(例如,非 iOS 广告系列),或者未出现在 Apple 发送的任何回传中。 |
sk |
促成 iOS Store Kit Ad Network 安装的广告是在对应的网站中展示的。值为 null 表示此细分受众群体不适用(例如,非 iOS 广告系列),或者未出现在 Apple 发送的任何回传中。 |
sk |
iOS Store Kit 广告网络回传顺序索引。 |
asset |
仅适用于 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
BudgetCampaignAssociationStatus 细分。
JSON 表示法 |
---|
{
"status": enum ( |
字段 | |
---|---|
status |
预算与广告系列的关联状态。 |
campaign |
广告系列资源名称。 |
BudgetCampaignAssociationStatus
预算与广告系列之间关联的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
广告系列目前正在使用该预算。 |
REMOVED |
广告系列不再使用该预算。 |
ClickType
枚举 Google Ads 点击类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
APP_DEEPLINK |
应用互动广告深层链接。 |
BREADCRUMBS |
面包屑导航。 |
BROADBAND_PLAN |
宽带套餐。 |
CALL_TRACKING |
手动拨打的电话。 |
CALLS |
来电。 |
CLICK_ON_ENGAGEMENT_AD |
点击“互动广告”。 |
GET_DIRECTIONS |
驾车方向。 |
LOCATION_EXPANSION |
获取详细位置信息。 |
LOCATION_FORMAT_CALL |
致电。 |
LOCATION_FORMAT_DIRECTIONS |
路线。 |
LOCATION_FORMAT_IMAGE |
图片。 |
LOCATION_FORMAT_LANDING_PAGE |
前往着陆页。 |
LOCATION_FORMAT_MAP |
地图。 |
LOCATION_FORMAT_STORE_INFO |
前往商店信息。 |
LOCATION_FORMAT_TEXT |
文本。 |
MOBILE_CALL_TRACKING |
手机通话。 |
OFFER_PRINTS |
打印优惠券。 |
OTHER |
其他。 |
PRODUCT_EXTENSION_CLICKS |
产品加号方块优惠信息。 |
PRODUCT_LISTING_AD_CLICKS |
购物 - 产品 - 在线。 |
SITELINKS |
站内链接。 |
STORE_LOCATOR |
显示附近的位置。 |
URL_CLICKS |
标题。 |
VIDEO_APP_STORE_CLICKS |
应用商店。 |
VIDEO_CALL_TO_ACTION_CLICKS |
号召性用语重叠式广告。 |
VIDEO_CARD_ACTION_HEADLINE_CLICKS |
卡片。 |
VIDEO_END_CAP_CLICKS |
结尾画面。 |
VIDEO_WEBSITE_CLICKS |
网站。 |
VISUAL_SITELINKS |
视觉化附加链接。 |
WIRELESS_PLAN |
无线套餐。 |
PRODUCT_LISTING_AD_LOCAL |
购物 - 产品 - 本地。 |
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL |
购物 - 产品 - 多渠道本地。 |
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE |
购物 - 产品 - 多渠道在线。 |
PRODUCT_LISTING_ADS_COUPON |
购物 - 产品 - 优惠券。 |
PRODUCT_LISTING_AD_TRANSACTABLE |
购物 - 产品 - 在 Google 上销售。 |
PRODUCT_AD_APP_DEEPLINK |
购物 - 产品 - 应用互动广告深层链接。 |
SHOWCASE_AD_CATEGORY_LINK |
购物 - 橱窗 - 类别。 |
SHOWCASE_AD_LOCAL_STOREFRONT_LINK |
购物 - 橱窗 - 本地店面。 |
SHOWCASE_AD_ONLINE_PRODUCT_LINK |
购物 - 橱窗 - 在线产品。 |
SHOWCASE_AD_LOCAL_PRODUCT_LINK |
购物 - 橱窗 - 本地商品。 |
PROMOTION_EXTENSION |
附加促销信息。 |
SWIPEABLE_GALLERY_AD_HEADLINE |
广告标题。 |
SWIPEABLE_GALLERY_AD_SWIPES |
滑动。 |
SWIPEABLE_GALLERY_AD_SEE_MORE |
了解详情。 |
SWIPEABLE_GALLERY_AD_SITELINK_ONE |
站内链接 1. |
SWIPEABLE_GALLERY_AD_SITELINK_TWO |
站内链接 2. |
SWIPEABLE_GALLERY_AD_SITELINK_THREE |
站内链接 3. |
SWIPEABLE_GALLERY_AD_SITELINK_FOUR |
站内链接 4。 |
SWIPEABLE_GALLERY_AD_SITELINK_FIVE |
站内链接 5. |
HOTEL_PRICE |
酒店价格。 |
PRICE_EXTENSION |
附加价格信息。 |
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION |
“Google 上的酒店预订”房间选择。 |
SHOPPING_COMPARISON_LISTING |
购物 - 购物比较服务详情。 |
CROSS_NETWORK |
跨广告网络。通过效果最大化广告系列和发现广告系列。 |
ConversionAttributionEventType
归因的转化的事件类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
表示此版本中未知的值。 |
IMPRESSION |
转化会归因于展示。 |
INTERACTION |
转化归因于互动。 |
ConversionLagBucket
表示展示和转化之间相隔的天数的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
LESS_THAN_ONE_DAY |
转化延迟时间分桶范围为 0 到 1 天。0 天包含在内,1 天不包含在内。 |
ONE_TO_TWO_DAYS |
转化延迟时间分桶范围为 1 到 2 天。1 天包含在内,2 天不包含在内。 |
TWO_TO_THREE_DAYS |
转化延迟时间分桶范围为 2 到 3 天。2 天包含在内,3 天不包含在内。 |
THREE_TO_FOUR_DAYS |
转化延迟时间分桶范围为 3 到 4 天。3 天包含在内,4 天不包含在内。 |
FOUR_TO_FIVE_DAYS |
转化延迟时间分桶范围为 4 到 5 天。4 天算在内,5 天不算在内。 |
FIVE_TO_SIX_DAYS |
转化延迟时间分桶从 5 天改为 6 天。包含 5 天,不包含 6 天。 |
SIX_TO_SEVEN_DAYS |
将转化延迟时间分桶从 6 天改为 7 天。包含 6 天,不包含 7 天。 |
SEVEN_TO_EIGHT_DAYS |
将转化延迟时间分桶从 7 天改为 8 天。7 天包含在内,8 天不包含在内。 |
EIGHT_TO_NINE_DAYS |
将转化延迟时间分桶从 8 天改为 9 天。8 天包含在内,9 天不包含在内。 |
NINE_TO_TEN_DAYS |
将转化延迟时间分桶从 9 天改为 10 天。包含第 9 天,不包含第 10 天。 |
TEN_TO_ELEVEN_DAYS |
将转化延迟时间分桶从 10 天改为 11 天。10 天算在内,11 天不算在内。 |
ELEVEN_TO_TWELVE_DAYS |
转化延迟时间分桶范围为 11 到 12 天。包含第 11 天,不包含第 12 天。 |
TWELVE_TO_THIRTEEN_DAYS |
将转化延迟时间分桶从 12 天改为 13 天。包含 12 天,不包含 13 天。 |
THIRTEEN_TO_FOURTEEN_DAYS |
将转化延迟时间分桶从 13 天改为 14 天。包含第 13 天,不包含第 14 天。 |
FOURTEEN_TO_TWENTY_ONE_DAYS |
转化延迟时间分桶范围为 14 到 21 天。14 天包含在内,21 天不包含在内。 |
TWENTY_ONE_TO_THIRTY_DAYS |
转化延迟时间分桶范围为 21 到 30 天。包含 21 天,不包含 30 天。 |
THIRTY_TO_FORTY_FIVE_DAYS |
转化延迟时间分桶范围从 30 天到 45 天。包含 30 天,不包含 45 天。 |
FORTY_FIVE_TO_SIXTY_DAYS |
转化延迟时间分桶范围为 45 到 60 天。45 天包含在内,60 天不包含在内。 |
SIXTY_TO_NINETY_DAYS |
转化延迟时间分桶范围从 60 天到 90 天。60 天包含在内,90 天不包含在内。 |
ConversionOrAdjustmentLagBucket
表示从展示到转化或从展示到对转化的调整所需的天数的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
CONVERSION_LESS_THAN_ONE_DAY |
转化延迟时间分桶范围为 0 到 1 天。0 天包含在内,1 天不包含在内。 |
CONVERSION_ONE_TO_TWO_DAYS |
转化延迟时间分桶范围为 1 到 2 天。1 天包含在内,2 天不包含在内。 |
CONVERSION_TWO_TO_THREE_DAYS |
转化延迟时间分桶范围为 2 到 3 天。2 天包含在内,3 天不包含在内。 |
CONVERSION_THREE_TO_FOUR_DAYS |
转化延迟时间分桶范围为 3 到 4 天。3 天包含在内,4 天不包含在内。 |
CONVERSION_FOUR_TO_FIVE_DAYS |
转化延迟时间分桶范围为 4 到 5 天。4 天算在内,5 天不算在内。 |
CONVERSION_FIVE_TO_SIX_DAYS |
转化延迟时间分桶从 5 天改为 6 天。包含 5 天,不包含 6 天。 |
CONVERSION_SIX_TO_SEVEN_DAYS |
将转化延迟时间分桶从 6 天改为 7 天。包含 6 天,不包含 7 天。 |
CONVERSION_SEVEN_TO_EIGHT_DAYS |
将转化延迟时间分桶从 7 天改为 8 天。7 天包含在内,8 天不包含在内。 |
CONVERSION_EIGHT_TO_NINE_DAYS |
将转化延迟时间分桶从 8 天改为 9 天。8 天包含在内,9 天不包含在内。 |
CONVERSION_NINE_TO_TEN_DAYS |
将转化延迟时间分桶从 9 天改为 10 天。包含第 9 天,不包含第 10 天。 |
CONVERSION_TEN_TO_ELEVEN_DAYS |
将转化延迟时间分桶从 10 天改为 11 天。10 天算在内,11 天不算在内。 |
CONVERSION_ELEVEN_TO_TWELVE_DAYS |
转化延迟时间分桶范围为 11 到 12 天。包含第 11 天,不包含第 12 天。 |
CONVERSION_TWELVE_TO_THIRTEEN_DAYS |
将转化延迟时间分桶从 12 天改为 13 天。包含 12 天,不包含 13 天。 |
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS |
将转化延迟时间分桶从 13 天改为 14 天。包含第 13 天,不包含第 14 天。 |
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS |
转化延迟时间分桶范围为 14 到 21 天。14 天包含在内,21 天不包含在内。 |
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS |
转化延迟时间分桶范围为 21 到 30 天。包含 21 天,不包含 30 天。 |
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS |
转化延迟时间分桶范围从 30 天到 45 天。包含 30 天,不包含 45 天。 |
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS |
转化延迟时间分桶范围为 45 到 60 天。45 天包含在内,60 天不包含在内。 |
CONVERSION_SIXTY_TO_NINETY_DAYS |
转化延迟时间分桶范围从 60 天到 90 天。60 天包含在内,90 天不包含在内。 |
ADJUSTMENT_LESS_THAN_ONE_DAY |
转化调整延迟时间分桶范围为 0 到 1 天。0 天包含在内,1 天不包含在内。 |
ADJUSTMENT_ONE_TO_TWO_DAYS |
转化调整延迟时间分桶(1 到 2 天)。1 天包含在内,2 天不包含在内。 |
ADJUSTMENT_TWO_TO_THREE_DAYS |
转化调整延迟时间分桶从 2 天改为 3 天。2 天包含在内,3 天不包含在内。 |
ADJUSTMENT_THREE_TO_FOUR_DAYS |
转化调整延迟时间分桶从 3 天改为 4 天。3 天包含在内,4 天不包含在内。 |
ADJUSTMENT_FOUR_TO_FIVE_DAYS |
转化调整延迟时间分桶从 4 天改为 5 天。4 天算在内,5 天不算在内。 |
ADJUSTMENT_FIVE_TO_SIX_DAYS |
转化调整延迟时间分桶从 5 天改为 6 天。包含 5 天,不包含 6 天。 |
ADJUSTMENT_SIX_TO_SEVEN_DAYS |
将转化调整延迟时间分桶从 6 天改为 7 天。包含 6 天,不包含 7 天。 |
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS |
将转化调整延迟时间分桶从 7 天改为 8 天。7 天包含在内,8 天不包含在内。 |
ADJUSTMENT_EIGHT_TO_NINE_DAYS |
转化调整延迟时间分桶从 8 天改为 9 天。8 天包含在内,9 天不包含在内。 |
ADJUSTMENT_NINE_TO_TEN_DAYS |
将转化调整延迟时间分桶从 9 天改为 10 天。包含第 9 天,不包含第 10 天。 |
ADJUSTMENT_TEN_TO_ELEVEN_DAYS |
转化调整延迟时间分桶从 10 天改为 11 天。10 天算在内,11 天不算在内。 |
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS |
转化调整延迟时间分桶从 11 天改为 12 天。包含第 11 天,不包含第 12 天。 |
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS |
转化调整延迟时间分桶从 12 天改为 13 天。包含 12 天,不包含 13 天。 |
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS |
将转化调整延迟时间分桶从 13 天改为 14 天。包含第 13 天,不包含第 14 天。 |
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS |
将转化调整延迟时间分桶从 14 天延长至 21 天。14 天包含在内,21 天不包含在内。 |
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS |
转化调整延迟时间分桶范围从 21 天扩大到 30 天。包含 21 天,不包含 30 天。 |
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS |
将转化调整延迟时间分桶从 30 天延长至 45 天。包含 30 天,不包含 45 天。 |
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS |
将转化调整延迟时间分桶从 45 天改为 60 天。45 天包含在内,60 天不包含在内。 |
ADJUSTMENT_SIXTY_TO_NINETY_DAYS |
将转化调整延迟时间分桶从 60 天延长至 90 天。60 天包含在内,90 天不包含在内。 |
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS |
转化调整延迟时间分桶从 90 天延长至 145 天。90 天包含在内,145 天不包含在内。 |
CONVERSION_UNKNOWN |
转化延迟时间分桶为“未知”。适用于 Google Ads 中未提供转化延迟时间分桶之前的日期。 |
ADJUSTMENT_UNKNOWN |
转化调整延迟时间分桶为“未知”。适用于 Google Ads 中未提供转化调整延迟时间分桶之前的日期。 |
ExternalConversionSource
与 ConversionAction 相关联的外部转化来源。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
表示此版本中未知的值。 |
WEBPAGE |
用户在观看广告后转到特定网页时发生的转化;在 Google Ads 界面中显示为“网站”。 |
ANALYTICS |
来自关联的 Google Analytics 目标或交易的转化;在 Google Ads 界面中显示为“Google Analytics”。 |
UPLOAD |
通过 ConversionUploadService 上传的网站转化;在 Google Ads 界面中显示为“从点击导入”。 |
AD_CALL_METRICS |
用户直接点击广告中的附加电话信息时发生的转化;在 Google Ads 界面中显示为“通过广告进行的通话”。 |
WEBSITE_CALL_METRICS |
用户点击广告后,从广告客户网站上拨打动态生成的电话号码(通过已安装的 JavaScript)时发生的转化;在 Google Ads 界面中显示为“网站致电”。 |
STORE_VISITS |
用户点击 Google 广告后光顾广告客户的实体店时发生的转化;在 Google Ads 界面中显示为“实体店光顾”。 |
ANDROID_IN_APP |
用户执行应用内操作(例如在 Android 应用中进行购买)时发生的转化;在 Google Ads 界面中显示为“Android 应用内操作”。 |
IOS_IN_APP |
用户执行应用内操作(例如在 iOS 应用中进行购买)时发生的转化;在 Google Ads 界面中显示为“iOS 应用内操作”。 |
IOS_FIRST_OPEN |
用户首次打开 iOS 应用时发生的转化;在 Google Ads 界面中显示为“iOS 应用安装(首次打开)”。 |
APP_UNSPECIFIED |
未提供 AppPlatform 的旧版应用转化;在 Google Ads 界面中显示为“移动应用”。 |
ANDROID_FIRST_OPEN |
用户首次打开 Android 应用时发生的转化;在 Google Ads 界面中显示为“Android 应用安装(首次打开)”。 |
UPLOAD_CALLS |
通过 ConversionUploadService 上传的来电转化;在 Google Ads 界面中显示为“从来电导入”。 |
FIREBASE |
来自关联的 Firebase 事件的转化;在 Google Ads 界面中显示为“Firebase”。 |
CLICK_TO_CALL |
用户点击移动电话号码时发生的转化;在 Google Ads 界面中显示为“电话号码点击次数”。 |
SALESFORCE |
来自 Salesforce 的转化;在 Google Ads 界面中显示为“Salesforce.com”。 |
STORE_SALES_CRM |
由 CRM 记录的实体店购买交易带来的转化;在 Google Ads 界面中显示为“实体店销售(数据合作伙伴)”。 |
STORE_SALES_PAYMENT_NETWORK |
通过付款网络进行的实体店购买交易带来的转化;在 Google Ads 界面中显示为“实体店销售(付款网络)”。 |
GOOGLE_PLAY |
无代码 Google Play 转化;在 Google Ads 界面中显示为“Google Play”。 |
THIRD_PARTY_APP_ANALYTICS |
来自关联的第三方应用分析事件的转化;在 Google Ads 界面中显示为“第三方应用分析”。 |
GOOGLE_ATTRIBUTION |
由 Google 归因控制的转化。 |
STORE_SALES_DIRECT_UPLOAD |
基于第一方或第三方商家数据上传的实体店销售转化。在 Google Ads 界面中显示为“实体店销售(直接上传)”。 |
STORE_SALES |
“实体店销售”转化是指根据第一方或第三方商家数据上传和/或使用支付网络中的银行卡进行的实体店内购物所得的转化。在 Google Ads 界面中显示为“实体店销售”。 |
SEARCH_ADS_360 |
从 Search Ads 360 Floodlight 数据导入的转化。 |
GOOGLE_HOSTED |
跟踪用户在与广告互动后在 Google 产品和服务中执行的本地操作的转化。 |
FLOODLIGHT |
Floodlight 代码报告的转化。 |
ANALYTICS_SEARCH_ADS_360 |
专门针对 Search Ads 360 从 Google Analytics 导入的转化。在 Google Ads 界面中显示为“Google Analytics (SA360)”。 |
FIREBASE_SEARCH_ADS_360 |
来自 Search Ads 360 关联的 Firebase 事件的转化。 |
DISPLAY_AND_VIDEO_360_FLOODLIGHT |
Floodlight 为 DV360 报告的转化。 |
HotelRateType
用于描述可能的酒店房价类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
UNAVAILABLE |
无法获取费率类型信息。 |
PUBLIC_RATE |
面向所有人的费率。 |
QUALIFIED_RATE |
提供会员回馈活动费率,并且满足公开费率等基本要求。界面处理方式将带删除线显示公开费率,并指明用户可以享受折扣。如需详细了解“符合条件的房价”,请访问 https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates |
PRIVATE_RATE |
面向满足某些资格条件的用户提供的费率,例如所有已登录的用户、20% 的移动用户、加拿大的所有移动用户等。 |
HotelPriceBucket
用于描述可能的酒店价格分桶的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
LOWEST_UNIQUE |
唯一最低价。合作伙伴的价格最低,且没有其他合作伙伴的价格与该价格相差无几。 |
LOWEST_TIED |
并列最低价。合作伙伴的价格与最低价格相差不大。 |
NOT_LOWEST |
不是最低价格。合作伙伴的价格与最低价格相差较大。 |
ONLY_PARTNER_SHOWN |
仅显示合作伙伴。 |
Keyword
关键字条件细分。
JSON 表示法 |
---|
{
"info": {
object ( |
字段 | |
---|---|
info |
关键字信息。 |
ad |
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 } |
字段 | |
---|---|
sk |
促成 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 |
素材资源名称。 |
interaction |
仅适用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。 |
ConvertingUserPriorEngagementTypeAndLtvBucket
枚举转化用户之前的互动类型和生命周期价值分桶
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
NEW |
转化用户是广告客户的新客户。 |
RETURNING |
转化用户返回到广告客户。回头客的定义因转化类型而异,例如第二次光顾实体店与第二次在线购买。 |
NEW_AND_HIGH_LTV |
完成转化的用户是广告客户的新客户,并且具有较高的生命周期价值。 |