SearchAds360Row

查询返回的行。

JSON 表示法
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
字段
adGroup

object (AdGroup)

查询中引用的广告组。

adGroupAd

object (AdGroupAd)

查询中引用的广告。

adGroupAdLabel

object (AdGroupAdLabel)

查询中引用的广告组广告标签。

adGroupAsset

object (AdGroupAsset)

查询中引用的广告组素材资源。

adGroupAssetSet

object (AdGroupAssetSet)

查询中引用的广告组素材资源组。

adGroupAudienceView

object (AdGroupAudienceView)

查询中引用的广告组受众群体视图。

adGroupBidModifier

object (AdGroupBidModifier)

查询中引用的出价调节系数。

adGroupCriterion

object (AdGroupCriterion)

查询中引用的条件。

adGroupCriterionLabel

object (AdGroupCriterionLabel)

查询中引用的广告组条件标签。

adGroupLabel

object (AdGroupLabel)

查询中引用的广告组标签。

ageRangeView

object (AgeRangeView)

查询中引用的年龄段视图。

asset

object (Asset)

查询中引用的资产。

assetGroupAsset

object (AssetGroupAsset)

查询中引用的素材资源组素材资源。

assetGroupSignal

object (AssetGroupSignal)

查询中引用的素材资源组信号。

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

查询中引用的素材资源组产品信息组过滤条件。

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

查询中引用的素材资源组顶级组合视图。

assetGroup

object (AssetGroup)

查询中引用的素材资源组。

assetSetAsset

object (AssetSetAsset)

查询中引用的素材资源组素材资源。

assetSet

object (AssetSet)

查询中引用的素材资源集。

biddingStrategy

object (BiddingStrategy)

查询中引用的出价策略。

campaignBudget

object (CampaignBudget)

查询中引用的广告系列预算。

campaign

object (Campaign)

查询中引用的广告系列。

campaignAsset

object (CampaignAsset)

查询中引用的广告系列素材资源。

campaignAssetSet

object (CampaignAssetSet)

查询中引用的广告系列素材资源集。

campaignAudienceView

object (CampaignAudienceView)

查询中引用的广告系列受众群体视图。

campaignCriterion

object (CampaignCriterion)

查询中引用的广告系列条件。

campaignLabel

object (CampaignLabel)

查询中引用的广告系列标签。

cartDataSalesView

object (CartDataSalesView)

查询中引用的购物车数据销售视图。

audience

object (Audience)

查询中引用的受众群体。

conversionAction

object (ConversionAction)

查询中引用的转化操作。

conversionCustomVariable

object (ConversionCustomVariable)

查询中引用的转化自定义变量。

customer

object (Customer)

查询中提及的客户。

customerAsset

object (CustomerAsset)

查询中引用的客户素材资源。

customerAssetSet

object (CustomerAssetSet)

查询中引用的客户素材资源集。

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

查询中引用的可访问出价策略。

customerClient

object (CustomerClient)

查询中引用的 CustomerClient。

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

查询中引用的动态搜索广告搜索字词视图。

genderView

object (GenderView)

查询中引用的性别视图。

geoTargetConstant

object (GeoTargetConstant)

查询中引用的地理位置定位常量。

keywordView

object (KeywordView)

查询中引用的关键字视图。

label

object (Label)

查询中引用的标签。

languageConstant

object (LanguageConstant)

查询中引用的语言常量。

locationView

object (LocationView)

查询中引用的位置视图。

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

查询中引用的产品出价类别。

productGroupView

object (ProductGroupView)

查询中引用的产品组视图。

shoppingPerformanceView

object (ShoppingPerformanceView)

查询中引用的购物效果视图。

userList

object (UserList)

查询中引用的用户名单。

webpageView

object (WebpageView)

查询中引用的网页视图。

visit

object (Visit)

查询中引用的事件级访问。

conversion

object (Conversion)

查询中引用的事件级转化。

metrics

object (Metrics)

指标。

segments

object (Segments)

细分受众群。

customColumns[]

object (Value)

自定义列。

广告组

广告组。

JSON 表示法
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
字段
resourceName

string

广告组的资源名称。广告组资源名称采用以下格式:

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

广告组的状态。

type

enum (AdGroupType)

广告组的类型。

adRotationMode

enum (AdGroupAdRotationMode)

广告组的广告轮播模式。

creationTime

string

创建此 adGroup 时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。

targetingSetting

object (TargetingSetting)

用于定位相关功能的设置。

labels[]

string

附加到此广告组的标签的资源名称。

engineId

string

外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请使用“adGroup.id”。

startDate

string

此广告组开始投放广告的日期。默认情况下,广告组会立即或在广告组的开始日期(以较早者为准)开始投放广告。如果设置了此字段,则广告组将从客户时区的指定日期开始时开始投放广告。此字段仅适用于 Microsoft Advertising 和 Facebook 网关账号。

格式:YYYY-MM-DD 示例:2019-03-14

endDate

string

广告组停止投放广告的日期。默认情况下,广告组的结束日期为广告组的结束日期。如果设置了此字段,则广告组将在指定日期(以客户所在时区为准)结束投放。此字段仅适用于 Microsoft Advertising 和 Facebook 网关账号。

格式:YYYY-MM-DD 示例:2019-03-14

languageCode

string

广告组中广告和关键字的语言。此字段仅适用于 Microsoft Advertising 账号。更多详情:https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

上次修改此广告组的日期时间。日期时间采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

id

string (int64 format)

广告组的 ID。

name

string

广告组的名称。

此字段是必填字段,创建新广告组时不应为空。

其包含的 UTF-8 全角字符必须少于 255 个。

并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。

cpcBidMicros

string (int64 format)

每次点击费用 (cost-per-click) 出价上限。

engineStatus

enum (AdGroupEngineStatus)

广告组的引擎状态。

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 (TargetRestriction)
    }
  ]
}
字段
targetRestrictions[]

object (TargetRestriction)

用于限制广告系列或广告组覆盖面的每个定位维度的设置。

TargetRestriction

每个定位维度的定位设置列表。

JSON 表示法
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
字段
targetingDimension

enum (TargetingDimension)

这些设置适用的定位维度。

bidOnly

boolean

指明是将您的广告限制为仅针对您为此 targetingDimension 选择的条件展示,还是定位此 targetingDimension 的所有值,并根据您在其他 TargetingDimensions 中的定位条件展示广告。如果值为 true,则表示这些条件只会应用出价调节系数,而不会影响定位。值 false 表示这些条件会限制定位以及应用出价调节系数。

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 (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
字段
resourceName

string

广告的资源名称。广告组的广告资源名称采用以下格式:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

广告的状态。

ad

object (Ad)

广告。

creationTime

string

创建此 adGroupAd 时的时间戳。日期时间采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

labels[]

string

附加到此广告组广告的标签的资源名称。

engineId

string

外部引擎账号中的广告 ID。此字段仅适用于 Search Ads 360 账号,例如 Yahoo Japan、Microsoft、百度账号。对于非 Search Ads 360 实体,请使用“adGroupAd.ad.id”。

engineStatus

enum (AdGroupAdEngineStatus)

外部引擎账号中广告的其他状态。可能的状态(取决于外部账号的类型)包括“活跃”、“有效”、“待审核”等。

lastModifiedTime

string

最后一次修改此广告组广告的日期时间。日期时间采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

AdGroupAdStatus

AdGroupAd 的可能状态。

枚举
UNSPECIFIED 未指定值。
UNKNOWN

接收的值在此版本中未知。

这是一个仅用于响应的值。

ENABLED 广告组的广告已启用。
PAUSED 广告组中的广告已暂停。
REMOVED 该广告组的广告会被移除。

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 多重素材资源发现广告。
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

string

广告的标题。

description1

string

广告内容描述的第一行。

description2

string

广告内容描述的第二行。

displayUrl

string

广告的显示网址。

displayMobileUrl

string

广告的移动网址。

adTrackingId

string (int64 format)

广告的跟踪 ID。

SearchAds360ExpandedTextAdInfo

一个 Search Ads 360 加大型文字广告。

JSON 表示法
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
字段
headline

string

广告的标题。

headline2

string

广告的第二个标题。

headline3

string

广告的第三个标题。

description1

string

广告内容描述的第一行。

description2

string

广告内容描述的第二行。

path1

string

附加到自动生成的可见网址(包含分隔符)的文本。

path2

string

使用分隔符附加到路径 1 的文本。

adTrackingId

string (int64 format)

广告的跟踪 ID。

SearchAds360ResponsiveSearchAdInfo

Search Ads 360 自适应搜索广告。

JSON 表示法
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
字段
headlines[]

object (AdTextAsset)

标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。

descriptions[]

object (AdTextAsset)

说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。

path1

string

附加到自动生成的可见网址(包含分隔符)的文本。

path2

string

使用分隔符附加到路径 1 的文本。

adTrackingId

string (int64 format)

广告的跟踪 ID。

AdTextAsset

在广告中使用的文字素材资源。

JSON 表示法
{
  "text": string
}
字段
text

string

素材资源文字。

SearchAds360ProductAdInfo

此类型没有字段。

一个 Search Ads 360 产品广告。

SearchAds360ExpandedDynamicSearchAdInfo

加大型动态搜索广告。

JSON 表示法
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
字段
description1

string

广告内容描述的第一行。

description2

string

广告内容描述的第二行。

adTrackingId

string (int64 format)

广告的跟踪 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 由于广告组暂停,广告素材也已暂停。

AdGroupAdLabel

广告组广告和标签之间的关系。

JSON 表示法
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}
字段
resourceName

string

广告组广告标签的资源名称。广告组广告标签资源名称采用以下格式:customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

标签附加到的广告组广告。

label

string

分配给广告组广告的标签。

AdGroupAsset

广告组与素材资源之间的关联。

JSON 表示法
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
字段
resourceName

string

广告组素材资源的资源名称。AdGroupAsset 资源名称采用以下格式:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

必需。与素材资源相关联的广告组。

asset

string

必需。与广告组相关联的素材资源。

status

enum (AssetLinkStatus)

广告组素材资源的状态。

AssetLinkStatus

描述资产关联状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 已启用资产链接。
REMOVED 已移除素材资源链接。
PAUSED 素材资源关联已暂停。

AdGroupAssetSet

AdGroupAssetSet 是广告组与素材资源集之间的关联。创建 AdGroupAssetSet 可将素材资源集与广告组相关联。

JSON 表示法
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
字段
resourceName

string

广告组素材资源组的资源名称。广告组素材资源组资源名称采用以下格式:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

此素材资源组所关联的广告组。

assetSet

string

与广告组相关联的素材资源集。

status

enum (AssetSetLinkStatus)

广告组素材资源集的状态。只读。

AssetSetLinkStatus

素材资源集与其容器之间可能关联的状态。

枚举
UNSPECIFIED 状态尚未指定。
UNKNOWN 接收的值在此版本中未知。这是一个仅用于响应的值。
ENABLED 素材资源集与其容器之间的关联已启用。
REMOVED 素材资源集与其容器之间的关联已解除。

AdGroupAudienceView

广告组受众群体视图。包括来自展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据,在受众群体一级汇总。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式:

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

表示广告组出价调节系数。

JSON 表示法
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
字段
resourceName

string

广告组出价调节系数的资源名称。广告组出价调节系数资源名称采用以下格式:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。对于 PreferredContent,该范围介于 1.0 - 6.0 之间。使用 0 可停用设备类型。

联合字段 criterion。此广告组出价调节系数的条件。

从 V5 开始的创建操作中必需。criterion 只能是下列其中一项:

device

object (DeviceInfo)

设备标准。

DeviceInfo

设备标准。

JSON 表示法
{
  "type": enum (Device)
}
字段
type

enum (Device)

设备类型。

设备

枚举可用于定位的 Google Ads 设备。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
MOBILE 配备完善的网络浏览功能的移动设备。
TABLET 配备完善的网络浏览功能的平板电脑。
DESKTOP 计算机。
CONNECTED_TV 智能电视和游戏机。
OTHER 其他设备类型。

AdGroupCriterion

广告组标准。adGroupCriterion 报告仅返回明确添加到广告组中的条件。

JSON 表示法
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
字段
resourceName

string

广告组条件的资源名称。广告组条件资源名称采用以下格式:

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

string

创建此广告组条件时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。

status

enum (AdGroupCriterionStatus)

条件的状态。

这是由客户设置的广告组条件实体的状态。注意:界面报告可能包含其他信息,这些信息会影响条件是否能够运行。在某些情况下,在 API 中已移除的标准仍可在界面中显示为已启用。例如,默认情况下,广告系列会面向所有年龄段的用户展示(已被排除的除外)。该界面会将各个年龄段显示为“已启用”,因为它们有资格观看广告;但 AdGroupCriterion.status 会显示为“已移除”,因为系统未添加任何肯定条件。

qualityInfo

object (QualityInfo)

关于标准质量的信息。

type

enum (CriterionType)

标准的类型。

labels[]

string

广告组条件所附标签的资源名称。

positionEstimates

object (PositionEstimates)

不同排名的定位标准出价估算值。

