- JSON 表示法
- CampaignPrimaryStatus
- CampaignPrimaryStatusReason
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- LocalServicesCampaignSettings
- CategoryBid
- TravelCampaignSettings
- DemandGenCampaignSettings
- VideoCampaignSettings
- VideoAdInventoryControl
- RealTimeBiddingSetting
- NetworkSettings
- HotelSettingInfo
- DynamicSearchAdsSetting
- ShoppingSetting
- AudienceSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- LocalCampaignSetting
- LocationSourceType
- AppCampaignSetting
- AppCampaignBiddingStrategyGoalType
- AppCampaignAppStore
- CampaignExperimentType
- FrequencyCapEntry
- FrequencyCapKey
- FrequencyCapLevel
- FrequencyCapEventType
- VanityPharma
- VanityPharmaDisplayUrlMode
- VanityPharmaText
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- PaymentMode
- PerformanceMaxUpgrade
- PerformanceMaxUpgradeStatus
- ListingType
- AssetAutomationSetting
- AssetAutomationType
- AssetAutomationStatus
- CampaignKeywordMatchType
- 佣金
- ManualCpa
- ManualCpc
- ManualCpm
- ManualCpv
- PercentCpc
- TargetCpm
- TargetCpmTargetFrequencyGoal
- FixedCpm
- FixedCpmGoal
- FixedCpmTargetFrequencyGoalInfo
- FixedCpmTargetFrequencyTimeUnit
- TargetCpv
广告系列。
JSON 表示法 |
---|
{ "resourceName": string, "primaryStatus": enum ( |
字段 | |
---|---|
resourceName |
不可变。广告系列的资源名称。广告系列资源名称采用以下格式:
|
primaryStatus |
仅限输出。广告系列的主要状态。 可深入了解广告系列未投放或未以最佳方式投放的原因。对广告系列及其相关实体所做的修改可能需要一段时间才能反映在此状态中。 |
primaryStatusReasons[] |
仅限输出。广告系列的主要状态原因。 可深入了解广告系列未投放或未以最佳方式投放的原因。汇总这些原因以确定总体 CampaignPrimaryStatus。 |
status |
广告系列的状态。 添加新的广告系列时,状态默认为 ENABLED。 |
servingStatus |
仅限输出。广告系列的广告投放状态。 |
biddingStrategySystemStatus |
仅限输出。广告系列出价策略的系统状态。 |
adServingOptimizationStatus |
广告系列的广告投放优化状态。 |
advertisingChannelType |
不可变。广告系列中广告的主要投放目标。您可以在 此字段是必填字段,创建新广告系列时不应为空。 只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
advertisingChannelSubType |
不可变。对 只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
urlCustomParameters[] |
用于替换 |
localServicesCampaignSettings |
与本地生活服务广告系列相关的设置。 |
travelCampaignSettings |
旅游广告系列的设置。 |
demandGenCampaignSettings |
需求开发广告系列的设置。 |
videoCampaignSettings |
视频广告系列的设置。 |
realTimeBiddingSetting |
实时出价设置,此功能仅适用于定位到 Ad Exchange 广告联盟的广告系列。 |
networkSettings |
广告系列的投放网络设置。 |
hotelSetting |
不可变。广告系列的酒店设置。 |
dynamicSearchAdsSetting |
用于控制动态搜索广告 (DSA) 的设置。 |
shoppingSetting |
用于控制购物广告系列的设置。 |
targetingSetting |
用于定位相关功能的设置。 |
geoTargetTypeSetting |
广告的地理位置定位设置。 |
localCampaignSetting |
本地广告系列的设置。 |
appCampaignSetting |
与应用广告系列相关的设置。 |
labels[] |
仅限输出。此广告系列所附标签的资源名称。 |
experimentType |
仅限输出。广告系列的类型:正常、草稿或实验。 |
biddingStrategyType |
仅限输出。出价策略的类型。 如需创建出价策略,可以通过设置出价方案来创建标准出价策略,也可以设置 此字段为只读字段。 |
accessibleBiddingStrategy |
仅限输出。AccessibleBiddingStrategy 的资源名称,其中包含附加组合出价策略(由“biddingStrategy”标识)的不受限制属性的只读视图。如果广告系列未使用组合策略,则为空。不受限制的策略属性可供共享策略的所有客户使用,并从 AccessibleBidStrategy 资源中读取。相比之下,受限属性仅适用于策略的所有者客户及其经理。受限属性只能从 BiddingStrategy 资源中读取。 |
frequencyCaps[] |
一个列表,用于限制每个用户看到此广告系列中的广告的频率。 |
videoBrandSafetySuitability |
具体广告系列一级的品牌保障设置。可让您选择广告资源类型,以在适合您品牌的内容中展示您的广告。请参阅 https://support.google.com/google-ads/answer/7515513。 |
vanityPharma |
说明未标明品牌的医药广告将如何展示。 |
selectiveOptimization |
针对此广告系列选择性优化设置,其中包括一组作为优化目标的转化操作。此功能仅适用于使用 MULTI_CHANNEL 作为 AdvertisingChannelType 且使用 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 作为 AdvertisingChannelSubType 的应用广告系列。 |
optimizationGoalSetting |
此广告系列的优化目标设置,其中包括一组优化目标类型。 |
trackingSetting |
仅限输出。针对跟踪信息的广告系列级设置。 |
paymentMode |
广告系列的付费模式。 |
excludedParentAssetFieldTypes[] |
应从此广告系列中排除的素材资源字段类型。此广告系列将不会从更高级别沿用这些字段类型的素材资源链接。 |
excludedParentAssetSetTypes[] |
应从此广告系列中排除的素材资源集类型。此广告系列将不会从较高层级沿用这些类型的素材资源组链接。营业地点组类型(GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP 和 STATIC_LOCATION_GROUP)是 LOCATION_SYNC 的子类型。因此,如果为此字段设置了 LOCATION_SYNC,则不允许将任何营业地点组素材资源组关联到此广告系列,并且将不会投放此广告系列下的所有附加地址信息 (LE) 和附加关联商户地址信息 (ALE)。目前仅支持 LOCATION_SYNC。 |
performanceMaxUpgrade |
仅限输出。有关将升级为效果最大化广告系列的信息。 |
assetAutomationSettings[] |
包含每个 AssetAutomationType 的启用/停用状态。如需了解默认选择启用/停用行为,请参阅每种素材资源自动化类型枚举的文档。 |
keywordMatchType |
广告系列的关键字匹配类型。设置为“广泛匹配”可为广告系列中的所有关键字设置广泛匹配。 |
id |
仅限输出。广告系列的 ID。 |
name |
广告系列的名称。 此字段是必填字段,创建新广告系列时不应为空。 并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
audienceSetting |
不可变。受众群体相关功能的设置。 |
baseCampaign |
仅限输出。广告系列草稿或实验广告系列的基准广告系列资源名称。对于基本广告系列,该指标等于 此字段为只读字段。 |
campaignBudget |
广告系列的预算。 |
startDate |
广告系列在提供服务的客户所在时区开始运行的日期(采用 YYYY-MM-DD 格式)。 |
campaignGroup |
此广告系列所属的广告系列组。 |
endDate |
广告系列在提供服务的客户所在时区运行的最后一天(采用 YYYY-MM-DD 格式)。创建时,默认值为 2037-12-30,表示广告系列将无限期投放下去。要将现有的广告系列设置为无限期投放,请将此字段设置为 2037-12-30。 |
finalUrlSuffix |
用于将查询参数附加到通过并行跟踪投放的着陆页的后缀。 |
optimizationScore |
仅限输出。广告系列的优化得分。 优化得分是一个估算的分值,反映了广告系列在设置方面的优化程度,能否发挥出理想的宣传效果。其范围为 0% (0.0) 到 100% (1.0),100% 表示广告系列已充分发挥其潜力。对于未计分的广告系列,此字段为 null。 请参阅“优化得分简介”(网址为 https://support.google.com/google-ads/answer/9061546)。 此字段为只读字段。 |
urlExpansionOptOut |
表示停用将网址扩展功能扩展到更精确的网址。如果选择停用 (true),则系统只会定位到素材资源组中的最终到达网址,或者广告客户的 Google Merchant Center Feed 或商家数据 Feed 中指定的网址。如果选择启用 (false),则会定位到整个域。只能为效果最大化广告系列设置此字段,默认值为 false。 |
hotelPropertyAssetSet |
不可变。指定旅行目标的效果最大化广告系列的一组酒店房源。 |
listingType |
不可变。为此广告系列投放的广告的列表类型。此字段仅限用于效果最大化广告系列。 |
联合字段 必须是嵌入到广告系列中的组合(通过 BiddingStrategy 服务创建)或标准。 |
|
biddingStrategy |
广告系列使用的组合出价策略。 |
commission |
“佣金”是一种自动出价策略,采用这种出价策略时,广告客户需按转化价值支付一定比例的费用。 |
manualCpa |
标准的每次转化费用人工出价策略。一种人工出价策略,允许广告客户针对广告客户指定的操作设置出价。仅适用于本地生活服务广告系列。 |
manualCpc |
标准的“每次点击费用人工出价”出价策略。基于点击的人工出价,此类出价中用户按点击次数付费。 |
manualCpm |
标准的每千次展示费用人工出价策略。基于展示的人工出价,此类出价中用户按每千次展示付费。 |
manualCpv |
一种出价策略,可针对每次视频观看支付可配置的金额。 |
maximizeConversions |
标准的“尽可能提高转化次数”出价策略,可在您的预算范围内自动争取尽可能多的转化次数。 |
maximizeConversionValue |
标准的“尽可能提高转化价值”出价策略,可自动设置出价,以便在您的预算范围内尽可能增加收入。 |
targetCpa |
“目标每次转化费用”标准出价策略,可自动设置出价,在将每次转化费用 (CPA) 控制在您设定的目标水平的前提下,帮助您争取尽可能多的转化。 |
targetImpressionShare |
“目标展示次数份额”出价策略。一种自动出价策略,可通过设置出价实现指定百分比的展示次数。 |
targetRoas |
标准的“目标广告支出回报率”出价策略,可自动最大限度提高收入,同时平均达到特定的目标广告支出回报率 (ROAS)。 |
targetSpend |
“标准目标支出”出价策略,可自动设置您的出价,帮助您在预算范围内争取尽可能多的点击。 |
percentCpc |
“标准百分比形式的每次点击费用”出价策略,采用这种策略时,出价是某些商品或服务广告价格的一小部分。 |
targetCpm |
一种出价策略,可自动优化每千次展示费用。 |
fixedCpm |
采用固定每千次展示费用的人工出价策略。 |
targetCpv |
一种自动出价策略,可根据您设置的目标每次观看费用设置合适的出价来优化广告效果。 |
CampaignPrimaryStatus
描述可能的广告系列主要状态的枚举。可深入了解广告系列未投放或未以最佳方式投放的原因。对广告系列及其相关实体所做的修改可能需要一段时间才能反映在此状态中。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ELIGIBLE |
该广告系列符合投放条件。 |
PAUSED |
用户指定的广告系列处于“已暂停”状态。 |
REMOVED |
用户指定的广告系列状态会被移除。 |
ENDED |
用户指定的此广告系列的结束时间已过。 |
PENDING |
广告系列可能会在日后投放。 |
MISCONFIGURED |
该广告系列或其关联实体的用户指定设置不正确。 |
LIMITED |
广告系列或其关联实体受到用户指定设置的限制。 |
LEARNING |
自动出价系统会根据用户指定的对广告系列或相关实体所做的更改进行调整。 |
NOT_ELIGIBLE |
该广告系列不符合投放条件。 |
CampaignPrimaryStatusReason
描述广告系列的主要状态原因的枚举。可深入了解广告系列未投放或未以最佳方式投放的原因。汇总这些原因以确定广告系列的总体主要状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
CAMPAIGN_REMOVED |
用户指定的广告系列状态会被移除。 |
CAMPAIGN_PAUSED |
用户指定的广告系列处于“已暂停”状态。 |
CAMPAIGN_PENDING |
用户指定的此广告系列开始投放的时间是将来的时间。 |
CAMPAIGN_ENDED |
用户指定的此广告系列的结束时间已过。 |
CAMPAIGN_DRAFT |
此广告系列处于草稿状态。 |
BIDDING_STRATEGY_MISCONFIGURED |
该出价策略的用户指定设置不正确。 |
BIDDING_STRATEGY_LIMITED |
出价策略受用户指定的设置(例如缺少数据或类似设置)的限制。 |
BIDDING_STRATEGY_LEARNING |
自动出价系统会根据用户指定的出价策略更改进行调整。 |
BIDDING_STRATEGY_CONSTRAINED |
如果调整每次转化费用/广告支出回报率目标,广告系列有望获得更高的转化价值。 |
BUDGET_CONSTRAINED |
预算限制了广告系列的投放能力。 |
BUDGET_MISCONFIGURED |
预算包含不正确的用户指定设置。 |
SEARCH_VOLUME_LIMITED |
广告系列未定位所有相关搜索查询。 |
AD_GROUPS_PAUSED |
用户指定的广告组均处于“已暂停”状态。 |
NO_AD_GROUPS |
此广告系列中没有符合条件的广告组。 |
KEYWORDS_PAUSED |
用户指定的关键字均处于“已暂停”状态。 |
NO_KEYWORDS |
此广告系列中没有符合条件的关键字。 |
AD_GROUP_ADS_PAUSED |
用户指定的广告组广告均处于“已暂停”状态。 |
NO_AD_GROUP_ADS |
此广告系列中没有符合条件的广告组广告。 |
HAS_ADS_LIMITED_BY_POLICY |
此广告系列中至少有一个广告受到政策限制。 |
HAS_ADS_DISAPPROVED |
此广告系列中至少有一个广告被拒登。 |
MOST_ADS_UNDER_REVIEW |
此广告系列中的大部分广告均处于待审核状态。 |
MISSING_LEAD_FORM_EXTENSION |
该广告系列设有潜在客户表单目标,但缺少附加潜在客户表单。 |
MISSING_CALL_EXTENSION |
该广告系列设有来电目标,但缺少附加电话信息。 |
LEAD_FORM_EXTENSION_UNDER_REVIEW |
附加潜在客户表单正在接受审核。 |
LEAD_FORM_EXTENSION_DISAPPROVED |
附加潜在客户表单已被拒登。 |
CALL_EXTENSION_UNDER_REVIEW |
附加电话信息正在接受审核。 |
CALL_EXTENSION_DISAPPROVED |
附加电话信息已被拒登。 |
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA |
此广告系列中没有符合条件的移动应用广告组条件。 |
CAMPAIGN_GROUP_PAUSED |
用户指定的广告系列组处于“已暂停”状态。 |
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED |
与父级广告系列组相关联的所有组预算已超过用户指定的时间。 |
APP_NOT_RELEASED |
与此 ACi 广告系列相关联的应用未在该广告系列的目标国家/地区发布。 |
APP_PARTIALLY_RELEASED |
与此 ACi 广告系列相关联的应用在该广告系列的目标国家/地区已部分发布。 |
HAS_ASSET_GROUPS_DISAPPROVED |
此广告系列中至少有一个素材资源组被拒登。 |
HAS_ASSET_GROUPS_LIMITED_BY_POLICY |
此广告系列中至少有一个素材资源组受到政策限制。 |
MOST_ASSET_GROUPS_UNDER_REVIEW |
此广告系列中的大多数素材资源组均待审核。 |
NO_ASSET_GROUPS |
此广告系列中没有符合条件的素材资源组。 |
ASSET_GROUPS_PAUSED |
此广告系列中的所有素材资源组均已暂停。 |
CampaignStatus
可能的广告系列状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
广告系列处于有效状态,可以展示广告。 |
PAUSED |
用户已暂停广告系列。 |
REMOVED |
广告系列已移除。 |
CampaignServingStatus
广告系列可能的投放状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
接收的值在此版本中未知。 这是一个仅用于响应的值。 |
SERVING |
正在投放。 |
NONE |
无。 |
ENDED |
已结束。 |
PENDING |
Pending. |
SUSPENDED |
已暂停。 |
BiddingStrategySystemStatus
BiddingStrategy 可能的系统状态。
枚举 | |
---|---|
UNSPECIFIED |
表明发生了意外错误,例如未找到出价策略类型或未找到状态信息。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
该出价策略有效,AdWords没有发现该策略存在任何问题。 |
LEARNING_NEW |
该出价策略正在学习中,因为它是最近创建的或最近重新启用的。 |
LEARNING_SETTING_CHANGE |
该出价策略正在学习,因为近期更改了设置。 |
LEARNING_BUDGET_CHANGE |
由于近期预算更改,该出价策略正在学习。 |
LEARNING_COMPOSITION_CHANGE |
该出价策略正在学习,因为与其关联的广告系列、广告组或关键字的数量最近发生了变化。 |
LEARNING_CONVERSION_TYPE_CHANGE |
出价策略取决于转化报告以及客户最近修改了与该出价策略相关的转化类型。 |
LEARNING_CONVERSION_SETTING_CHANGE |
出价策略取决于转化报告,且客户最近更改了转化设置。 |
LIMITED_BY_CPC_BID_CEILING |
该出价策略受到出价上限的限制。 |
LIMITED_BY_CPC_BID_FLOOR |
该出价策略受到出价下限的限制。 |
LIMITED_BY_DATA |
出价策略受限,因为过去几周没有足够的转化流量。 |
LIMITED_BY_BUDGET |
此出价策略中有很大一部分关键字受到预算限制。 |
LIMITED_BY_LOW_PRIORITY_SPEND |
该出价策略无法达到其目标支出,因为系统已降低其支出的优先级。 |
LIMITED_BY_LOW_QUALITY |
此出价策略中有很大一部分关键字的质量得分较低。 |
LIMITED_BY_INVENTORY |
由于定位范围较小,此出价策略无法用尽其预算。 |
MISCONFIGURED_ZERO_ELIGIBILITY |
缺少转化跟踪(没有 ping)和/或智能购物广告系列的再营销名单。 |
MISCONFIGURED_CONVERSION_TYPES |
出价策略取决于转化报告,而客户缺少可能会针对该策略报告的转化类型。 |
MISCONFIGURED_CONVERSION_SETTINGS |
出价策略取决于转化报告,且客户的转化设置配置有误。 |
MISCONFIGURED_SHARED_BUDGET |
出价策略之外的某些广告系列与策略中包含的广告系列共享预算。 |
MISCONFIGURED_STRATEGY_TYPE |
该广告系列的策略类型无效,未投放。 |
PAUSED |
该出价策略无效。没有与该出价策略关联的有效广告系列、广告组或关键字。或者该出价策略没有关联的有效预算。 |
UNAVAILABLE |
此出价策略目前不支持状态报告。 |
MULTIPLE_LEARNING |
在相关时段,此出价策略存在多个 LEARNING_* 系统状态。 |
MULTIPLE_LIMITED |
此出价策略在相关时段存在多个 LIMITED_* 系统状态。 |
MULTIPLE_MISCONFIGURED |
此出价策略在相关时段存在多个 MISCONFIGURED_* 系统状态。 |
MULTIPLE |
此出价策略在相关时间段内存在多个系统状态。 |
AdServingOptimizationStatus
描述可能的投放状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
接收的值在此版本中未知。 这是一个仅用于响应的值。 |
OPTIMIZE |
系统会根据广告系列的点击率对广告投放进行优化。 |
CONVERSION_OPTIMIZE |
根据广告系列的点击率 * 转化次数来优化广告投放。如果广告系列未采用转化优化工具出价策略,则默认为“优化”。 |
ROTATE |
广告将在 90 天内均匀轮播,然后针对点击进行优化。 |
ROTATE_INDEFINITELY |
效果欠佳的广告和效果较好的广告会更均匀地展示,并且不进行优化。 |
UNAVAILABLE |
广告投放优化状态未知。 |
LocalServicesCampaignSettings
LocalServicesCampaign 子资源的设置。
JSON 表示法 |
---|
{
"categoryBids": [
{
object ( |
字段 | |
---|---|
categoryBids[] |
与 MANUAL_CPA 出价策略关联的分类级出价。 |
CategoryBid
LocalServicesReportingCampaignSettings 中的类别出价。
JSON 表示法 |
---|
{ "categoryId": string, "manualCpaBidMicros": string } |
字段 | |
---|---|
categoryId |
与出价相关联的类别。例如:xcat:service_area_business_plumber。 |
manualCpaBidMicros |
相应类别的每次转化费用人工出价。出价必须高于该类别关联的预订价格。值以微单位和广告客户的币种为单位。 |
TravelCampaignSettings
旅游广告系列的设置。
JSON 表示法 |
---|
{ "travelAccountId": string } |
字段 | |
---|---|
travelAccountId |
不可变。与旅游广告系列相关联的旅游账号 ID。 |
DemandGenCampaignSettings
需求开发广告系列的设置。
JSON 表示法 |
---|
{ "upgradedTargeting": boolean } |
字段 | |
---|---|
upgradedTargeting |
不可变。指定此广告系列是否使用升级版定位选项。当此字段设为 |
VideoCampaignSettings
视频广告系列的设置。
JSON 表示法 |
---|
{
"videoAdInventoryControl": {
object ( |
字段 | |
---|---|
videoAdInventoryControl |
针对覆盖面广告系列中自适应广告容器的广告资源控制。 |
VideoAdInventoryControl
对于使用自适应广告容器的广告系列,广告资源控制系统决定了广告可在哪些广告资源上展示。这仅适用于采用以下出价策略的广告系列:TARGET_CPM 和 FIXED_CPM。
JSON 表示法 |
---|
{ "allowInStream": boolean, "allowInFeed": boolean, "allowShorts": boolean } |
字段 | |
---|---|
allowInStream |
确定 VideoResponsiveAds 是否可用于插播视频广告。 |
allowInFeed |
确定 VideoResponsiveAds 是否可用于信息流视频广告。 |
allowShorts |
确定视频自适应广告是否可用作 Shorts 短视频格式。 |
RealTimeBiddingSetting
实时出价设置,此功能仅适用于定位到 Ad Exchange 广告网络的广告系列。
JSON 表示法 |
---|
{ "optIn": boolean } |
字段 | |
---|---|
optIn |
广告系列是否启用了实时出价。 |
NetworkSettings
广告系列的投放网络设置。
JSON 表示法 |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean, "targetYoutube": boolean, "targetGoogleTvNetwork": boolean } |
字段 | |
---|---|
targetGoogleSearch |
广告是否会随 google.com 搜索结果一起展示。 |
targetSearchNetwork |
广告是否将在 Google 搜索网络的合作伙伴网站上投放(要求 |
targetContentNetwork |
广告是否将在 Google 展示广告网络中的指定展示位置投放。展示位置使用 Placement 条件指定。 |
targetPartnerSearchNetwork |
广告是否将在 Google 合作伙伴网络中投放。这仅可用于部分 Google 合作伙伴账号。 |
targetYoutube |
广告是否会在 YouTube 上投放。 |
targetGoogleTvNetwork |
广告是否会在 Google TV 网络上投放。 |
HotelSettingInfo
酒店广告的广告系列级设置。
JSON 表示法 |
---|
{ "hotelCenterId": string } |
字段 | |
---|---|
hotelCenterId |
不可变。关联的 Hotel Center 账号。 |
DynamicSearchAdsSetting
用于控制动态搜索广告 (DSA) 的设置。
JSON 表示法 |
---|
{ "domainName": string, "languageCode": string, "feeds": [ string ], "useSuppliedUrlsOnly": boolean } |
字段 | |
---|---|
domainName |
必需。此设置代表的互联网域名,例如“google.com”或“www.google.com” |
languageCode |
必需。用于指定网域语言的语言代码,例如“en”。 |
feeds[] |
与广告系列相关联的页面 Feed 的列表。 |
useSuppliedUrlsOnly |
广告系列是否仅使用广告客户提供的网址。 |
ShoppingSetting
购物广告系列的设置。定义了可以通过广告系列宣传的所有产品,以及此广告系列与其他购物广告系列的互动方式。
JSON 表示法 |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "advertisingPartnerIds": [ string ], "merchantId": string, "campaignPriority": integer, "enableLocal": boolean, "disableProductFeed": boolean } |
字段 | |
---|---|
feedLabel |
要包含在广告系列中的产品的 Feed 标签。只能设置 FeedLabel 和 sales_country 中的一项。如果使用“sales_country”代替“sales_country”,则“FeedLabel”字段可接受格式相同的国家/地区代码,例如:“XX”。否则,可以是 Google Merchant Center 中用于 Feed 标签的任何字符串。 |
useVehicleInventory |
不可变。是否定位到车辆详情商品目录。只有智能购物广告系列支持此字段。若要在效果最大化广告系列中设置车辆详情广告资源,请改用 |
advertisingPartnerIds[] |
不可变。在广告系列内进行协作的广告合作伙伴的广告账号 ID。 |
merchantId |
Merchant Center 账号的 ID。对于创建操作,此字段是必填字段。对于购物广告系列,此字段是不可更改的。 |
campaignPriority |
广告系列的优先级。数值较高的广告系列优先于优先级较低的广告系列。对于购物广告系列,此字段是必填字段,值介于 0 和 2 之间(包括 0 和 2)。对于智能购物广告系列,此字段是选填字段,但如果设置了此字段,则必须等于 3。 |
enableLocal |
是否包含本地商品。 |
disableProductFeed |
停用可选的商品 Feed。此字段目前仅适用于需求开发广告系列,如需详细了解此功能,请访问 https://support.google.com/google-ads/answer/13721750。 |
AudienceSetting
受众群体定位设置。
JSON 表示法 |
---|
{ "useAudienceGrouped": boolean } |
字段 | |
---|---|
useAudienceGrouped |
不可变。如果为 true,此广告系列会使用受众群体资源进行受众群体定位。如果为 false,此广告系列可能会改用细分受众群条件。 |
GeoTargetTypeSetting
表示与广告地理位置定位相关的设置集合。
JSON 表示法 |
---|
{ "positiveGeoTargetType": enum ( |
字段 | |
---|---|
positiveGeoTargetType |
用于在此特定广告系列中进行肯定地理位置定位的设置。 |
negativeGeoTargetType |
此特定广告系列中用于排除性地理位置定位的设置。 |
PositiveGeoTargetType
可能的肯定地理位置定位类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
PRESENCE_OR_INTEREST |
指定当用户位于广告客户定位到的地理位置或对其表现出兴趣时会触发广告。 |
SEARCH_INTEREST |
指定当用户搜索广告客户的指定地理位置时,会触发广告展示。此方式只能用于搜索广告系列和标准购物广告系列。 |
PRESENCE |
指定当用户位于或经常前往广告客户的目标位置时,会触发广告。 |
NegativeGeoTargetType
可能的排除性地理位置定位类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
PRESENCE_OR_INTEREST |
指定如果用户位于广告客户排除的地理位置或对其表现出兴趣,则不向其展示广告。 |
PRESENCE |
指定位于广告客户排除的地理位置的用户无法看到广告。 |
LocalCampaignSetting
本地广告系列的广告系列设置。
JSON 表示法 |
---|
{
"locationSourceType": enum ( |
字段 | |
---|---|
locationSourceType |
此本地广告系列的地理位置来源类型。 |
LocationSourceType
可能的位置来源类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
GOOGLE_MY_BUSINESS |
与客户关联的商家资料相关联的营业地点。 |
AFFILIATE |
联属(连锁店)营业地点。例如,Best Buy 商店地址。 |
AppCampaignSetting
应用广告系列的广告系列级设置。
JSON 表示法 |
---|
{ "biddingStrategyGoalType": enum ( |
字段 | |
---|---|
biddingStrategyGoalType |
表示此应用广告系列的出价策略应作为优化目标。 |
appStore |
不可变。分发此特定应用的应用商店。 |
appId |
不可变。唯一标识移动应用的字符串。 |
AppCampaignBiddingStrategyGoalType
应用广告系列出价策略的目标类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST |
力求最大限度地增加应用安装量。每次转化费用出价是指目标每次安装费用。 |
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST |
尽可能增加应用安装带来的选定应用内转化。每次转化费用出价是指目标每次安装费用。 |
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST |
尽可能增加应用安装带来的选定应用内转化。每次转化费用出价是指目标每次应用内转化的费用。请注意,实际的每次转化费用可能一开始可能会高于目标每次转化费用,因为还没有发生长期转化。 |
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND |
力求最大限度地增加所有转化次数价值,例如安装 + 选定的应用内转化,同时达到或超过目标广告支出回报率。 |
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME |
力求尽可能增加应用的预注册量。 |
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST |
力求在没有目标每次安装费用的情况下最大限度地提升应用安装量。 |
AppCampaignAppStore
描述应用广告系列应用商店的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
APPLE_APP_STORE |
Apple App Store。 |
GOOGLE_APP_STORE |
Google Play。 |
CampaignExperimentType
指明此广告系列是常规广告系列、广告系列草稿还是实验广告系列。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BASE |
这是一个常规广告系列。 |
DRAFT |
这是广告系列的草稿版本。该广告系列对基本广告系列进行了一定程度的修改,但没有投放或累积指标。 |
EXPERIMENT |
这是广告系列的实验版本。对基准广告系列进行了一些修改,有一部分流量从基准广告系列转移到此实验广告系列。 |
FrequencyCapEntry
一条规则,用于指定一个广告(或某组广告)在特定时间段内最多可以向用户展示。
JSON 表示法 |
---|
{
"key": {
object ( |
字段 | |
---|---|
key |
特定频次上限的键。同一个键最多只能有一个频次上限。 |
cap |
此上限在时间范围内允许的事件数量上限。 |
FrequencyCapKey
一组用作频次上限键的字段。同一个键最多只能有一个频次上限。
JSON 表示法 |
---|
{ "level": enum ( |
字段 | |
---|---|
level |
上限所应用的级别(例如,广告组广告、广告组)。上限会应用到此级别的所有实体。 |
eventType |
上限所应用的事件类型(例如展示)。 |
timeUnit |
定义该上限所用的时间单位(例如,天、周)。 |
timeLength |
上限持续时长的单位数。 |
FrequencyCapLevel
上限所应用的级别(例如广告组广告、广告组)。上限会应用于此级别的所有资源。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AD_GROUP_AD |
该上限在广告组广告一级应用。 |
AD_GROUP |
该上限在广告组一级应用。 |
CAMPAIGN |
该上限在广告系列一级应用。 |
FrequencyCapEventType
上限所应用的事件类型(例如展示)。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
IMPRESSION |
该上限适用于广告展示次数。 |
VIDEO_VIEW |
该上限适用于视频广告观看次数。 |
VanityPharma
说明未标明品牌的医药广告将如何展示。
JSON 表示法 |
---|
{ "vanityPharmaDisplayUrlMode": enum ( |
字段 | |
---|---|
vanityPharmaDisplayUrlMode |
个性化药店网址的显示模式。 |
vanityPharmaText |
当网站说明为个性化医药网址选择显示模式时,将在文字广告的显示网址中显示的文字。 |
VanityPharmaDisplayUrlMode
描述个性化药店网址的可能显示模式的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MANUFACTURER_WEBSITE_URL |
将个性化药店网址替换为制造商网站网址。 |
WEBSITE_DESCRIPTION |
将个性化药店网址替换为网站说明。 |
VanityPharmaText
描述可能文本的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
PRESCRIPTION_TREATMENT_WEBSITE_EN |
处方治疗网站,网站内容为英语。 |
PRESCRIPTION_TREATMENT_WEBSITE_ES |
提供西班牙语网站内容的处方治疗网站 (Sitio de tratamientos con receta)。 |
PRESCRIPTION_DEVICE_WEBSITE_EN |
以英语显示网站内容的处方器械网站。 |
PRESCRIPTION_DEVICE_WEBSITE_ES |
具有西班牙语网站内容的处方器械网站 (Sitio de dispositivos con receta)。 |
MEDICAL_DEVICE_WEBSITE_EN |
网站内容为英语的医疗设备网站。 |
MEDICAL_DEVICE_WEBSITE_ES |
包含西班牙语网站内容的医疗设备网站 (Sitio de dispositivos médicos)。 |
PREVENTATIVE_TREATMENT_WEBSITE_EN |
包含英语网站内容的预防性治疗网站。 |
PREVENTATIVE_TREATMENT_WEBSITE_ES |
包含西班牙语网站内容的预防性治疗网站 (Sitio de tratamientospreventivos)。 |
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN |
处方避孕网站,网站内容以英语显示。 |
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES |
一个提供西班牙语网站内容的处方避孕网站 (Sitio de anticonceptivos con receta)。 |
PRESCRIPTION_VACCINE_WEBSITE_EN |
处方疫苗网站,网站内容以英语显示。 |
PRESCRIPTION_VACCINE_WEBSITE_ES |
包含西班牙语网站内容的处方疫苗网站 (Sitio de vacunas con receta)。 |
SelectiveOptimization
针对此广告系列选择性优化设置,其中包括一组作为优化目标的转化操作。此功能仅适用于使用 MULTI_CHANNEL 作为 AdvertisingChannelType 且使用 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 作为 AdvertisingChannelSubType 的应用广告系列。
JSON 表示法 |
---|
{ "conversionActions": [ string ] } |
字段 | |
---|---|
conversionActions[] |
一组选定的转化操作,用于优化此广告系列。 |
OptimizationGoalSetting
此广告系列的优化目标设置,其中包括一组优化目标类型。
JSON 表示法 |
---|
{
"optimizationGoalTypes": [
enum ( |
字段 | |
---|---|
optimizationGoalTypes[] |
优化目标类型的列表。 |
OptimizationGoalType
优化目标的类型
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用作返回值。表示此版本中未知的值。 |
CALL_CLICKS |
针对点击致电进行优化。致电点击转化是用户选择“致电”的次数在观看广告后联系商店。 |
DRIVING_DIRECTIONS |
针对行车路线进行优化。驾车路线转化是指用户选择“查询路线”的次数用户在观看广告后导航到相应商店 |
APP_PRE_REGISTRATION |
针对预注册进行优化。预注册转化次数是指在应用发布时收到通知的预注册用户数量。 |
TrackingSetting
针对跟踪信息的广告系列级设置。
JSON 表示法 |
---|
{ "trackingUrl": string } |
字段 | |
---|---|
trackingUrl |
仅限输出。用于动态跟踪的网址。 |
PaymentMode
描述可能的付款方式的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
CLICKS |
按互动付费。 |
CONVERSION_VALUE |
按转化价值付费。只有 AdvertisingChannelType.HOTEL、 BiddingStrategyType.COMMISSION 和 BudgetType.STANDARD 的广告系列支持此模式。 |
CONVERSIONS |
按转化次数付费。只有采用 AdvertisingChannelType.DISPLAY(不包括 AdvertisingChannelSubType.DISPLAY_GMAIL)、BidStrategyType.TARGET_CPA 和 BudgetType.FIXED_CPA 的广告系列支持此模式。客户还必须符合使用此模式的条件。如需了解详情,请参阅 Customer.eligibility_failure_reasons。 |
GUEST_STAY |
按房客入住付费的价值。只有 AdvertisingChannelType.HOTEL、 BiddingStrategyType.COMMISSION 和 BudgetType.STANDARD 的广告系列支持此模式。 |
PerformanceMaxUpgrade
有关将升级为效果最大化广告系列的广告系列的信息。
JSON 表示法 |
---|
{
"performanceMaxCampaign": string,
"preUpgradeCampaign": string,
"status": enum ( |
字段 | |
---|---|
performanceMaxCampaign |
仅限输出。指明广告系列要升级到哪个效果最大化广告系列。 |
preUpgradeCampaign |
仅限输出。表示旧版广告系列已升级为效果最大化广告系列。 |
status |
仅限输出。请求升级为效果最大化广告系列的广告系列的升级状态。 |
PerformanceMaxUpgradeStatus
广告系列的效果最大化广告系列升级状态枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
UPGRADE_IN_PROGRESS |
正在升级为效果最大化广告系列。 |
UPGRADE_COMPLETE |
升级为效果最大化广告系列已完成。 |
UPGRADE_FAILED |
未能升级为效果最大化广告系列。广告系列仍将按尝试升级前的状态投放。 |
UPGRADE_ELIGIBLE |
广告系列符合升级为效果最大化广告系列的条件。 |
ListingType
可能的商品详情类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
VEHICLES |
此广告系列投放车辆广告。 |
AssetAutomationSetting
素材资源自动化设置包含 AssetAutomationType 对和启用/停用素材资源自动化的状态
JSON 表示法 |
---|
{ "assetAutomationType": enum ( |
字段 | |
---|---|
assetAutomationType |
广告客户想要启用/停用素材资源自动化类型。 |
assetAutomationStatus |
素材资源自动化类型的启用/停用状态。 |
AssetAutomationType
素材资源自动化的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用作返回值。表示此版本中未知的值。 |
TEXT_ASSET_AUTOMATION |
文字素材资源自动化操作包括标题和广告内容描述。默认情况下,广告客户会选择启用效果最大化广告系列,同时会选择停用搜索广告系列。 |
AssetAutomationStatus
素材资源自动化的状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用作返回值。表示此版本中未知的值。 |
OPTED_IN |
选择启用后,系统将允许生成和投放某种类型的素材资源。 |
OPTED_OUT |
若选择停用此功能,系统将停止生成和投放某种类型的素材资源。 |
CampaignKeywordMatchType
描述广告系列的关键字匹配类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BROAD |
广告系列级广泛匹配。 |
佣金
“佣金”是一种自动出价策略,采用这种出价策略时,广告客户需按转化价值支付一定比例的费用。
JSON 表示法 |
---|
{ "commissionRateMicros": string } |
字段 | |
---|---|
commissionRateMicros |
佣金率界定了在转化价值中向广告客户收费的那部分。应以 (x * 1,000,000) 形式向此字段传递佣金率 x。例如,106,000 表示佣金率为 0.106 (10.6%)。 |
ManualCpa
此类型没有字段。
一种人工出价策略,允许广告客户针对广告客户指定的操作设置出价。
ManualCpc
基于点击的人工出价,此类出价中用户按点击次数付费。
JSON 表示法 |
---|
{ "enhancedCpcEnabled": boolean } |
字段 | |
---|---|
enhancedCpcEnabled |
是否根据转化优化工具数据增强出价。 |
ManualCpm
此类型没有字段。
基于展示的人工出价,此类出价中用户按每千次展示付费。
ManualCpv
此类型没有字段。
基于观看的出价,此类出价中用户按视频观看次数付费。
PercentCpc
一种出价策略,采用这种出价策略时,出价只是某些商品或服务的宣传价格的一部分。
JSON 表示法 |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
字段 | |
---|---|
cpcBidCeilingMicros |
可通过出价策略设置的出价上限。这是一个可选字段,由广告客户输入并以本地微单位指定。注意:零值的解释方式与未定义 bid_floor 的解释方式相同。 |
enhancedCpcEnabled |
针对每次竞价提高或降低出价,具体取决于带来转化的可能性。单独出价可以超过 cpcBidCeilingMicros,但不应为一个广告系列的平均出价金额。 |
TargetCpm
“目标每千次展示费用”是一种自动出价策略,可根据您设置的目标每千次展示费用设置合适的出价来优化广告效果。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 goal 。与出价目标相关的其他信息。goal 只能是下列其中一项: |
|
targetFrequencyGoal |
“目标频次”出价的目标详情。 |
TargetCpmTargetFrequencyGoal
“目标频次”出价的目标详情。
JSON 表示法 |
---|
{
"targetCount": string,
"timeUnit": enum ( |
字段 | |
---|---|
targetCount |
“目标频次”计数表示您想要覆盖单个用户的次数。 |
timeUnit |
表示您希望达到指定 targetCount 的时间段的时间范围。 |
固定每千次展示费用
固定 CPM(每千次展示费用)出价策略。采用固定每千次展示费用的人工出价策略。
JSON 表示法 |
---|
{ "goal": enum ( |
字段 | |
---|---|
goal |
固定每千次展示费用出价目标。确定确切的出价优化参数。 |
联合字段 goal_info 。与出价目标相关的其他信息。goal_info 只能是下列其中一项: |
|
targetFrequencyInfo |
“目标频次”出价策略的目标详情。 |
FixedCpmGoal
描述“固定每千次展示费用”出价策略目标的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
REACH |
达到率最大化,即看到该广告系列中广告的用户数量。 |
TARGET_FREQUENCY |
采用“目标频次”的每千次展示费用出价。优化出价,按照所请求的频次覆盖单个用户。 |
FixedCpmTargetFrequencyGoalInfo
“固定每千次展示费用”出价策略的目标频次出价目标详情。仅当出价策略目标是TARGET_FREQUENCY
时才具有相关性。
JSON 表示法 |
---|
{
"targetCount": string,
"timeUnit": enum ( |
字段 | |
---|---|
targetCount |
目标频次计数表示广告客户希望向同一用户展示广告的次数。 |
timeUnit |
表示您希望达到指定 targetCount 的时间段的时间范围。 |
FixedCpmTargetFrequencyTimeUnit
一个枚举,用于描述使用“固定每千次展示费用”出价策略时,根据目标频次优化出价的时间范围。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MONTHLY |
优化出价,在 30 天内达到目标频次。 |
TargetCpv
此类型没有字段。
“目标每次观看费用”出价策略。一种自动出价策略,可根据您设置的目标每次观看费用设置合适的出价来优化广告效果。