- JSON 表示法
- AccountBudget
- AccountBudgetStatus
- PendingAccountBudgetProposal
- AdGroupAdAssetCombinationView
- AssetUsage
- AdGroupAdAssetView
- AdGroupAdAssetPolicySummary
- AdGroupAudienceView
- AdGroupCriterionSimulation
- SimulationType
- SimulationModificationMethod
- CpcBidSimulationPointList
- CpcBidSimulationPoint
- PercentCpcBidSimulationPointList
- PercentCpcBidSimulationPoint
- AdGroupSimulation
- CpvBidSimulationPointList
- CpvBidSimulationPoint
- TargetCpaSimulationPointList
- TargetCpaSimulationPoint
- TargetRoasSimulationPointList
- TargetRoasSimulationPoint
- AgeRangeViewAgeRangeView
- 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
- 尽可能提高转化次数
- 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
- BusinessRegistrationNumberBusinessRegistrationNumber
- BusinessRegistrationDocumentBusinessRegistrationDocument
- 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
- SearchTermViewSearchTermView
- SearchTermTargetingStatus
- ShoppingPerformanceViewShoppingPerformanceView
- 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 |
查询中引用的 CustomInterest。 |
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_”“已批准”字段,还可能包含“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。只有当已批准的支出限额为 INFINITE 时,系统才会填充此字段。 |
联合字段 此值对账号的支出金额具有最终决定权。 |
|
adjusted |
仅限输出。调整后的支出限额(以微单位表示)。一百万个微单位为一个单位。 如果已获批准的支出限额有限,调整后的支出限额可能会因适用于此预算的调整项类型(如适用)而异。 如需了解不同类型的调整,请参阅以下网址:https://support.google.com/google-ads/answer/1704323 例如,借记调整项会减少账号允许支出的金额。 |
adjusted |
仅限输出。经过调整的支出限额,采用明确定义的类型,例如 INFINITE。只有当调整后的支出限额为 INFINITE(如果已批准的支出限额为 INFINITE)时,系统才会填充此字段。 |
AccountBudgetStatus
AccountBudget 的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
PENDING |
账号预算正在等待审批。 |
APPROVED |
账号预算已获批准。 |
CANCELLED |
用户已取消账号预算。 |
PendingAccountBudgetProposal
与封闭的账号级预算相关联的待处理提案(如果适用)。
JSON 表示法 |
---|
{ "proposalType": enum ( |
字段 | |
---|---|
proposal |
仅限输出。此提案的类型,例如,结束与此提案关联的预算。 |
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 中。广告组广告素材资源组合视图资源名称采用以下格式: |
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
广告组条件模拟。下面分别详细介绍了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法组合。Hotel AdGroupCriterion 模拟操作从 V5 开始。
- 展示 - 关键字 - CPC_BID - 统一
- 搜索 - 关键字 - CPC_BID - UNIFORM
- 购物 - LISTING_GROUP - CPC_出价 - 统一
- HOTEL - LISTING_GROUP - CPC_BID - UNIFORM
- 酒店 - 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_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_IMPRESSION_SHARE - UNIFORM
- 搜索广告系列 - 预算 - 统一
- 购物广告系列 - 预算 - 统一
- 购物 - TARGET_ROAS - UNIFORM
- 多渠道 - 目标每次转化费用 - 统一
- MULTI_CHANNEL - TARGET_ROAS - UNIFORM
- 发现广告系列 - 目标每次转化费用 - 默认
- 展示广告 - 目标每次转化费用 - 统一
- PERFORMANCE_MAX - TARGET_CPA - UNIFORM
- PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
- PERFORMANCE_MAX - 预算 - UNIFORM
JSON 表示法 |
---|
{ "resourceName": string, "campaignId": string, "type": enum ( |
字段 | |
---|---|
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 |
仅限输出。如果模拟类型为 BUDGET,则模拟得分。 |
BudgetSimulationPointList
预算类型模拟的模拟点容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
字段 | |
---|---|
points[] |
一系列预算金额的预测指标。 |
BudgetSimulationPoint
特定预算金额的预测指标。
JSON 表示法 |
---|
{ "budgetAmountMicros": string, "requiredCpcBidCeilingMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, "interactions": string } |
字段 | |
---|---|
budget |
预计指标所依据的模拟预算。 |
required |
为实现此模拟,广告客户必须设置预计的每日每次点击费用出价上限(以广告客户币种的微单位表示)。只有采用“目标支出”出价策略的广告系列才支持此字段。 |
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 |
仅限输出。发生此更改的 Simple 资源。 |
client |
仅限输出。更改的途径。 |
user |
仅限输出。执行此项更改的用户的电子邮件地址。 |
old |
仅限输出。更改前的旧资源。系统只会填充已更改的字段。 |
new |
仅限输出。更改后的新资源。系统只会填充已更改的字段。 |
resource |
仅限输出。对已更改的资源执行的操作。 |
changed |
仅限输出。所返回资源中发生更改的字段列表。 这是完全限定字段名称的逗号分隔列表。示例: |
campaign |
仅限输出。受此次变更影响的广告系列。 |
ad |
仅限输出。受此更改影响的广告组。 |
feed |
仅限输出。受此更改影响的 Feed。 |
feed |
仅限输出。受此更改影响的 FeedItem。 |
asset |
仅限输出。受此更改影响的资产。 |
ChangeEventResourceType
列出 ChangeEvent 资源支持的资源类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的分类资源。 |
AD |
Ad 资源发生变化。 |
AD_GROUP |
更改广告组资源。 |
AD_GROUP_CRITERION |
AdGroupCriterion 资源更改。 |
CAMPAIGN |
广告系列资源发生更改。 |
CAMPAIGN_BUDGET |
CampaignBudget 资源更改。 |
AD_GROUP_BID_MODIFIER |
AdGroupBidModifier 资源更改。 |
CAMPAIGN_CRITERION |
一项 CampaignCriterion 资源更改。 |
FEED |
Feed 资源更改。 |
FEED_ITEM |
FeedItem 资源更改。 |
CAMPAIGN_FEED |
CampaignFeed 资源更改。 |
AD_GROUP_FEED |
广告组 Feed 资源更改。 |
AD_GROUP_AD |
更改了 AdGroupAd 资源。 |
ASSET |
Asset 资源更改。 |
CUSTOMER_ASSET |
CustomerAsset 资源更改。 |
CAMPAIGN_ASSET |
CampaignAsset 资源更改。 |
AD_GROUP_ASSET |
AdGroupAsset 资源更改。 |
ASSET_SET |
AssetSet 资源更改。 |
ASSET_SET_ASSET |
AssetSetAsset 资源更改。 |
CAMPAIGN_ASSET_SET |
CampaignAssetSet 资源更改。 |
ChangeClientType
发出 changeEvent 资源的来源。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的未分类客户端类型。 |
GOOGLE_ADS_WEB_CLIENT |
通过“ads.google.com”所做的更改。例如,通过广告系列管理工具进行的更改。 |
GOOGLE_ADS_AUTOMATED_RULE |
通过 Google Ads 自动规则所做的更改。 |
GOOGLE_ADS_SCRIPTS |
通过 Google Ads 脚本进行的更改。 |
GOOGLE_ADS_BULK_UPLOAD |
由 Google Ads 批量上传进行的更改。 |
GOOGLE_ADS_API |
Google Ads API 所做的更改。 |
GOOGLE_ADS_EDITOR |
由 Google Ads 编辑器所做的更改。此值为占位符。该 API 不会返回这些更改。 |
GOOGLE_ADS_MOBILE_APP |
由 Google Ads 移动应用所做的更改。 |
GOOGLE_ADS_RECOMMENDATIONS |
通过 Google Ads 建议进行的更改。 |
SEARCH_ADS_360_SYNC |
通过 Search Ads 360 Sync 进行的更改。 |
SEARCH_ADS_360_POST |
通过 Search Ads 360 发布所做的更改。 |
INTERNAL_TOOL |
通过内部工具进行的更改。例如,当用户为广告系列等实体设置网址模板时,系统会自动将其封装在 SA360 Clickserver 网址中。 |
OTHER |
未分类的更改类型,例如通过 Google Ads 兑换优惠券所做的更改。 |
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION |
订阅 Google Ads 建议后所做的更改。 |
ChangedResource
用于呈现所有受支持资源的封装容器 proto。将仅设置 changeResourceType 的资源。
JSON 表示法 |
---|
{ "ad": { object ( |
字段 | |
---|---|
ad |
仅限输出。如果 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 |
仅限输出。设置 if 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 |
更改广告组资源。 |
AD_GROUP_AD |
更改了 AdGroupAd 资源。 |
AD_GROUP_CRITERION |
一项 AdGroupCriterion 资源更改。 |
CAMPAIGN |
广告系列资源发生更改。 |
CAMPAIGN_CRITERION |
CampaignCriterion 资源更改。 |
FEED |
Feed 资源更改。 |
FEED_ITEM |
FeedItem 资源更改。 |
AD_GROUP_FEED |
广告组 Feed 资源更改。 |
CAMPAIGN_FEED |
CampaignFeed 资源更改。 |
AD_GROUP_BID_MODIFIER |
更改了 AdGroupBidModifier 资源。 |
SHARED_SET |
SharedSet 资源更改。 |
CAMPAIGN_SHARED_SET |
CampaignSharedSet 资源更改。 |
ASSET |
资产资源更改。 |
CUSTOMER_ASSET |
CustomerAsset 资源更改。 |
CAMPAIGN_ASSET |
CampaignAsset 资源更改。 |
AD_GROUP_ASSET |
更改了 AdGroupAsset 资源。 |
COMBINED_AUDIENCE |
CombinedAudience 资源更改。 |
ChangeStatusOperation
更改后的资源的状态
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的分类资源。 |
ADDED |
资源已创建。 |
CHANGED |
资源已修改。 |
REMOVED |
已移除资源。 |
CombinedAudience
说明包含不同受众群体的组合受众群体的资源。
JSON 表示法 |
---|
{
"resourceName": string,
"id": string,
"status": enum ( |
字段 | |
---|---|
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
表示客户拥有并与其共享的 BiddingStrategies 视图。
与 BiddingStrategy 相比,该资源除了包含该客户拥有的策略之外,还包含该客户拥有并与该客户共享的策略。此资源不提供指标,而且仅公开了部分 BiddingStrategy 属性。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
字段 | |
---|---|
resource |
仅限输出。可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称的格式为:
|
id |
仅限输出。出价策略的 ID。 |
name |
仅限输出。出价策略的名称。 |
type |
仅限输出。出价策略的类型。 |
owner |
仅限输出。拥有出价策略的客户的 ID。 |
owner |
仅限输出。拥有出价策略的客户的 descriptiveName。 |
联合字段 您只能设置一个。 |
|
maximize |
仅限输出。这是一种自动出价策略,可帮助您在预算范围内为广告系列争取尽可能高的转化价值。 |
maximize |
仅限输出。这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。 |
target |
仅限输出。一种出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。 |
target |
仅限输出。一种出价策略,可自动根据所选百分比的展示次数进行优化。 |
target |
仅限输出。一种出价策略,可帮助您最大限度地提高收入,同时使平均广告支出回报率达到特定的目标值。 |
target |
仅限输出。一种出价策略,会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。 |
MaximizeConversionValue
这是一种自动出价策略,可帮助您在预算范围内为广告系列争取尽可能高的转化价值。
JSON 表示法 |
---|
{ "targetRoas": number } |
字段 | |
---|---|
target |
仅限输出。目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。 |
MaximizeConversions
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
字段 | |
---|---|
target |
仅限输出。目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。 |
TargetCpa
这是一种自动出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。
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
给定客户与客户客户之间的关联。CustomerClients 仅适用于经理账号。包括所有直接客户和间接客户,以及经理本人。
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 |
是否包含默认频道子类型。例如,如果 adChannelType 为 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
地理位置视图按地理位置条件汇总了广告系列的效果。如果未设置任何地理位置条件,则不会返回任何结果;而是使用 geoView 或 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 |
不可变。封装图像。 |
media |
不可变。内容包含 HTML5 素材资源的 ZIP 归档媒体。 |
audio |
仅限输出。封装音频。 |
video |
不可变。封装视频。 |
MediaType
媒体的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定媒体类型。 |
UNKNOWN |
此版本中未知收到的值。 这是一个仅用于响应的值。 |
IMAGE |
静态图片,用于图片广告。 |
ICON |
小图片,用于地图广告。 |
MEDIA_BUNDLE |
ZIP 文件,用于模板广告字段。 |
AUDIO |
音频文件。 |
VIDEO |
视频文件。 |
DYNAMIC_IMAGE |
动画图片,例如动画 GIF。 |
MediaImage
封装图像。
JSON 表示法 |
---|
{ "data": string, "fullSizeImageUrl": string, "previewSizeImageUrl": string } |
字段 | |
---|---|
data |
不可变。原始图片数据。 使用 base64 编码的字符串。 |
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 |
不可变。本地生活服务验证的资源名称。本地生活服务验证资源名称采用以下格式:
|
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 |
不可变。本地生活服务验证的资源名称。本地生活服务验证资源名称采用以下格式:
|
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 |
许可不是所请求的文档类型或包含无效的 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 |
仅限输出。转变错误。 |
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。请仅使用 1 种类型,然后重试。 |
CONVERSION_ALREADY_ENHANCED |
此转化已有具有相同订单 ID 和转化操作的增强功能。请确保您的数据配置正确无误,然后重试。 |
DUPLICATE_ENHANCEMENT_IN_REQUEST |
多项增强功能具有相同的转化操作和订单 ID。请确保您的数据配置正确无误,然后重试。 |
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT |
由于 Google 客户数据政策,此账号无法使用增强型转化。请与您的 Google 代表联系。 |
MISSING_ORDER_ID_FOR_WEBPAGE |
调整网站转化需要提供订单 ID(即交易 ID)。请确保您的网站代码能够获取订单 ID,并且您在进行调整时发送相同的订单 ID。 |
ORDER_ID_CONTAINS_PII |
无法对包含个人身份信息 (PII) 的订单 ID 使用调整。 |
INVALID_JOB_ID |
请求中提供的职位 ID 不在允许范围内。作业 ID 必须是 [1, 2^31] 这个范围内的正整数。 |
NO_CONVERSION_ACTION_FOUND |
找不到调整请求中指定的转化操作。请确保该转化操作可在此账号中使用。 |
INVALID_CONVERSION_ACTION_TYPE |
调整请求中指定的转化操作类型不支持上传调整项。RETRACTION 或 RESTATEMENT 类型的转化调整项只能用于 SALESFORCE 、UPLOAD_CLICK 或 WEBPAGE 类型的转化操作。ENHANCEMENT 类型的转化调整项只能用于 WEBPAGE 类型的转化操作。 |
ConversionUploadError
描述可能存在的转化上传错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
TOO_MANY_CONVERSIONS_IN_REQUEST |
在单个请求中上传的事件数量应少于 2,001 个。 |
UNPARSEABLE_GCLID |
无法对导入的 GCLID 进行解码。确保您没有修改点击 ID。 |
CONVERSION_PRECEDES_EVENT |
导入事件的 conversionDateTime 早于点击。请确保您的conversionDateTime 正确无误,然后重试。 |
EXPIRED_EVENT |
此项转化的点击时间早于其点击型转化时间范围,因此无法记录导入的事件。请确保您导入的是最新数据。 |
TOO_RECENT_EVENT |
与给定标识符或 iOS 网址参数关联的点击发生时间还不到 6 小时。请在 6 小时后重试。 |
EVENT_NOT_FOUND |
导入的事件无法归因于某个点击。导致这种情况的原因可能是:该事件不是由 Google Ads 广告系列带来的。 |
UNAUTHORIZED_CUSTOMER |
点击 ID 或调用与您无权访问的 Google Ads 账号相关联。请务必导入由您的经理账号管理的账号的转化数据。 |
TOO_RECENT_CONVERSION_ACTION |
无法将事件导入刚刚创建的转化操作。请在 6 小时后再次尝试导入。 |
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME |
在点击发生时,点击所对应的 Google Ads 账号的有效转化账号未启用转化跟踪。 |
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION |
导入的事件包含外部归因数据,但相应转化操作未设置为使用外部归因模型。请确保转化操作配置正确无误,然后重试。 |
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION |
转化操作已设置为使用外部归因模型,但导入的事件缺少数据。请确保导入的事件包含外部归因功劳和所有必填字段。 |
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION |
订单 ID 无法用于通过外部归因模型衡量的转化。请确保该转化配置正确无误,并且导入的事件仅包含必要的数据,然后重试。 |
ORDER_ID_ALREADY_IN_USE |
导入的事件包含之前记录的订单 ID,因此未对其进行处理。 |
DUPLICATE_ORDER_ID |
导入的事件包含多个具有相同订单 ID 的转化,因而未能得到处理。请确保订单 ID 是唯一的,然后重试。 |
TOO_RECENT_CALL |
无法导入发生时间还不足 6 小时的通话。请在 6 小时后再次尝试上传。 |
EXPIRED_CALL |
由于通话发生在此转化操作的回溯期之前,因此无法记录。请确保导入设置已配置为获取最新数据。 |
CALL_NOT_FOUND |
找不到促成导入事件的来电或点击。请确保您的数据源已设置为包含正确的标识符。 |
CONVERSION_PRECEDES_CALL |
来电的 conversionDateTime 早于关联的点击。确保您的 conversionDateTime 正确无误。 |
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME |
在导入来电时,点击所对应的 Google Ads 账号的有效转化账号中未启用转化跟踪。 |
UNPARSEABLE_CALLERS_PHONE_NUMBER |
请确保电话号码格式为 E.164 (+16502531234)、国际号码 (+64 3-331 6005) 或美国国内号码 (6502531234)。 |
CLICK_CONVERSION_ALREADY_EXISTS |
导入的事件与现有转化具有相同的点击和 conversionDateTime 。请为每个唯一身份事件使用唯一的conversionDateTime 或订单 ID,然后重试。 |
CALL_CONVERSION_ALREADY_EXISTS |
导入的来电与现有转化的 conversionDateTime 相同。请确保您的 conversionDateTime 配置正确,然后重试。 |
DUPLICATE_CLICK_CONVERSION_IN_REQUEST |
多个事件具有相同的点击和 conversionDateTime 。请确保您的 conversionDateTime 配置正确,然后重试。 |
DUPLICATE_CALL_CONVERSION_IN_REQUEST |
多个事件具有相同的来电信息和 conversionDateTime 。请确保您的 conversionDateTime 配置正确,然后重试。 |
CUSTOM_VARIABLE_NOT_ENABLED |
请在转化设置中启用自定义变量,然后重试。 |
CUSTOM_VARIABLE_VALUE_CONTAINS_PII |
事件的自定义变量包含个人身份信息 (PII),因此无法导入。请移除这些变量,然后重试。 |
INVALID_CUSTOMER_FOR_CLICK |
导入的事件带来的点击与其他 Google Ads 账号相关联。请确保要导入的账号正确无误。 |
INVALID_CUSTOMER_FOR_CALL |
来自此次通话的点击与其他 Google Ads 账号相关联。请确保您要导入的账号正确无误。针对“客户”查询 conversionTrackingSetting.google_ads_conversion_customer,以确定正确的账号。 |
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY |
无法导入转化来源,原因是转化来源未遵守 Apple 应用透明度跟踪 (ATT) 政策或客户不同意进行跟踪。 |
CLICK_NOT_FOUND |
此事件的电子邮件地址或电话号码无法与点击相匹配。这可能是因为该事件不是由 Google Ads 广告系列促成,您可以放心地忽略此警告。如果包含的导入事件数量超出预期,您可能需要检查设置。 |
INVALID_USER_IDENTIFIER |
请务必使用 SHA-256 算法对用户提供的数据进行哈希处理,并确保您已按照相关准则进行标准化处理。 |
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER |
用户提供的数据不能用于外部归因模型。请改用其他归因模型或省略用户标识符,然后重试。 |
UNSUPPORTED_USER_IDENTIFIER |
所提供的用户标识符不受支持。请仅使用经过哈希处理的电子邮件地址或电话号码,然后重试。 |
GBRAID_WBRAID_BOTH_SET |
无法同时使用 gbraid 和 wbraid 参数。请仅使用其中一个,然后重试。 |
UNPARSEABLE_WBRAID |
无法解析事件导入数据。请检查您的 wbraid 参数是否未修改,然后重试。 |
UNPARSEABLE_GBRAID |
无法解析事件导入数据。请检查您的 gbraid 参数是否未修改,然后重试。 |
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID |
使用每次点击统计为一次转化设置的转化操作无法与 gbraid 或 wbraid 参数配合使用。 |
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS |
由于 Google 客户数据政策,此账号无法使用增强型转化。请与您的 Google 代表联系。 |
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS |
请确保您在转化设置中同意客户数据处理条款,然后重试。您可以通过查询客户的 conversionTrackingSetting.accepted_customer_data_terms 检查您的设置。 |
ORDER_ID_CONTAINS_PII |
事件的订单 ID 包含个人身份信息 (PII),因此无法导入。 |
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS |
请确保您已在转化设置中启用增强型潜在客户转化,然后重试。要检查您的设置,请查询客户的 conversionTrackingSetting.Enhance_conversions_for_leads_enabled。 |
INVALID_JOB_ID |
请求中提供的职位 ID 不在允许范围内。作业 ID 必须是 [1, 2^31] 这个范围内的正整数。 |
NO_CONVERSION_ACTION_FOUND |
找不到上传请求中指定的转化操作。请确保该转化操作可在此账号中使用。 |
INVALID_CONVERSION_ACTION_TYPE |
上传请求中指定的转化操作未设置为上传相应转化数据。 |
DateError
描述可能的日期错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
收到的错误代码在此版本中未知。 |
INVALID_FIELD_VALUES_IN_DATE |
指定的字段值与有效日期不符。 |
INVALID_FIELD_VALUES_IN_DATE_TIME |
指定的字段值不对应于有效的日期时间。 |
INVALID_STRING_DATE |
该字符串日期的格式应为 yyyy-mm-dd。 |
INVALID_STRING_DATE_TIME_MICROS |
字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss.ssssss。 |
INVALID_STRING_DATE_TIME_SECONDS |
字符串日期时间格式应为 yyyy-mm-dd hh:mm:ss。 |
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET |
字符串日期时间格式应为 yyyy-mm-dd hh:mm:ss+|-hh:mm。 |
EARLIER_THAN_MINIMUM_DATE |
日期早于允许的最早日期。 |
LATER_THAN_MAXIMUM_DATE |
日期晚于允许的最晚日期。 |
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE |
构成日期范围的下限日期晚于相应的上限日期。 |
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL |
构成日期范围的上限与下限日期都为 Null。 |
DistinctError
用于描述可能的不同错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
DUPLICATE_ELEMENT |
元素重复。 |
DUPLICATE_TYPE |
类型重复。 |
FieldError
用于描述可能的字段错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
REQUIRED |
缺少必填字段。 |
IMMUTABLE_FIELD |
尝试更改的字段是不可变的。 |
INVALID_VALUE |
此字段的值无效。 |
VALUE_MUST_BE_UNSET |
无法设置该字段。 |
REQUIRED_NONEMPTY_LIST |
必填的重复字段为空。 |
FIELD_CANNOT_BE_CLEARED |
此字段无法清除。 |
BLOCKED_VALUE |
此字段的值已列入此字段的拒绝名单。 |
FIELD_CAN_ONLY_BE_CLEARED |
除清除外,无法修改该字段的值。 |
MutateError
用于描述可能的更改错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不支持收到的错误代码。 |
RESOURCE_NOT_FOUND |
找不到所请求的资源。 |
ID_EXISTS_IN_MULTIPLE_MUTATES |
不能在一个请求中对同一个资源执行两次 mutate 操作。 |
INCONSISTENT_FIELD_VALUES |
字段的内容与表示相同数据的另一个字段不匹配。 |
MUTATE_NOT_ALLOWED |
不允许对所请求的资源执行 mutate 操作。 |
RESOURCE_NOT_IN_GOOGLE_ADS |
资源不在 Google Ads 中。属于其他广告系统。 |
RESOURCE_ALREADY_EXISTS |
要创建的资源已存在。 |
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY |
此资源不能与“validateOnly”搭配使用。 |
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE |
此操作不能与“partialFailure”搭配使用。 |
RESOURCE_READ_ONLY |
尝试写入只读字段。 |
NotAllowlistedError
用于描述可能未列入许可名单的错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
收到的错误代码在此版本中未知。 |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE |
客户未列入可使用该功能的许可名单。 |
StringFormatError
用于描述可能的字符串格式错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
收到的错误代码在此版本中未知。 |
ILLEGAL_CHARS |
输入的字符串值包含不允许使用的字符。 |
INVALID_FORMAT |
所关联字段的输入字符串值无效。 |
StringLengthError
用于描述可能的字符串长度错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
收到的错误代码在此版本中未知。 |
EMPTY |
指定的字段应包含至少一个非空白字符。 |
TOO_SHORT |
名称过短。 |
TOO_LONG |
过长。 |
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 相当于 https://support.google.com/merchants/answer/6324436 一文中所述的 google_product_category ID。 |
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
包含可能的 UserInterestTaxonomyTypes 的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AFFINITY |
此用户兴趣的相似性。 |
IN_MARKET |
此用户兴趣对应的市场。 |
MOBILE_APP_INSTALL_USER |
已知安装了指定类别应用的用户。 |
VERTICAL_GEO |
基于兴趣的行业的地理位置。 |
NEW_SMART_PHONE_USER |
针对新智能手机用户的用户兴趣标准。 |
LifeEvent
人生大事:一种基于兴趣的特定行业,可在用户面临人生重大事件时覆盖他们。
JSON 表示法 |
---|
{
"resourceName": string,
"id": string,
"name": string,
"parent": string,
"launchedToAll": boolean,
"availabilities": [
{
object ( |
字段 | |
---|---|
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 |
仅限输出。E164 格式的消费者电话号码。 |
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、短信等 |
participant |
仅限输出。潜在客户对话的参与者类型:ADVERTISER 或 CONSUMER。 |
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 |
收到的来电次数 (phoneCall) 除以您的电话号码的展示次数 (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 |
广告展示后,任意营业地点 surface 上的致电按钮点击次数。此衡量指标来自基于素材资源的位置。 |
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 |
星期几,例如 MONDAY。 |
device |
指标应用于的设备。 |
external |
外部转化来源。 |
hotel |
酒店入住日(星期几)。 |
hotel |
酒店日期选择类型。 |
hotel |
酒店房价类型。 |
hotel |
酒店价格范围。 |
keyword |
关键字标准。 |
month |
一年中的月份,例如 1 月。 |
placeholder |
占位符类型。此字段仅适用于 Feed 项指标。 |
product |
商品的渠道。 |
product |
商品的渠道独占性。 |
product |
商品的使用情况。 |
recommendation |
建议类型。 |
search |
搜索引擎结果页 (SERP) 的类型。 |
search |
触发广告的关键字(包括变体)的匹配类型。 |
slot |
广告的位置。 |
conversion |
应用的转化价值规则的主要维度。NO_RULE_APPLIED 显示的是未应用价值规则的转化的总记录价值。“ORIGINAL”显示已应用价值规则的转化的原始价值。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 |
提供旅行 activity 的状态。 |
external |
广告客户提供的活动 ID。 |
ad |
广告组的资源名称。 |
asset |
素材资源组的资源名称。 |
auction |
“竞价分析”报告中竞价参与者的网域(显示网址)。 |
campaign |
广告系列的资源名称。 |
conversion |
转化操作的资源名称。 |
conversion |
转化操作名称。 |
conversion |
这会按原始转化次数和转化价值与转化次数(如果转化调整后)的增量细分您的转化列。假行包含最初所述的数据;而真行则包含现在的数据与最初所述的数据之间的增量。将两组数据相加后得到的调整后数据。 |
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 年第二季度从 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 界面中显示为“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 |
完成转化的用户是广告客户的新客户,并且具有较高的生命周期价值。 |