finalUrls[]

string

广告的所有跨网域重定向之后可能存在的最终到达网址列表。

engineId

string

外部引擎账号中的广告组条件的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请使用“adGroupCriterion.criterion_id”。

lastModifiedTime

string

上次修改此广告组条件时的日期时间。日期时间采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

criterionId

string (int64 format)

条件的 ID。

adGroup

string

条件所属的广告组。

negative

boolean

是定位 (false) 还是排除 (true) 条件。

该字段不可更改。 如需将条件从正切换为负,请先移除再重新添加。

bidModifier

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。

cpcBidMicros

string (int64 format)

每次点击费用出价。

effectiveCpcBidMicros

string (int64 format)

有效每次点击费用 (cost-per-click) 出价。

engineStatus

enum (AdGroupCriterionEngineStatus)

广告组条件的引擎状态。

finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。

trackingUrlTemplate

string

用于构建跟踪网址的网址模板。

联合字段 criterion。广告组标准。

您只能设置一个。criterion 只能是下列其中一项:

keyword

object (KeywordInfo)

关键字。

listingGroup

object (ListingGroupInfo)

产品信息组。

ageRange

object (AgeRangeInfo)

年龄段。

gender

object (GenderInfo)

性别。

userList

object (UserListInfo)

用户列表。

webpage

object (WebpageInfo)

网页

location

object (LocationInfo)

位置信息。

AdGroupCriterionStatus

AdGroupCriterion 的可能状态。

枚举
UNSPECIFIED 未指定值。
UNKNOWN

接收的值在此版本中未知。

这是一个仅用于响应的值。

ENABLED 广告组条件已启用。
PAUSED 广告组条件已暂停。
REMOVED 广告组条件会被移除。

QualityInfo

广告组条件质量信息的容器。

JSON 表示法
{
  "qualityScore": integer
}
字段
qualityScore

integer

质量得分。

如果 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 人生大事

PositionEstimates

不同排名的定位标准出价估算值。

JSON 表示法
{
  "topOfPageCpcMicros": string
}
字段
topOfPageCpcMicros

string (int64 format)

要让广告显示在搜索结果首页顶部所需的每次点击费用出价的估算值。

AdGroupCriterionEngineStatus

枚举 AdGroupCriterion 引擎状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
AD_GROUP_CRITERION_ELIGIBLE

已弃用。请勿使用。

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN 百度:出价或质量太低,无法显示。
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 (KeywordMatchType),
  "text": string
}
字段
matchType

enum (KeywordMatchType)

关键字的匹配类型。

text

string

关键字文本(最多 80 个字符和 10 个字词)。

KeywordMatchType

可能的关键字匹配类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
EXACT 完全匹配。
PHRASE 词组匹配。
BROAD 广泛匹配。

ListingGroupInfo

产品信息组条件。

JSON 表示法
{
  "type": enum (ListingGroupType)
}
字段
type

enum (ListingGroupType)

产品信息组的类型。

ListingGroupType

产品信息组的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
SUBDIVISION 根据某些商品详情维度对商品进行细分。这些节点不会用于定位列表条目,而仅用于定义树的结构。
UNIT 产品信息组的单位,用于定义出价。

AgeRangeInfo

年龄段标准。

JSON 表示法
{
  "type": enum (AgeRangeType)
}
字段
type

enum (AgeRangeType)

年龄段的类型。

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 (GenderType)
}
字段
type

enum (GenderType)

性别的类型。

GenderType

受众特征性别的类型(例如,女性)。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
MALE 男。
FEMALE 女性。
UNDETERMINED 性别未确定。

UserListInfo

用户列表标准。表示由广告客户定义的要定位的用户列表。

JSON 表示法
{
  "userList": string
}
字段
userList

string

用户列表资源名称。

WebpageInfo

表示用于定位广告客户网站网页的条件。

JSON 表示法
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
字段
conditions[]

object (WebpageConditionInfo)

用于网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。条件列表为空表示广告系列网站的所有网页均已定位。

此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。

coveragePercentage

number

网站条件覆盖率百分比。这是根据广告组和广告系列中的网站定位条件、排除网站定位条件和否定关键字计算出的网站覆盖率百分比。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。此字段为只读字段。

criterionName

string

由此参数定义的条件的名称。名称值将用于对此类参数进行标识、排序和过滤。

此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。

WebpageConditionInfo

用于定位广告客户网站网页的逻辑表达式。

JSON 表示法
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
字段
operand

enum (WebpageConditionOperand)

网页定位条件的操作数。

operator

enum (WebpageConditionOperator)

网页定位条件的运算符。

argument

string

网页定位条件的参数。

WebpageConditionOperand

网页条件中的网页条件操作数。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
URL 表示网页网址定位条件的操作数。
CATEGORY 表示网页类别定位条件的操作数。
PAGE_TITLE 表示网页标题定位条件的操作数。
PAGE_CONTENT 表示网页内容定位条件的操作数。
CUSTOM_LABEL 表示网页自定义标签定位条件的操作数。

WebpageConditionOperator

网页条件中的网页条件运算符。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
EQUALS 参数 web 条件等于所比较的网络条件。
CONTAINS 参数 web 条件是比较网络条件的一部分。

LocationInfo

地理位置标准。

JSON 表示法
{
  "geoTargetConstant": string
}
字段
geoTargetConstant

string

地理位置定位常量资源名称。

AdGroupCriterionLabel

广告组条件和标签之间的关系。

JSON 表示法
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}
字段
resourceName

string

广告组条件标签的资源名称。广告组条件标签资源名称采用以下格式:customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

标签附加到的广告组条件。

label

string

分配给广告组条件的标签。

AdGroupLabel

广告组和标签之间的关系。

JSON 表示法
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
字段
resourceName

string

广告组标签的资源名称。广告组标签资源名称采用以下格式:customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

adGroup

string

标签附加到的广告组。

label

string

分配给广告组的标签。

AgeRangeView

年龄段视图。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

年龄段视图的资源名称。年龄段视图资源名称采用以下格式:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

素材资源

素材资源是广告的一部分,可在多个广告之间共享。可以是图片 (ImageAsset)、视频 (YoutubeVideoAsset) 等。资源不可更改,且无法移除。若要停止投放某项素材资源,请从使用该素材资源的实体中移除该素材资源。

JSON 表示法
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
字段
resourceName

string

资产的资源名称。资产资源名称采用以下格式:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

资产的类型。

finalUrls[]

string

所有跨网域重定向之后可能的最终到达网址的列表。

status

enum (AssetStatus)

素材资源的状态。

creationTime

string

创建此素材资源时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。

lastModifiedTime

string

上次修改此素材资源的日期时间。日期时间采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

id

string (int64 format)

资产的 ID。

name

string

资产的可选名称。

trackingUrlTemplate

string

用于构建跟踪网址的网址模板。

engineStatus

enum (AssetEngineStatus)

资产的引擎状态。

联合字段 asset_data。资产的特定类型。asset_data 只能是下列其中一项:
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube 视频素材资源。

imageAsset

object (ImageAsset)

图片素材资源。

textAsset

object (TextAsset)

文字素材资源。

calloutAsset

object (UnifiedCalloutAsset)

统一的宣传信息素材资源。

pageFeedAsset

object (UnifiedPageFeedAsset)

统一的页面 Feed 素材资源。

mobileAppAsset

object (MobileAppAsset)

一项移动应用素材资源。

callAsset

object (UnifiedCallAsset)

统一的电话素材资源。

callToActionAsset

object (CallToActionAsset)

号召性用语素材资源。

locationAsset

object (UnifiedLocationAsset)

统一的地址素材资源。

资源类型

描述可能的资产类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
YOUTUBE_VIDEO YouTube 视频素材资源。
MEDIA_BUNDLE 媒体包素材资源。
IMAGE 图片素材资源。
TEXT 文字素材资源。
LEAD_FORM 潜在客户表单素材资源。
BOOK_ON_GOOGLE “通过 Google 预订”素材资源。
PROMOTION 促销信息素材资源。
CALLOUT 宣传信息素材资源。
STRUCTURED_SNIPPET 结构化摘要素材资源。
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 动态航班素材资源。
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
}
字段
youtubeVideoTitle

string

YouTube 视频标题。

youtubeVideoId

string

YouTube 视频 ID。这是用于 YouTube 视频网址的字符串值,共 11 个。

ImageAsset

图片素材资源。

JSON 表示法
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
字段
mimeType

enum (MimeType)

图片资源的 MIME 类型。

fullSize

object (ImageDimension)

此图片原始大小的元数据。

fileSize

string (int64 format)

图片资源的文件大小(以字节为单位)。

MimeType

MIME 类型

枚举
UNSPECIFIED 未指定 MIME 类型。
UNKNOWN

接收的值在此版本中未知。

这是一个仅用于响应的值。

IMAGE_JPEG image/jpeg MIME 类型。
IMAGE_GIF image/gif MIME 类型。
IMAGE_PNG image/png MIME 类型。
FLASH application/x-shockwave-flash MIME 类型。
TEXT_HTML text/html MIME 类型。
PDF application/pdf MIME 类型。
MSWORD application/msword MIME 类型。
MSEXCEL application/vnd.ms-excel MIME 类型。
RTF application/rtf 的 MIME 类型。
AUDIO_WAV audio/wav MIME 类型。
AUDIO_MP3 audio/mp3 MIME 类型。
HTML5_AD_ZIP application/x-html5-ad-zip MIME 类型。

ImageDimension

特定大小的图片的元数据(原始大小或调整后的图片)。

JSON 表示法
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
字段
heightPixels

string (int64 format)

图片的高度。

widthPixels

string (int64 format)

图片的宽度。

url

string

可返回具有此高度和宽度的图片的网址。

TextAsset

文字素材资源。

JSON 表示法
{
  "text": string
}
字段
text

string

文字素材资源的文字内容。

UnifiedCalloutAsset

统一的宣传信息素材资源。

JSON 表示法
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
字段
calloutText

string

宣传信息文字。此字符串的长度应介于 1 和 25 之间(含 1 和 25)。

startDate

string

此素材资源生效并且可以开始投放的开始日期,格式为 yyyy-MM-dd。

endDate

string

此素材资源有效并且仍在投放的最后日期,格式为 yyyy-MM-dd。

adScheduleTargets[]

object (AdScheduleInfo)

不重叠的投放时间列表,用于指定素材资源可以投放的所有时间间隔。每天最多可以设置 6 个时间表,总共 42 个。

useSearcherTimeZone

boolean

是否按搜索用户的时区显示资源。适用于 Microsoft Ads。

AdScheduleInfo

表示 AdSchedule 标准。

AdSchedule 指定为星期几以及展示广告的时间间隔。

同一天最多只能添加六个 AdSchedule。

JSON 表示法
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
字段
startMinute

enum (MinuteOfHour)

此时间表启动的那一小时之后的分钟数。

此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。

endMinute

enum (MinuteOfHour)

此投放时间结束小时后的分钟数。该时间表不包含结束分钟。

此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。

dayOfWeek

enum (DayOfWeek)

投放时间是星期几。

此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。

startHour

integer

24 小时制的整点启动时间。此字段必须介于 0 和 23 之间(含 0 和 23)。

此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。

endHour

integer

24 小时制的整点结束时间;24 表示一天结束。此字段必须介于 0 和 24 之间(含 0 和 24)。

此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。

MinuteOfHour

