- JSON 表示法
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd广告组广告
- AdGroupAdStatus
- 广告
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdEffectiveLabel
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfoDeviceInfo
- 设备
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionEffectiveLabel
- AdGroupCriterionLabel
- AdGroupEffectiveLabel
- AdGroupLabel
- AgeRangeViewAgeRangeView
- Asset
- 资源类型
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- 尽可能提高转化次数
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- 广告系列
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpcManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignEffectiveLabel
- CampaignLabel
- CartDataSalesView
- 受众群体
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- 客户
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView KeywordView
- 标签
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- UserLocationView
- WebpageView
- 访问
- ProductChannel
- 转化
- AttributionType
- ConversionStatus
- 指标
- Value
- QualityScoreBucket
- InteractionEventType
- 细分
- AdNetworkType
- 关键字
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
查询返回的行。
JSON 表示法 |
---|
{ "adGroup": { object ( |
字段 | |
---|---|
ad |
查询中引用的广告组。 |
ad |
查询中引用的广告。 |
ad |
查询中引用的广告组广告有效标签。 |
ad |
查询中引用的广告组广告标签。 |
ad |
查询中引用的广告组素材资源。 |
ad |
查询中引用的广告组素材资源集。 |
ad |
查询中引用的广告组受众群体视图。 |
ad |
查询中引用的出价调节系数。 |
ad |
查询中引用的条件。 |
ad |
查询中引用的广告组条件有效标签。 |
ad |
查询中引用的广告组条件标签。 |
ad |
查询中引用的有效广告组标签。 |
ad |
查询中引用的广告组标签。 |
age |
查询中引用的年龄段视图。 |
asset |
查询中引用的资产。 |
asset |
查询中引用的素材资源组素材资源。 |
asset |
查询中引用的素材资源组信号。 |
asset |
查询中引用的素材资源组产品信息组过滤条件。 |
asset |
查询中引用的素材资源组“效果最佳的组合”视图。 |
asset |
查询中引用的素材资源组。 |
asset |
查询中引用的素材资源组素材资源。 |
asset |
查询中引用的资产集。 |
bidding |
查询中引用的出价策略。 |
campaign |
查询中引用的广告系列预算。 |
campaign |
查询中引用的广告系列。 |
campaign |
查询中引用的广告系列素材资源。 |
campaign |
查询中引用的广告系列素材资源组。 |
campaign |
查询中引用的广告系列受众群体视图。 |
campaign |
查询中引用的广告系列定位条件。 |
campaign |
查询中引用的广告系列有效标签。 |
campaign |
查询中引用的广告系列标签。 |
cart |
查询中引用的购物车数据销售视图。 |
audience |
查询中引用的受众群体。 |
conversion |
查询中引用的转化操作。 |
conversion |
查询中引用的转化自定义变量。 |
customer |
查询中引用的客户。 |
customer |
查询中引用的客户素材资源。 |
customer |
查询中引用的客户素材资源集。 |
accessible |
查询中引用的可用出价策略。 |
customer |
查询中引用的 CustomerManagerLink。 |
customer |
查询中引用的 CustomerClient。 |
dynamic |
查询中引用的动态搜索广告搜索字词视图。 |
gender |
查询中引用的性别视图。 |
geo |
查询中引用的地理位置定位目标常量。 |
keyword |
查询中引用的关键字视图。 |
label |
查询中引用的标签。 |
language |
查询中引用的语言常量。 |
location |
查询中引用的位置视图。 |
product |
查询中引用的商品出价类别。 |
product |
查询中引用的产品组视图。 |
shopping |
查询中引用的购物广告效果视图。 |
user |
查询中引用的用户列表。 |
user |
查询中引用的用户位置视图。 |
webpage |
查询中引用的网页视图。 |
visit |
查询中引用的事件级访问。 |
conversion |
查询中引用的事件级转化。 |
metrics |
指标。 |
segments |
细分。 |
custom |
自定义列。 |
广告组
广告组。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resource |
广告组的资源名称。广告组资源名称的格式如下:
|
status |
广告组的状态。 |
type |
广告组的类型。 |
ad |
广告组的广告轮播模式。 |
creation |
创建此广告组时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
targeting |
用于定位相关功能的设置。 |
labels[] |
附加到此广告组的标签的资源名称。 |
effective |
附加到此广告组的有效标签的资源名称。有效标签是指继承或直接分配给此广告组的标签。 |
engine |
外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请改用“adGroup.id”。 |
start |
此广告组开始投放广告的日期。默认情况下,广告组会立即或在广告组的开始日期(以较早者为准)开始投放广告。如果设置了此字段,则广告组将从客户时区的指定日期开始时开始投放广告。此字段仅适用于 Microsoft Advertising 和 Facebook 网关账号。 格式:YYYY-MM-DD 示例:2019-03-14 |
end |
广告组停止投放广告的日期。默认情况下,广告组会在广告组的结束日期停止投放广告。如果设置了此字段,则广告组会在客户时区的指定日期结束时停止投放广告。此字段仅适用于 Microsoft Advertising 和 Facebook 网关账号。 格式:YYYY-MM-DD 示例:2019-03-14 |
language |
广告组中的广告和关键字的语言。此字段仅适用于 Microsoft Advertising 账号。更多详情:https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last |
上次修改此广告组的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
id |
广告组的 ID。 |
name |
广告组的名称。 此字段为必填字段,在创建新广告组时不应为空。 其包含的 UTF-8 全角字符必须少于 255 个。 并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
cpc |
每次点击费用 (cost-per-click) 出价上限。 |
engine |
广告组的引擎状态。 |
AdGroupStatus
广告组可能的状态。
枚举 | |
---|---|
UNSPECIFIED |
状态尚未指定。 |
UNKNOWN |
接收的值在此版本中未知。 这是一个仅用于响应的值。 |
ENABLED |
广告组已启用。 |
PAUSED |
广告组处于暂停状态。 |
REMOVED |
广告组已移除。 |
AdGroupType
列出广告组可能类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定类型。 |
UNKNOWN |
此版本中未知收到的值。 这是仅限响应的值。 |
SEARCH_STANDARD |
搜索广告系列的默认广告组类型。 |
DISPLAY_STANDARD |
展示广告系列的默认广告组类型。 |
SHOPPING_PRODUCT_ADS |
用于投放标准产品广告的购物广告系列的广告组类型。 |
SHOPPING_SHOWCASE_ADS |
仅限在购物搜索结果中投放橱窗广告或商家广告的广告组的类型。 |
HOTEL_ADS |
酒店广告系列的默认广告组类型。 |
SHOPPING_SMART_ADS |
智能购物广告系列中的广告组类型。 |
VIDEO_BUMPER |
不可跳过的简短插播视频广告。 |
VIDEO_TRUE_VIEW_IN_STREAM |
TrueView(可跳过)插播视频广告。 |
VIDEO_TRUE_VIEW_IN_DISPLAY |
TrueView 展示视频广告。 |
VIDEO_NON_SKIPPABLE_IN_STREAM |
不可跳过的插播视频广告。 |
VIDEO_OUTSTREAM |
外播视频广告。 |
SEARCH_DYNAMIC_ADS |
动态搜索广告组的广告组类型。 |
SHOPPING_COMPARISON_LISTING_ADS |
比价购物广告系列中广告组的类型。 |
PROMOTED_HOTEL_ADS |
促销酒店广告组的广告组类型。 |
VIDEO_RESPONSIVE |
自适应视频广告组。 |
VIDEO_EFFICIENT_REACH |
视频“经济实惠地扩大覆盖面”广告组。 |
SMART_CAMPAIGN_ADS |
智能广告系列的广告组类型。 |
TRAVEL_ADS |
旅游广告系列的广告组类型。 |
AdGroupAdRotationMode
广告组可能的广告轮播模式。
枚举 | |
---|---|
UNSPECIFIED |
未指定广告轮播模式。 |
UNKNOWN |
此版本中未知收到的值。 这是仅限响应的值。 |
OPTIMIZE |
根据点击次数或转化次数优化广告组的广告。 |
ROTATE_FOREVER |
永久均匀轮播。 |
AdGroupEngineStatus
广告组引擎的状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AD_GROUP_ELIGIBLE |
已弃用。请勿使用。 |
AD_GROUP_EXPIRED |
由于广告组的结束日期已过,因此该广告组没有广告在投放。 |
AD_GROUP_REMOVED |
广告组已被删除。 |
AD_GROUP_DRAFT |
由于关联的广告组仍处于草稿状态,因此此广告组没有投放任何广告。 |
AD_GROUP_PAUSED |
该广告组已暂停。 |
AD_GROUP_SERVING |
广告组处于有效状态,目前正在投放广告。 |
AD_GROUP_SUBMITTED |
广告组已提交(Microsoft Bing Ads 旧版状态)。 |
CAMPAIGN_PAUSED |
由于广告系列已暂停,因此此广告组未投放任何广告。 |
ACCOUNT_PAUSED |
由于账号已暂停,因此此广告组没有投放任何广告。 |
TargetingSetting
广告系列一级和广告组一级的与定位相关的功能设置。如需详细了解定位设置,请访问 https://support.google.com/google-ads/answer/7365594
JSON 表示法 |
---|
{
"targetRestrictions": [
{
object ( |
字段 | |
---|---|
target |
用于限制广告系列或广告组覆盖面的每个定位维度的设置。 |
TargetRestriction
按定位维度显示的定位设置列表。
JSON 表示法 |
---|
{
"targetingDimension": enum ( |
字段 | |
---|---|
targeting |
这些设置适用的定位维度。 |
bid |
指示是将您的广告限制为仅根据您为此 targetingDimension 选择的条件进行展示,还是定位到此 targetingDimension 的所有值,并根据您在其他 targetingDimension 中的定位条件展示广告。如果值为 |
TargetingDimension
描述可能的定位维度的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
KEYWORD |
关键字标准,例如“火星游轮”。您可以将 KEYWORD 用作自定义出价维度。关键字始终是定位维度,因此无法使用 TargetRestriction 将其设为目标“全部”维度。 |
AUDIENCE |
受众群体条件,包括用户名单、用户兴趣、自定义的兴趣相似细分受众群和自定义的有购买意向受众群体。 |
TOPIC |
用于定位内容类别的主题条件,例如用于展示广告和视频定位的“category::Animals>Pets”。 |
GENDER |
用于定位性别的条件。 |
AGE_RANGE |
用于定位年龄段的条件。 |
PLACEMENT |
展示位置条件,包括“www.flowers4sale.com”等网站,以及移动应用程序、移动应用类别、YouTube 视频和 YouTube 频道。 |
PARENTAL_STATUS |
生育情况定位条件。 |
INCOME_RANGE |
收入范围定位条件。 |
AdGroupAd
广告组广告。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resource |
广告的资源名称。广告组广告资源名称的格式如下:
|
status |
广告的状态。 |
ad |
广告。 |
creation |
创建此 adGroupAd 时的时间戳。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
labels[] |
附加到此广告组广告的标签的资源名称。 |
effective |
附加到此广告的有效标签的资源名称。有效标签是指继承或直接分配给此广告的标签。 |
engine |
外部引擎账号中的广告的 ID。此字段仅适用于 Search Ads 360 账号,例如 Yahoo Japan、Microsoft、百度等。对于非 Search Ads 360 实体,请改用“adGroupAd.ad.id”。 |
engine |
外部引擎账号中的广告的其他状态。可能的状态(取决于外部账号的类型)包括“活跃”“有效”“待审核”等。 |
last |
上次修改此广告组广告的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
AdGroupAdStatus
AdGroupAd 的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
接收的值在此版本中未知。 这是仅限响应的值。 |
ENABLED |
广告组广告已启用。 |
PAUSED |
广告组中的广告已暂停。 |
REMOVED |
广告组广告已移除。 |
广告
某个广告。
JSON 表示法 |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
字段 | |
---|---|
resource |
广告的资源名称。广告资源名称的格式为:
|
final |
广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
type |
广告的类型。 |
id |
广告的 ID。 |
display |
在某些广告格式的广告说明中显示的网址。 |
name |
广告的名称。此名称仅用于能够标识广告。该名称不必是唯一的,也不会影响投放的广告。目前只有 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd 支持名称字段。 |
联合字段 ad_data 。与广告类型相关的详细信息。必须设置一个值。ad_data 只能是下列其中一项: |
|
text |
与文字广告有关的详细信息。 |
expanded |
与加大型文字广告相关的详细信息。 |
responsive |
与自适应搜索广告相关的详细信息。 |
product |
与产品广告相关的详细信息。 |
expanded |
与加大型动态搜索广告相关的详细信息。 |
AdType
广告的可能类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
接收的值在此版本中未知。 这是一个仅用于响应的值。 |
TEXT_AD |
广告是文字广告。 |
EXPANDED_TEXT_AD |
广告是加大型文字广告。 |
CALL_ONLY_AD |
广告是来电专用广告。 |
EXPANDED_DYNAMIC_SEARCH_AD |
广告是加大型动态搜索广告。 |
HOTEL_AD |
广告是酒店广告。 |
SHOPPING_SMART_AD |
广告是智能购物广告。 |
SHOPPING_PRODUCT_AD |
该广告是标准购物广告。 |
VIDEO_AD |
广告是视频广告。 |
GMAIL_AD |
此广告是 Gmail 广告。 |
IMAGE_AD |
此广告是图片广告。 |
RESPONSIVE_SEARCH_AD |
广告是自适应搜索广告。 |
LEGACY_RESPONSIVE_DISPLAY_AD |
广告是旧版自适应展示广告。 |
APP_AD |
广告是应用广告。 |
LEGACY_APP_INSTALL_AD |
广告是旧版应用安装广告。 |
RESPONSIVE_DISPLAY_AD |
广告是自适应展示广告。 |
LOCAL_AD |
广告是本地广告。 |
HTML5_UPLOAD_AD |
该广告是产品类型为 HTML5_UPLOAD_AD 的上传的展示广告。 |
DYNAMIC_HTML5_AD |
广告是上传的展示广告,采用 DYNAMIC_HTML5_* 产品类型之一。 |
APP_ENGAGEMENT_AD |
广告是应用互动广告。 |
SHOPPING_COMPARISON_LISTING_AD |
该广告是购物比价购物广告。 |
VIDEO_BUMPER_AD |
导视视频广告。 |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
不可跳过的视频插播广告。 |
VIDEO_OUTSTREAM_AD |
外播视频广告。 |
VIDEO_TRUEVIEW_DISCOVERY_AD |
视频 TrueView 展示广告。 |
VIDEO_TRUEVIEW_IN_STREAM_AD |
TrueView 插播视频广告。 |
VIDEO_RESPONSIVE_AD |
视频自适应广告。 |
SMART_CAMPAIGN_AD |
智能广告系列。 |
APP_PRE_REGISTRATION_AD |
通用应用预注册广告。 |
DISCOVERY_MULTI_ASSET_AD |
发现广告多素材资源广告。 |
DISCOVERY_CAROUSEL_AD |
轮播式发现广告。 |
TRAVEL_AD |
旅游广告。 |
DISCOVERY_VIDEO_RESPONSIVE_AD |
自适应视频发现广告。 |
MULTIMEDIA_AD |
多媒体广告。 |
SearchAds360TextAdInfo
Search Ads 360 文字广告。
JSON 表示法 |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
字段 | |
---|---|
headline |
广告的标题。 |
description1 |
广告说明的第一行。 |
description2 |
广告说明的第二行。 |
display |
广告的显示网址。 |
display |
广告的显示移动网址。 |
ad |
广告的跟踪 ID。 |
SearchAds360ExpandedTextAdInfo
Search Ads 360 加大型文字广告。
JSON 表示法 |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
字段 | |
---|---|
headline |
广告的标题。 |
headline2 |
广告的第二个标题。 |
headline3 |
广告的第三个标题。 |
description1 |
广告说明的第一行。 |
description2 |
广告说明的第二行。 |
path1 |
附加到自动生成的可见网址(带有分隔符)的文本。 |
path2 |
使用分隔符附加到 path1 的文本。 |
ad |
广告的跟踪 ID。 |
SearchAds360ResponsiveSearchAdInfo
Search Ads 360 自适应搜索广告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
path1 |
附加到自动生成的可见网址(带有分隔符)的文本。 |
path2 |
使用分隔符附加到 path1 的文本。 |
ad |
广告的跟踪 ID。 |
AdTextAsset
广告中使用的文字素材资源。
JSON 表示法 |
---|
{ "text": string } |
字段 | |
---|---|
text |
素材资源文字。 |
SearchAds360ProductAdInfo
此类型没有字段。
Search Ads 360 产品广告。
SearchAds360ExpandedDynamicSearchAdInfo
加大型动态搜索广告。
JSON 表示法 |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
字段 | |
---|---|
description1 |
广告说明的第一行。 |
description2 |
广告说明的第二行。 |
ad |
广告的跟踪 ID。 |
AdGroupAdEngineStatus
枚举 AdGroupAd 引擎状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AD_GROUP_AD_ELIGIBLE |
已弃用。请勿使用。 |
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN |
百度:广告素材未获批准。 |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
百度:移动网址正在接受审核。 |
AD_GROUP_AD_PARTIALLY_INVALID |
百度:广告素材在移动设备上无效,但在桌面设备上有效。 |
AD_GROUP_AD_TO_BE_ACTIVATED |
百度:广告素材已可激活。 |
AD_GROUP_AD_NOT_REVIEWED |
百度:广告素材未经审核。 |
AD_GROUP_AD_ON_HOLD |
已弃用。请勿使用。之前由 Gemini 使用 |
AD_GROUP_AD_PAUSED |
广告素材已暂停。 |
AD_GROUP_AD_REMOVED |
广告素材已移除。 |
AD_GROUP_AD_PENDING_REVIEW |
广告素材正在等待审核。 |
AD_GROUP_AD_UNDER_REVIEW |
广告素材正在接受审核。 |
AD_GROUP_AD_APPROVED |
广告素材已获批准。 |
AD_GROUP_AD_DISAPPROVED |
广告素材已被拒登。 |
AD_GROUP_AD_SERVING |
广告素材正在投放。 |
AD_GROUP_AD_ACCOUNT_PAUSED |
由于账号处于暂停状态,广告素材也处于暂停状态。 |
AD_GROUP_AD_CAMPAIGN_PAUSED |
由于广告系列处于暂停状态,因此广告素材也处于暂停状态。 |
AD_GROUP_AD_AD_GROUP_PAUSED |
由于广告组处于暂停状态,因此广告素材也处于暂停状态。 |
AdGroupAdEffectiveLabel
广告组广告与有效标签之间的关系。有效标签是指继承或直接分配给此广告组广告的标签。
JSON 表示法 |
---|
{ "resourceName": string, "adGroupAd": string, "label": string, "ownerCustomerId": string } |
字段 | |
---|---|
resource |
广告组广告有效标签的资源名称。广告组广告有效标签资源名称采用以下格式: |
ad |
有效标签附加到的广告组广告。 |
label |
分配给广告组广告的有效标签。 |
owner |
拥有有效标签的客户的 ID。 |
AdGroupAdLabel
广告组广告与标签之间的关系。
JSON 表示法 |
---|
{ "resourceName": string, "adGroupAd": string, "label": string, "ownerCustomerId": string } |
字段 | |
---|---|
resource |
广告组广告标签的资源名称。广告组广告标签资源名称采用以下格式: |
ad |
标签附加到的广告组广告。 |
label |
分配给广告组广告的标签。 |
owner |
标签所属客户的 ID。 |
AdGroupAsset
广告组与素材资源之间的关联。
JSON 表示法 |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
字段 | |
---|---|
resource |
广告组素材资源的资源名称。AdGroupAsset 资源名称采用以下格式:
|
ad |
必需。素材资源关联到的广告组。 |
asset |
必需。与广告组关联的素材资源。 |
status |
广告组素材资源的状态。 |
AssetLinkStatus
用于描述资产关联状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
已启用素材资源关联。 |
REMOVED |
素材资源链接已移除。 |
PAUSED |
素材资源关联已暂停。 |
AdGroupAssetSet
AdGroupAssetSet 是广告组与素材资源集之间的关联。创建 AdGroupAssetSet 会将素材资源组与广告组相关联。
JSON 表示法 |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
字段 | |
---|---|
resource |
广告组素材资源组的资源名称。广告组素材资源组资源名称的格式为:
|
ad |
此素材资源集关联到的广告组。 |
asset |
与广告组关联的素材资源集。 |
status |
广告组素材资源组的状态。只读。 |
AssetSetLinkStatus
素材资源集与其容器之间可能关联的状态。
枚举 | |
---|---|
UNSPECIFIED |
状态尚未指定。 |
UNKNOWN |
此版本中未知收到的值。这是仅限响应的值。 |
ENABLED |
已启用素材资源集与其容器之间的关联。 |
REMOVED |
资产集与其容器之间的关联会被移除。 |
AdGroupAudienceView
广告组受众群体视图。包括在受众群体一级汇总的展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式:
|
AdGroupBidModifier
表示广告组出价调节系数。
JSON 表示法 |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
字段 | |
---|---|
resource |
广告组出价调节系数的资源名称。广告组出价调节系数资源名称采用以下格式:
|
bid |
条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。对于 PreferredContent,该范围介于 1.0 - 6.0 之间。使用 0 可停用设备类型。 |
联合字段 从 V5 开始,在创建操作中是必需的。 |
|
device |
设备条件。 |
DeviceInfo
设备条件。
JSON 表示法 |
---|
{
"type": enum ( |
字段 | |
---|---|
type |
设备类型。 |
设备
枚举可用于定位的 Google Ads 设备。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
MOBILE |
配备完善网络浏览功能的移动设备。 |
TABLET |
配备完善的网络浏览功能的平板电脑。 |
DESKTOP |
计算机。 |
CONNECTED_TV |
智能电视和游戏机。 |
OTHER |
其他设备类型。 |
AdGroupCriterion
广告组标准。adGroupCriterion 报告仅返回明确添加到广告组中的条件。
JSON 表示法 |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
字段 | |
---|---|
resource |
广告组条件的资源名称。广告组条件资源名称采用以下格式:
|
creation |
创建此广告组条件时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
status |
条件的状态。 这是广告组条件实体的状态,由客户端设置。注意:界面报告可能包含其他信息,这些信息会影响条件是否能够运行。在某些情况下,在 API 中移除的条件可能仍会在界面中显示为已启用。例如,默认情况下,广告系列会面向所有年龄段的用户展示(已被排除的除外)。该界面会将各个年龄段显示为“已启用”,因为它们有资格观看广告;但 AdGroupCriterion.status 会显示为“已移除”,因为系统未添加任何肯定条件。 |
quality |
有关标准质量的信息。 |
type |
标准的类型。 |
labels[] |
广告组条件所附标签的资源名称。 |
effective |
附加到此广告组条件的有效标签的资源名称。有效标签是指继承或直接分配给此广告组条件的标签。 |
position |
针对不同位置的条件出价的估算值。 |
final |
广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
engine |
外部引擎账号中的广告组条件的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请改用“adGroupCriterion.criterion_id”。 |
last |
上次修改此广告组条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
criterion |
条件的 ID。 |
ad |
条件所属的广告组。 |
negative |
是定位 ( 该字段不可更改。 如需将条件从正切换为负,请先移除再重新添加。 |
bid |
条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
cpc |
每次点击费用出价。 |
effective |
有效每次点击费用 (cost-per-click) 出价。 |
engine |
广告组条件的引擎状态。 |
final |
用于将参数附加到最终到达网址的网址模板。 |
tracking |
用于构建跟踪网址的网址模板。 |
联合字段 只能设置一个值。 |
|
keyword |
关键字。 |
listing |
商品信息组。 |
age |
年龄段。 |
gender |
性别。 |
user |
用户名单。 |
webpage |
网页 |
location |
位置信息。 |
AdGroupCriterionStatus
AdGroupCriterion 的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
接收的值在此版本中未知。 这是一个仅用于响应的值。 |
ENABLED |
广告组条件已启用。 |
PAUSED |
广告组条件处于暂停状态。 |
REMOVED |
广告组条件已移除。 |
QualityInfo
用于存放广告组条件质量信息的容器。
JSON 表示法 |
---|
{ "qualityScore": integer } |
字段 | |
---|---|
quality |
质量得分。 如果 Google 没有足够的信息来确定值,则系统可能不会填充该字段。 |
CriterionType
描述可能的条件类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
KEYWORD |
关键字,例如“火星之旅”。 |
PLACEMENT |
展示位置(也称为网站),例如“www.flowers4sale.com” |
MOBILE_APP_CATEGORY |
要定位到的移动应用类别。 |
MOBILE_APPLICATION |
要定位的移动应用。 |
DEVICE |
要定位的设备。 |
LOCATION |
要定位到的地理位置。 |
LISTING_GROUP |
要定位的产品信息组。 |
AD_SCHEDULE |
广告投放时间。 |
AGE_RANGE |
年龄段。 |
GENDER |
性别。 |
INCOME_RANGE |
收入范围。 |
PARENTAL_STATUS |
育儿状况。 |
YOUTUBE_VIDEO |
YouTube 视频。 |
YOUTUBE_CHANNEL |
YouTube 频道。 |
USER_LIST |
用户名单。 |
PROXIMITY |
近距离。 |
TOPIC |
展示广告网络上的主题定位条件(例如“宠物和动物”)。 |
LISTING_SCOPE |
要定位到的商品详情范围。 |
LANGUAGE |
语言。 |
IP_BLOCK |
IpBlock。 |
CONTENT_LABEL |
用于类别排除的内容标签。 |
CARRIER |
运营商。 |
USER_INTEREST |
用户感兴趣的类别。 |
WEBPAGE |
动态搜索广告的网页条件。 |
OPERATING_SYSTEM_VERSION |
操作系统版本 |
APP_PAYMENT_MODEL |
应用付费模式。 |
MOBILE_DEVICE |
移动设备。 |
CUSTOM_AFFINITY |
自定义的兴趣相似受众群体。 |
CUSTOM_INTENT |
自定义的意向受众群体。 |
LOCATION_GROUP |
营业地点组。 |
CUSTOM_AUDIENCE |
自定义受众群体 |
COMBINED_AUDIENCE |
组合的受众群体 |
KEYWORD_THEME |
智能广告系列关键字主题 |
AUDIENCE |
受众群体 |
LOCAL_SERVICE_ID |
本地生活服务广告服务 ID。 |
BRAND |
品牌 |
BRAND_LIST |
品牌列表 |
LIFE_EVENT |
人生大事 |
位置估算
针对不同位置的条件出价的估算值。
JSON 表示法 |
---|
{ "topOfPageCpcMicros": string } |
字段 | |
---|---|
top |
要让广告显示在搜索结果首页顶部所需的每次点击费用出价的估算值。 |
AdGroupCriterionEngineStatus
枚举 AdGroupCriterion 引擎状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AD_GROUP_CRITERION_ELIGIBLE |
已弃用。请勿使用。 |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
百度:出价或质量太低,无法显示。 |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
百度:对于移动设备而言,出价过低或质量太差;但可在桌面设备上显示。 |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
百度:出价或质量对于桌面设备来说过低,但可在移动设备上显示。 |
AD_GROUP_CRITERION_INVALID_SEARCH |
百度:出价或质量太低,无法显示。 |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
百度:由于搜索量较低,百度已将其暂停。 |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
百度:移动网址正在接受审核。 |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
百度:某个设备的着陆页无效,而其他设备的着陆页有效。 |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
百度:百度账号管理已创建关键字并将其暂停,现在您可以启用该关键字。 |
AD_GROUP_CRITERION_UNDER_REVIEW |
百度:正在等待百度审核。Gemini:条件正在审核中。 |
AD_GROUP_CRITERION_NOT_REVIEWED |
百度:待审核的标准。 |
AD_GROUP_CRITERION_ON_HOLD |
已弃用。请勿使用。之前由 Gemini 使用 |
AD_GROUP_CRITERION_PENDING_REVIEW |
Y!J:条件待审核 |
AD_GROUP_CRITERION_PAUSED |
标准已暂停。 |
AD_GROUP_CRITERION_REMOVED |
已移除标准。 |
AD_GROUP_CRITERION_APPROVED |
条件已获批准。 |
AD_GROUP_CRITERION_DISAPPROVED |
条件已被拒绝。 |
AD_GROUP_CRITERION_SERVING |
条件处于有效状态且正在投放。 |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
由于账号处于暂停状态,因此此条件也已暂停。 |
KeywordInfo
关键字条件。
JSON 表示法 |
---|
{
"matchType": enum ( |
字段 | |
---|---|
match |
关键字的匹配类型。 |
text |
关键字文本(最多 80 个字符和 10 个字词)。 |
KeywordMatchType
可能的关键字匹配类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
EXACT |
完全匹配。 |
PHRASE |
词组匹配。 |
BROAD |
广泛匹配。 |
ListingGroupInfo
产品信息组条件。
JSON 表示法 |
---|
{
"type": enum ( |
字段 | |
---|---|
type |
产品信息组的类型。 |
ListingGroupType
商家信息组的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
SUBDIVISION |
根据某些商品详情维度对商品进行细分。这些节点不会用于定位商家信息条目,而只是用于定义树的结构。 |
UNIT |
产品信息组的单位,用于定义出价。 |
AgeRangeInfo
年龄范围条件。
JSON 表示法 |
---|
{
"type": enum ( |
字段 | |
---|---|
type |
年龄段的类型。 |
AgeRangeType
受众特征年龄段的类型(例如,年龄在 18 至 24 岁之间)。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AGE_RANGE_18_24 |
年龄在 18 至 24 岁之间。 |
AGE_RANGE_25_34 |
年龄在 25 至 34 岁之间。 |
AGE_RANGE_35_44 |
年龄在 35 至 44 岁之间。 |
AGE_RANGE_45_54 |
年龄在 45 至 54 岁之间。 |
AGE_RANGE_55_64 |
年龄在 55 至 64 岁之间。 |
AGE_RANGE_65_UP |
65 岁及以上。 |
AGE_RANGE_UNDETERMINED |
年龄段未确定。 |
GenderInfo
性别条件。
JSON 表示法 |
---|
{
"type": enum ( |
字段 | |
---|---|
type |
性别的类型。 |
GenderType
受众特征中的性别类型(例如,女性)。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
MALE |
男。 |
FEMALE |
女性。 |
UNDETERMINED |
性别未确定。 |
UserListInfo
用户列表标准。表示由广告客户定义的要定位的用户列表。
JSON 表示法 |
---|
{ "userList": string } |
字段 | |
---|---|
user |
用户名单资源名称。 |
WebpageInfo
表示用于定位广告客户网站网页的条件。
JSON 表示法 |
---|
{
"conditions": [
{
object ( |
字段 | |
---|---|
conditions[] |
网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。 此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
coverage |
网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。此字段为只读字段。 |
criterion |
由此参数定义的条件的名称。名称值将用于对此类参数进行标识、排序和过滤。 此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
WebpageConditionInfo
用于定位广告客户网站网页的逻辑表达式。
JSON 表示法 |
---|
{ "operand": enum ( |
字段 | |
---|---|
operand |
网页定位条件的操作数。 |
operator |
网页定位条件的运算符。 |
argument |
网页定位条件的参数。 |
WebpageConditionOperand
网页条件中的网页条件运算符。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
URL |
表示网页网址定位条件的操作数。 |
CATEGORY |
表示网页类别定位条件的操作数。 |
PAGE_TITLE |
表示网页标题定位条件的运算数。 |
PAGE_CONTENT |
表示网页内容定位条件的操作数。 |
CUSTOM_LABEL |
表示网页自定义标签定位条件的运算数。 |
WebpageConditionOperator
网页条件中的网页条件运算符。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
EQUALS |
参数网站条件等于被比较的网站条件。 |
CONTAINS |
实参网站条件是被比较的网站条件的一部分。 |
LocationInfo
地理位置条件。
JSON 表示法 |
---|
{ "geoTargetConstant": string } |
字段 | |
---|---|
geo |
目标地理位置常量资源名称。 |
AdGroupCriterionEffectiveLabel
广告组条件与有效标签之间的关系。有效标签是指继承或直接分配给此广告组条件的标签。
JSON 表示法 |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
字段 | |
---|---|
resource |
广告组条件有效标签的资源名称。广告组条件有效标签资源名称采用以下格式: |
ad |
附加了有效标签的广告组条件。 |
label |
分配给广告组条件的有效标签。 |
owner |
拥有有效标签的客户的 ID。 |
AdGroupCriterionLabel
广告组条件与标签之间的关系。
JSON 表示法 |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
字段 | |
---|---|
resource |
广告组条件标签的资源名称。广告组条件标签资源名称采用以下格式: |
ad |
标签附加到的广告组条件。 |
label |
分配给广告组条件的标签。 |
owner |
标签所属客户的 ID。 |
AdGroupEffectiveLabel
广告组与有效标签之间的关系。有效标签是指继承或直接分配给此广告组的标签。
JSON 表示法 |
---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
字段 | |
---|---|
resource |
广告组有效标签的资源名称。广告组有效标签资源名称采用以下格式: |
ad |
有效标签附加到的广告组。 |
label |
分配给广告组的有效标签。 |
owner |
拥有有效标签的客户的 ID。 |
AdGroupLabel
广告组与标签之间的关系。
JSON 表示法 |
---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
字段 | |
---|---|
resource |
广告组标签的资源名称。广告组标签资源名称采用以下格式: |
ad |
标签附加到的广告组。 |
label |
分配给广告组的标签。 |
owner |
标签所属客户的 ID。 |
AgeRangeView
年龄段视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
年龄段视图的资源名称。年龄段视图资源名称采用以下格式:
|
素材资源
素材资源是广告的组成部分,可在多个广告中共享。它可以是图片 (ImageAsset)、视频 (YoutubeVideoAsset) 等。资源是不可变的,无法删除。如需停止投放某个素材资源,请从使用该素材资源的实体中移除该素材资源。
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resource |
资源的资源名称。资产资源名称的格式为:
|
type |
资源的类型。 |
final |
所有跨网域重定向之后可能的最终到达网址的列表。 |
status |
素材资源的状态。 |
creation |
创建此素材资源时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
last |
上次修改此素材资源的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
id |
资产的 ID。 |
name |
资产的名称(可选)。 |
tracking |
用于构建跟踪网址的网址模板。 |
engine |
素材资源的引擎状态。 |
联合字段 asset_data 。资产的具体类型。asset_data 只能是下列其中一项: |
|
youtube |
YouTube 视频素材资源。 |
image |
图片素材资源。 |
text |
文字素材资源。 |
callout |
统一的宣传信息素材资源。 |
sitelink |
统一的站内链接素材资源。 |
page |
统一的页面 Feed 素材资源。 |
mobile |
移动应用素材资源。 |
call |
统一的电话素材资源。 |
call |
号召性用语素材资源。 |
location |
统一的地址素材资源。 |
资源类型
描述可能的资产类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
YOUTUBE_VIDEO |
YouTube 视频素材资源。 |
MEDIA_BUNDLE |
媒体包素材资源。 |
IMAGE |
图片素材资源。 |
TEXT |
文字素材资源。 |
LEAD_FORM |
潜在客户表单素材资源。 |
BOOK_ON_GOOGLE |
“通过 Google 预订”素材资源。 |
PROMOTION |
促销信息素材资源。 |
CALLOUT |
宣传信息素材资源。 |
STRUCTURED_SNIPPET |
结构化摘要素材资源。 |
SITELINK |
站内链接素材资源。 |
PAGE_FEED |
页面 Feed 素材资源。 |
DYNAMIC_EDUCATION |
动态教育素材资源。 |
MOBILE_APP |
移动应用素材资源。 |
HOTEL_CALLOUT |
酒店宣传信息素材资源。 |
CALL |
电话素材资源。 |
PRICE |
价格素材资源。 |
CALL_TO_ACTION |
号召性用语素材资源。 |
DYNAMIC_REAL_ESTATE |
动态房地产素材资源。 |
DYNAMIC_CUSTOM |
动态自定义素材资源。 |
DYNAMIC_HOTELS_AND_RENTALS |
动态酒店及房屋租赁素材资源。 |
DYNAMIC_FLIGHTS |
动态航班素材资源。 |
DISCOVERY_CAROUSEL_CARD |
轮播式发现广告卡片素材资源。 |
DYNAMIC_TRAVEL |
动态旅行素材资源。 |
DYNAMIC_LOCAL |
动态本地素材资源。 |
DYNAMIC_JOBS |
动态职位素材资源。 |
LOCATION |
地址素材资源。 |
HOTEL_PROPERTY |
酒店房源素材资源。 |
AssetStatus
素材资源可能的状态。
枚举 | |
---|---|
UNSPECIFIED |
状态尚未指定。 |
UNKNOWN |
接收的值在此版本中未知。这是仅限响应的值。 |
ENABLED |
资源已启用。 |
REMOVED |
该资源已被移除。 |
ARCHIVED |
资源已归档。 |
PENDING_SYSTEM_GENERATED |
资源由系统生成,正在等待用户审核。 |
AssetEngineStatus
下一个 ID = 11
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
SERVING |
该素材资源处于有效状态。 |
SERVING_LIMITED |
资源处于有效受限状态。 |
DISAPPROVED |
资源被拒登(不符合条件)。 |
DISABLED |
资源处于非活跃状态(待处理)。 |
REMOVED |
该资源已被移除。 |
YoutubeVideoAsset
YouTube 资产。
JSON 表示法 |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
字段 | |
---|---|
youtube |
YouTube 视频标题。 |
youtube |
YouTube 视频 ID。这是 YouTube 视频网址中使用的 11 个字符的字符串值。 |
ImageAsset
图片素材资源。
JSON 表示法 |
---|
{ "mimeType": enum ( |
字段 | |
---|---|
mime |
图片素材资源的 MIME 类型。 |
full |
此图片的原始大小元数据。 |
file |
图片素材资源的文件大小(以字节为单位)。 |
MimeType
MIME 类型
枚举 | |
---|---|
UNSPECIFIED |
未指定 MIME 类型。 |
UNKNOWN |
此版本中未知收到的值。 这是仅限响应的值。 |
IMAGE_JPEG |
image/jpeg MIME 类型。 |
IMAGE_GIF |
图片/gif 的 MIME 类型。 |
IMAGE_PNG |
MIME 类型为 image/png。 |
FLASH |
MIME 类型为 application/x-shockwave-flash。 |
TEXT_HTML |
MIME 类型为 text/html。 |
PDF |
MIME 类型为 application/pdf。 |
MSWORD |
application/msword MIME 类型。 |
MSEXCEL |
MIME 类型为 application/vnd.ms-excel。 |
RTF |
application/rtf 的 MIME 类型。 |
AUDIO_WAV |
audio/wav MIME 类型。 |
AUDIO_MP3 |
MIME 类型为 audio/mp3。 |
HTML5_AD_ZIP |
MIME 类型为 application/x-html5-ad-zip。 |
ImageDimension
特定尺寸(原始尺寸或调整后的尺寸)的图片的元数据。
JSON 表示法 |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
字段 | |
---|---|
height |
图片的高度。 |
width |
图片的宽度。 |
url |
用于返回此高度和宽度的图片的网址。 |
TextAsset
文字素材资源。
JSON 表示法 |
---|
{ "text": string } |
字段 | |
---|---|
text |
文字素材资源的文字内容。 |
UnifiedCalloutAsset
统一的宣传信息素材资源。
JSON 表示法 |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
字段 | |
---|---|
callout |
宣传信息文字。此字符串的长度应介于 1 和 25 之间(含 1 和 25)。 |
start |
此素材资源生效并可开始投放的开始日期(采用 yyyy-MM-dd 格式)。 |
end |
此素材资源生效并且仍在投放的最后日期,格式为 yyyy-MM-dd。 |
ad |
不重叠的投放时间列表,用于指定素材资源可以投放的所有时间间隔。每天最多可设置 6 个投放时间,总计 42 个。 |
use |
是否在搜索用户的时区显示资源。适用于 Microsoft Ads。 |
AdScheduleInfo
表示 AdSchedule 条件。
AdSchedule 指定为广告展示的星期几和时间间隔。
同一天最多只能添加 6 个广告时间表。
JSON 表示法 |
---|
{ "startMinute": enum ( |
字段 | |
---|---|
start |
此时间表启动的那一小时之后的分钟数。 此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
end |
此时间表结束的结束小时之后的分钟数。时间表不含结束分钟数。 此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
day |
投放时间是星期几。 此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
start |
24 小时制的整点启动时间。此字段必须介于 0 到 23 之间(包括这两个数值)。 此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
end |
结束时间(采用 24 小时制);24 表示一天结束。此字段必须介于 0 到 24 之间(包括这两个数值)。 此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
MinuteOfHour
枚举了四分之一小时。例如:"FIFTEEN"
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
ZERO |
整点过后零分钟。 |
FIFTEEN |
十五分钟(整点过后)。 |
THIRTY |
整点过后 30 分钟。 |
FORTY_FIVE |
整点过后四十五分钟。 |
DayOfWeek
枚举星期几,例如“星期一”。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
MONDAY |
星期一。 |
TUESDAY |
星期二。 |
WEDNESDAY |
星期三。 |
THURSDAY |
星期四。 |
FRIDAY |
星期五。 |
SATURDAY |
星期六。 |
SUNDAY |
星期日。 |
UnifiedSitelinkAsset
统一的站内链接素材资源。
JSON 表示法 |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
字段 | |
---|---|
link |
站内链接的网址显示文本。此字符串的长度应介于 1 和 25 之间(含 1 和 25)。 |
description1 |
站内链接的说明的第一行。如此行已设置,则长度应介于 1 到 35 之间(包括 1 和 35),并且还必须设置 description2。 |
description2 |
站内链接的说明的第二行。如此行已设置,则长度应介于 1 到 35 之间(包括 1 和 35),并且还必须设置 description1。 |
start |
此素材资源生效并可开始投放的开始日期(采用 yyyy-MM-dd 格式)。 |
end |
此素材资源生效并且仍在投放的最后日期,格式为 yyyy-MM-dd。 |
ad |
不重叠的投放时间列表,用于指定素材资源可以投放的所有时间间隔。每天最多可设置 6 个投放时间,总计 42 个。 |
tracking |
用于跟踪站内链接素材资源的点击次数的 ID。这是 Yahoo!“仅限日本”字段。 |
use |
是否在搜索用户所在的时区显示站内链接素材资源。适用于 Microsoft Ads。 |
mobile |
站内链接素材资源是否应在移动设备上展示的偏好设置。适用于 Microsoft Ads。 |
UnifiedPageFeedAsset
统一页面 Feed 素材资源。
JSON 表示法 |
---|
{ "pageUrl": string, "labels": [ string ] } |
字段 | |
---|---|
page |
广告客户要定位到的网页。 |
labels[] |
用于对网页网址进行分组的标签。 |
MobileAppAsset
表示移动应用的素材资源。
JSON 表示法 |
---|
{
"appId": string,
"appStore": enum ( |
字段 | |
---|---|
app |
必需。用于唯一标识移动应用的字符串。它应仅包含平台原生 ID,例如 Android 的“com.android.ebay”或 iOS 的“12345689”。 |
app |
必需。分发此特定应用的应用商店。 |
MobileAppVendor
移动应用供应商的类型
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
APPLE_APP_STORE |
Apple App Store 的移动应用供应商。 |
GOOGLE_APP_STORE |
Google 应用商店的移动应用供应商。 |
UnifiedCallAsset
统一的电话素材资源。
JSON 表示法 |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
字段 | |
---|---|
country |
电话号码对应的双字母国家/地区代码。示例:“US”“us”。 |
phone |
广告客户的原始电话号码。示例:“1234567890”“(123)456-7890” |
call |
指示此 CallAsset 应使用自己的来电转化设置、遵循账号级设置,还是停用来电转化。 |
call |
要将来电转化归因到的转化操作。如果未设置,则使用默认转化操作。此字段仅在 callConversionReportingState 设置为 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 时才有效。 |
ad |
非重叠时间表的列表,用于指定资源可以投放的所有时间间隔。每天最多可设置 6 个投放时间,总计 42 个。 |
call |
来电是否仅显示电话号码,而不显示指向网站的链接。适用于 Microsoft Ads。 |
call |
是否应在来电跟踪中启用相应来电。适用于 Microsoft Ads。 |
use |
是否在搜索用户所在的时区显示来电扩展广告。适用于 Microsoft Ads。 |
start |
此素材资源生效并且可以开始投放的开始日期,格式为 yyyy-MM-dd。 |
end |
此素材资源有效且仍在投放的最后一天,格式为 yyyy-MM-dd。 |
CallConversionReportingState
来电转化操作状态的可能数据类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
DISABLED |
来电转化操作已停用。 |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
来电转化操作将使用在账号一级设置的来电转化类型。 |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
来电转化操作将使用在资源(来电专用广告/附加电话信息)一级设置的来电转化类型。 |
CallToActionAsset
号召性用语素材资源。
JSON 表示法 |
---|
{
"callToAction": enum ( |
字段 | |
---|---|
call |
号召性用语。 |
CallToActionType
用于描述可能的号召性用语类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
LEARN_MORE |
号召性用语类型为“了解详情”。 |
GET_QUOTE |
号召性用语类型为“获取报价”。 |
APPLY_NOW |
号召性用语类型现已应用。 |
SIGN_UP |
号召性用语类型为注册。 |
CONTACT_US |
号召性用语类型为“与我们联系”。 |
SUBSCRIBE |
号召性用语类型为“订阅”。 |
DOWNLOAD |
号召性用语类型为“下载”。 |
BOOK_NOW |
号召性用语类型为“立即预订”。 |
SHOP_NOW |
号召性用语类型为“立即选购”。 |
BUY_NOW |
号召性用语类型为“立即购买”。 |
DONATE_NOW |
号召性用语类型为立即捐款。 |
ORDER_NOW |
号召性用语类型为立即订购。 |
PLAY_NOW |
号召性用语类型为“立即播放”。 |
SEE_MORE |
号召性用语类型为“了解详情”。 |
START_NOW |
号召性用语类型为“立即开始”。 |
VISIT_SITE |
号召性用语类型为访问网站。 |
WATCH_NOW |
号召性用语类型为立即观看。 |
UnifiedLocationAsset
统一的地址素材资源。
JSON 表示法 |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
字段 | |
---|---|
place |
地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。对于给定的客户 ID 和素材资源类型,此字段是唯一的。如需详细了解地点 ID,请访问 https://developers.google.com/places/web-service/place-id。 |
business |
客户的营业地点列表。只有在地址素材资源从商家资料账号同步时,系统才会返回此值。同一账号下可以有多个指向同一地点 ID 的商家资料商家信息。 |
location |
地点所有权类型。如果类型为 BUSINESS_OWNER,则会作为附加地址信息投放。如果类型为“AFFILIATE”(联属营业地点),则会作为联属营业地点投放。 |
BusinessProfileLocation
从关联的商家资料账号同步的商家资料营业地点数据。
JSON 表示法 |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
字段 | |
---|---|
labels[] |
广告客户为商家资料账号中的营业地点指定的标签。此信息会从商家资料账号同步。 |
store |
此营业地点的商家资料商店代码。这些数据是从商家资料账号同步过来的。 |
listing |
此商家资料营业地点的商家信息 ID。此信息会从关联的商家资料账号同步过来。 |
LocationOwnershipType
地点所有权的可能类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BUSINESS_OWNER |
营业地点的商家所有者(旧版地址信息附加信息 - LE)。 |
AFFILIATE |
联属营业地点(第三方营业地点附加信息 - ALE)。 |
AssetGroupAsset
AssetGroupAsset 是将素材资源与素材资源组相关联的纽带。添加 AssetGroupAsset 可将素材资源与素材资源组相关联。
JSON 表示法 |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
字段 | |
---|---|
resource |
素材资源组素材资源的资源名称。素材资源组资产资源名称采用以下格式:
|
asset |
此素材资源组素材资源所关联的素材资源组。 |
asset |
此素材资源组素材资源所关联的素材资源。 |
field |
素材资源在素材资源组中的展示位置说明。例如:HEADLINE、YOUTUBE_VIDEO 等 |
status |
素材资源与素材资源组之间的关联状态。 |
AssetFieldType
用于描述素材资源可能的展示位置的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
HEADLINE |
该素材资源已关联,可用作标题。 |
DESCRIPTION |
关联该素材资源以用作说明。 |
MANDATORY_AD_TEXT |
该素材资源已关联,以用作必填广告文字。 |
MARKETING_IMAGE |
该素材资源已关联,可用作营销图片。 |
MEDIA_BUNDLE |
该素材资源已关联,可用作媒体包。 |
YOUTUBE_VIDEO |
资产已关联,可用作 YouTube 视频。 |
BOOK_ON_GOOGLE |
关联此素材资源是为了表明酒店广告系列已启用“在 Google 上预订”功能。 |
LEAD_FORM |
该素材资源已关联,可用作附加潜在客户表单。 |
PROMOTION |
该素材资源已关联,可用作附加促销信息。 |
CALLOUT |
该素材资源已关联,可用作附加宣传信息。 |
STRUCTURED_SNIPPET |
该素材资源已关联,可用作附加结构化摘要信息。 |
SITELINK |
该素材资源已关联,可用作站内链接。 |
MOBILE_APP |
关联该素材资源是为了将其用作附加移动应用信息。 |
HOTEL_CALLOUT |
该素材资源已关联,可用作酒店附加宣传信息。 |
CALL |
该素材资源已关联,可用作附加电话信息。 |
PRICE |
关联该素材资源以用作附加价格信息。 |
LONG_HEADLINE |
该素材资源已关联,可用作长标题。 |
BUSINESS_NAME |
该素材资源已关联,用作商家名称。 |
SQUARE_MARKETING_IMAGE |
该素材资源已关联,可用作方形营销图片。 |
PORTRAIT_MARKETING_IMAGE |
该素材资源已关联,可用作纵向营销图片。 |
LOGO |
该资源已关联,可用作徽标。 |
LANDSCAPE_LOGO |
该资源已关联,可用作横向徽标。 |
VIDEO |
该素材资源已关联,可用作非 YouTube 徽标。 |
CALL_TO_ACTION_SELECTION |
关联的素材资源可用于选择号召性用语。 |
AD_IMAGE |
关联该素材资源是为了用于选择广告图片。 |
BUSINESS_LOGO |
该素材资源已关联,可用作商家徽标。 |
HOTEL_PROPERTY |
关联此素材资源是为了在指定旅行目标的效果最大化广告系列中将其用作酒店房源。 |
DISCOVERY_CAROUSEL_CARD |
该素材资源已关联,可用作轮播式发现广告卡片。 |
AssetGroupSignal
AssetGroupSignal 表示素材资源组中的信号。信号的存在会告知效果最大化广告系列哪些用户最有可能完成转化。效果最大化广告系列会参考您的信号,寻找意向相似或更强烈的新用户,以在搜索网络、展示广告网络、视频平台等位置促成转化。
JSON 表示法 |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
字段 | |
---|---|
resource |
素材资源组信号的资源名称。素材资源组信号资源名称的格式为:
|
asset |
此素材资源组信号所属的素材资源组。 |
联合字段 signal 。素材资源组的信号。signal 只能是下列其中一项: |
|
audience |
效果最大化广告系列要使用的受众群体信号。 |
AudienceInfo
受众群体条件。
JSON 表示法 |
---|
{ "audience": string } |
字段 | |
---|---|
audience |
受众群体资源名称。 |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter 表示素材资源组中的产品信息组过滤条件树节点。
JSON 表示法 |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
字段 | |
---|---|
resource |
素材资源组产品信息组过滤条件的资源名称。素材资源组产品信息组过滤条件资源名称采用以下格式:
|
asset |
此素材资源组产品信息组过滤条件所属的素材资源组。 |
id |
ListingGroupFilter 的 ID。 |
type |
商品信息组过滤条件节点的类型。 |
vertical |
当前节点树代表的行业。同一树中的所有节点必须属于同一行业。 |
case |
用于对其父级进行细分的维度值。根组为未定义。 |
parent |
父级商家信息群组细分的资源名称。根产品信息组过滤条件节点为 null。 |
path |
用于定义此商品详情组过滤条件的维度的路径。 |
ListingGroupFilterType
商品详情群组过滤条件的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
SUBDIVISION |
按某些商品详情维度对商品进行细分。 |
UNIT_INCLUDED |
包含的产品信息组过滤条件叶节点。 |
UNIT_EXCLUDED |
已排除的产品信息组过滤条件叶节点。 |
ListingGroupFilterVertical
产品信息组过滤条件行业的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
SHOPPING |
表示购物行业。此行业仅适用于面向零售行业的效果最大化广告系列。 |
ListingGroupFilterDimension
素材资源组产品信息组过滤条件的商品详情维度。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 dimension 。维度始终属于以下某种类型。dimension 只能是下列其中一项: |
|
product |
商品的出价类别。 |
product |
商品的品牌。 |
product |
产品优惠的地区。 |
product |
商品的使用情况。 |
product |
商品的属性。 |
product |
商品优惠的商品 ID。 |
product |
商品优惠的类型。 |
ProductBiddingCategory
特定级别的出价类别的一个元素。顶级类别位于级别 1,其子类别位于级别 2,以此类推。目前,我们最多支持 5 个级别。用户必须指定一个维度类型,用于指示类别的级别。同一细分中的所有案例都必须具有相同的维度类型(类别级别)。
JSON 表示法 |
---|
{
"level": enum ( |
字段 | |
---|---|
level |
表示分类中的类别级别。 |
id |
产品出价类别的 ID。 此 ID 相当于 google_product_category ID,如以下文章中所述:https://support.google.com/merchants/answer/6324436 |
ListingGroupFilterBiddingCategoryLevel
产品信息组过滤条件出价类别的级别。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
LEVEL1 |
1 级。 |
LEVEL2 |
2 级。 |
LEVEL3 |
第 3 级。 |
LEVEL4 |
4 级。 |
LEVEL5 |
第 5 级。 |
ProductBrand
商品的品牌。
JSON 表示法 |
---|
{ "value": string } |
字段 | |
---|---|
value |
商品品牌的字符串值。 |
ProductChannel
商品的本地性。
JSON 表示法 |
---|
{
"channel": enum ( |
字段 | |
---|---|
channel |
相应地区的值。 |
ListingGroupFilterProductChannel
用于描述商品优惠的地区的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ONLINE |
商品在线销售。 |
LOCAL |
商品在本地实体店销售。 |
ProductCondition
商品优惠的条件。
JSON 表示法 |
---|
{
"condition": enum ( |
字段 | |
---|---|
condition |
条件的值。 |
ListingGroupFilterProductCondition
用于描述商品优惠状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
NEW |
产品使用情况是全新的。 |
REFURBISHED |
商品状况为“翻新”。 |
USED |
商品是二手商品。 |
ProductCustomAttribute
商品的属性。
JSON 表示法 |
---|
{
"index": enum ( |
字段 | |
---|---|
index |
指示自定义属性的索引。 |
value |
产品自定义属性的字符串值。 |
ListingGroupFilterCustomAttributeIndex
客户属性的索引。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
INDEX0 |
第一个产品信息组过滤条件自定义属性。 |
INDEX1 |
第二个产品信息组过滤条件自定义属性。 |
INDEX2 |
第三个产品信息组过滤条件自定义属性。 |
INDEX3 |
第四个产品信息组过滤条件自定义属性。 |
INDEX4 |
第五个产品信息组过滤条件自定义属性。 |
ProductItemId
产品优惠的商品 ID。
JSON 表示法 |
---|
{ "value": string } |
字段 | |
---|---|
value |
ID 的值。 |
ProductType
商品优惠的类型。
JSON 表示法 |
---|
{
"level": enum ( |
字段 | |
---|---|
level |
类型的级别。 |
value |
类型的值。 |
ListingGroupFilterProductTypeLevel
描述商品优惠类型级别的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
LEVEL1 |
1 级。 |
LEVEL2 |
2 级。 |
LEVEL3 |
第 3 级。 |
LEVEL4 |
4 级。 |
LEVEL5 |
第 5 级。 |
ListingGroupFilterDimensionPath
用于定义产品信息组过滤条件的维度的路径。
JSON 表示法 |
---|
{
"dimensions": [
{
object ( |
字段 | |
---|---|
dimensions[] |
维度从产品信息组过滤条件层次结构(不包括根节点)到此产品信息组过滤条件的完整路径。 |
AssetGroupTopCombinationView
广告组广告素材资源组合使用情况视图。
JSON 表示法 |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
字段 | |
---|---|
resource |
素材资源组“效果最佳的组合”视图的资源名称。素材资源组热门组合视图资源名称采用以下格式:"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
asset |
一起投放的效果最佳的素材资源组合。 |
AssetGroupAssetCombinationData
素材资源组素材资源组合数据
JSON 表示法 |
---|
{
"assetCombinationServedAssets": [
{
object ( |
字段 | |
---|---|
asset |
投放的素材资源。 |
AssetUsage
包含相应资产的使用情况信息。
JSON 表示法 |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
字段 | |
---|---|
asset |
资产的资源名称。 |
served |
素材资源的已投放字段类型。 |
ServedAssetFieldType
可能的素材资源字段类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
接收的值在此版本中未知。 这是仅限响应的值。 |
HEADLINE_1 |
该素材资源用于标题 1。 |
HEADLINE_2 |
该素材资源用于标题 2。 |
HEADLINE_3 |
该素材资源用于标题 3。 |
DESCRIPTION_1 |
该素材资源用于说明 1。 |
DESCRIPTION_2 |
该素材资源用于说明 2。 |
HEADLINE |
素材资源已用于标题。仅当广告中只有一个标题时,才使用此属性。否则,请使用 HEADLINE_1、HEADLINE_2 或 HEADLINE_3 枚举 |
HEADLINE_IN_PORTRAIT |
该素材资源在纵向图片中用作标题。 |
LONG_HEADLINE |
资源已用于长标题(用于 MultiAssetResponsiveAd)。 |
DESCRIPTION |
该素材资源已在说明中使用。仅当广告中只有一条广告内容描述时,才应使用此列。否则,请使用 DESCRIPTION_1 或 DESCRIPTION_@ 枚举 |
DESCRIPTION_IN_PORTRAIT |
资源在纵向图片中用作说明。 |
BUSINESS_NAME_IN_PORTRAIT |
该素材资源在纵向图片中用作商家名称。 |
BUSINESS_NAME |
资源被用作商家名称。 |
MARKETING_IMAGE |
素材资源被用作营销图片。 |
MARKETING_IMAGE_IN_PORTRAIT |
该素材资源被用作纵向图片的营销图片。 |
SQUARE_MARKETING_IMAGE |
素材资源被用作方形营销图片。 |
PORTRAIT_MARKETING_IMAGE |
该素材资源用作纵向营销图片。 |
LOGO |
资源被用作徽标。 |
LANDSCAPE_LOGO |
该素材资源被用作横向徽标。 |
CALL_TO_ACTION |
素材资源用作号召性用语。 |
YOU_TUBE_VIDEO |
该资产曾被用作 YouTube 视频。 |
SITELINK |
此素材资源用作站内链接。 |
CALL |
此素材资源用作调用。 |
MOBILE_APP |
此资源用作移动应用。 |
CALLOUT |
此素材资源用作宣传信息。 |
STRUCTURED_SNIPPET |
此素材资源将用作结构化摘要。 |
PRICE |
此素材资源用作价格。 |
PROMOTION |
此素材资源已用作促销信息。 |
AD_IMAGE |
此素材资源用作图片。 |
LEAD_FORM |
该素材资源会用作潜在客户表单。 |
BUSINESS_LOGO |
该素材资源用作商家徽标。 |
AssetGroup
素材资源组。AssetGroupAsset 用于将素材资源与素材资源组相关联。AssetGroupSignal 用于将信号与素材资源组相关联。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
字段 | |
---|---|
resource |
素材资源组的资源名称。素材资源组资源名称的格式为:
|
id |
素材资源组的 ID。 |
campaign |
此素材资源组所关联的广告系列。与素材资源组关联的素材资源。 |
name |
必需。素材资源组的名称。必需。长度不得低于 1 且不得高于 128。在广告系列中,此维度必须是唯一的。 |
final |
所有跨网域重定向之后的最终到达网址列表。在效果最大化广告系列中,除非选择停用,否则默认情况下,网址符合扩展条件。 |
final |
所有跨网域重定向之后的最终到达移动网址列表。在效果最大化广告系列中,除非您选择停用,否则网址默认符合扩展条件。 |
status |
素材资源组的状态。 |
path1 |
可能显示的文字的第一部分(附加到广告中展示的网址)。 |
path2 |
可能显示的文字的第二部分(附加到广告中展示的网址)。仅当设置了 path1 时才能设置此字段。 |
ad |
此素材资源组的整体广告效力。 |
AssetGroupStatus
素材资源组的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
状态尚未指定。 |
UNKNOWN |
此版本中未知收到的值。 |
ENABLED |
素材资源组已启用。 |
PAUSED |
素材资源组已暂停。 |
REMOVED |
素材资源组已移除。 |
AdStrength
枚举可能的广告效力。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
PENDING |
广告效力目前处于“待定”状态。 |
NO_ADS |
无法生成任何广告。 |
POOR |
信号强度较弱。 |
AVERAGE |
平均强度。 |
GOOD |
强度不错。 |
EXCELLENT |
力量极佳。 |
AssetSetAsset
AssetSetAsset 是资产与资产集之间的关联。添加 AssetSetAsset 可将资产与素材资源集相关联。
JSON 表示法 |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
字段 | |
---|---|
resource |
资产集资产的资源名称。资产集资产资源名称的格式为:
|
asset |
此素材资源集中的素材资源所关联的素材资源集。 |
asset |
此素材资源集中的素材资源所关联的素材资源。 |
status |
素材资源组素材资源的状态。只读。 |
AssetSetAssetStatus
素材资源集素材资源的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
状态尚未指定。 |
UNKNOWN |
接收的值在此版本中未知。这是仅限响应的值。 |
ENABLED |
该素材资源集素材资源已启用。 |
REMOVED |
素材资源集中的素材资源会被移除。 |
AssetSet
素材资源组,表示一组素材资源。使用 AssetSetAsset 将资产关联到素材资源集。
JSON 表示法 |
---|
{ "id": string, "resourceName": string } |
字段 | |
---|---|
id |
素材资源组的 ID。 |
resource |
资产集的资源名称。资产集资源名称的格式为:
|
BiddingStrategy
出价策略。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resource |
出价策略的资源名称。出价策略资源名称的格式为:
|
status |
出价策略的状态。 此字段为只读字段。 |
type |
出价策略的类型。通过设置出价方案来创建出价策略。 此字段为只读字段。 |
currency |
出价策略使用的币种(ISO 4217 三字母代码)。 对于经理客户中的出价策略,您可以在创建时设置此币种,默认值为经理客户的币种。对于投放广告的客户,此字段无法设置;投放广告的客户中的所有策略都会隐式使用投放广告的客户的币种。在所有情况下,effectiveCurrencyCode 字段都会返回策略使用的货币。 |
id |
出价策略的 ID。 |
name |
出价策略的名称。账号中的所有出价策略必须区分命名。 此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 |
effective |
出价策略使用的币种(ISO 4217 三字母代码)。 对于经理客户中的出价策略,此币种是指广告客户在创建策略时设置的币种。对于为客户提供服务,这是客户的 currencyCode。 出价策略指标以此币种报告。 此字段为只读字段。 |
campaign |
附加到出价策略的广告系列的数量。 此字段为只读字段。 |
non |
附加到出价策略的未移除广告系列的数量。 此字段为只读字段。 |
联合字段 只能设置一个。 |
|
enhanced |
一种出价策略,会针对更有可能促成转化的点击提高出价,并针对不太可能促成转化的点击降低出价。 |
maximize |
这是一种自动出价策略,可帮助您在预算范围内为广告系列争取尽可能高的转化价值。 |
maximize |
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。 |
target |
一种出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。 |
target |
一种出价策略,可自动针对所选的展示次数百分比进行优化。 |
target |
此出价策略会根据广告客户应在竞价中胜过特定竞争对手的目标百分比来设置出价。该字段已弃用。使用此字段创建新的出价策略或将包含此字段的出价策略附加到广告系列将会失败。允许对已填充此架构的策略进行突变。 |
target |
这种出价策略有助于您在尽可能提高收入的同时,尽可能使平均广告支出回报率等于您设置的目标回报率。 |
target |
一种出价策略,会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。 |
BiddingStrategyStatus
BiddingStrategy 的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
接收的值在此版本中未知。 这是仅限响应的值。 |
ENABLED |
出价策略已启用。 |
REMOVED |
出价策略已移除。 |
BiddingStrategyType
用于描述可能的出价策略类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
COMMISSION |
佣金是一种自动出价策略,广告客户需要支付转化价值的一定比例。 |
ENHANCED_CPC |
智能点击付费是一种出价策略,能够针对更有可能带来转化的点击提高出价,并针对不太可能带来转化的点击降低出价。 |
INVALID |
仅用于返回值。表示广告系列没有出价策略。这会导致广告系列无法投放。例如,广告系列可能关联到经理账号出价策略,而广告投放账号随后会与该经理账号解除关联。在这种情况下,广告系列会自动与目前无法访问的经理账号出价策略取消关联,并转换为“无效”出价策略类型。 |
MANUAL_CPA |
人工出价策略,可让广告客户根据广告客户指定的操作设置出价。 |
MANUAL_CPC |
基于点击的人工出价,此类出价中用户按点击次数付费。 |
MANUAL_CPM |
基于人工展示的出价,用户按每千次展示付费。 |
MANUAL_CPV |
一种出价策略,按每次视频观看付费,付费金额可进行配置。 |
MAXIMIZE_CONVERSIONS |
一种出价策略,可在指定每日预算的情况下自动争取尽可能多的转化次数。 |
MAXIMIZE_CONVERSION_VALUE |
这是一种自动出价策略,可在您的预算范围内自动设置出价,以最大限度地提高收入。 |
PAGE_ONE_PROMOTED |
首页宣传广告出价方案,用于设置最高每次点击费用出价,以在 google.com 上争取首页展示或首页宣传广告展示位置。此枚举值已废弃。 |
PERCENT_CPC |
百分比形式的每次转化费用出价策略是一种出价策略,其中出价是某件商品或服务的广告价格的一小部分。 |
TARGET_CPA |
“目标每次转化费用”是一种自动出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。 |
TARGET_CPM |
“目标每千次展示费用”是一种自动出价策略,可为您设置合适的出价,在不超出您设置的目标每千次展示费用 (CPM) 的前提下,帮您获得尽可能多的展示。 |
TARGET_IMPRESSION_SHARE |
这是一种自动出价策略,可设置出价,以便一定比例的搜索广告展示在首页顶部(或其他目标位置)。 |
TARGET_OUTRANK_SHARE |
“排名胜出率目标”是一种自动出价策略,会根据广告客户应在竞价中超越特定竞争对手的目标份额来设置出价。此枚举值已废弃。 |
TARGET_ROAS |
“目标广告支出回报率”是一种自动出价策略,可帮助您在达到特定目标平均支出回报率 (ROAS) 平均值的同时,尽可能提高收入。 |
TARGET_SPEND |
“目标支出”是一种自动出价策略,会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。 |
EnhancedCpc
此类型没有字段。
这是一种自动出价策略,会针对更有可能带来转化的点击提高出价,并针对不太可能带来转化的点击降低出价。
此出价策略已被弃用,无法再创建。将 enhancedCpcEnabled 设置为 true 并使用 ManualCpc 即可实现等效的功能。
MaximizeConversionValue
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。
JSON 表示法 |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
字段 | |
---|---|
cpc |
可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略,可更改。 |
cpc |
可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略,可更改。 |
target |
目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。 |
MaximizeConversions
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。
JSON 表示法 |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
字段 | |
---|---|
cpc |
可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略,可更改。 |
cpc |
可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。 |
target |
目标每次转化费用 (CPA) 选项。这是您愿意为每次转化操作支付的平均金额,以出价策略所用币种的微单位指定。设置后,该出价策略会在不超过目标每次转化费用的前提下,争取尽可能多的转化。如果未设置目标每次转化费用,则出价策略的目标是在预算范围内尽可能降低每次转化费用。 |
TargetCpa
这是一种自动出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。
JSON 表示法 |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
字段 | |
---|---|
target |
平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。 |
cpc |
可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
cpc |
可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
TargetRoas
这是一种自动出价策略,可帮助您在达到特定目标广告支出回报率 (ROAS) 平均值的同时,尽可能提高收入。
JSON 表示法 |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
字段 | |
---|---|
target |
必需。每单位支出所选择的收入(基于转化数据)。值必须介于 0.01 到 1000.0 之间(包括 0.01 和 1000.0)。 |
cpc |
可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
cpc |
可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
TargetSpend
这是一种自动出价策略,可为您设置适当的出价,助您在不超出预算的前提下为您争取尽可能多的点击。
JSON 表示法 |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
字段 | |
---|---|
targetSpendMicros |
已废弃:尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 此字段已弃用,不应再使用。如需了解详情,请访问 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。 |
cpc |
可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。 |
CampaignBudget
广告系列预算。
JSON 表示法 |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
字段 | |
---|---|
resource |
广告系列预算的资源名称。广告系列预算资源名称的格式为:
|
delivery |
确定广告系列预算的支出速率的投放方式。 如果在创建操作中未指定,则默认为 STANDARD。 |
period |
支出预算的时间段。如果未指定,则默认为“DAILY”。 |
amount |
预算的金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。每月支出上限为此金额的 30.4 倍。 |
BudgetDeliveryMethod
预算的可能投放方式。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
STANDARD |
预算服务器将在整个时间段内平均地调节投放。 |
ACCELERATED |
预算服务器不会节流投放,广告将尽快投放。 |
BudgetPeriod
预算的可能期限。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
DAILY |
每日预算。 |
FIXED_DAILY |
固定每日预算。 |
CUSTOM_PERIOD |
自定义预算可与 total_amount 搭配使用,以指定生命周期预算上限。 |
广告系列
广告系列。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resource |
广告系列的资源名称。广告系列资源名称采用以下格式:
|
status |
广告系列的状态。 添加新的广告系列时,状态默认为 ENABLED。 |
serving |
广告系列的广告投放状态。 |
bidding |
广告系列出价策略的系统状态。 |
ad |
广告系列的广告投放优化状态。 |
advertising |
广告系列中的广告的主要投放目标。您可以在 此字段为必填字段,在创建新广告系列时不应为空。 只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
advertising |
(可选)对 只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
url |
用于替换 |
real |
实时出价设置,此功能仅适用于定位到 Ad Exchange 广告网络的广告系列。 |
network |
广告系列的投放网络设置。 |
dynamic |
用于控制动态搜索广告 (DSA) 的设置。 |
shopping |
用于控制购物广告系列的设置。 |
geo |
广告地理位置定位的设置。 |
effective |
此广告系列所附有效标签的资源名称。有效标签是指继承或直接分配给此广告系列的标签。 |
labels[] |
此广告系列所附标签的资源名称。 |
bidding |
出价策略的类型。 您可以通过以下方式创建出价策略:设置出价方案来创建标准出价策略,或设置 此字段为只读字段。 |
accessible |
Accessible BiddingStrategy 的资源名称,其中包含附加组合出价策略(由“biddingStrategy”标识)的不受限制属性的只读视图。如果广告系列未使用组合策略,则为空。不受限制的策略属性可供与该策略共享的所有客户使用,并且会从 AccessibleBiddingStrategy 资源读取。与之相反,受限属性仅供策略的客户所有者及其经理使用。受限属性只能从 BiddingStrategy 资源读取。 |
frequency |
用于限制每位用户看到此广告系列的广告的频率的列表。 |
selective |
此广告系列的选择性优化设置,其中包含一组要针对此广告系列进行优化的转化操作。此功能仅适用于使用 MULTI_CHANNEL 作为 AdvertisingChannelType 且使用 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 作为 AdvertisingChannelSubType 的应用广告系列。 |
optimization |
此广告系列的优化目标设置,其中包含一组优化目标类型。 |
tracking |
跟踪信息的广告系列级设置。 |
engine |
外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请改用“campaign.id”。 |
excluded |
应从此广告系列中排除的素材资源字段类型。此广告系列不会从上级继承使用这些字段类型的素材资源关联。 |
create |
创建广告系列时的时间戳。时间戳采用客户所在的时区,格式为“yyyy-MM-dd HH:mm:ss”。v1 中将弃用 createTime。请改用 creationTime。 |
creation |
创建广告系列时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
last |
上次修改此广告系列的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
id |
广告系列的 ID。 |
name |
广告系列的名称。 此字段为必填字段,在创建新广告系列时不应为空。 并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
tracking |
用于构建跟踪网址的网址模板。 |
campaign |
广告系列的广告系列预算资源名称。 |
start |
广告系列在提供服务的客户所在时区开始运行的日期(采用 YYYY-MM-DD 格式)。 |
end |
广告系列在提供服务的客户所在时区运行的最后一天(采用 YYYY-MM-DD 格式)。创建时,默认为 2037-12-30,这表示广告系列将无限期投放。要将现有的广告系列设置为无限期投放,请将此字段设置为 2037-12-30。 |
final |
用于将查询参数附加到通过并行跟踪投放的着陆页的后缀。 |
url |
表示选择不将网址扩展到更多定位网址。如果选择不扩展(true),则仅定位到素材资源组中的最终到达网址,或广告客户的 Google Merchant Center Feed 或商家数据 Feed 中指定的网址。如果选择启用(false),则会定位到整个网域。此字段只能为效果最大化广告系列设置,默认值为 false。 |
联合字段 必须是组合出价策略(通过 BiddingStrategy 服务创建)或嵌入到广告系列中的标准出价策略。 |
|
bidding |
广告系列使用的组合出价策略的资源名称。 |
manual |
标准的“每次转化费用人工出价”策略。人工出价策略,可让广告客户根据广告客户指定的操作设置出价。仅适用于本地生活服务广告系列。 |
manual |
标准的每次点击费用人工出价策略。按点击次数手动出价,用户按点击次数付费。 |
manual |
标准的“每千次展示费用人工出价”策略。基于展示的人工出价,此类出价中用户按每千次展示付费。 |
maximize |
标准的“尽可能提高转化次数”出价策略,可在不超出预算的前提下自动尽可能提高转化次数。 |
maximize |
标准的“尽可能提高转化价值”出价策略,可自动设置出价,以便在您的预算范围内,最大限度提高收入。 |
target |
标准的“目标每次转化费用”出价策略,可自动设置适当的出价,帮助您以自己设定的目标每次转化费用 (CPA) 争取到尽可能多的转化。 |
target |
“目标展示次数份额”出价策略。这是一种自动出价策略,可设置出价以争取所选展示次数百分比。 |
target |
标准的“目标广告支出回报率”出价策略,可自动最大限度提高收入,同时平均达到特定的目标广告支出回报率 (ROAS)。 |
target |
标准的“目标支出”出价策略,会自动设置适当的出价,帮助您在不超出预算的前提下争取尽可能多的点击。 |
percent |
标准的“百分比形式的每次点击费用”出价策略,其中出价是某件商品或服务的广告价格的一小部分。 |
target |
一种自动优化每千次展示费用的出价策略。 |
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 |
广告投放优化状态未知。 |
AdvertisingChannelType
用于描述各种广告渠道类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
SEARCH |
搜索网络。包括展示广告系列捆绑包和搜索广告系列 + 展示广告系列。 |
DISPLAY |
仅限 Google 展示广告网络。 |
SHOPPING |
购物广告系列会在购物媒体资源和 Google.com 搜索结果中投放。 |
HOTEL |
酒店广告系列。 |
VIDEO |
视频广告系列。 |
MULTI_CHANNEL |
跨多个渠道投放的应用广告系列和应用互动广告系列。 |
LOCAL |
本地广告系列。 |
SMART |
智能广告系列。 |
PERFORMANCE_MAX |
效果最大化广告系列。 |
LOCAL_SERVICES |
本地生活服务广告系列。 |
DISCOVERY |
发现广告系列。 |
TRAVEL |
旅游广告系列。 |
SOCIAL |
社交广告系列。 |
AdvertisingChannelSubType
用于描述不同渠道子类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用作返回值。表示此版本中未知的值。 |
SEARCH_MOBILE_APP |
面向搜索网络的移动应用广告系列。 |
DISPLAY_MOBILE_APP |
适用于展示广告网络的移动应用广告系列。 |
SEARCH_EXPRESS |
适用于搜索广告的 AdWords Express 广告系列。 |
DISPLAY_EXPRESS |
投放到展示广告网络的 AdWords Express 广告系列。 |
SHOPPING_SMART_ADS |
智能购物广告系列。 |
DISPLAY_GMAIL_AD |
Gmail 广告系列。 |
DISPLAY_SMART_CAMPAIGN |
智能型展示广告系列:您无法制作此子类型的新广告系列。 |
VIDEO_OUTSTREAM |
外播视频广告系列。 |
VIDEO_ACTION |
视频 TrueView 行动号召广告系列。 |
VIDEO_NON_SKIPPABLE |
包含不可跳过的视频广告的视频广告系列。 |
APP_CAMPAIGN |
借助应用广告系列,您可以轻松地在 Google 的各项热门产品和服务(包括 Google 搜索、Google Play、YouTube 和 Google 展示广告网络)中宣传您的 Android 应用或 iOS 应用。 |
APP_CAMPAIGN_FOR_ENGAGEMENT |
应用互动广告系列,专注于在 Google 搜索、YouTube 和 Google 展示广告网络等多个 Google 热门产品和服务中吸引用户再次使用这款应用。 |
LOCAL_CAMPAIGN |
专门用于本地广告的广告系列。 |
SHOPPING_COMPARISON_LISTING_ADS |
购物比价购物广告系列。 |
SMART_CAMPAIGN |
标准智能广告系列。 |
VIDEO_SEQUENCE |
包含依序播放视频广告的视频广告系列。 |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
用于宣传应用预注册的应用广告系列,专门用于在 Google Play、YouTube 和展示广告网络中的多个广告渠道中投放广告。 |
VIDEO_REACH_TARGET_FREQUENCY |
采用“目标频次”出价策略的视频覆盖面广告系列。 |
TRAVEL_ACTIVITIES |
旅游活动广告系列。 |
SOCIAL_FACEBOOK_TRACKING_ONLY |
仅跟踪 Facebook 社交广告系列。 |
CustomParameter
可供 trackingUrlTemplate
、finalUrls
或 mobile_final_urls
中的自定义参数标记使用的映射。
JSON 表示法 |
---|
{ "key": string, "value": string } |
字段 | |
---|---|
key |
与参数代码名称匹配的键。 |
value |
要替换的值。 |
RealTimeBiddingSetting
实时出价设置,此功能仅适用于定位到 Ad Exchange 广告网络的广告系列。
JSON 表示法 |
---|
{ "optIn": boolean } |
字段 | |
---|---|
opt |
广告系列是否已选择启用实时出价。 |
NetworkSettings
广告系列的投放网络设置。
JSON 表示法 |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
字段 | |
---|---|
target |
广告是否会随 google.com 搜索结果一起展示。 |
target |
广告是否将在 Google 搜索网络中的合作伙伴网站上投放(要求 |
target |
广告是否将在 Google 展示广告网络中的指定展示位置投放。您可以使用展示位置条件指定展示位置。 |
target |
广告是否将在 Google 合作伙伴网络中投放。这仅可用于部分 Google 合作伙伴账号。 |
DynamicSearchAdsSetting
用于控制动态搜索广告 (DSA) 的设置。
JSON 表示法 |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
字段 | |
---|---|
domain |
必需。此设置所代表的互联网域名,例如“google.com”或“www.google.com”。 |
language |
必需。用于指定网域语言的语言代码,例如“en”。 |
use |
广告系列是否仅使用广告客户提供的网址。 |
ShoppingSetting
购物广告系列的设置。定义了可以通过广告系列宣传的所有产品,以及此广告系列与其他购物广告系列的互动方式。
JSON 表示法 |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
字段 | |
---|---|
feed |
要添加到广告系列中的商品的 Feed 标签。只能设置 feedLabel 或 salesCountry 之一。如果将 feedLabel 字段用作 salesCountry 字段的替代项,则该字段接受采用相同格式的国家/地区代码,例如“XX”。否则,可以是 Google Merchant Center 中用于 Feed 标签的任何字符串。 |
use |
是否定位到车辆商品目录广告资源。 |
merchant |
Merchant Center 账号的 ID。此字段对创建操作是必需的。对于购物广告系列,此字段不可更改。 |
sales |
要纳入广告系列的商品的销售国家/地区。 |
campaign |
广告系列的优先级。数值越高,相应广告系列的优先级就越高,反之越低。对于购物广告系列,此字段为必填字段,值介于 0 到 2 之间(包括这两个数值)。对于智能购物广告系列而言,此字段是选填项,如进行设置则须等于 3。 |
enable |
是否要添加本地商品。 |
GeoTargetTypeSetting
表示与广告地理位置定位相关的一组设置。
JSON 表示法 |
---|
{ "positiveGeoTargetType": enum ( |
字段 | |
---|---|
positive |
用于在此特定广告系列中进行肯定地理位置定位的设置。 |
negative |
此特定广告系列中用于否定地理位置定位的设置。 |
PositiveGeoTargetType
可能的肯定地理位置定位类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
PRESENCE_OR_INTEREST |
指定如果用户位于广告客户定位的地理位置或对这些地理位置表现出兴趣,则触发广告。 |
SEARCH_INTEREST |
指定如果用户搜索广告客户定位的地理位置,则触发广告。此功能只能用于搜索广告系列和标准购物广告系列。 |
PRESENCE |
指定当用户位于或经常前往广告客户的目标位置时,会触发广告。 |
NegativeGeoTargetType
可能的排除性地理位置定位类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
PRESENCE_OR_INTEREST |
指定如果用户位于广告客户排除的地理位置或对这些地理位置表现出兴趣,则不向其展示广告。 |
PRESENCE |
指定如果用户位于广告客户排除的地理位置,则会被排除在广告展示范围之外。 |
FrequencyCapEntry
此类型没有字段。
用于指定在特定时间段内,广告(或一组广告)可向用户展示的次数上限的规则。
SelectiveOptimization
此广告系列的选择性优化设置,其中包含一组要针对此广告系列进行优化的转化操作。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType 且将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。
JSON 表示法 |
---|
{ "conversionActions": [ string ] } |
字段 | |
---|---|
conversion |
为优化此广告系列而选择的一组转化操作资源名称。 |
OptimizationGoalSetting
此广告系列的优化目标设置,其中包括一组优化目标类型。
JSON 表示法 |
---|
{
"optimizationGoalTypes": [
enum ( |
字段 | |
---|---|
optimization |
优化目标类型列表。 |
OptimizationGoalType
优化目标的类型
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用作返回值。表示此版本中未知的值。 |
CALL_CLICKS |
针对来电点击次数进行优化。致电点击转化是指用户在浏览广告后选择“致电”联系商店的次数。 |
DRIVING_DIRECTIONS |
针对导航优化。导航转化是指用户在浏览广告后选择“查询路线”以导航到实体店的次数。 |
APP_PRE_REGISTRATION |
以提高预注册量为目标进行优化。预注册转化是指在应用发布时会收到通知的预注册用户注册人数。 |
TrackingSetting
针对跟踪信息的广告系列级设置。
JSON 表示法 |
---|
{ "trackingUrl": string } |
字段 | |
---|---|
tracking |
用于动态跟踪的网址。 |
ManualCpa
此类型没有字段。
人工出价策略,可让广告客户根据广告客户指定的操作设置出价。
ManualCpc
基于点击的人工出价,此类出价中用户按点击次数付费。
JSON 表示法 |
---|
{ "enhancedCpcEnabled": boolean } |
字段 | |
---|---|
enhanced |
是否根据转化优化工具数据增强出价。 |
ManualCpm
此类型没有字段。
基于展示的人工出价,此类出价中用户按每千次展示付费。
PercentCpc
一种出价策略,采用这种出价策略时,出价是某些商品或服务广告价格的一小部分。
JSON 表示法 |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
字段 | |
---|---|
cpc |
可通过出价策略设置的出价上限。这是由广告客户输入的可选字段,以本地微单位指定。注意:零值的解读方式与 bid_ceiling 未定义相同。 |
enhanced |
根据转化可能性,上调或下调每次竞价的出价。个别出价可能会超过 cpcBidCeilingMicros,但广告系列的平均出价金额不应超过。 |
TargetCpm
此类型没有字段。
“目标每千次展示费用”是一种自动出价策略,可根据您设置的目标每千次展示费用来设置出价,以优化广告效果。
CampaignAsset
广告系列与素材资源之间的关联。
JSON 表示法 |
---|
{
"resourceName": string,
"status": enum ( |
字段 | |
---|---|
resource |
广告系列素材资源的资源名称。CampaignAsset 资源名称的格式如下:
|
status |
广告系列素材资源的状态。 |
campaign |
素材资源关联到的广告系列。 |
asset |
与广告系列关联的素材资源。 |
CampaignAssetSet
CampaignAssetSet 是广告系列与素材资源集之间的关联。添加 CampaignAssetSet 可将素材资源组与广告系列相关联。
JSON 表示法 |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
字段 | |
---|---|
resource |
广告系列素材资源集的资源名称。资产集资产资源名称的格式为:
|
campaign |
此素材资源集所关联的广告系列。 |
asset |
与广告系列相关联的素材资源集。 |
status |
广告系列素材资源组素材资源的状态。只读。 |
CampaignAudienceView
广告系列受众群体视图。包括展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 中的效果数据,按广告系列和受众群体条件汇总。此视图仅包含在广告系列一级附加的受众群体。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
广告系列受众群体视图的资源名称。广告系列受众群体视图资源名称采用以下格式:
|
CampaignCriterion
广告系列定位条件。
JSON 表示法 |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
字段 | |
---|---|
resource |
广告系列条件的资源名称。广告系列条件资源名称的格式如下:
|
display |
条件的显示名称。 对于变更,此字段会被忽略。 |
type |
条件的类型。 |
status |
条件的状态。 |
last |
上次修改此广告系列条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
criterion |
条件的 ID。 在变更期间,此字段会被忽略。 |
bid |
条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。使用 0 可停用设备类型。 |
negative |
是定位 ( |
联合字段 您只能设置一个。 |
|
keyword |
关键字。 |
location |
位置信息。 |
device |
设备。 |
age |
年龄段。 |
gender |
性别。 |
user |
用户列表。 |
language |
语言。 |
webpage |
网页。 |
location |
营业地点组 |
CampaignCriterionStatus
CampaignCriterion 的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
接收的值在此版本中未知。 这是仅限响应的值。 |
ENABLED |
广告系列定位条件处于启用状态。 |
PAUSED |
广告系列定位条件已暂停。 |
REMOVED |
广告系列定位条件会被移除。 |
LanguageInfo
语言条件。
JSON 表示法 |
---|
{ "languageConstant": string } |
字段 | |
---|---|
language |
语言常量资源名称。 |
LocationGroupInfo
通过 Feed 指定的一系列地理位置周围一定半径内的区域。
JSON 表示法 |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
字段 | |
---|---|
geo |
用于限制 Feed 中地理区域范围的地理位置定位目标常量。目前仅允许一个地理位置定位常量。 |
radius |
半径的单位。地理位置定位条件常量支持英里和米。Feed 项集支持毫英里和米。此字段是必需的,必须在 CREATE 操作中设置。 |
feed |
定位其 FeedItemSet 的 FeedItemSet。如果指定了多个 ID,则系统会定位到至少出现在一个集合中的所有项。此字段不能与 geoTargetConstants 搭配使用。此字段是可选字段,只能在 CREATE 操作中设置。 |
radius |
以相应单位指定目标地理位置周边半径的距离。此字段是必需的,必须在 CREATE 操作中设置。 |
LocationGroupRadiusUnits
营业地点组中半径距离的单位(例如 MILES)
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
METERS |
米 |
MILES |
英里 |
MILLI_MILES |
英里 |
CampaignEffectiveLabel
表示广告系列与有效标签之间的关系。有效标签是指继承或直接分配给此广告系列的标签。
JSON 表示法 |
---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
字段 | |
---|---|
resource |
资源的名称。CampaignEffectivelabel 资源名称采用如下格式: |
campaign |
有效标签附加到的广告系列。 |
label |
为广告系列分配的有效标签。 |
owner |
拥有有效标签的客户的 ID。 |
CampaignLabel
表示广告系列与标签之间的关系。
JSON 表示法 |
---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
字段 | |
---|---|
resource |
资源的名称。广告系列标签资源名称采用以下格式: |
campaign |
标签附加到的广告系列。 |
label |
分配给广告系列的标签。 |
owner |
标签所属客户的 ID。 |
CartDataSalesView
购物车数据销售视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
购物车数据销售视图的资源名称。购物车数据销售视图资源名称采用以下格式: |
受众群体
受众群体是一个非常实用的定位选项,可让您组合各种细分受众群属性(例如详细受众特征和兴趣相似的受众群体)来创建代表目标细分受众群某一部分的受众群体。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
字段 | |
---|---|
resource |
受众群体的资源名称。受众群体名称采用以下格式:
|
id |
受众群体的 ID。 |
name |
必需。受众群体的名称。它在所有受众群体中应该是独一无二的。其长度下限为 1,上限为 255。 |
description |
此受众群体的说明。 |
ConversionAction
转化操作。
JSON 表示法 |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
字段 | |
---|---|
resource |
转化操作的资源名称。转化操作资源名称的格式如下:
|
creation |
Floodlight 活动创建的时间戳,采用 ISO 8601 格式。 |
status |
针对转化事件累计的此转化操作的状态。 |
type |
此转化操作的类型。 |
category |
为此转化操作报告的转化类别。 |
value |
与此转化操作相关联的转化事件的价值相关的设置。 |
attribution |
与此转化操作的归因模型相关的设置。 |
floodlight |
Floodlight 转化类型的 Floodlight 设置。 |
id |
转化操作的 ID。 |
name |
转化操作的名称。 此字段为必填字段,在创建新的转化操作时不应为空。 |
primary |
如果某个转化操作的 primaryForGoal 位为 false,则无论其客户转化目标或广告系列转化目标是什么,所有广告系列都无法对该转化操作进行出价。不过,自定义转化目标不遵循 primaryForGoal,因此,如果广告系列的自定义转化目标配置了 primaryForGoal = false 转化操作,则该转化操作仍可出价。默认情况下,如果未设置,primaryForGoal 将为 true。在 V9 中,primaryForGoal 只能在创建后通过“更新”操作设置为 false,因为它未声明为可选。 |
owner |
转化操作所有者客户的资源名称;如果这是系统定义的转化操作,则为 null。 |
include |
此转化操作是否应纳入“clientAccountConversions”指标。 |
include |
此转化操作是否应纳入“转化次数”指标。 |
click |
互动(例如点击)和转化事件之间可能相隔的天数上限。 |
app |
应用转化操作的应用 ID。 |
ConversionActionStatus
转化操作可能的状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
系统会记录转化。 |
REMOVED |
系统将不会记录转化。 |
HIDDEN |
系统不会记录转化,并且转化操作不会显示在界面中。 |
ConversionActionType
转化操作的可能类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AD_CALL |
用户点击广告的来电号码附加信息时发生的转化。 |
CLICK_TO_CALL |
当用户在移动设备上点击电话号码时发生的转化。 |
GOOGLE_PLAY_DOWNLOAD |
用户从 Google Play 商店下载移动应用时发生的转化。 |
GOOGLE_PLAY_IN_APP_PURCHASE |
用户通过 Android 结算系统在应用中进行购买时发生的转化。 |
UPLOAD_CALLS |
由广告客户跟踪并上传的致电转化。 |
UPLOAD_CLICKS |
由广告客户跟踪并随归因点击一起上传的转化。 |
WEBPAGE |
在网页上发生的转化。 |
WEBSITE_CALL |
用户拨打广告客户网站中动态生成的电话号码时发生的转化。 |
STORE_SALES_DIRECT_UPLOAD |
基于第一方或第三方商家数据上传的实体店销售转化。只有许可名单中的客户才能使用实体店销售(直接上传)类型。 |
STORE_SALES |
根据上传的第三方或第三方商家数据,和/或使用支付网络中的银行卡在实体店内购买促成的实体店销售转化。只有许可名单中的客户才能使用实体店销售类型。只读。 |
FIREBASE_ANDROID_FIRST_OPEN |
通过 Firebase 跟踪的 Android 应用首次打开转化。 |
FIREBASE_ANDROID_IN_APP_PURCHASE |
通过 Firebase 跟踪的 Android 应用内购买转化。 |
FIREBASE_ANDROID_CUSTOM |
通过 Firebase 跟踪的 Android 应用自定义转化。 |
FIREBASE_IOS_FIRST_OPEN |
通过 Firebase 跟踪的 iOS 应用首次打开转化。 |
FIREBASE_IOS_IN_APP_PURCHASE |
通过 Firebase 跟踪的 iOS 应用应用内购买转化次数。 |
FIREBASE_IOS_CUSTOM |
通过 Firebase 跟踪的 iOS 应用自定义转化。 |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
通过第三方应用分析工具跟踪的 Android 应用首次打开转化。 |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
通过第三方应用分析工具跟踪的 Android 应用内购买转化。 |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
通过第三方应用 Analytics 跟踪的 Android 应用自定义转化。 |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
通过第三方应用 Analytics 跟踪的 iOS 应用首次打开转化。 |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
通过第三方应用分析工具跟踪的 iOS 应用内购买转化。 |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
通过第三方应用 Analytics 跟踪的 iOS 应用自定义转化。 |
ANDROID_APP_PRE_REGISTRATION |
用户从 Google Play 商店预注册移动应用时发生的转化。只读。 |
ANDROID_INSTALLS_ALL_OTHER_APPS |
跟踪所有未通过应用专用类型跟踪的 Google Play 下载的转化。只读。 |
FLOODLIGHT_ACTION |
这项 Floodlight 活动用于统计用户在查看或点击广告客户的某个广告后访问特定网页的次数。只读。 |
FLOODLIGHT_TRANSACTION |
用于跟踪完成的销售次数或购买的商品数量的 Floodlight 活动。还可以捕获每次销售的总金额。只读。 |
GOOGLE_HOSTED |
跟踪用户在与广告互动后在 Google 产品和服务中执行的本地操作的转化。只读。 |
LEAD_FORM_SUBMIT |
在用户提交潜在客户表单时报告的转化。只读。 |
SALESFORCE |
由 Salesforce 促成的转化。只读。 |
SEARCH_ADS_360 |
从 Search Ads 360 Floodlight 数据导入的转化数据。只读。 |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
未设置来电跟踪,但使用智能广告系列自定义条件在智能广告系列广告中发生的来电转化。只读。 |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
用户点击 Google 地图中的 call 元素。仅限智能广告系列。只读。 |
SMART_CAMPAIGN_MAP_DIRECTIONS |
用户在 Google 地图中请求获取前往某个商家位置的路线。仅限智能广告系列。只读。 |
SMART_CAMPAIGN_TRACKED_CALLS |
使用智能广告系列自定义条件,在已设置来电跟踪的智能广告系列中发生的来电转化。只读。 |
STORE_VISITS |
用户光顾广告客户的实体店时发生的转化。只读。 |
WEBPAGE_CODELESS |
通过网站事件(例如表单提交或网页加载)创建的转化,这些转化未使用单独编码的事件代码段。只读。 |
UNIVERSAL_ANALYTICS_GOAL |
来自关联的 Universal Analytics 目标的转化。 |
UNIVERSAL_ANALYTICS_TRANSACTION |
来自关联的 Universal Analytics 交易的转化。 |
GOOGLE_ANALYTICS_4_CUSTOM |
来自关联的 Google Analytics 4 自定义事件转化的转化。 |
GOOGLE_ANALYTICS_4_PURCHASE |
来自关联的 Google Analytics 4 购买转化的转化。 |
ConversionActionCategory
与 ConversionAction 相关联的转化的类别。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
DEFAULT |
默认类别。 |
PAGE_VIEW |
用户访问某个网页。 |
PURCHASE |
购买、销售或“下单”事件。 |
SIGNUP |
注册用户操作。 |
LEAD |
带来潜在客户的操作。 |
DOWNLOAD |
软件下载操作(例如应用)。 |
ADD_TO_CART |
在广告客户网站上将商品添加到购物车或购物袋。 |
BEGIN_CHECKOUT |
用户在广告客户网站上进入结账流程。 |
SUBSCRIBE_PAID |
产品或服务的付费订阅开始。 |
PHONE_CALL_LEAD |
表示对广告主提供的产品/服务感兴趣的来电。 |
IMPORTED_LEAD |
从外部来源导入 Google Ads 的潜在客户转化。 |
SUBMIT_LEAD_FORM |
在广告客户网站上提交表单,表明对商家感兴趣。 |
BOOK_APPOINTMENT |
与广告客户的商家预约服务。 |
REQUEST_QUOTE |
报价或价格估算请求。 |
GET_DIRECTIONS |
搜索广告主的营业地点并有意光顾。 |
OUTBOUND_CLICK |
对广告客户合作伙伴网站的点击。 |
CONTACT |
与广告客户的通话、短信、电子邮件、聊天或其他类型的联系方式。 |
ENGAGEMENT |
网站互动事件,例如网站停留时长较长或 Google Analytics (GA) 智能目标。适用于 GA、Firebase、GA Gold 目标导入。 |
STORE_VISIT |
光顾实体店。 |
STORE_SALE |
在实体店内发生的销售。 |
QUALIFIED_LEAD |
从外部来源导入 Google Ads 的潜在客户转化,已获得广告客户(营销/销售团队)的进一步资格认证。在潜在客户转化为销售的历程中,广告客户会获取潜在客户,然后通过与消费者联系来采取行动。如果消费者感兴趣并可能最终购买他们的产品,广告客户会将此类潜在客户标记为“符合条件的潜在客户”。 |
CONVERTED_LEAD |
从外部来源导入 Google Ads 的潜在客户转化,且该转化已进一步完成潜在客户发掘广告主所定义的选定阶段。 |
ValueSettings
与与此转化操作关联的转化事件的价值相关的设置。
JSON 表示法 |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
字段 | |
---|---|
default |
当为此转化操作发送的转化事件包含无效、被禁止或缺失的价值,或者此转化操作配置为始终使用默认价值时,要使用的值。 |
default |
当为此转化操作发送的转化事件的币种代码无效或缺失,或者此转化操作配置为始终使用默认值时,要使用的币种代码。 |
always |
用于控制是否使用默认价值和默认货币代码来替代为此转化操作的转化事件中指定的价值和货币代码。 |
AttributionModelSettings
与此转化操作的归因模型相关的设置。
JSON 表示法 |
---|
{ "attributionModel": enum ( |
字段 | |
---|---|
attribution |
此转化操作的归因模型类型。 |
data |
转化操作采用以数据为依据的归因模型的状态。 |
AttributionModel
一种归因模型,描述了如何在之前的多个潜在互动之间分配特定转化的功劳。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
EXTERNAL |
使用外部归因模型。 |
GOOGLE_ADS_LAST_CLICK |
将转化功劳全部归于最终点击。 |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
使用 Google 搜索归因模型将转化功劳全部归于用户的首次点击。 |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
使用 Google 搜索归因将转化功劳平均分配给转化过程中的所有点击。 |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
使用 Google 搜索归因模型,将转化的功劳以指数方式更多地归于最近的点击(半衰期为 1 周)。 |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
该归因模型会将转化功劳的 40% 分配给首次点击和最终点击。其余 20% 会平均分配给所有其他点击。此归因模型使用 Google 搜索归因。 |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
这是一种灵活的模型,可利用机器学习技术,根据 Google 搜索归因模型,在点击之间确定适当的功劳分配。 |
DataDrivenModelStatus
枚举以数据为依据的模型状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AVAILABLE |
以数据为依据的模型可用。 |
STALE |
以数据为依据的模型已过时。至少已 7 天未更新。它仍在使用中,但如果 30 天内没有更新,则会过期。 |
EXPIRED |
以数据为依据的模型已过期。它已至少 30 天未更新,无法使用。最常见的原因是,最近 30 天内没有达到所需的事件数量。 |
NEVER_GENERATED |
系统从未生成以数据为依据的模型。最常见的原因是,在任何 30 天内都没有达到所需的事件数。 |
FloodlightSettings
与 Floodlight 转化操作相关的设置。
JSON 表示法 |
---|
{ "activityGroupTag": string, "activityTag": string, "activityId": string } |
字段 | |
---|---|
activity |
报告转化次数时用于标识 Floodlight 活动组的字符串。 |
activity |
报告转化次数时用于标识 Floodlight 活动的字符串。 |
activity |
DoubleClick Campaign Manager (DCM) 中的 Floodlight 活动的 ID。 |
ConversionCustomVariable
转化自定义变量。如需了解“新版 Search Ads 360 中的自定义 Floodlight 指标和维度简介”,请访问 https://support.google.com/sa360/answer/13567857
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
字段 | |
---|---|
resource |
转化自定义变量的资源名称。转化自定义变量资源名称采用以下格式:
|
id |
转化自定义变量的 ID。 |
name |
必需。转化自定义变量的名称。名称应不重复。名称的最大长度为 100 个字符。前后不应有任何多余的空格。 |
tag |
必需。转化自定义变量的代码。代码应是唯一的,由字符“u”和一个小于或等于 100 的数字组成。例如“u4”。 |
status |
用于统计转化事件的转化自定义变量的状态。 |
owner |
拥有转化自定义变量的客户的资源名称。 |
family |
转化自定义变量的系列。 |
cardinality |
转化自定义变量的基数。 |
floodlight |
Search Ads 360 Floodlight 转化自定义变量的字段。 |
custom |
使用此转化自定义变量的自定义列的 ID。 |
ConversionCustomVariableStatus
转化自定义变量的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ACTIVATION_NEEDED |
转化自定义变量正在等待启用,只有在设为“启用”后才会累积统计信息。 此状态不能用于 CREATE 和 UPDATE 请求。 |
ENABLED |
转化自定义变量已启用,并会累积统计信息。 |
PAUSED |
转化自定义变量将被暂停,并且在重新设为“启用”之前不会累积统计数据。 |
ConversionCustomVariableFamily
转化自定义变量的系列。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
STANDARD |
标准转化自定义变量。客户需要先激活,然后才能使用。 |
FLOODLIGHT |
从自定义 Floodlight 变量导入的转化自定义变量。 |
ConversionCustomVariableCardinality
转化自定义变量的基数。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BELOW_ALL_LIMITS |
转化自定义变量的基数低于所有上限。该变量可用于细分,如果启用该变量,则可累积新值的统计信息。 |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
转化自定义变量的基数超出了细分上限,但未超出统计上限。细分将被停用,但如果变量处于启用状态,系统可以针对新值累积统计信息。 |
APPROACHES_STATS_LIMIT |
转化自定义变量已超出细分限制,并且即将达到统计数据限制(大于 90%)。细分将被停用,但如果变量处于启用状态,系统可以针对新值累积统计信息。 |
EXCEEDS_STATS_LIMIT |
转化自定义变量已超出细分限制和统计限制。系统会停用细分,并且只有在现有值不会进一步增加变量的基数时,启用变量的统计信息才能累积。 |
FloodlightConversionCustomVariableInfo
Search Ads 360 Floodlight 转化自定义变量相关信息。
JSON 表示法 |
---|
{ "floodlightVariableType": enum ( |
字段 | |
---|---|
floodlight |
Search Ads 360 中定义的 Floodlight 变量类型。 |
floodlight |
Search Ads 360 中定义的 Floodlight 变量数据类型。 |
FloodlightVariableType
Floodlight 变量的类型,如 Search Ads 360 中所定义。如需了解详情,请参阅 https://support.google.com/searchads/answer/4397154?hl=en。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
DIMENSION |
维度 Floodlight 变量类型。 |
METRIC |
指标 Floodlight 变量类型。 |
UNSET |
Floodlight 变量类型未设置。 |
FloodlightVariableDataType
Floodlight 变量的数据类型(如 Search Ads 360 中所定义)。如需了解详情,请参阅 https://support.google.com/searchads/answer/4397154?hl=en。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
NUMBER |
表示“数字”类型的 Floodlight 变量。此变量可分配给 DIMENSION 或 METRIC 类型的 Floodlight 变量。 |
STRING |
表示“字符串”类型的 Floodlight 变量。此变量可分配给维度类型的 Floodlight 变量。 |
客户
客户。
JSON 表示法 |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
字段 | |
---|---|
resource |
客户的资源名称。客户资源名称采用以下格式:
|
conversion |
客户的转化跟踪设置。 |
account |
Engine 账号类型,例如 Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track 等。 |
double |
经理客户的 DoubleClick Campaign Manager (DCM) 设置。 |
account |
账号状态,例如“已启用”“已暂停”“已移除”等 |
last |
上次修改此客户的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
engine |
外部引擎账号中的账号的 ID。 |
status |
客户的状态。 |
creation |
创建此客户时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
id |
客户的 ID。 |
descriptive |
(可选)客户的非唯一描述性名称。 |
currency |
账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。 |
time |
客户的当地时区 ID。 |
tracking |
用于根据参数构建跟踪网址的网址模板。 |
final |
用于将参数附加到最终到达网址的网址模板。 |
auto |
是否为客户启用了自动标记功能。 |
manager |
客户是否为经理。 |
ConversionTrackingSetting
与 Search Ads 360 转化跟踪相关的一系列客户级设置。
JSON 表示法 |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
字段 | |
---|---|
accepted |
客户是否已接受客户数据条款。如果使用跨账号转化跟踪,此值会从经理账号继承。此字段为只读字段。如需了解详情,请参阅 https://support.google.com/adspolicy/answer/7475709。 |
conversion |
转化跟踪状态。它指示客户是否在使用转化跟踪,以及此客户的转化跟踪所有者是谁。如果此客户正在使用跨账号转化跟踪,则返回的值会因请求的 |
enhanced |
客户是否已选择启用增强型潜在客户转化。如果使用跨账号转化跟踪,此值会从经理账号继承。此字段为只读字段。 |
google |
创建和管理转化的客户的资源名称。此字段为只读字段。 |
conversion |
此账号使用的转化跟踪 ID。此 ID 并不表示客户是否使用了转化跟踪(conversionTrackingStatus 可用)。此字段为只读字段。 |
google |
客户的经理的转化跟踪 ID。此字段在客户选择启用转化跟踪时设置,并替换 conversionTrackingId。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。 |
cross |
客户的经理的转化跟踪 ID。客户选择启用跨账号转化跟踪后,系统会设置此 ID,并覆盖 conversionTrackingId。 |
ConversionTrackingStatus
客户的转化跟踪状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
NOT_CONVERSION_TRACKED |
客户未使用任何转化跟踪。 |
CONVERSION_TRACKING_MANAGED_BY_SELF |
转化操作由此客户创建和管理。 |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
转化操作由请求的 login-customer-id 中指定的经理账号创建和管理。 |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
转化操作由与请求的 login-customer-id 中指定的客户或经理不同的经理创建和管理。 |
AccountType
可能的引擎账号类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BAIDU |
百度账号。 |
ENGINE_TRACK |
引擎跟踪账号。 |
FACEBOOK |
Facebook 账号。 |
FACEBOOK_GATEWAY |
通过网关管理的 Facebook 账号。 |
GOOGLE_ADS |
Google Ads 账户的效果。 |
MICROSOFT |
Microsoft Advertising 账号。 |
SEARCH_ADS_360 |
Search Ads 360 经理账号。 |
YAHOO_JAPAN |
Yahoo Japan 账号。 |
DoubleClickCampaignManagerSetting
经理客户的 DoubleClick Campaign Manager (DCM) 设置。
JSON 表示法 |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
字段 | |
---|---|
advertiser |
与此客户关联的 Campaign Manager 广告客户的 ID。 |
network |
与此客户相关联的 Campaign Manager 广告联盟的 ID。 |
time |
与此客户关联的 Campaign Manager 广告网络的时区(采用 IANA 时区数据库格式),例如 America/New_York。 |
AccountStatus
账号可能的状态。
枚举 | |
---|---|
UNSPECIFIED |
默认值。 |
UNKNOWN |
未知值。 |
ENABLED |
账号可以投放广告。 |
PAUSED |
用户停用账号。 |
SUSPENDED |
账号因内部流程而被停用。 |
REMOVED |
账号将不可撤消地被停用。 |
DRAFT |
账号仍在设置过程中,尚未启用。 |
CustomerStatus
客户的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
表示可以投放广告的有效账号。 |
CANCELED |
表示已取消的账号无法投放广告。可由管理员用户重新激活。 |
SUSPENDED |
表示已中止的账号无法投放广告。只能由 Google 支持团队激活。 |
CLOSED |
表示已关闭的账号无法投放广告。测试账号的状态也会变为“已关闭”。状态为永久性,且无法重新打开。 |
CustomerAsset
客户与资产之间的关联。
JSON 表示法 |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
字段 | |
---|---|
resource |
客户素材资源的资源名称。CustomerAsset 资源名称采用以下格式:
|
asset |
必需。与客户关联的素材资源。 |
status |
客户素材资源的状态。 |
CustomerAssetSet
CustomerAssetSet 是客户与素材资源集之间的关联。添加 CustomerAssetSet 可将素材资源集与客户相关联。
JSON 表示法 |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
字段 | |
---|---|
resource |
客户素材资源集的资源名称。素材资源组的素材资源资源名称采用以下格式:
|
asset |
与客户关联的素材资源集。 |
customer |
此素材资源集所关联的客户。 |
status |
客户素材资源组素材资源的状态。只读。 |
AccessibleBiddingStrategy
表示客户拥有并与其共享的 BiddingStrategies 视图。
与 BiddingStrategy 不同,此资源除了包含客户拥有的策略之外,还包含客户经理拥有并与客户共享的策略。此资源不提供指标,并且仅公开一部分出价策略属性。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
字段 | |
---|---|
resource |
可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称的格式为:
|
id |
出价策略的 ID。 |
name |
出价策略的名称。 |
type |
出价策略的类型。 |
owner |
拥有出价策略的客户的 ID。 |
owner |
拥有出价策略的客户的 descriptiveName。 |
联合字段 您只能设置一个。 |
|
maximize |
这是一种自动出价策略,可帮助您在预算范围内为广告系列争取尽可能高的转化价值。 |
maximize |
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。 |
target |
一种出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。 |
target |
一种出价策略,可自动针对所选的展示次数百分比进行优化。 |
target |
一种出价策略,可帮助您最大限度地提高收入,同时使平均广告支出回报率达到特定的目标值。 |
target |
一种出价策略,会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。 |
MaximizeConversionValue
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。
JSON 表示法 |
---|
{ "targetRoas": number } |
字段 | |
---|---|
target |
目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。 |
MaximizeConversions
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。
JSON 表示法 |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
字段 | |
---|---|
target |
目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。 |
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 |
可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。 |
CustomerManagerLink
表示客户-经理关联关系。
JSON 表示法 |
---|
{
"resourceName": string,
"status": enum ( |
字段 | |
---|---|
resource |
资源的名称。CustomerManagerLink 资源名称的格式为: |
status |
客户与经理之间的关联状态。 |
manager |
与该客户相关联的经理账号。 |
manager |
客户-经理关联的 ID。此字段为只读字段。 |
start |
CustomerManagerLink 的创建时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
ManagerLinkStatus
关联的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ACTIVE |
表示当前有效的关系 |
INACTIVE |
表示已终止的关系 |
PENDING |
表示经理已请求建立关系,但客户尚未接受。 |
REFUSED |
经理请求建立关联,但客户拒绝了。 |
CANCELED |
表示经理已请求建立关联,但经理取消了关联。 |
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。只读。 |
DynamicSearchAdsSearchTermView
动态搜索广告搜索字词视图。
JSON 表示法 |
---|
{ "resourceName": string, "landingPage": string } |
字段 | |
---|---|
resource |
动态搜索广告搜索字词视图的资源名称。动态搜索广告搜索字词视图资源名称的格式为:
|
landing |
展示的动态着陆页网址。 此字段为只读字段。 |
GenderView
性别视图。genderView 资源反映的是有效的投放状态,而不是添加了哪些条件。默认情况下,不设定性别条件的广告组会向所有性别的用户展示,因此所有性别都会显示在 genderView 中并带有统计信息。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
性别视图的资源名称。性别视图资源名称采用以下格式:
|
GeoTargetConstant
地理位置定位目标常量。
JSON 表示法 |
---|
{
"resourceName": string,
"status": enum ( |
字段 | |
---|---|
resource |
地理位置定位目标常量的资源名称。地理位置定位常量资源名称采用以下格式:
|
status |
地理位置定位条件常量状态。 |
id |
地理位置定位目标常量的 ID。 |
name |
地理位置定位目标常量的英语名称。 |
country |
与目标关联的 ISO 3166-1 alpha-2 国家/地区代码。 |
target |
地理位置定位目标常量目标类型。 |
canonical |
完整的英语名称,包括目标的名称及其父级和国家/地区的名称。 |
parent |
父级地理位置定位目标常量的资源名称。目标地理位置常量资源名称采用以下格式:
|
GeoTargetConstantStatus
地理位置定位目标常量的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
接收的值在此版本中未知。 这是仅限响应的值。 |
ENABLED |
地理位置定位目标常量有效。 |
REMOVAL_PLANNED |
目标地理位置常量已过时,将被移除。 |
KeywordView
关键字视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
关键字视图的资源名称。关键字视图资源名称采用以下格式:
|
标签
标签。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resource |
资源的名称。标签资源名称采用以下格式: |
status |
标签的状态。只读。 |
text |
一种在彩色背景上显示文本的标签。 |
id |
标签的 ID。只读。 |
name |
标签的名称。 此字段是必填字段,创建新标签时不应为空。 此字符串的长度应介于 1 到 80 之间(包括 1 和 80)。 |
LabelStatus
标签的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
标签已启用。 |
REMOVED |
标签已移除。 |
TextLabel
一种在彩色背景上显示文本的标签。
JSON 表示法 |
---|
{ "backgroundColor": string, "description": string } |
字段 | |
---|---|
background |
标签的背景颜色(十六进制格式)。此字符串必须与正则表达式“^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$”匹配。注意:经理账号可能看不到背景颜色。 |
description |
标签的简短说明。长度不得超过 200 个字符。 |
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
地理位置视图按地理位置条件汇总了广告系列的效果。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
位置视图的资源名称。营业地点视图资源名称采用以下格式:
|
ProductBiddingCategoryConstant
产品出价类别。
JSON 表示法 |
---|
{ "resourceName": string, "level": enum ( |
字段 | |
---|---|
resource |
商品出价类别的资源名称。商品出价类别资源名称的格式为:
|
level |
商品出价类别的级别。 |
status |
产品出价类别的状态。 |
id |
商品出价类别的 ID。 此 ID 相当于本文中所述的 google_product_category ID:https://support.google.com/merchants/answer/6324436。 |
country |
商品出价类别的双字母大写国家/地区代码。 |
product |
父级商品出价类别的资源名称。 |
language |
商品出价类别的语言代码。 |
localized |
商品出价类别的显示值,已根据 languageCode 进行本地化。 |
ProductBiddingCategoryLevel
用于描述商品出价类别级别的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
LEVEL1 |
1 级。 |
LEVEL2 |
2 级。 |
LEVEL3 |
第 3 级。 |
LEVEL4 |
4 级。 |
LEVEL5 |
第 5 级。 |
ProductBiddingCategoryStatus
描述产品出价类别状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ACTIVE |
该类别处于有效状态,可以用于出价。 |
OBSOLETE |
此类别已过时。仅用于生成报告。 |
ProductGroupView
产品组视图。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
商品组视图的资源名称。产品组视图资源名称采用以下格式:
|
ShoppingPerformanceView
购物广告效果视图。提供按多个产品维度级别汇总的购物广告系列统计信息。Merchant Center 中的商品维度值(例如品牌、类别、自定义属性、商品状况和商品类型)将反映相应事件记录的日期和时间各个维度的状态。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
购物广告效果视图的资源名称。购物效果视图资源名称采用以下格式: |
UserList
用户列表。这是客户可能定位到的用户列表。
JSON 表示法 |
---|
{
"resourceName": string,
"type": enum ( |
字段 | |
---|---|
resource |
用户列表的资源名称。用户列表资源名称采用以下格式:
|
type |
此列表的类型。 此字段为只读字段。 |
id |
用户列表的 ID。 |
name |
此用户名单的名称。用户名单名称可能不具有唯一性,具体取决于其 access_reason(例如,如果 access_reason=SHARED) |
UserListType
包含可能的用户名单类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
REMARKETING |
UserList 表示为转化类型的集合。 |
LOGICAL |
表示为其他用户列表/兴趣组合的 UserList。 |
EXTERNAL_REMARKETING |
在 Google Ad Manager 平台中创建的 UserList。 |
RULE_BASED |
与规则关联的 UserList。 |
SIMILAR |
包含与另一个 UserList 中的用户相似的用户的 UserList。 |
CRM_BASED |
广告客户以电子邮件或其他格式提供的第一方 CRM 数据的用户名单。 |
UserLocationView
用户位置信息视图。
“用户所在位置”视图包含在国家/地区一级汇总的所有指标,每个国家/地区一行。它会按定位到或未定位到的位置报告用户实际所处位置的指标。如果使用其他细分字段,则每个国家/地区可能会有多个行。
JSON 表示法 |
---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
字段 | |
---|---|
resource |
用户位置信息视图的资源名称。UserLocation 视图资源名称采用以下格式:
|
country |
国家/地区的条件 ID。 |
targeting |
指明是否定位到地理位置。 |
WebpageView
网页浏览。
JSON 表示法 |
---|
{ "resourceName": string } |
字段 | |
---|---|
resource |
网页视图的资源名称。网页视图资源名称采用以下格式:
|
访问
光顾。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
字段 | |
---|---|
resource |
访问的资源名称。访问资源名称采用以下格式:
|
id |
访问的 ID。 |
criterion |
Search Ads 360 关键字 ID。值为 0 表示关键字未归因。 |
merchant |
包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时,Search Ads 360 会生成此 ID。 |
ad |
广告 ID。值为 0 表示广告未归因。 |
click |
作为点击 ID 网址参数传递到着陆页的每次访问的唯一字符串。 |
visit |
访问事件的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
product |
点击的商品的 ID。 |
product |
获得点击的商品的销售渠道:线上或本地。 |
product |
为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。 |
product |
获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。 |
product |
为包含获得点击的商品的商品目录 Feed 注册的国家/地区(ISO-3166 格式)。 |
asset |
在访问事件期间与之互动的素材资源的 ID。 |
asset |
访问事件的素材资源字段类型。 |
ProductChannel
用于描述商品优惠的地区的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ONLINE |
商品在线销售。 |
LOCAL |
该商品在本地商店有售。 |
转化
转化。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitId": string, "advertiserConversionId": string, "productId": string, "productChannel": enum ( |
字段 | |
---|---|
resource |
转化的资源名称。转化资源名称的格式为:
|
id |
转化的 ID |
criterion |
Search Ads 360 条件 ID。值为 0 表示条件未归因。 |
merchant |
包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时,Search Ads 360 会生成此 ID。 |
ad |
广告 ID。值为 0 表示广告未归因。 |
click |
转化归因于的访问的唯一字符串,该字符串会作为点击 ID 网址参数传递到着陆页。 |
visit |
转化归因于的 Search Ads 360 访问 ID。 |
advertiser |
对于线下转化,此 ID 由广告主提供。如果广告客户未指定此类 ID,Search Ads 360 会生成一个 ID。对于线上转化,这等于 ID 列或 floodlightOrderId 列,具体取决于广告客户的 Floodlight 指令。 |
product |
点击的商品的 ID。 |
product |
获得点击的商品的销售渠道:线上或本地。 |
product |
为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。 |
product |
获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。 |
product |
为包含获得点击的商品的商品目录 Feed 注册的国家/地区(ISO-3166 格式)。 |
attribution |
转化归因于的原因:访问或关键字+广告。 |
conversion |
转化事件的时间戳。 |
conversion |
转化上次修改的时间戳。 |
conversion |
转化归因于的访问的时间戳。 |
conversion |
转化记录的商品数量,由 qty 网址参数确定。广告主负责动态填充该参数(如转化中售出的商品数量),否则默认为 1。 |
conversion |
转化事件的调整后收入(以微为单位)。此字段始终采用广告投放账号所用的币种。 |
floodlight |
在修改 Floodlight 货币指令之前,与 Floodlight 事件关联的未更改的原始收入(采用当前报告所用的币种)。 |
floodlight |
广告主为转化提供的 Floodlight 订单 ID。 |
status |
转化的状态,“已启用”或“已移除”。 |
asset |
在转化事件期间与之互动的素材资源的 ID。 |
asset |
转化事件的素材资源字段类型。 |
AttributionType
SearchAds360 中的转化归因类型
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
VISIT |
转化归因于某次访问。 |
CRITERION_AD |
转化会归因于条件和广告对。 |
ConversionStatus
转化的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
ENABLED |
转化已启用。 |
REMOVED |
相应转化已被移除。 |
指标
指标数据。
JSON 表示法 |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
字段 | |
---|---|
all |
所有转化的价值。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/sa360/answer/9250611。 |
all |
转化总次数。包括所有转化,无论 includeInConversionsMetric 的值如何。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/sa360/answer/9250611。 |
conversion |
转化自定义指标。 |
conversions |
按转化日期统计的可出价转化价值的总和。如果选择此列并添加了日期,则日期列中的值表示转化日期。 |
conversions |
按转化日期统计的针对可出价转化类型的转化次数总和。由于归因建模,此值可能会是小数。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。 |
historical |
广告素材的历史质量得分。 |
historical |
历史着陆页体验的质量。 |
historical |
历史搜索的预测点击率 (CTR)。 |
interaction |
付费和免费互动的类型。 |
raw |
原始事件转化指标。 |
absolute |
“搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。 |
all |
互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 |
all |
所有转化的值。 |
all |
转化总次数。包括所有转化,无论 includeInConversionsMetric 的值如何。 |
all |
所有转化的价值除以广告互动(例如文字广告的点击次数或视频广告的观看次数)的总费用。 |
all |
用户在点击广告后或点击广告后,点击“致电”按钮向商店致电的次数。此数值不考虑致电是否接通,也不考虑通话时长。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后,点击“查询路线”按钮导航到相应实体店的次数。 此指标仅适用于 Feed 项。 |
all |
互动带来的所有转化价值除以互动总次数。 |
all |
用户在点击广告后,点击链接查看相应实体店的菜单的次数。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后,在相应商店下单的次数。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后发生的其他转化(例如,发布对商店的评价或保存该商店的地理位置)的次数。 此指标仅适用于 Feed 项。 |
all |
用户在点击广告后光顾相应商店的次数估算值。 此指标仅适用于 Feed 项。 |
visits |
Search Ads 360 成功记录并转到广告主着陆页的点击次数。 |
all |
用户点击广告后进入商店网址的次数。 此指标仅适用于 Feed 项。 |
average |
您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。 |
average |
所有点击次数的总费用除以所获得的总点击次数。此指标是一个货币值,默认以客户的币种返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
average |
平均每千次展示费用 (CPM)。此指标是一个货币值,默认以客户的币种返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks |
点击次数。 |
content |
您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意:内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
content |
您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
content |
您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
conversions |
每次符合转化条件的互动带来的可出价转化次数(来自互动)。显示广告互动促成可出价转化的平均频率。 |
client |
客户账号转化的值。这仅包括 includeInClientAccountConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversions |
可出价转化价值除以转化符合条件的互动的总费用。 |
conversions |
互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
client |
客户账号转化次数。这仅包括 includeInClientAccountConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
cost |
在此期间您的每次点击费用 (CPC) 和每千次展示费用 (CPM) 费用的总和。此指标是一个货币值,默认以客户的币种返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cost |
广告互动费用除以所有转化次数。 |
cost |
每次可出价转化的平均转化次数所对应的转化次数可用的费用。 |
cost |
广告互动费用除以当前模型归因转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
cross |
转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 allConversions 中。 |
cross |
按转化日期统计的跨设备转化次数。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/sa360/answer/9250611。 |
cross |
跨设备转化的值的总和。 |
cross |
按转化日期汇总的跨设备转化价值。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/sa360/answer/9250611。 |
ctr |
广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
conversions |
转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
conversions |
“转化”字段中包含的转化带来的转化价值总和。要使用此指标,您必须为各项转化操作输入转化价值。 |
average |
平均质量得分。 |
historical |
历史质量得分。 |
impressions |
广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
interaction |
在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 |
interactions |
互动次数。互动是指与某种广告格式关联的主用户操作:对于文字广告和购物广告而言是点击,对于视频广告而言是观看,诸如此类。 |
invalid |
报告期内从总点击次数(过滤后 + 未过滤的点击次数)过滤出的点击次数所占的百分比。 |
invalid |
Google 认为不合规定且不向您收费的点击次数。 |
general |
从总点击次数(过滤后 + 未过滤的点击次数)中滤除的常规无效点击次数所占的百分比。这些点击是指 Google 通过常规滤除方法(即已知的无效数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等)检测到的不合法点击。我们不会向您收取这些点击的费用,您的账户统计信息也不会受其影响。如需了解详情,请访问帮助页面:https://support.google.com/campaignmanager/answer/6076504。 |
general |
常规无效点击的数量。这些是通过常规滤除方式(例如已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等)检测到的无效点击子集。我们不会向您收取这些点击的费用,您的账户统计信息也不会受其影响。如需了解详情,请访问帮助页面:https://support.google.com/campaignmanager/answer/6076504。 |
mobile |
适合移动设备的页面的移动点击次数所占的百分比。 |
search |
在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请参阅 https://support.google.com/sa360/answer/9566729。任何低于 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。 页首广告通常展示在顶部自然搜索结果上方,但在某些查询中,页首广告可能会展示在顶部自然搜索结果下方。 |
top |
广告在邻近顶部自然搜索结果的位置展示的次数所占百分比。 |
value |
所有转化的价值除以所有转化的次数。 |
value |
所有转化的价值除以所有转化次数。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息,请访问 https://support.google.com/sa360/answer/9250611。 |
value |
可出价转化的价值除以可出价转化的次数。显示每次可出价转化的平均价值。 |
value |
按转化日期划分的可出价转化价值除以可出价转化次数(按转化日期)。显示每次可出价转化的平均价值(按转化日期)。如果选择此列并添加了日期,则日期列中的值表示转化日期。 |
client |
浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
client |
客户账号作为交叉销售产品时的销货成本 (COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的销货成本为 5 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币值,默认以客户的币种返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross |
“作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。作为交叉销售产品时的销货成本是指并未通过广告宣传售出的产品的总费用。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的销货成本为 5 美元。只有在您跟踪含购物车数据的转化时,该指标才可用。此指标是一个货币价值,默认情况下以客户的货币返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
“客户账号作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的其他产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的毛利润”是指广告促成的交叉销售所产生的收入减去销货成本。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。衬衫的价格为 20 美元,其销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的毛利润就是:15 美元 = 20 美元 - 5 美元。只有在您跟踪含购物车数据的转化时,该指标才可用。此指标是一个货币价值,默认情况下以客户的货币返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross |
“作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的其他产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的毛利润”是指广告促成的交叉销售所产生的收入减去销货成本。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。衬衫的价格为 20 美元,其销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的毛利润就是:15 美元 = 20 美元 - 5 美元。只有在您跟踪含购物车数据的转化时,该指标才可用。此指标是一个货币值,默认以客户的币种返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数 |
client |
“客户账号作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售所产生的总价值。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为交叉销售产品时的收入为 20 美元。只有在您跟踪含购物车数据的转化时,该指标才可用。此指标是一个货币值,默认以客户的币种返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数 |
cross |
“作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售所产生的总价值。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为交叉销售产品时的收入为 20 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币值,默认以客户的币种返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
客户账号中的“交叉销售产品的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
cross |
“作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符,就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
client |
“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品(请参阅购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些货品的成本会计入“作为主推产品时的销货成本”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为主推产品时的销货成本为 3 美元。只有在您跟踪含购物车数据的转化时,该指标才可用。此指标是一个货币价值,默认情况下以客户的货币返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead |
“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些货品的成本会计入“作为主推产品时的销货成本”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为主推产品时的销货成本为 3 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币值,默认以客户的币种返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
“作为客户账号主推产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的同一产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您通过这些销售获得的收入减去销货成本即为您的主打产品的毛利润。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。在这笔订单中,作为主推产品时的毛利润就是:7 美元 = 10 美元 - 3 美元。只有在您跟踪含购物车数据的转化时,该指标才可用。此指标是一个货币值,默认以客户的币种返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数 |
lead |
“作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的同一产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。在这笔订单中,作为主推产品时的毛利润就是:7 美元 = 10 美元 - 3 美元。只有在您跟踪含购物车数据的转化时,该指标才可用。此指标是一个货币值,默认以客户的币种返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数 |
client |
“作为客户账号的主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为主推产品时的收入为 10 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead |
“作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为主推产品时的收入为 10 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币值,默认以客户的币种返回。如需查看 metrics_currency 参数,请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
“客户账号作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些售出产品的总数会计入“作为主推产品时的销量”。示例:客户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
lead |
“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(详见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些售出产品的总数会计入“作为主推产品时的销量”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。 |
值
通用数据容器。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 value 。值。value 只能是下列其中一项: |
|
boolean |
布尔值。 |
int64 |
int64。 |
float |
浮点数。 |
double |
双精度型。 |
string |
它是一个字符串。 |
QualityScoreBucket
列出可能的质量得分类别的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
BELOW_AVERAGE |
广告素材质量低于平均水平。 |
AVERAGE |
广告素材质量中等。 |
ABOVE_AVERAGE |
广告素材的质量高于平均水平。 |
InteractionEventType
用于描述可能的付费和免费互动类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
CLICK |
点击访问网站。在大多数情况下,此互动会导航到外部位置,通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。 |
ENGAGEMENT |
用户表达的意图,即在原地与广告互动。 |
VIDEO_VIEW |
用户观看了视频广告。 |
NONE |
广告转化事件的默认 InteractionEventType。如果广告转化行未指明应将非付费互动(例如广告转化)“提升”为核心指标并报告,则应使用此值。这些转化只是“其他(广告)转化”。 |
细分
仅细分字段。
JSON 表示法 |
---|
{ "adNetworkType": enum ( |
字段 | |
---|---|
ad |
广告网络类型。 |
conversion |
转化操作类别。 |
conversion |
转化自定义维度。 |
day |
星期几,例如星期一。 |
device |
指标应用于的设备。 |
keyword |
关键字条件。 |
product |
商品的渠道。 |
product |
商品的渠道独占性。 |
product |
商品的使用情况。 |
product |
所售商品的使用情况。 |
raw |
原始事件转化维度。 |
conversion |
转化操作的资源名称。 |
conversion |
转化操作名称。 |
date |
指标适用的日期。yyyy-MM-dd 格式,例如 2018-04-17。 |
geo |
表示城市的地理位置定位目标常量的资源名称。 |
geo |
代表国家/地区的地理位置定位目标常量的资源名称。 |
geo |
代表都市圈的地理位置定位目标常量的资源名称。 |
geo |
代表区域的地理位置定位目标常量的资源名称。 |
hour |
以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 |
month |
由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 |
product |
商品的出价类别(第 1 级)。 |
product |
商品的出价类别(第 2 级)。 |
product |
商品的出价类别(第 3 级)。 |
product |
商品的出价类别(第 4 级)。 |
product |
商品的出价类别(第 5 级)。 |
product |
商品的品牌。 |
product |
商品目标销售国家/地区的地理位置定位目标常量的资源名称。 |
product |
商品的自定义属性 0。 |
product |
商品的自定义属性 1。 |
product |
商品的自定义属性 2。 |
product |
商品的自定义属性 3。 |
product |
商品的自定义属性 4。 |
product |
商品的项目 ID。 |
product |
商品语言的语言常量的资源名称。 |
product |
所售商品的出价类别(第 1 级)。 |
product |
所售商品的出价类别(第 2 级)。 |
product |
所售商品的出价类别(第 3 级)。 |
product |
所售产品的出价类别(级别 4)。 |
product |
所售商品的出价类别(第 5 级)。 |
product |
所售商品的品牌。 |
product |
所售商品的自定义属性 0。 |
product |
所售商品的自定义属性 1。 |
product |
所售商品的自定义属性 2。 |
product |
所售商品的自定义属性 3。 |
product |
所售商品的自定义属性 4。 |
product |
所售商品的商品 ID。 |
product |
所售商品的名称。 |
product |
所售商品的类型(第 1 级)。 |
product |
所售商品的类型(第 2 级)。 |
product |
所售商品的类型(第 3 级)。 |
product |
所售商品的类型(第 4 级)。 |
product |
所售商品的类型(第 5 级)。 |
product |
商品的商店 ID。 |
product |
商品的名称。 |
product |
商品的类型(第 1 级)。 |
product |
商品的类型(第 2 级)。 |
product |
商品的类型(第 3 级)。 |
product |
商品的类型(第 4 级)。 |
product |
商品的类型(第 5 级)。 |
quarter |
由一个季度第一天的日期表示的季度。对季度使用日历年,例如 2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 |
week |
定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 |
year |
年份,格式为 yyyy。 |
asset |
仅适用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。如果广告的所有部分(例如广告本身和附加链接等其他组件)一同投放,系统会统计这些部分获得的互动次数(例如点击次数)。如果 interactionOnThisAsset 为 true,则表示互动发生在此特定素材资源上;如果 interactionOnThisAsset 为 false,则表示互动并非发生在此特定素材资源上,而是发生在与此素材资源一起投放的广告的其他部分。 |
AdNetworkType
枚举 Google Ads 广告网络类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
SEARCH |
Google 搜索。 |
SEARCH_PARTNERS |
搜索网络合作伙伴。 |
CONTENT |
展示广告网络。 |
YOUTUBE_SEARCH |
YouTube 搜索。 |
YOUTUBE_WATCH |
YouTube 视频 |
MIXED |
跨广告网络。 |
Keyword
关键字条件细分。
JSON 表示法 |
---|
{
"info": {
object ( |
字段 | |
---|---|
info |
关键字信息。 |
ad |
AdGroupCriterion 资源名称。 |
ProductChannelExclusivity
描述商品优惠可用性的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
SINGLE_CHANNEL |
商品仅通过一个渠道销售(本地实体店或线上),具体取决于其 ProductChannel。 |
MULTI_CHANNEL |
该商品与其网店或本地实体店中的商品匹配,表明其在两个 ShoppingProductChannel 中均可供购买。 |
ProductCondition
用于描述商品优惠状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
OLD |
商品使用情况较旧。 |
NEW |
商品是全新的。 |
REFURBISHED |
商品状况为“翻新”。 |
USED |
商品是二手商品。 |
AssetInteractionTarget
AssetInteractionTarget 细分。
JSON 表示法 |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
字段 | |
---|---|
asset |
资产资源名称。 |
interaction |
仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标一起使用。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。 |