一刻钟的枚举。例如:"FIFTEEN"

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
ZERO 整点过后的零分钟。
FIFTEEN 整点过后十五分钟。
THIRTY 整点过后三十分钟。
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 (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
字段
description1

string

站内链接的说明的第一行。如此行已设置,则长度应介于 1 到 35 之间(包括 1 和 35),并且还必须设置 description2。

description2

string

附加链接说明的第二行。如此行已设置,则长度应介于 1 到 35 之间(包括 1 和 35),并且还必须设置 description1。

startDate

string

此素材资源生效并且可以开始投放的开始日期,格式为 yyyy-MM-dd。

endDate

string

此素材资源有效并且仍在投放的最后日期,格式为 yyyy-MM-dd。

adScheduleTargets[]

object (AdScheduleInfo)

不重叠的投放时间列表,用于指定素材资源可以投放的所有时间间隔。每天最多可以设置 6 个时间表,总共 42 个。

trackingId

string (int64 format)

用于跟踪站内链接素材资源的点击次数的 ID。这是一个 Yahoo!Japan 字段。

useSearcherTimeZone

boolean

是否按搜索用户所在的时区显示站内链接素材资源。适用于 Microsoft Ads。

mobilePreferred

boolean

是否偏好设置设为在移动设备上展示站内链接素材资源。适用于 Microsoft Ads。

UnifiedPageFeedAsset

统一的页面 Feed 素材资源。

JSON 表示法
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
字段
pageUrl

string

广告客户要定位的网页。

labels[]

string

用于对页面网址进行分组的标签。

MobileAppAsset

一项代表移动应用的素材资源。

JSON 表示法
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
字段
appId

string

必需。唯一标识移动应用的字符串。它应该只包含平台原生 ID,例如“com.android.ebay”对于 Android 或“12345689”。

appStore

enum (MobileAppVendor)

必需。分发此特定应用的应用商店。

MobileAppVendor

移动应用供应商的类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
APPLE_APP_STORE Apple App Store 的移动应用供应商。
GOOGLE_APP_STORE Google 应用商店的移动应用供应商。

UnifiedCallAsset

统一的电话素材资源。

JSON 表示法
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
字段
countryCode

string

电话号码的双字母国家/地区代码。示例:“US”、“us”。

phoneNumber

string

广告客户的原始电话号码。示例:“1234567890”“(123)456-7890”

callConversionReportingState

enum (CallConversionReportingState)

指明此 CallAsset 是应该使用自己的致电转化设置、采用账号级设置,还是停用致电转化。

callConversionAction

string

将来电转化归因于的转化操作。如果未设置此政策,系统将使用默认转化操作。此字段仅在 callConversionReportingState 设置为 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 时才有效。

adScheduleTargets[]

object (AdScheduleInfo)

不重叠的投放时间列表,用于指定素材资源可以投放的所有时间间隔。每天最多可以设置 6 个时间表,总共 42 个。

callOnly

boolean

来电是否仅显示电话号码,而不显示网站链接。适用于 Microsoft Ads。

callTrackingEnabled

boolean

是否应在通话跟踪中启用通话。适用于 Microsoft Ads。

useSearcherTimeZone

boolean

是否按照搜索用户的时区显示附加电话信息。适用于 Microsoft Ads。

startDate

string

此素材资源生效并且可以开始投放的开始日期,格式为 yyyy-MM-dd。

endDate

string

此素材资源有效并且仍在投放的最后日期,格式为 yyyy-MM-dd。

CallConversionReportingState

来电转化操作状态可能的数据类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
DISABLED 来电转化操作已停用。
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 来电转化操作将使用在账号一级设置的来电转化类型。
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 来电转化操作将使用在资源(来电专用广告/附加电话信息)一级设置的来电转化类型。

CallToActionAsset

号召性用语素材资源。

JSON 表示法
{
  "callToAction": enum (CallToActionType)
}
字段
callToAction

enum (CallToActionType)

号召性用语。

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 (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
字段
placeId

string

地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。此字段对于给定客户 ID 和素材资源类型而言是唯一的。如需详细了解地点 ID,请访问 https://developers.google.com/places/web-service/place-id

businessProfileLocations[]

object (BusinessProfileLocation)

客户的营业地点列表。只有在将地址素材资源从商家资料账号同步时,系统才会返回该字符串。同一账号下可以有多个指向同一地点 ID 的商家资料商家信息。

locationOwnershipType

enum (LocationOwnershipType)

营业地点所有权的类型。如果类型为 BUSINESS_OWNER,则将作为附加地址信息投放。如果类型为 AFFILIATE,则将作为关联商户地址提供。

BusinessProfileLocation

从关联的商家资料账号同步了商家资料营业地点数据。

JSON 表示法
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
字段
labels[]

string

广告客户为商家资料账号中的营业地点指定的标签。这些数据是从商家资料账号同步过来的。

storeCode

string

此营业地点的商家资料商店代码。这些数据是从商家资料账号同步过来的。

listingId

string (int64 format)

此商家资料营业地点的商家信息 ID。这些数据是从关联的商家资料账号同步过来的。

LocationOwnershipType

可能的营业地点所有权类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
BUSINESS_OWNER 营业地点的商家所有者(旧版附加地址信息 - LE)。
AFFILIATE 关联商户地址(第三方附加地址信息 - ALE)。

AssetGroupAsset

AssetGroupAsset 是素材资源与素材资源组之间的关联。添加 AssetGroupAsset 可将素材资源与素材资源组相关联。

JSON 表示法
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
字段
resourceName

string

素材资源组素材资源的资源名称。素材资源组的素材资源资源名称采用以下格式:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

此素材资源组素材资源要关联的素材资源组。

asset

string

此素材资源组素材资源要关联的素材资源。

fieldType

enum (AssetFieldType)

素材资源在素材资源组中的展示位置说明。例如:HEADLINE、YOUTUBE_VIDEO 等

status

enum (AssetLinkStatus)

素材资源与素材资源组之间的关联状态。

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 该素材资源已关联,可用作附加结构化摘要信息。
MOBILE_APP 该素材资源已关联,可用作附加移动应用信息。
HOTEL_CALLOUT 该素材资源已关联,可用作酒店附加宣传信息。
CALL 该素材资源已关联,可用作附加电话信息。
PRICE 该素材资源已关联,可用作附加价格信息。
LONG_HEADLINE 该素材资源已关联,可用作长标题。
BUSINESS_NAME 该素材资源已关联,用作商家名称。
SQUARE_MARKETING_IMAGE 该素材资源已关联,可用作方形营销图片。
PORTRAIT_MARKETING_IMAGE 该素材资源已关联,可用作纵向营销图片。
VIDEO 资产链接可用作非 YouTube 徽标。
CALL_TO_ACTION_SELECTION 该素材资源已关联,用于选择号召性用语。
AD_IMAGE 该素材资源已关联,用于选择广告图片。
HOTEL_PROPERTY 该素材资源已关联,用作指定旅行目标的效果最大化广告系列中的酒店房源。

AssetGroupSignal

AssetGroupSignal 表示素材资源组中的信号。信号的存在会告知效果最大化广告系列哪些用户最有可能完成转化。效果最大化广告系列会根据该信号寻找意向相似或更强的新用户,以便在搜索网络、展示广告网络、视频平台等位置获取转化。

JSON 表示法
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
字段
resourceName

string

素材资源组信号的资源名称。素材资源组信号资源名称采用以下格式:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

此素材资源组信号所属的素材资源组。

联合字段 signal。素材资源组的信号。signal 只能是下列其中一项:
audience

object (AudienceInfo)

效果最大化广告系列要使用的受众群体信号。

AudienceInfo

受众群体条件。

JSON 表示法
{
  "audience": string
}
字段
audience

string

受众群体资源名称。

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter 表示素材资源组中的产品信息组过滤条件树节点。

JSON 表示法
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
字段
resourceName

string

素材资源组产品信息组过滤条件的资源名称。素材资源组产品信息组过滤条件资源名称采用以下格式:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

此素材资源组产品信息组过滤条件所属的素材资源组。

id

string (int64 format)

ListingGroupFilter 的 ID。

type

enum (ListingGroupFilterType)

产品信息组过滤条件节点的类型。

vertical

enum (ListingGroupFilterVertical)

当前节点树代表的行业。同一树中的所有节点必须属于同一行业。

caseValue

object (ListingGroupFilterDimension)

此产品信息组用于优化其父级的维度值。对于根组,未定义。

parentListingGroupFilter

string

父级产品信息组细分的资源名称。对于根产品信息组过滤条件节点,值为 null。

path

object (ListingGroupFilterDimensionPath)

用于定义此产品信息组过滤条件的维度的路径。

ListingGroupFilterType

产品信息组过滤条件的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
SUBDIVISION 根据某些商品详情维度对商品进行细分。
UNIT_INCLUDED 包含的产品信息组过滤条件叶节点。
UNIT_EXCLUDED 一个已排除的产品信息组过滤条件叶节点。

ListingGroupFilterVertical

产品信息组过滤条件行业的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
SHOPPING 表示购物行业。只能在零售专用效果最大化广告系列中使用该行业。

ListingGroupFilterDimension

素材资源组产品信息组过滤条件的产品信息维度。

JSON 表示法
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
字段
联合字段 dimension。以下类型之一的维度始终存在。dimension 只能是下列其中一项:
productBiddingCategory

object (ProductBiddingCategory)

商品报价的出价类别。

productBrand

object (ProductBrand)

商品优惠的品牌。

productChannel

object (ProductChannel)

产品优惠的地区。

productCondition

object (ProductCondition)

商品优惠的条件。

productCustomAttribute

object (ProductCustomAttribute)

商品优惠的自定义属性。

productItemId

object (ProductItemId)

产品优惠的商品 ID。

productType

object (ProductType)

商品优惠的类型。

ProductBiddingCategory

特定级别的出价类别的一个元素。顶级类别位于级别 1,其子类别位于级别 2,以此类推。目前,我们最多支持 5 个级别。用户必须指定表示类别层级的维度类型。同一细分的所有情况都必须具有相同的维度类型(类别级别)。

JSON 表示法
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
字段
level

enum (ListingGroupFilterBiddingCategoryLevel)

表示类目中的类别级别。

id

string (int64 format)

产品出价类别的 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

string

产品品牌的字符串值。

ProductChannel

产品优惠的地区。

JSON 表示法
{
  "channel": enum (ListingGroupFilterProductChannel)
}
字段
channel

enum (ListingGroupFilterProductChannel)

locality 的值。

ListingGroupFilterProductChannel

描述商品优惠地点的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ONLINE 商品在线销售。
LOCAL 该商品在本地商店有售。

ProductCondition

商品优惠的条件。

JSON 表示法
{
  "condition": enum (ListingGroupFilterProductCondition)
}
字段
condition

enum (ListingGroupFilterProductCondition)

条件的值。

ListingGroupFilterProductCondition

描述商品优惠使用情况的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
NEW 产品使用情况是全新的。
REFURBISHED 商品的使用情况为翻新。
USED 系统会使用商品使用情况。

ProductCustomAttribute

商品优惠的自定义属性。

JSON 表示法
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
字段
index

enum (ListingGroupFilterCustomAttributeIndex)

指示自定义属性的索引。

value

string

产品自定义属性的字符串值。

ListingGroupFilterCustomAttributeIndex

客户属性的索引。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
INDEX0 首个产品信息组过滤条件自定义属性。
INDEX1 第二个产品信息组过滤条件自定义属性。
INDEX2 第三个产品信息组过滤条件自定义属性。
INDEX3 第四个产品信息组过滤条件自定义属性。
INDEX4 第五个产品信息组过滤器自定义属性。

ProductItemId

产品优惠的商品 ID。

JSON 表示法
{
  "value": string
}
字段
value

string

ID 的值。

ProductType

商品优惠的类型。

JSON 表示法
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
字段
level

enum (ListingGroupFilterProductTypeLevel)

类型的级别。

value

string

类型的值。

ListingGroupFilterProductTypeLevel

描述商品优惠类型级别的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
LEVEL1 1 级。
LEVEL2 2 级。
LEVEL3 3 级。
LEVEL4 4 级。
LEVEL5 5 级。

ListingGroupFilterDimensionPath

用于定义产品信息组过滤条件的维度的路径。

JSON 表示法
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
字段
dimensions[]

object (ListingGroupFilterDimension)

从产品信息组过滤条件层次结构(不包括根节点)到此产品信息组过滤条件的维度的完整路径。

AssetGroupTopCombinationView

广告组广告素材资源组合使用情况的视图。

JSON 表示法
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
字段
resourceName

string

素材资源组顶级组合视图的资源名称。素材资源组热门组合视图资源名称采用以下格式:"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

一起投放的效果最佳的素材资源组合。

AssetGroupAssetCombinationData

素材资源组的素材资源组合数据

JSON 表示法
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
字段
assetCombinationServedAssets[]

object (AssetUsage)

投放的素材资源。

AssetUsage

包含相应资产的使用情况信息。

JSON 表示法
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
字段
asset

string

资产的资源名称。

servedAssetFieldType

enum (ServedAssetFieldType)

素材资源的已投放字段类型。

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 该素材资源用作纵向营销图片。
CALL_TO_ACTION 该素材资源被用作号召性用语。
YOU_TUBE_VIDEO 该资产曾被用作 YouTube 视频。
CALL 此素材资源将用作通话。
MOBILE_APP 此素材资源用作移动应用。
CALLOUT 此素材资源用作宣传信息。
STRUCTURED_SNIPPET 此素材资源已用作结构化摘要。
PRICE 此素材资源已用作价格。
PROMOTION 此素材资源已用作促销信息。
AD_IMAGE 此素材资源已用作图片。
LEAD_FORM 该素材资源会用作潜在客户表单。

AssetGroup

素材资源组。AssetGroupAsset 用于将素材资源与素材资源组相关联。AssetGroupSignal 用于将信号与素材资源组相关联。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
字段
resourceName

string

素材资源组的资源名称。素材资源组资源名称采用以下格式:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

素材资源组的 ID。

campaign

string

与此素材资源组相关联的广告系列。与素材资源组相关联的素材资源。

name

string

必需。素材资源组的名称。必需。其长度下限为 1,上限为 128。在一个广告系列中必须是唯一的。

finalUrls[]

string

所有跨网域重定向之后的最终到达网址列表。在效果最大化广告系列中,除非选择停用,否则默认情况下,网址符合扩展条件。

finalMobileUrls[]

string

所有跨网域重定向之后的最终到达移动网址列表。在效果最大化广告系列中,除非选择停用,否则默认情况下,网址符合扩展条件。

status

enum (AssetGroupStatus)

素材资源组的状态。

path1

string

可能显示的文字的第一部分(附加到广告中展示的网址)。

path2

string

可能显示的文字的第二部分(附加到广告中展示的网址)。此字段只能在设置 path1 时设置。

adStrength

enum (AdStrength)

此素材资源组的总体广告效力。

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 (AssetSetAssetStatus)
}
字段
resourceName

string

资产集资产的资源名称。素材资源组的素材资源资源名称采用以下格式:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

此素材资源集中的素材资源所关联的素材资源集。

asset

string

此素材资源集中的素材资源所关联的素材资源。

status

enum (AssetSetAssetStatus)

素材资源组的素材资源的状态。只读。

AssetSetAssetStatus

素材资源集素材资源的可能状态。

枚举
UNSPECIFIED 状态尚未指定。
UNKNOWN 接收的值在此版本中未知。这是一个仅用于响应的值。
ENABLED 该素材资源集素材资源已启用。
REMOVED 此素材资源组的素材资源会被移除。

AssetSet

表示一系列资产的资产集。使用 AssetSetAsset 将资产与资产集相关联。

JSON 表示法
{
  "id": string,
  "resourceName": string
}
字段
id

string (int64 format)

素材资源集的 ID。

resourceName

string

资产集的资源名称。素材资源组资源名称采用以下格式:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

出价策略。

JSON 表示法
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
字段
resourceName

string

出价策略的资源名称。出价策略资源名称采用以下格式:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

出价策略的状态。

此字段为只读字段。

type

enum (BiddingStrategyType)

出价策略的类型。通过设置出价方案来创建出价策略。

此字段为只读字段。

currencyCode

string

出价策略使用的货币(ISO 4217 三字母代码)。

对于经理客户的出价策略,此币种可在创建时设置,并默认设为经理客户的币种。对于为客户提供服务的客户,无法设置此字段;提供服务的客户中的所有策略都隐式使用提供服务的客户的货币。在任何情况下,effectiveCurrencyCode 字段均返回出价策略使用的币种。

id

string (int64 format)

出价策略的 ID。

name

string

出价策略的名称。同一账号内的所有出价策略都必须具有辨识度的名称。

此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。

effectiveCurrencyCode

string

出价策略使用的货币(ISO 4217 三字母代码)。

对于经理客户中的出价策略,此币种是指广告客户在创建策略时设置的币种。对于服务客户,这是客户的 currencyCode。

系统会采用此币种报告出价策略指标。

此字段为只读字段。

campaignCount

string (int64 format)

附加到此出价策略的广告系列数量。

此字段为只读字段。

nonRemovedCampaignCount

string (int64 format)

附加到此出价策略的未移除广告系列的数量。

此字段为只读字段。

联合字段 scheme。出价方案。

您只能设置一个。scheme 只能是下列其中一项:

enhancedCpc

object (EnhancedCpc)

此出价策略会针对更有可能带来转化的点击提高出价,并针对不太可能带来转化的点击降低出价。

maximizeConversionValue

object (MaximizeConversionValue)

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。

maximizeConversions

object (MaximizeConversions)

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。

targetCpa

object (TargetCpa)

一种出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。

targetImpressionShare

object (TargetImpressionShare)

一种出价策略,可自动根据所选百分比的展示次数进行优化。

targetOutrankShare

object (TargetOutrankShare)

一种出价策略,可根据竞价中广告客户的排名超过特定竞争对手的出价所占的比例来设置出价。此字段已弃用。您无法通过此字段创建新的出价策略,也无法将带有此字段的出价策略附加到广告系列。允许更改为已填充此架构的策略。

targetRoas

object (TargetRoas)

一种出价策略,可帮助您最大限度地提高收入,同时平均达到特定的目标广告支出回报率 (ROAS)。

targetSpend

object (TargetSpend)

这种出价策略会为您设置出价,帮助您在预算范围内争取尽可能多的点击。

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 “目标每次转化费用”是一种自动出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。
TARGET_CPM “目标每千次展示费用”是一种自动出价策略,可为您设置合适的出价,帮助您以自己设定的目标每千次展示费用 (CPM) 争取尽可能多的展示次数。
TARGET_IMPRESSION_SHARE 一种自动出价策略,可通过设置出价使特定比例的搜索广告展示在首页(或其他定位到的地理位置)的顶部。
TARGET_OUTRANK_SHARE “排名胜出率目标”是一种自动出价策略,可根据广告主应在特定竞价中胜出而胜过特定竞争对手的竞价目标部分设置出价。此枚举值已废弃。
TARGET_ROAS “目标广告支出回报率”是一种自动出价策略,可帮助您尽可能提高收入,同时确保达到一个平均目标广告支出回报率 (ROAS) 的平均值。
TARGET_SPEND “目标支出”是一种自动出价策略,会使用您的出价来帮助您在预算范围内争取尽可能多的点击。

EnhancedCpc

此类型没有字段。

一种自动出价策略,可针对更有可能带来转化的点击提高出价,并针对不太可能带来转化的点击降低出价。

此出价策略已弃用,无法再创建。使用 ManualCpc 并将 EnhancedCpcEnabled 设置为 true 以实现等效功能。

MaximizeConversionValue

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。

JSON 表示法
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
字段
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。

cpcBidFloorMicros

string (int64 format)

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。

targetRoas

number

目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。

MaximizeConversions

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。

JSON 表示法
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
字段
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。

cpcBidFloorMicros

string (int64 format)

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。

targetCpaMicros

string (int64 format)

目标每次转化费用 (CPA) 选项。这是您愿意为每项转化操作支付的平均金额(以出价策略所用币种的微单位表示)。如果已设置,该出价策略会在不超过目标每次转化费用的前提下,争取尽可能多的转化。如果未设置目标每次转化费用,出价策略会致力于在预算范围内尽可能降低每次转化费用。

TargetCpa

这是一种自动出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。

JSON 表示法
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
字段
targetCpaMicros

string (int64 format)

平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。

cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此值。

cpcBidFloorMicros

string (int64 format)

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此值。

TargetImpressionShare

一种自动出价策略,可通过设置出价使特定比例的搜索广告展示在首页(或其他定位到的地理位置)的顶部。

JSON 表示法
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
字段
location

enum (TargetImpressionShareLocation)

搜索结果页上的指定地理位置。

locationFractionMicros

string (int64 format)

要在指定地理位置展示的广告的选定比例(以微单位表示)。例如,1% 等于 10,000。

cpcBidCeilingMicros

string (int64 format)

自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段,该字段用于设置上限值,并以本地微单位指定。

TargetImpressionShareLocation

描述可能目标的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ANYWHERE_ON_PAGE 网页上的任意位置。
TOP_OF_PAGE 顶部广告框。
ABSOLUTE_TOP_OF_PAGE 顶部广告框中的顶部广告位。

TargetOutrankShare

一种自动出价策略,可根据所占的竞价目标比例(广告客户应在排名上胜过特定竞争对手)来设置出价。此策略已被弃用。

JSON 表示法
{
  "cpcBidCeilingMicros": string
}
字段
cpcBidCeilingMicros

string (Int64Value format)

可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

TargetRoas

这是一种自动出价策略,可帮助您尽可能提高收入,同时确保达到平均广告支出回报率。

JSON 表示法
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
字段
targetRoas

number

必需。每单位支出所选择的收入(基于转化数据)。值必须介于 0.01 到 1000.0 之间(包括 0.01 和 1000.0)。

cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此值。

cpcBidFloorMicros

string (int64 format)

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此值。

TargetSpend

这是一种自动出价策略,可为您设置适当的出价,助您在不超出预算的前提下为您争取尽可能多的点击。

JSON 表示法
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
字段
targetSpendMicros
(deprecated)

string (int64 format)

已弃用:要在哪个支出目标下尽可能争取更多点击次数。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 此字段已弃用,不应再使用。如需了解详情,请参阅 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html

cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

CampaignBudget

广告系列预算。

JSON 表示法
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
字段
resourceName

string

广告系列预算的资源名称。广告系列预算资源名称采用以下格式:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

决定广告系列预算的支出费率的投放方式。

如果在创建操作中未指定,则默认为 STANDARD。

period

enum (BudgetPeriod)

支出预算的时间段。如果未指定,则默认为 DAILY。

amountMicros

string (int64 format)

预算的金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。每月支出上限为此金额的 30.4 倍。

BudgetDeliveryMethod

可能的预算投放方式。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
STANDARD 预算服务器将在整个时间段内平均地调节投放。
ACCELERATED 预算服务器不会调节投放,系统会尽快投放广告。

BudgetPeriod

预算的可能时间段。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
DAILY 每日预算。
FIXED_DAILY 固定的每日预算。
CUSTOM_PERIOD 可以将自定义预算与 total_amount 一起使用,以指定有效期预算限额。

广告系列

广告系列。

JSON 表示法
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
字段
resourceName

string

广告系列的资源名称。广告系列资源名称采用以下格式:

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

广告系列的状态。

添加新的广告系列时,状态默认为 ENABLED。

servingStatus

enum (CampaignServingStatus)

广告系列的广告投放状态。

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

广告系列出价策略的系统状态。

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

广告系列的广告投放优化状态。

advertisingChannelType

enum (AdvertisingChannelType)

广告系列中广告的主要投放目标。您可以在networkSettings中优化定位选项。

此字段是必填字段,创建新广告系列时不应为空。

只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。

advertisingChannelSubType

enum (AdvertisingChannelSubType)

advertisingChannelType的可选优化。必须是父渠道类型的有效子类型。

只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。

urlCustomParameters[]

object (CustomParameter)

用于替换 trackingUrlTemplatefinalUrlsmobile_final_urls 中的自定义参数标记的映射列表。

realTimeBiddingSetting

object (RealTimeBiddingSetting)

实时出价设置,此功能仅适用于定位到 Ad Exchange 广告联盟的广告系列。

networkSettings

object (NetworkSettings)

广告系列的投放网络设置。

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

用于控制动态搜索广告 (DSA) 的设置。

shoppingSetting

object (ShoppingSetting)

用于控制购物广告系列的设置。

geoTargetTypeSetting

object (GeoTargetTypeSetting)

广告的地理位置定位设置。

labels[]

string

此广告系列所附标签的资源名称。

biddingStrategyType

enum (BiddingStrategyType)

出价策略的类型。

如需创建出价策略,可以通过设置出价方案来创建标准出价策略,也可以设置 biddingStrategy 字段来创建组合出价策略。

此字段为只读字段。

accessibleBiddingStrategy

string

AccessibleBiddingStrategy 的资源名称,其中包含附加组合出价策略(由“biddingStrategy”标识)的不受限制属性的只读视图。如果广告系列未使用组合策略,则为空。不受限制的策略属性可供共享策略的所有客户使用,并且可从 AccessibleBidStrategy 资源中读取。相比之下,受限属性仅适用于策略的所有者客户及其经理。受限属性只能从 BiddingStrategy 资源中读取。

frequencyCaps[]

object (FrequencyCapEntry)

一个列表,用于限制每个用户看到此广告系列中的广告的频率。

selectiveOptimization

object (SelectiveOptimization)

针对此广告系列选择性优化设置,其中包括一组作为优化目标的转化操作。此功能仅适用于使用 MULTI_CHANNEL 作为 AdvertisingChannelType 且使用 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 作为 AdvertisingChannelSubType 的应用广告系列。

optimizationGoalSetting

object (OptimizationGoalSetting)

此广告系列的优化目标设置,其中包括一组优化目标类型。

trackingSetting

object (TrackingSetting)

针对跟踪信息的广告系列级设置。

engineId

string

外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请改用“campaign.id”。

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

应从此广告系列中排除的素材资源字段类型。此广告系列将不会从更高级别沿用这些字段类型的素材资源链接。

createTime

string

创建广告系列时的时间戳。时间戳采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss”格式。v1 中将弃用 createTime。请改用 CreationTime。

creationTime

string

创建广告系列时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。

lastModifiedTime

string

此广告系列上次修改的日期时间。日期时间采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

id

string (int64 format)

广告系列的 ID。

name

string

广告系列的名称。

此字段是必填字段,创建新广告系列时不应为空。

并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。

trackingUrlTemplate

string

用于构建跟踪网址的网址模板。

campaignBudget

string

广告系列的预算。

startDate

string

广告系列在提供服务的客户所在时区开始运行的日期(采用 YYYY-MM-DD 格式)。

endDate

string

广告系列在提供服务的客户所在时区运行的最后一天(采用 YYYY-MM-DD 格式)。创建时,默认值为 2037-12-30,表示广告系列将无限期投放下去。要将现有的广告系列设置为无限期投放,请将此字段设置为 2037-12-30。

finalUrlSuffix

string

用于将查询参数附加到通过并行跟踪投放的着陆页的后缀。

urlExpansionOptOut

boolean

表示停用将网址扩展功能扩展到更精确的网址。如果选择停用 (true),则系统只会定位到素材资源组中的最终到达网址,或者广告客户的 Google Merchant Center Feed 或商家数据 Feed 中指定的网址。如果选择启用 (false),则会定位到整个域。只能为效果最大化广告系列设置此字段,默认值为 false。

联合字段 campaign_bidding_strategy。广告系列的出价策略。

必须是嵌入到广告系列中的组合(通过 BiddingStrategy 服务创建)或标准。campaign_bidding_strategy 只能是下列其中一项:

biddingStrategy

string

广告系列使用的组合出价策略。

manualCpa

object (ManualCpa)

标准的每次转化费用人工出价策略。一种人工出价策略,允许广告客户针对广告客户指定的操作设置出价。仅适用于本地生活服务广告系列。

manualCpc

object (ManualCpc)

标准的“每次点击费用人工出价”出价策略。基于点击的人工出价,此类出价中用户按点击次数付费。

manualCpm

object (ManualCpm)

标准的每千次展示费用人工出价策略。基于展示的人工出价,此类出价中用户按每千次展示付费。

maximizeConversions

object (MaximizeConversions)

标准的“尽可能提高转化次数”出价策略,可在您的预算范围内自动争取尽可能多的转化次数。

maximizeConversionValue

object (MaximizeConversionValue)

标准的“尽可能提高转化价值”出价策略,可自动设置出价,以便在您的预算范围内尽可能增加收入。

targetCpa

object (TargetCpa)

“目标每次转化费用”标准出价策略,可自动设置出价,在将每次转化费用 (CPA) 控制在您设定的目标水平的前提下,帮助您争取尽可能多的转化。

targetImpressionShare

object (TargetImpressionShare)

“目标展示次数份额”出价策略。一种自动出价策略,可通过设置出价实现指定百分比的展示次数。

targetRoas

object (TargetRoas)

标准的“目标广告支出回报率”出价策略,可在确保平均广告支出回报率的同时,自动最大限度提高收入。

targetSpend

object (TargetSpend)

“标准目标支出”出价策略,可自动设置您的出价,帮助您在预算范围内争取尽可能多的点击。

percentCpc

object (PercentCpc)

“标准百分比形式的每次点击费用”出价策略,采用这种策略时,出价是某些商品或服务广告价格的一小部分。

targetCpm

object (TargetCpm)

一种出价策略,可自动优化每千次展示费用。

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 Play、YouTube 和 Google 展示广告网络等 Google 顶级媒体资源上轻松宣传您的 Android 或 iOS 应用。
APP_CAMPAIGN_FOR_ENGAGEMENT 以提升互动度为目标的应用广告系列,专注于在 Google 的多个热门产品和服务(包括 Google 搜索、YouTube 和 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

可供 trackingUrlTemplatefinalUrlsmobile_final_urls 中的自定义参数代码使用的映射。

JSON 表示法
{
  "key": string,
  "value": string
}
字段
key

string

与参数标记名称匹配的键。

value

string

要替换的值。

RealTimeBiddingSetting

实时出价设置,此功能仅适用于定位到 Ad Exchange 广告联盟的广告系列。

JSON 表示法
{
  "optIn": boolean
}
字段
optIn

boolean

广告系列是否启用了实时出价。

NetworkSettings

广告系列的投放网络设置。

JSON 表示法
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
字段
targetSearchNetwork

boolean

广告是否将在 Google 搜索网络的合作伙伴网站上投放(要求 targetGoogleSearch 也为 true)。

targetContentNetwork

boolean

广告是否将在 Google 展示广告网络中的指定展示位置投放。展示位置使用 Placement 条件指定。

targetPartnerSearchNetwork

boolean

广告是否将在 Google 合作伙伴网络中投放。这仅可用于部分 Google 合作伙伴账号。

DynamicSearchAdsSetting

用于控制动态搜索广告 (DSA) 的设置。

JSON 表示法
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
字段
domainName

string

必需。此设置代表的互联网域名,例如“google.com”或“www.google.com”

languageCode

string

必需。用于指定网域语言的语言代码,例如“en”。

useSuppliedUrlsOnly

boolean

广告系列是否仅使用广告客户提供的网址。

ShoppingSetting

购物广告系列的设置。定义了可以通过广告系列宣传的所有产品,以及此广告系列与其他购物广告系列的互动方式。

JSON 表示法
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
字段
feedLabel

string

要包含在广告系列中的产品的 Feed 标签。只能设置 feedLabel 和 salesCountry 中的一个。如果使用 FeedLabel 字段代替 salesCountry,该 FeedLabel 字段接受相同格式的国家/地区代码,例如:“XX”。否则,可以是 Google Merchant Center 中用于 Feed 标签的任何字符串。

useVehicleInventory

boolean

是否定位到车辆详情商品目录。

merchantId

string (int64 format)

Merchant Center 账号的 ID。对于创建操作,此字段是必填字段。对于购物广告系列,此字段是不可更改的。

salesCountry

string

要添加到广告系列中的产品的目标销售国家/地区。

campaignPriority

integer

广告系列的优先级。数值较高的广告系列优先于优先级较低的广告系列。对于购物广告系列,此字段是必填字段,值介于 0 和 2 之间(包括 0 和 2)。对于智能购物广告系列,此字段是选填字段,但如果设置了此字段,则必须等于 3。

enableLocal

boolean

是否包含本地商品。

GeoTargetTypeSetting

表示与广告地理位置定位相关的设置集合。

JSON 表示法
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
字段
positiveGeoTargetType

enum (PositiveGeoTargetType)

用于在此特定广告系列中进行肯定地理位置定位的设置。

negativeGeoTargetType

enum (NegativeGeoTargetType)

此特定广告系列中用于排除性地理位置定位的设置。

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
  ]
}
字段
conversionActions[]

string

一组选定的转化操作,用于优化此广告系列。

OptimizationGoalSetting

此广告系列的优化目标设置,其中包括一组优化目标类型。

JSON 表示法
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
字段
optimizationGoalTypes[]

enum (OptimizationGoalType)

优化目标类型的列表。

OptimizationGoalType

优化目标的类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用作返回值。表示此版本中未知的值。
CALL_CLICKS 针对点击致电进行优化。致电点击转化是用户选择“致电”的次数在观看广告后联系商店。
DRIVING_DIRECTIONS 针对行车路线进行优化。驾车路线转化是指用户选择“查询路线”的次数用户在观看广告后导航到相应商店
APP_PRE_REGISTRATION 针对预注册进行优化。预注册转化次数是指在应用发布时收到通知的预注册用户数量。

TrackingSetting

针对跟踪信息的广告系列级设置。

JSON 表示法
{
  "trackingUrl": string
}
字段
trackingUrl

string

用于动态跟踪的网址。

ManualCpa

此类型没有字段。

一种人工出价策略,允许广告客户针对广告客户指定的操作设置出价。

ManualCpc

基于点击的人工出价,此类出价中用户按点击次数付费。

JSON 表示法
{
  "enhancedCpcEnabled": boolean
}
字段
enhancedCpcEnabled

boolean

是否根据转化优化工具数据增强出价。

ManualCpm

此类型没有字段。

基于展示的人工出价,此类出价中用户按每千次展示付费。

PercentCpc

一种出价策略,采用这种出价策略时,出价只是某些商品或服务的宣传价格的一小部分。

JSON 表示法
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
字段
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。这是一个可选字段,由广告客户输入并以本地微单位指定。注意:零值的解释方式与未定义 bid_floor 的解释方式相同。

enhancedCpcEnabled

boolean

针对每次竞价提高或降低出价,具体取决于带来转化的可能性。单独出价可以超过 cpcBidCeilingMicros,但不应为广告系列的平均出价金额。

TargetCpm

此类型没有字段。

“目标每千次展示费用”是一种自动出价策略,可根据您设置的目标每千次展示费用设置合适的出价来优化广告效果。

CampaignAsset

广告系列与资产之间的关联。

JSON 表示法
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
字段
resourceName

string

广告系列素材资源的资源名称。CampaignAsset 资源名称采用以下格式:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

广告系列素材资源的状态。

campaign

string

资产所关联的广告系列。

asset

string

与广告系列相关联的素材资源。

CampaignAssetSet

CampaignAssetSet 是广告系列与素材资源集之间的关联。添加 CampaignAssetSet 可将素材资源集与广告系列相关联。

JSON 表示法
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
字段
resourceName

string

广告系列素材资源集的资源名称。素材资源组的素材资源资源名称采用以下格式:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

此素材资源集所关联的广告系列。

assetSet

string

与广告系列相关联的素材资源集。

status

enum (AssetSetLinkStatus)

广告系列素材资源组的素材资源的状态。只读。

CampaignAudienceView

广告系列受众群体视图。包括展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 中的效果数据,按广告系列和受众群体条件汇总。此视图仅包含在广告系列一级添加的受众群体。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

广告系列受众群体视图的资源名称。广告系列受众群体视图资源名称采用以下格式:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

广告系列标准。

JSON 表示法
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
字段
resourceName

string

广告系列条件的资源名称。广告系列条件资源名称采用以下格式:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

条件的显示名称。

对于变更,此字段会被忽略。

type

enum (CriterionType)

标准的类型。

status

enum (CampaignCriterionStatus)

条件的状态。

lastModifiedTime

string

上次修改此广告系列标准时的日期时间。日期时间采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

criterionId

string (int64 format)

条件的 ID。

在变更期间,此字段会被忽略。

bidModifier

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。使用 0 可停用设备类型。

negative

boolean

是定位 (false) 还是排除 (true) 条件。

联合字段 criterion。广告系列定位标准。

您只能设置一个。criterion 只能是下列其中一项:

keyword

object (KeywordInfo)

关键字。

location

object (LocationInfo)

位置信息。

device

object (DeviceInfo)

设备。

ageRange

object (AgeRangeInfo)

年龄段。

gender

object (GenderInfo)

性别。

userList

object (UserListInfo)

用户列表。

language

object (LanguageInfo)

语言。

webpage

object (WebpageInfo)

网页。

locationGroup

object (LocationGroupInfo)

营业地点组

CampaignCriterionStatus

CampaignCriterion 的可能状态。

枚举
UNSPECIFIED 未指定值。
UNKNOWN

接收的值在此版本中未知。

这是一个仅用于响应的值。

ENABLED 广告系列条件已启用。
PAUSED 广告系列条件已暂停。
REMOVED 广告系列条件会被移除。

LanguageInfo

语言标准。

JSON 表示法
{
  "languageConstant": string
}
字段
languageConstant

string

语言常量资源名称。

LocationGroupInfo

通过 Feed 指定的一系列地理位置周围一定半径内的区域。

JSON 表示法
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
字段
geoTargetConstants[]

string

地理位置定位常量,用于限制 Feed 中的地理区域范围。目前只允许使用一个地理位置定位常量。

radiusUnits

enum (LocationGroupRadiusUnits)

半径的单位。地理位置定位常量支持英里和米。Feed 项集支持毫英里和米。这是必填字段,必须在 CREATE 操作中设置。

feedItemSets[]

string

定位其 FeedItemSet 的 FeedItemSet。如果指定了多个 ID,则系统会定位至少 1 个集合中出现的所有项。此字段不能与 geoTargetConstants 一起使用。这是可选操作,只能在 CREATE 操作中设置。

radius

string (int64 format)

用于指定地理位置周围半径范围的距离(以单位表示)。这是必填字段,必须在 CREATE 操作中设置。

LocationGroupRadiusUnits

营业地点组中半径距离的单位(例如 MILES)

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
METERS
MILES 英里
MILLI_MILES 英里

CampaignLabel

表示广告系列和标签之间的关系。

JSON 表示法
{
  "resourceName": string,
  "campaign": string,
  "label": string
}
字段
resourceName

string

资源的名称。广告系列标签资源名称采用以下格式:customers/{customerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

标签附加到的广告系列。

label

string

分配给广告系列的标签。

CartDataSalesView

购物车数据销售视图。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

购物车数据销售视图的资源名称。购物车数据销售视图资源名称采用以下格式:customers/{customerId}/cartDataSalesView

受众群体

受众群体是一种有效的定位选项,可以让您通过交叉使用不同的细分受众群属性(例如详细受众特征和兴趣相似),创建可代表目标细分受众群各个部分的受众群体。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
字段
resourceName

string

受众群体的资源名称。受众群体名称采用以下格式:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

受众群体的 ID。

name

string

必需。受众群体的名称。它在所有受众群体中应该是独一无二的。其长度下限为 1,上限为 255。

description

string

此受众群体的说明。

ConversionAction

转化操作。

JSON 表示法
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
字段
resourceName

string

转化操作的资源名称。转化操作资源名称采用以下格式:

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

创建 Floodlight 活动的时间戳,采用 ISO 8601 格式。

status

enum (ConversionActionStatus)

针对转化事件累计的此转化操作的状态。

type

enum (ConversionActionType)

此转化操作的类型。

category

enum (ConversionActionCategory)

为此转化操作报告的转化类别。

valueSettings

object (ValueSettings)

与此转化操作相关联的转化事件的价值相关的设置。

attributionModelSettings

object (AttributionModelSettings)

与此转化操作的归因模型相关的设置。

floodlightSettings

object (FloodlightSettings)

适用于 Floodlight 转化类型的 Floodlight 设置。

id

string (int64 format)

转化操作的 ID。

name

string

转化操作的名称。

此字段是必填字段,在创建新的转化操作时不应为空。

primaryForGoal

boolean

如果某个转化操作的 primaryForGoal 位为 false,则无论其客户转化目标或广告系列转化目标是什么,所有广告系列都无法对该转化操作进行出价。但是,自定义转化目标不遵循 primaryForGoal,因此如果广告系列的自定义转化目标配置了 primaryForGoal = false 转化操作,该转化操作仍可供出价。默认情况下,如果未设置,primaryForGoal 将为 true。在 V9 中,只有在通过“update”创建后,才能将 primaryForGoal 设置为 false操作,因为它未声明为可选。

ownerCustomer

string

转化操作所有者客户的资源名称;如果这是系统定义的转化操作,则为 null。

includeInClientAccountConversionsMetric

boolean

此转化操作是否应纳入到“clientAccountConversions”中指标。

includeInConversionsMetric

boolean

此转化操作是否应纳入到“转化次数”列中指标。

clickThroughLookbackWindowDays

string (int64 format)

互动(例如点击)与转化事件之间可能经过的天数上限。

appId

string

应用转化操作的应用 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 通过第三方应用 Analytics 跟踪的 Android 应用首次打开转化。
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE 通过第三方应用分析工具跟踪的 Android 应用应用内购买转化次数。
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM 通过第三方应用分析跟踪的 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、Firebase、Google Analytics 黄金级目标。
STORE_VISIT 光顾实体店。
STORE_SALE 在实体店中进行的销售。
QUALIFIED_LEAD 从外部来源导入 Google Ads 并由广告客户(营销/销售团队)进一步过滤的潜在客户转化。在“从潜在客户到完成销售交易”的转化历程中,广告客户会获得潜在客户,然后主动与消费者联系以采取行动。如果消费者感兴趣并可能最终购买他们的产品,广告客户会将此类潜在客户标记为“符合条件的潜在客户”。
CONVERTED_LEAD 从外部来源导入 Google Ads 的潜在客户转化,且该转化已进一步完成潜在客户发掘广告主所定义的选定阶段。

ValueSettings

与此转化操作相关联的转化事件的价值相关的设置。

JSON 表示法
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
字段
defaultValue

number

要在发送此转化操作的转化事件时指定了无效、禁止或缺失的值,或者将此转化操作配置为始终使用默认价值,要使用哪种价值。

defaultCurrencyCode

string

当发送此转化操作的转化事件的货币代码无效或缺失时,或者将此转化操作配置为始终使用默认价值时,要使用的货币代码。

alwaysUseDefaultValue

boolean

控制是否使用默认价值和默认货币代码来代替此转化操作的转化事件中指定的价值和货币代码。

AttributionModelSettings

与此转化操作的归因模型相关的设置。

JSON 表示法
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
字段
attributionModel

enum (AttributionModel)

此转化操作的归因模型类型。

dataDrivenModelStatus

enum (DataDrivenModelStatus)

转化操作的以数据为依据的归因模型的状态。

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
}
字段
activityGroupTag

string

报告转化次数时用于标识 Floodlight 活动组的字符串。

activityTag

string

报告转化次数时用于标识 Floodlight 活动的字符串。

activityId

string (int64 format)

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 (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
字段
resourceName

string

转化自定义变量的资源名称。转化自定义变量资源名称采用以下格式:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

转化自定义变量的 ID。

name

string

必需。转化自定义变量的名称。名称应该是唯一的。名称的最大长度为 100 个字符。前后不应有任何多余的空格。

tag

string

必需。转化自定义变量的代码。标记应该是唯一的,并由“u”组成字符,后跟小于或等于 100 的数字。例如:“u4”。

status

enum (ConversionCustomVariableStatus)

用于统计转化事件的转化自定义变量的状态。

ownerCustomer

string

拥有转化自定义变量的客户的资源名称。

family

enum (ConversionCustomVariableFamily)

转化自定义变量的系列。

cardinality

enum (ConversionCustomVariableCardinality)

转化自定义变量的基数。

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Search Ads 360 Floodlight 转化自定义变量的字段。

customColumnIds[]

string (int64 format)

使用此转化自定义变量的自定义列的 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 (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
字段
floodlightVariableType

enum (FloodlightVariableType)

Search Ads 360 中定义的 Floodlight 变量类型。

floodlightVariableDataType

enum (FloodlightVariableDataType)

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 表示“String”的 Floodlight 变量类型。此变量可分配给“DIMENSION”类型的 Floodlight 变量。

客户

客户。

JSON 表示法
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
字段
resourceName

string

客户的资源名称。客户资源名称采用以下格式:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

客户的转化跟踪设置。

accountType

enum (AccountType)

Engine 账号类型,例如 Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track 等。

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

经理客户的 DoubleClick Campaign Manager (DCM) 设置。

accountStatus

enum (AccountStatus)

账号状态,例如“已启用”“已暂停”“已移除”等

lastModifiedTime

string

此客户上次修改时的日期时间。日期时间采用客户所在时区,格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

engineId

string

外部引擎账号中账号的 ID。

status

enum (CustomerStatus)

客户的状态。

creationTime

string

创建此客户时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。

id

string (int64 format)

客户的 ID。

descriptiveName

string

(可选)客户的非唯一描述性名称。

currencyCode

string

账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。

timeZone

string

客户的当地时区 ID。

trackingUrlTemplate

string

用于根据参数构建跟踪网址的网址模板。

finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。

autoTaggingEnabled

boolean

是否为客户启用了自动标记功能。

manager

boolean

客户是否为经理。

ConversionTrackingSetting

与 Search Ads 360 转化跟踪相关的一系列客户级设置。

JSON 表示法
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
字段
acceptedCustomerDataTerms

boolean

客户是否已接受客户数据条款。如果使用的是跨账号转化跟踪,此值继承自经理账号。此字段是只读字段。有关详情,请参阅 https://support.google.com/adspolicy/answer/7475709

conversionTrackingStatus

enum (ConversionTrackingStatus)

转化跟踪状态。它指明了该客户是否在使用转化跟踪,以及谁是该客户的转化跟踪负责人。如果此客户正在使用跨账号转化跟踪,则返回的值会因请求的 login-customer-id 而异。

enhancedConversionsForLeadsEnabled

boolean

客户是否已选择启用增强型潜在客户转化。如果使用的是跨账号转化跟踪,此值继承自经理账号。此字段为只读字段。

googleAdsConversionCustomer

string

在其中创建和管理转化的客户的资源名称。此字段为只读字段。

conversionTrackingId

string (int64 format)

此账号使用的转化跟踪 ID。此 ID 并不表示客户是否使用了转化跟踪(conversionTrackingStatus 可用)。此字段为只读字段。

googleAdsCrossAccountConversionTrackingId

string (int64 format)

客户的经理的转化跟踪 ID。此字段在客户选择启用转化跟踪时设置,并替换 conversionTrackingId。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。

crossAccountConversionTrackingId

string (int64 format)

客户的经理的转化跟踪 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
}
字段
advertiserId

string (int64 format)

与此客户相关联的 Campaign Manager 广告客户的 ID。

networkId

string (int64 format)

与此客户相关联的 Campaign Manager 广告网络的 ID。

timeZone

string

与此客户关联的 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 (AssetLinkStatus)
}
字段
resourceName

string

客户资源的资源名称。CustomerAsset 资源名称采用以下格式:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

必需。与客户关联的素材资源。

status

enum (AssetLinkStatus)

客户素材资源的状态。

CustomerAssetSet

CustomerAssetSet 是客户与素材资源集之间的关联。添加 CustomerAssetSet 可将素材资源集与客户相关联。

JSON 表示法
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
字段
resourceName

string

客户素材资源集的资源名称。素材资源组的素材资源资源名称采用以下格式:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

与客户相关联的素材资源集。

customer

string

此素材资源集所关联的客户。

status

enum (AssetSetLinkStatus)

客户素材资源组的素材资源的状态。只读。

AccessibleBiddingStrategy

表示客户拥有并与客户共享的 BiddingStrategies 视图。

与 BiddingStrategy 相比,该资源除了包含该客户拥有的策略之外,还包含该客户拥有并与该客户共享的策略。此资源不提供指标,而且仅公开了部分 BiddingStrategy 属性。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
字段
resourceName

string

可访问的出价策略的资源名称。AccessibleBidStrategy 资源名称采用以下格式:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

出价策略的 ID。

name

string

出价策略的名称。

type

enum (BiddingStrategyType)

出价策略的类型。

ownerCustomerId

string (int64 format)

拥有出价策略的客户的 ID。

ownerDescriptiveName

string

拥有该出价策略的客户的描述性名称。

联合字段 scheme。出价方案。

您只能设置一个。scheme 只能是下列其中一项:

maximizeConversionValue

object (MaximizeConversionValue)

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。

maximizeConversions

object (MaximizeConversions)

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。

targetCpa

object (TargetCpa)

一种出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。

targetImpressionShare

object (TargetImpressionShare)

一种出价策略,可自动根据所选百分比的展示次数进行优化。

targetRoas

object (TargetRoas)

一种出价策略,可帮助您最大限度地提高收入,同时平均达到特定的目标广告支出回报率 (ROAS)。

targetSpend

object (TargetSpend)

这种出价策略会为您设置出价,帮助您在预算范围内争取尽可能多的点击。

MaximizeConversionValue

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。

JSON 表示法
{
  "targetRoas": number
}
字段
targetRoas

number

目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。

MaximizeConversions

这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。

JSON 表示法
{
  "targetCpa": string,
  "targetCpaMicros": string
}
字段
targetCpa

string (int64 format)

目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。

targetCpaMicros

string (int64 format)

目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。

TargetCpa

这是一种自动出价策略,可为您设置合适的出价来帮助您争取尽可能多的转化,同时将每次转化费用控制在您设定的目标水平。

JSON 表示法
{
  "targetCpaMicros": string
}
字段
targetCpaMicros

string (int64 format)

平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。

TargetImpressionShare

一种自动出价策略,可通过设置出价使特定比例的搜索广告展示在首页(或其他定位到的地理位置)的顶部。

JSON 表示法
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
字段
location

enum (TargetImpressionShareLocation)

搜索结果页上的指定地理位置。

locationFractionMicros

string (int64 format)

要在指定地理位置展示的广告的选定比例(以微单位表示)。例如,1% 等于 10,000。

cpcBidCeilingMicros

string (int64 format)

自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段,该字段用于设置上限值,并以本地微单位指定。

TargetRoas

这是一种自动出价策略,可帮助您尽可能提高收入,同时确保达到平均广告支出回报率。

JSON 表示法
{
  "targetRoas": number
}
字段
targetRoas

number

所选单位支出的收入(基于转化数据)。

TargetSpend

这是一种自动出价策略,可为您设置适当的出价,助您在不超出预算的前提下为您争取尽可能多的点击。

JSON 表示法
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
字段
targetSpendMicros
(deprecated)

string (int64 format)

尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 此字段已弃用,不应再使用。如需了解详情,请参阅 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html

cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

ManagerLinkStatus

链接的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ACTIVE 表示当前有效的关系
INACTIVE 表示终止的关系
PENDING 表示经理已请求建立关系,但客户尚未接受。
REFUSED 经理提出关系请求,但客户拒绝了。
CANCELED 表示经理已请求建立关系,但经理取消了此关系。

CustomerClient

指定客户与客户之间的关联。CustomerClients 仅适用于经理账号。该数据会涵盖所有直接和间接客户客户,以及经理本身。

JSON 表示法
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
字段
resourceName

string

客户客户的资源名称。CustomerClient 资源名称的格式为:customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

发出请求的客户所拥有的标签的资源名称,这些标签应用于客户客户。标签资源名称采用以下格式:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

客户客户的状态。只读。

clientCustomer

string

与指定客户相关联的客户-客户的资源名称。只读。

hidden

boolean

指定此账号是否为隐藏账号。

只读。

level

string (int64 format)

指定客户与客户之间的距离。对于自链接,级别值为 0。只读。

timeZone

string

客户端时区的通用语言区域数据代码库 (CLDR) 字符串表示法,例如 America/Los_Angeles。只读。

testAccount

boolean

指明客户是否为测试账号。只读。

manager

boolean

指明客户是否为经理。只读。

descriptiveName

string

客户的描述性名称。只读。

currencyCode

string

客户的货币代码(例如“USD”“EUR”)。只读。

id

string (int64 format)

客户的 ID。只读。

DynamicSearchAdsSearchTermView

动态搜索广告搜索字词视图。

JSON 表示法
{
  "resourceName": string,
  "landingPage": string
}
字段
resourceName

string

动态搜索广告搜索字词视图的资源名称。动态搜索广告搜索字词视图资源名称采用以下格式:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

为展示动态选择的着陆页网址。

此字段为只读字段。

GenderView

性别视图。genderView 资源反映的是有效的投放状态,而非添加的条件。默认情况下,没有性别条件的广告组会面向所有性别展示,因此所有性别都会显示在 genderView 中及统计信息。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

性别视图的资源名称。性别视图资源名称采用以下格式:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

地理位置定位常量。

JSON 表示法
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
字段
resourceName

string

地理位置定位常量的资源名称。地理位置定位条件常量资源名称采用以下格式:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

地理位置定位常量状态。

id

string (int64 format)

地理位置定位常量的 ID。

name

string

地理位置定位常量英文名称。

countryCode

string

与定位相关联的 ISO-3166-1 alpha-2 国家/地区代码。

targetType

string

地理位置定位常量目标类型。

canonicalName

string

完全限定的英文名称,包括定位的名称及其父级和国家/地区的名称。

parentGeoTarget

string

父级地理位置定位常量的资源名称。地理位置定位条件常量资源名称采用以下格式:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

地理位置定位常量的可能状态。

枚举
UNSPECIFIED 未指定值。
UNKNOWN

接收的值在此版本中未知。

这是一个仅用于响应的值。

ENABLED 目标地理区域常量有效。
REMOVAL_PLANNED 地理位置定位常量已过时,并将被移除。

KeywordView

关键字视图。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

关键字视图的资源名称。关键字视图资源名称采用以下格式:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

标签

标签。

JSON 表示法
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
字段
resourceName

string

资源的名称。标签资源名称采用以下格式:customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

标签的状态。只读。

textLabel

object (TextLabel)

一种在彩色背景上显示文本的标签。

id

string (int64 format)

标签的 ID。只读。

name

string

标签的名称。

此字段是必填字段,创建新标签时不应为空。

此字符串的长度应介于 1 到 80 之间(包括 1 和 80)。

LabelStatus

标签的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 标签已启用。
REMOVED 已移除标签。

TextLabel

一种在彩色背景上显示文本的标签。

JSON 表示法
{
  "backgroundColor": string,
  "description": string
}
字段
backgroundColor

string

十六进制格式的标签的背景颜色。此字符串必须与正则表达式“^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$”匹配。注意:经理账号可能无法看到背景颜色。

description

string

标签的简短说明。长度不得超过 200 个字符。

LanguageConstant

一种语言。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
字段
resourceName

string

语言常量的资源名称。语言常量资源名称采用以下格式:

languageConstants/{criterionId}

id

string (int64 format)

语言常量的 ID。

code

string

语言代码,例如“en_US”、“en_AU”、“es”、“fr”等。

name

string

语言的英语全名,例如“英语(美国)”“西班牙语”等。

targetable

boolean

语言是否可定位。

LocationView

地理位置视图按地理位置条件汇总了广告系列的效果。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

营业地点视图的资源名称。位置视图资源名称采用以下格式:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

产品出价类别。

JSON 表示法
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
字段
resourceName

string

产品出价类别的资源名称。产品出价类别资源名称采用以下格式:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

产品出价类别的级别。

status

enum (ProductBiddingCategoryStatus)

产品出价类别的状态。

id

string (int64 format)

产品出价类别的 ID。

此 ID 相当于 https://support.google.com/merchants/answer/6324436 一文中所述的 google_product_category ID。

countryCode

string

产品出价类别的双字母大写国家/地区代码。

productBiddingCategoryConstantParent

string

父级产品出价类别的资源名称。

languageCode

string

产品出价类别的语言代码。

localizedName

string

根据 languageCode 本地化的商品出价类别的显示值。

ProductBiddingCategoryLevel

描述产品出价类别级别的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
LEVEL1 1 级。
LEVEL2 2 级。
LEVEL3 3 级。
LEVEL4 4 级。
LEVEL5 5 级。

ProductBiddingCategoryStatus

描述产品出价类别状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ACTIVE 此类别有效,可用于出价。
OBSOLETE 此类别已过时。仅用于报告目的。

ProductGroupView

产品组视图。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

产品组视图的资源名称。产品组视图资源名称采用以下格式:

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

购物广告效果视图。提供多个产品维度级别的购物广告系列统计信息。Merchant Center 中的产品维度值(例如品牌、类别、自定义属性、产品使用情况和产品类型)将反映每个维度截至记录相应事件的日期和时间的状态。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

购物效果视图的资源名称。购物效果视图资源名称采用以下格式:customers/{customerId}/shoppingPerformanceView

UserList

用户列表。这是客户可定位的用户列表。

JSON 表示法
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
字段
resourceName

string

用户列表的资源名称。用户列表资源名称采用以下格式:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

此列表的类型。

此字段为只读字段。

id

string (int64 format)

用户列表的 ID。

name

string

此用户名单的名称。用户名单名称可能不是唯一的,具体取决于其 access_reason(例如,如果 access_reason=SHARED)

UserListType

包含可能的用户名单类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
REMARKETING 表示为转化类型集合的 UserList。
LOGICAL 表示为其他用户列表/兴趣组合的 UserList。
EXTERNAL_REMARKETING 在 Google Ad Manager 平台中创建的用户列表。
RULE_BASED 与规则关联的 UserList。
SIMILAR 包含与其他 UserList 的用户类似的用户的 UserList。
CRM_BASED 广告客户以电子邮件或其他格式提供的第一方 CRM 数据的用户名单。

WebpageView

网页浏览。

JSON 表示法
{
  "resourceName": string
}
字段
resourceName

string

网页视图的资源名称。网页视图资源名称采用以下格式:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

访问

光顾。

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
字段
resourceName

string

访问的资源名称。访问资源名称采用以下格式:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

访问的 ID。

criterionId

string (int64 format)

Search Ads 360 关键字 ID。值为 0 表示关键字未归因。

merchantId

string (int64 format)

包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时,Search Ads 360 会生成此 ID。

adId

string (int64 format)

广告 ID。值 0 表示未归因广告。

clickId

string

作为点击 ID 网址参数传递到着陆页的每次访问的唯一字符串。

visitDateTime

string

访问事件的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。

productId

string

所点击商品的 ID。

productChannel

enum (ProductChannel)

获得点击的商品的销售渠道:线上或本地。

productLanguageCode

string

为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。

productStoreId

string

获得点击的本地商品目录广告中的商店。这应与本地商品 Feed 中使用的商店 ID 一致。

productCountryCode

string

为包含获得点击的商品的商品目录 Feed 注册的国家/地区(ISO-3166 格式)。

assetId

string (int64 format)

在访问事件期间互动过的素材资源的 ID。

assetFieldType

enum (AssetFieldType)

访问事件的素材资源字段类型。

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 (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
字段
resourceName

string

转化的资源名称。转化资源名称采用以下格式:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

转化的 ID

criterionId

string (int64 format)

Search Ads 360 条件 ID。值 0 表示该条件未归因。

merchantId

string (int64 format)

包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时,Search Ads 360 会生成此 ID。

adId

string (int64 format)

广告 ID。值 0 表示未归因广告。

clickId

string

转化归因于的访问的唯一字符串,该字符串会作为点击 ID 网址参数传递到着陆页。

visitId

string (int64 format)

转化所归因的 Search Ads 360 访问 ID。

advertiserConversionId

string

对于线下转化,这是广告客户提供的 ID。如果广告客户未指定此类 ID,Search Ads 360 会生成一个 ID。对于在线转化,此值等于 ID 列或 floodlightOrderId 列,具体取决于广告客户的 Floodlight 说明。

productId

string

所点击商品的 ID。

productChannel

enum (ProductChannel)

获得点击的商品的销售渠道:线上或本地。

productLanguageCode

string

为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。

productStoreId

string

获得点击的本地商品目录广告中的商店。这应与本地商品 Feed 中使用的商店 ID 一致。

productCountryCode

string

为包含获得点击的商品的商品目录 Feed 注册的国家/地区(ISO-3166 格式)。

attributionType

enum (AttributionType)

转化归因于的原因:访问或关键字+广告。

conversionDateTime

string

转化事件的时间戳。

conversionLastModifiedDateTime

string

上次修改转化的时间戳。

conversionVisitDateTime

string

转化归因于的访问的时间戳。

conversionQuantity

string (int64 format)

转化记录的商品数量,由 qty 网址参数确定。广告客户负责动态填充该参数(例如转化中所售商品的数量),否则该值默认为 1。

conversionRevenueMicros

string (int64 format)

转化事件的调整后收入(以微为单位)。此字段始终采用广告投放账号所用的币种。

floodlightOriginalRevenue

string (int64 format)

在修改 Floodlight 货币指令之前,与 Floodlight 事件关联的未更改的原始收入(采用当前报告所用的币种)。

floodlightOrderId

string

广告客户为转化提供的 Floodlight 订单 ID。

status

enum (ConversionStatus)

转化的状态,“已启用”或“已移除”。

assetId

string (int64 format)

转化事件期间互动过的素材资源的 ID。

assetFieldType

enum (AssetFieldType)

转化事件的素材资源字段类型。

AttributionType

SearchAds360 中的转化归因类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
VISIT 这次转化就归因于某次访问。
CRITERION_AD 这次转化归因于某个条件和广告对。

ConversionStatus

转化的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 转换已启用。
REMOVED 该转化已被移除。

指标

指标数据。

JSON 表示法
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
字段
allConversionsValueByConversionDate

number

所有转化的价值。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/sa360/answer/9250611

allConversionsByConversionDate

number

转化总次数。这包含所有转化,而不考虑 includeInConversionsMetric 的值。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/sa360/answer/9250611

conversionCustomMetrics[]

object (Value)

转化自定义指标。

conversionsValueByConversionDate

number

按转化日期划分的可出价转化价值总和。如果选择此列并添加了日期,则日期列中的值表示转化日期。

conversionsByConversionDate

number

可出价转化类型的转化次数总和(按转化日期)。由于归因建模的原因,可以是小数。如果选择此列并添加了日期,则日期列中的值表示转化日期。

historicalCreativeQualityScore

enum (QualityScoreBucket)

广告素材的历史质量得分。

historicalLandingPageQualityScore

enum (QualityScoreBucket)

历史着陆页体验的质量。

historicalSearchPredictedCtr

enum (QualityScoreBucket)

历史搜索预测的点击率 (CTR)。

interactionEventTypes[]

enum (InteractionEventType)

付费和免费互动的类型。

rawEventConversionMetrics[]

object (Value)

原始事件转化指标。

absoluteTopImpressionPercentage

number

“搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。

allConversionsFromInteractionsRate

number

互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。

allConversionsValue

number

所有转化的值。

allConversions

number

转化总次数。这包含所有转化,而不考虑 includeInConversionsMetric 的值。

allConversionsValuePerCost

number

所有转化的价值除以广告互动(例如文字广告获得的点击或视频广告获得的观看)的总费用。

allConversionsFromClickToCall

number

用户点击“致电”的次数按钮,以便在点击广告时或之后致电商店。此数值不考虑通话是否接通,也不考虑通话时长。

此指标仅适用于 Feed 项。

allConversionsFromDirections

number

用户点击“查询路线”的次数按钮,用户在点击广告后导航到商店。

此指标仅适用于 Feed 项。

allConversionsFromInteractionsValuePerInteraction

number

互动带来的所有转化的价值除以总互动次数。

allConversionsFromMenu

number

用户在点击广告后,点击链接查看相应商店菜单的次数。

此指标仅适用于 Feed 项。

allConversionsFromOrder

number

用户点击广告后在商店下单的次数。

此指标仅适用于 Feed 项。

allConversionsFromOtherEngagement

number

用户点击广告后发生的其他转化(例如,发布对商店的评价或保存该商店的营业地点)的次数。

此指标仅适用于 Feed 项。

allConversionsFromStoreVisit

number

用户在点击广告后光顾商店的估算次数。

此指标仅适用于 Feed 项。

visits

number

Search Ads 360 已成功记录并转发到广告客户着陆页的点击次数。

allConversionsFromStoreWebsite

number

用户点击广告后进入商店网址的次数。

此指标仅适用于 Feed 项。

averageCost

number

您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。

averageCpc

number

所有点击次数的总费用除以所获得的总点击次数。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

averageCpm

number

平均每千次展示费用 (CPM)。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

clicks

string (int64 format)

点击次数。

contentBudgetLostImpressionShare

number

您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意:内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

contentImpressionShare

number

您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

contentRankLostImpressionShare

number

您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

conversionsFromInteractionsRate

number

与符合转化条件的互动的平均可出价转化次数(来自互动)。显示广告互动带来可出价转化的平均频率。

clientAccountConversionsValue

number

客户账号转化的值。这仅包括 includeInClientAccountConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

conversionsValuePerCost

number

可出价转化价值除以转化符合条件的互动的总费用。

conversionsFromInteractionsValuePerInteraction

number

互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

clientAccountConversions

number

客户账号转化次数。这仅包括 includeInClientAccountConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

costMicros

string (int64 format)

在此期间您的每次点击费用 (CPC) 和每千次展示费用 (CPM) 费用的总和。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

costPerAllConversions

number

广告互动费用除以所有转化次数。

costPerConversion

number

符合转化条件的平均每次可出价转化费用。

costPerCurrentModelAttributedConversion

number

广告互动费用除以当前模型归因转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

crossDeviceConversions

number

转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化次数已包含在 allConversions 中。

crossDeviceConversionsValue

number

跨设备转化的值的总和。

ctr

number

广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。

conversions

number

转化次数。这仅包括 includeInConversionsMetric 属性设为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。

conversionsValue

number

“转化”字段中包含的转化带来的转化价值总和。要使用此指标,您必须为各项转化操作输入转化价值。

averageQualityScore

number

平均质量得分。

historicalQualityScore

string (int64 format)

历史质量得分。

impressions

string (int64 format)

广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。

interactionRate

number

在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。

interactions

string (int64 format)

互动次数。互动是指与某种广告格式关联的主用户操作:对于文字广告和购物广告而言是点击,对于视频广告而言是观看,诸如此类。

invalidClickRate

number

报告期内从总点击次数(过滤后 + 未过滤的点击次数)过滤出的点击次数所占的百分比。

invalidClicks

string (int64 format)

Google 认为不合规定且不向您收费的点击次数。

mobileFriendlyClicksPercentage

number

适合移动设备的页面的移动点击次数所占的百分比。

searchAbsoluteTopImpressionShare

number

在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请参阅 https://support.google.com/sa360/answer/9566729。任何低于 0.1 的值都会报告为 0.0999。

searchBudgetLostAbsoluteTopImpressionShare

number

此数字用于估算您的广告因预算不足而未能在搜索结果中作为头条广告进行展示的频率。注意:搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchBudgetLostImpressionShare

number

您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchBudgetLostTopImpressionShare

number

此数字是一个估算值,用于估算您的广告因预算不足而未能在顶部自然搜索结果邻近位置展示的频率。注意:搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchClickShare

number

您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意:搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

searchExactMatchImpressionShare

number

对于与关键字完全匹配(或是关键字的紧密变体形式)的搜索字词,此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意:搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

searchImpressionShare

number

您在搜索网络中获得的展示次数除以您有资格获得的估算展示次数。注意:在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

searchRankLostAbsoluteTopImpressionShare

number

此数字是一个估算值,用于估算您的广告因广告评级较低而未能在搜索结果中作为头条广告进行展示的频率。注意:搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchRankLostImpressionShare

number

您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchRankLostTopImpressionShare

number

此数字是一个估算值,用于估算您的广告因广告评级较低而未能在顶部自然搜索结果邻近位置展示的频率。注意:搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。

searchTopImpressionShare

number

您在页首广告中实际获得的展示次数除以您有资格在页首广告中获得的估算展示次数所得到的百分比。注意:搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

页首广告通常展示在顶部自然搜索结果上方,但在某些查询中,页首广告可能会展示在顶部自然搜索结果下方。

topImpressionPercentage

number

在顶部自然搜索结果邻近位置展示的广告展示次数所占的百分比。

valuePerAllConversions

number

所有转化的价值除以所有转化的次数。

valuePerAllConversionsByConversionDate

number

所有转化的价值除以所有转化次数。如果选择此列并添加了日期,则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列,请访问 https://support.google.com/sa360/answer/9250611

valuePerConversion

number

可出价转化的价值除以可出价转化次数。显示每次可出价转化的平均价值。

valuePerConversionsByConversionDate

number

按转化日期划分的可出价转化价值除以按转化日期划分的可出价转化次数。显示每次可出价转化的平均价值(按转化日期)。如果选择此列并添加了日期,则日期列中的值表示转化日期。

clientAccountViewThroughConversions

string (int64 format)

浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

客户账号的交叉销售销货成本 (COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。作为交叉销售产品时的销货成本是指并未通过广告宣传售出的产品的总费用。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的销货成本为 5 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

crossSellCostOfGoodsSoldMicros

string (int64 format)

“作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。作为交叉销售产品时的销货成本是指并未通过广告宣传售出的产品的总费用。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的销货成本为 5 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

clientAccountCrossSellGrossProfitMicros

string (int64 format)

客户账号作为交叉销售产品时的毛利润是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的其他产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的毛利润”是指广告促成的交叉销售所产生的收入减去销货成本。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。衬衫的价格为 20 美元,其销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的毛利润就是:15 美元 = 20 美元 - 5 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

crossSellGrossProfitMicros

string (int64 format)

“作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的其他产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的毛利润”是指广告促成的交叉销售所产生的收入减去销货成本。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。衬衫的价格为 20 美元,其销货成本价值为 5 美元。在这笔订单中,作为交叉销售产品时的毛利润就是:15 美元 = 20 美元 - 5 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

clientAccountCrossSellRevenueMicros

string (int64 format)

客户账号交叉销售产品的收入是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售给您带来的收入总和。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为交叉销售产品时的收入为 20 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

crossSellRevenueMicros

string (int64 format)

“作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售给您带来的收入总和。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为交叉销售产品时的收入为 20 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

clientAccountCrossSellUnitsSold

number

客户账号中的“交叉销售产品的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。

crossSellUnitsSold

number

“作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果产品不一致,就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

客户账号中“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总费用。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品(请参阅购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些产品的成本会计入“作为主推产品时的销货成本”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为主推产品时的销货成本为 3 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

leadCostOfGoodsSoldMicros

string (int64 format)

“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品(请参阅购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些产品的成本会计入“作为主推产品时的销货成本”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的销货成本价值为 3 美元,衬衫的销货成本价值为 5 美元。在这笔订单中,作为主推产品时的销货成本为 3 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

clientAccountLeadGrossProfitMicros

string (int64 format)

客户账号的潜在客户毛利润是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的同一产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您通过这些销售获得的收入减去销货成本即为您的主打产品的毛利润。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。在这笔订单中,作为主推产品时的毛利润就是:7 美元 = 10 美元 - 3 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

leadGrossProfitMicros

string (int64 format)

“作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后,因广告宣传某产品而售出的同一产品给您带来的利润。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您通过这些销售获得的收入减去销货成本即为您的主打产品的毛利润。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。帽子的价格为 10 美元,其销货成本价值为 3 美元。在这笔订单中,作为主推产品时的毛利润就是:7 美元 = 10 美元 - 3 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

clientAccountLeadRevenueMicros

string (int64 format)

客户账号中的“主推产品”收入是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您因销售这些产品而获得的总价值会计入“作为主推产品时的收入”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为主推产品时的收入为 10 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

leadRevenueMicros

string (int64 format)

“作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么您因销售这些产品而获得的总价值会计入“作为主推产品时的收入”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫。这顶帽子的价格是 10 美元,这件衬衫的价格是 20 美元。在这笔订单中,作为主推产品时的收入为 10 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币价值,默认情况下以客户的货币返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数

clientAccountLeadUnitsSold

number

客户账号中“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些售出产品的总数会计入“作为主推产品时的销量”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。

leadUnitsSold

number

“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式:您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品(参见购物广告),此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符,那么这些售出产品的总数会计入“作为主推产品时的销量”。示例:某个用户点击了宣传某款帽子的购物广告,然后购买了该款帽子,同时还购买了一件衬衫和一件夹克。在这笔订单中,作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。

通用数据容器。

JSON 表示法
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
字段
联合字段 value。一个值。value 只能是下列其中一项:
booleanValue

boolean

布尔值。

int64Value

string (int64 format)

int64。

floatValue

number

一个浮点数。

doubleValue

number

双精度型。

stringValue

string

它是一个字符串。

QualityScoreBucket

列出可能的质量得分类别的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
BELOW_AVERAGE 广告素材质量低于平均水平。
AVERAGE 广告素材质量中等。
ABOVE_AVERAGE 广告素材质量高于平均水平。

InteractionEventType

描述可能的付费互动和免费互动类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CLICK 点击访问网站。在大多数情况下,这种互动会导航到外部位置,通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。
ENGAGEMENT 用户在原位置与广告互动的明确意向。
VIDEO_VIEW 用户观看了一个视频广告。
NONE 广告转化事件的默认 InteractionEventType。当广告转化行没有指明免费互动(例如广告转化)应该“推广”时,系统会使用此方法作为核心指标的一部分进行报告这些都属于其他(广告)转化。

细分

仅限细分字段。

JSON 表示法
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
字段
adNetworkType

enum (AdNetworkType)

广告网络类型。

conversionActionCategory

enum (ConversionActionCategory)

转化操作类别。

conversionCustomDimensions[]

object (Value)

转化自定义维度。

dayOfWeek

enum (DayOfWeek)

星期几,例如 MONDAY。

device

enum (Device)

指标应用于的设备。

keyword

object (Keyword)

关键字标准。

productChannel

enum (ProductChannel)

商品的渠道。

productChannelExclusivity

enum (ProductChannelExclusivity)

商品的渠道独占性。

productCondition

enum (ProductCondition)

商品的使用情况。

productSoldCondition

enum (ProductCondition)

所售产品的使用情况。

rawEventConversionDimensions[]

object (Value)

原始事件转化维度。

conversionAction

string

转化操作的资源名称。

conversionActionName

string

转化操作名称。

date

string

指标适用的日期。yyyy-MM-dd 格式,例如 2018-04-17。

geoTargetCity

string

表示城市的地理位置定位目标常量的资源名称。

geoTargetCountry

string

表示国家/地区的地理位置定位常量的资源名称。

geoTargetMetro

string

代表都市圈的地理位置定位目标常量的资源名称。

geoTargetRegion

string

代表区域的地理位置定位目标常量的资源名称。

hour

integer

以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。

month

string

由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。

productBiddingCategoryLevel1

string

商品的出价类别(第 1 级)。

productBiddingCategoryLevel2

string

商品的出价类别(第 2 级)。

productBiddingCategoryLevel3

string

商品的出价类别(第 3 级)。

productBiddingCategoryLevel4

string

商品的出价类别(第 4 级)。

productBiddingCategoryLevel5

string

商品的出价类别(第 5 级)。

productBrand

string

商品的品牌。

productCountry

string

商品目标销售国家/地区的地理位置定位目标常量的资源名称。

productCustomAttribute0

string

商品的自定义属性 0。

productCustomAttribute1

string

商品的自定义属性 1。

productCustomAttribute2

string

商品的自定义属性 2。

productCustomAttribute3

string

商品的自定义属性 3。

productCustomAttribute4

string

商品的自定义属性 4。

productItemId

string

商品的项目 ID。

productLanguage

string

商品语言的语言常量的资源名称。

productSoldBiddingCategoryLevel1

string

所售产品的出价类别(级别 1)。

productSoldBiddingCategoryLevel2

string

所售产品的出价类别(级别 2)。

productSoldBiddingCategoryLevel3

string

所售产品的出价类别(级别 3)。

productSoldBiddingCategoryLevel4

string

所售产品的出价类别(级别 4)。

productSoldBiddingCategoryLevel5

string

所售产品的出价类别(级别 5)。

productSoldBrand

string

所售产品的品牌。

productSoldCustomAttribute0

string

所售商品的自定义属性 0。

productSoldCustomAttribute1

string

所售商品的自定义属性 1。

productSoldCustomAttribute2

string

所售商品的自定义属性 2。

productSoldCustomAttribute3

string

所售商品的自定义属性 3。

productSoldCustomAttribute4

string

所售商品的自定义属性 4。

productSoldItemId

string

所售商品的商品 ID。

productSoldTitle

string

所售商品的名称。

productSoldTypeL1

string

所售商品的类型(第 1 级)。

productSoldTypeL2

string

所售商品的类型(第 2 级)。

productSoldTypeL3

string

所售商品的类型(第 3 级)。

productSoldTypeL4

string

所售商品的类型(第 4 级)。

productSoldTypeL5

string

所售商品的类型(第 5 级)。

productStoreId

string

商品的商店 ID。

productTitle

string

商品的名称。

productTypeL1

string

商品的类型(第 1 级)。

productTypeL2

string

商品的类型(第 2 级)。

productTypeL3

string

商品的类型(第 3 级)。

productTypeL4

string

商品的类型(第 4 级)。

productTypeL5

string

商品的类型(第 5 级)。

quarter

string

由一个季度第一天的日期表示的季度。针对季度使用日历年,例如,2018 年第二季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。

week

string

定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。

year

integer

年份,格式为 yyyy。

assetInteractionTarget

object (AssetInteractionTarget)

仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标一起使用。指明互动指标是出现在素材资源本身上,还是出现在其他素材资源或广告单元上。当投放的广告的所有部分(例如广告本身以及站内链接等其他组件)一起投放时,系统会统计互动(例如点击次数)。如果 interactionOnThisAsset 为 true,则表示互动发生在此特定素材资源上;如果 InteractionOnThisAsset 为 false,则表示互动并非针对该特定素材资源,而是在已投放此素材资源的广告的其他部分。

AdNetworkType

枚举 Google Ads 广告网络类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
SEARCH Google 搜索。
SEARCH_PARTNERS 搜索网络合作伙伴。
CONTENT 展示广告网络。
YOUTUBE_WATCH YouTube 视频
MIXED 跨广告网络。

Keyword

关键字条件细分。

JSON 表示法
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
字段
info

object (KeywordInfo)

关键字信息。

adGroupCriterion

string

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

string

资产资源名称。

interactionOnThisAsset

boolean

仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标一起使用。指明互动指标是出现在素材资源本身上,还是出现在其他素材资源或广告单元上。