- JSON 表示法
- FinalAppUrl
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AppUrlOperatingSystemType
- AdType
- UrlCollection
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SystemManagedResourceSource
- TextAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ExpandedTextAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CallAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ExpandedDynamicSearchAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdImageAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdVideoAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdVideoAssetInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdVideoAssetInventoryPreferences
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoTrueViewInStreamAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoBumperInStreamAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoOutstreamAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoNonSkippableInStreamAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- InFeedVideoAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VideoThumbnail
- VideoResponsiveAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ResponsiveSearchAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LegacyResponsiveDisplayAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DisplayAdFormatSetting
- AppAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdMediaBundleAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LegacyAppInstallAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ResponsiveDisplayAdControlSpec
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DisplayUploadAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DisplayUploadProductType
- AppEngagementAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ShoppingComparisonListingAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AppPreRegistrationAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DemandGenMultiAssetAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DemandGenCarouselAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdDemandGenCarouselCardAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DemandGenVideoResponsiveAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AdCallToActionAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DemandGenProductAdInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TravelAdInfo
某个广告。
JSON 表示法 |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
字段 | |
---|---|
resourceName |
不可变。广告的资源名称。广告资源名称采用以下格式:
|
finalUrls[] |
广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
finalAppUrls[] |
用户安装了特定应用后在移动设备上使用的最终到达应用网址列表。 |
finalMobileUrls[] |
广告的所有跨网域重定向之后可能存在的最终到达移动网址列表。 |
urlCustomParameters[] |
可用于替换 |
type |
仅限输出。广告的类型。 |
devicePreference |
广告的设备偏好设置。您只能指定移动设备的偏好设置。设置此偏好设置后,当某广告在移动设备上展示时,该广告将优于其他广告。广告仍可在其他类型的设备上展示,例如在没有其他广告可展示的情况下。如果未指定(无设备偏好设置),则系统会定位所有设备。仅受部分广告类型支持。 |
urlCollections[] |
广告的其他网址,使用可从广告中的其他字段引用的唯一标识符进行标记。 |
systemManagedResourceSource |
仅限输出。如果广告由系统管理,则此字段会指示来源。此字段为只读字段。 |
id |
仅限输出。广告的 ID。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
finalUrlSuffix |
构建最终到达网址时使用的后缀。 |
displayUrl |
在某些广告格式的广告说明中显示的网址。 |
addedByGoogleAds |
仅限输出。指示此广告是否由 Google Ads 自动添加,而不是由用户添加。例如,当根据现有广告的效果自动创建广告作为新广告的建议时,可能会发生这种情况。 |
name |
不可变。广告的名称。此名称仅用于识别广告。它不必是唯一的,也不会影响投放的广告。name 字段目前仅适用于 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd。 |
联合字段 ad_data 。与广告类型相关的详细信息。必须设置一个值。ad_data 只能是下列其中一项: |
|
textAd |
不可变。与文字广告有关的详细信息。 |
expandedTextAd |
与加大型文字广告相关的详情。 |
callAd |
与来电广告相关的详情。 |
expandedDynamicSearchAd |
不可变。与加大型动态搜索广告相关的详细信息。此类广告的标题、最终到达网址和显示网址会在投放时根据广告系列级关联的 |
hotelAd |
与酒店广告相关的详细信息。 |
shoppingSmartAd |
与智能购物广告相关的详细信息。 |
shoppingProductAd |
与购物产品广告相关的详细信息。 |
imageAd |
不可变。与图片广告有关的详情。 |
videoAd |
与视频广告相关的详细信息。 |
videoResponsiveAd |
与视频自适应广告相关的详细信息。 |
responsiveSearchAd |
与自适应搜索广告相关的详细信息。 |
legacyResponsiveDisplayAd |
与旧版自适应展示广告相关的详细信息。 |
appAd |
与应用广告相关的详情。 |
legacyAppInstallAd |
不可变。与旧版应用安装广告相关的详细信息。 |
responsiveDisplayAd |
与自适应展示广告相关的详细信息。 |
localAd |
与本地广告相关的详情。 |
displayUploadAd |
与上传的展示广告相关的详情。 |
appEngagementAd |
与应用互动广告相关的详情。 |
shoppingComparisonListingAd |
与比价购物广告相关的详细信息。 |
smartCampaignAd |
与智能广告系列广告相关的详细信息。 |
appPreRegistrationAd |
与应用预注册广告相关的详细信息。 |
demandGenMultiAssetAd |
与多重素材资源需求开发广告相关的详细信息。 |
demandGenCarouselAd |
与轮播式需求开发广告相关的详细信息。 |
demandGenVideoResponsiveAd |
与需求开发视频自适应广告相关的详细信息。 |
demandGenProductAd |
与产品需求开发广告相关的详细信息。 |
travelAd |
与旅游广告相关的详细信息。 |
FinalAppUrl
用于深层链接到指定操作系统的应用的网址。
JSON 表示法 |
---|
{
"osType": enum ( |
字段 | |
---|---|
osType |
此网址所针对的操作系统。必填。 |
url |
应用深层链接网址。深层链接用于指定应用中与您要展示的内容相对应的位置,并且应采用 {scheme}://{host_path} 格式。该架构用于标识要打开哪个应用。对于您的应用,您可以使用以应用名称开头的自定义架构。主机和路径用于指定内容在应用中的唯一位置。例如:“exampleapp://productid_1234”。必填。 |
AppUrlOperatingSystemType
操作系统
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
IOS |
Apple iOS 操作系统。 |
ANDROID |
Android 操作系统。 |
AdType
可能的广告类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定值。 |
UNKNOWN |
接收的值在此版本中未知。 这是一个仅用于响应的值。 |
TEXT_AD |
该广告是文字广告。 |
EXPANDED_TEXT_AD |
该广告是加大型文字广告。 |
EXPANDED_DYNAMIC_SEARCH_AD |
该广告是加大型动态搜索广告。 |
HOTEL_AD |
该广告是酒店广告。 |
SHOPPING_SMART_AD |
该广告是智能购物广告。 |
SHOPPING_PRODUCT_AD |
该广告是标准购物广告。 |
VIDEO_AD |
该广告是视频广告。 |
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_IN_STREAM_AD |
TrueView 插播视频广告。 |
VIDEO_RESPONSIVE_AD |
视频自适应广告。 |
SMART_CAMPAIGN_AD |
智能广告系列。 |
CALL_AD |
来电广告。 |
APP_PRE_REGISTRATION_AD |
通用应用预注册广告。 |
IN_FEED_VIDEO_AD |
信息流视频广告。 |
DEMAND_GEN_MULTI_ASSET_AD |
多素材资源需求开发广告。 |
DEMAND_GEN_CAROUSEL_AD |
轮播式需求开发广告。 |
TRAVEL_AD |
旅游广告。 |
DEMAND_GEN_VIDEO_RESPONSIVE_AD |
需求开发视频自适应广告。 |
DEMAND_GEN_PRODUCT_AD |
产品需求开发广告。 |
UrlCollection
使用唯一标识符标记的网址集合。
JSON 表示法 |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
字段 | |
---|---|
finalUrls[] |
可能的最终到达网址的列表。 |
finalMobileUrls[] |
可能的最终到达移动网址列表。 |
urlCollectionId |
此 UrlCollection 实例的唯一标识符。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
SystemManagedResourceSource
列出可能的系统管理的实体来源的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
AD_VARIATIONS |
生成的广告变体实验广告。 |
TextAdInfo
文字广告。
JSON 表示法 |
---|
{ "headline": string, "description1": string, "description2": string } |
字段 | |
---|---|
headline |
广告的标题。 |
description1 |
广告内容描述的第一行。 |
description2 |
广告内容描述的第二行。 |
ExpandedTextAdInfo
加大型文字广告。
JSON 表示法 |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
字段 | |
---|---|
headlinePart1 |
广告标题的第一部分。 |
headlinePart2 |
广告标题的第二部分。 |
headlinePart3 |
广告标题的第三部分。 |
description |
广告的广告内容描述。 |
description2 |
广告的第二条说明。 |
path1 |
可以与广告的显示网址一起显示的文字。 |
path2 |
可以与广告的显示网址一起显示的其他文字。 |
CallAdInfo
来电广告。
JSON 表示法 |
---|
{
"countryCode": string,
"phoneNumber": string,
"businessName": string,
"headline1": string,
"headline2": string,
"description1": string,
"description2": string,
"callTracked": boolean,
"disableCallConversion": boolean,
"phoneNumberVerificationUrl": string,
"conversionAction": string,
"conversionReportingState": enum ( |
字段 | |
---|---|
countryCode |
广告中的国家/地区代码。 |
phoneNumber |
广告中的电话号码。 |
businessName |
广告中的商家名称。 |
headline1 |
广告中的第一个标题。 |
headline2 |
广告中的第二个标题。 |
description1 |
广告内容描述的第一行。 |
description2 |
广告内容描述的第二行。 |
callTracked |
是否为广告素材启用来电跟踪。启用来电跟踪的同时也会启用来电转化。 |
disableCallConversion |
是否为广告素材停用来电转化。如果设置为 |
phoneNumberVerificationUrl |
要用于电话号码验证的网址。 |
conversionAction |
将来电转化归因于的转化操作。如果未设置,系统将使用默认转化操作。只有在 |
conversionReportingState |
此来电广告的来电转化行为。它可以使用自己的致电转化设置,也可以沿用账号级设置,也可以被停用。 |
path1 |
可附加到广告中网址的第一部分文字。可选。 |
path2 |
可附加到广告中网址的第二部分文字。仅当同时设置了 |
ExpandedDynamicSearchAdInfo
加大型动态搜索广告。
JSON 表示法 |
---|
{ "description": string, "description2": string } |
字段 | |
---|---|
description |
广告的广告内容描述。 |
description2 |
广告的第二条说明。 |
HotelAdInfo
此类型没有字段。
酒店广告。
ShoppingSmartAdInfo
此类型没有字段。
智能购物广告。
ShoppingProductAdInfo
此类型没有字段。
标准购物广告。
ImageAdInfo
图片广告。
JSON 表示法 |
---|
{ "mimeType": enum ( |
字段 | |
---|---|
mimeType |
图片的 MIME 类型。 |
pixelWidth |
全尺寸图片的宽度(以像素为单位)。 |
pixelHeight |
全尺寸图片的高度(以像素为单位)。 |
imageUrl |
全尺寸图片的网址。 |
previewPixelWidth |
预览尺寸图片的宽度(以像素为单位)。 |
previewPixelHeight |
预览尺寸图片的高度(以像素为单位)。 |
previewImageUrl |
预览尺寸图片的网址。 |
name |
图片的名称。如果图像是从媒体文件创建而来,则这是媒体文件的名称。如果图片是通过字节创建的,则为空。 |
联合字段 image 。用以创建 ImageAd 的图片。这可以通过以下两种方式之一进行指定。1. 现有的媒体文件资源。2. 原始图片数据(以字节为单位)。image 只能是下列其中一项: |
|
imageAsset |
广告所用的图片素材资源。 |
data |
原始图片数据(以字节为单位)。 使用 base64 编码的字符串。 |
adIdToCopyImageFrom |
要从中复制图片的广告 ID。 |
AdImageAsset
在广告中使用的图片素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此图片的 Asset 资源名称。 |
VideoAdInfo
视频广告。
JSON 表示法 |
---|
{ "video": { object ( |
字段 | |
---|---|
video |
广告使用的 YouTube 视频素材资源。 |
联合字段 format 。不同视频广告格式的具体格式架构。format 只能是下列其中一项: |
|
inStream |
视频 TrueView 插播广告格式。 |
bumper |
导视插播视频广告格式。 |
outStream |
外播视频广告格式。 |
nonSkippable |
不可跳过的插播广告格式。 |
inFeed |
信息流视频广告格式。 |
AdVideoAsset
在广告中使用的视频素材资源。
JSON 表示法 |
---|
{
"asset": string,
"adVideoAssetInfo": {
object ( |
字段 | |
---|---|
asset |
此视频的资产资源名称。 |
adVideoAssetInfo |
包含此 AdVideoAsset 的信息字段。 |
AdVideoAssetInfo
包含 AdVideoAssets 的信息字段。
JSON 表示法 |
---|
{
"adVideoAssetInventoryPreferences": {
object ( |
字段 | |
---|---|
adVideoAssetInventoryPreferences |
此 AdVideoAsset 的广告资源偏好设置列表。此字段只能用于 DiscoveryVideoResponsiveAd。在投放期间,设置了广告资源素材资源偏好设置的视频素材资源将优先于同一广告中的其他视频。例如,假设此广告是为特定广告资源投放。服务器会先尝试将符合条件的视频与相应广告资源的匹配偏好设置进行匹配。仅当找到具有匹配偏好且符合指定广告位条件的视频时,才会选择未设置偏好设置的视频。 |
AdVideoAssetInventoryPreferences
YouTube 视频资产广告资源偏好设置。
JSON 表示法 |
---|
{ "inFeedPreference": boolean, "inStreamPreference": boolean, "shortsPreference": boolean } |
字段 | |
---|---|
inFeedPreference |
如果为 true,则在选择要在 Feed 中投放的视频时,系统会优先选择具有此广告资源偏好设置的 YouTube 视频素材资源。 |
inStreamPreference |
如果为 true,则在选择要投放视频插播广告的视频时,系统会优先选择具有此广告资源偏好设置的 YouTube 视频资源。 |
shortsPreference |
如果为 true,则在选择要在 YouTube Shorts 上投放的视频时,系统会优先选择具有此广告资源偏好设置的 YouTube 视频素材资源。 |
VideoTrueViewInStreamAdInfo
表示 TrueView 视频插播广告格式(在视频播放期间展示的广告,通常在开始播放时,会在视频几秒后显示一个“跳过”按钮)。
JSON 表示法 |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
字段 | |
---|---|
actionButtonLabel |
号召性用语 (CTA) 按钮上的标签,可将用户引导至视频广告的最终到达网址。对于 TrueView 行动号召广告系列,此字段为必填字段,否则为选填字段。 |
actionHeadline |
随 CTA(号召性用语)按钮一起显示的额外文字,可提供背景信息并鼓励用户点击该按钮。 |
companionBanner |
与广告一起使用的随播横幅广告的图片素材资源。 |
VideoBumperInStreamAdInfo
表示导视插播广告格式(非常短的不可跳过的插播视频广告)。
JSON 表示法 |
---|
{
"companionBanner": {
object ( |
字段 | |
---|---|
companionBanner |
与广告一起使用的随播横幅广告的图片素材资源。 |
actionButtonLabel |
“号召性用语”页上的标签按钮将用户引导至视频广告的最终到达网址。 |
actionHeadline |
随 CTA(号召性用语)按钮一起显示的额外文字,可提供背景信息并鼓励用户点击该按钮。 |
VideoOutstreamAdInfo
外播视频广告格式的表示形式(与具有自动播放功能的 Feed 一起展示的广告,无声音)。
JSON 表示法 |
---|
{ "headline": string, "description": string } |
字段 | |
---|---|
headline |
广告的标题。 |
description |
广告内容描述。 |
VideoNonSkippableInStreamAdInfo
表示不可跳过的插播广告格式(15 秒不可跳过的插播视频广告)。
JSON 表示法 |
---|
{
"companionBanner": {
object ( |
字段 | |
---|---|
companionBanner |
与广告一起使用的随播横幅广告的图片素材资源。 |
actionButtonLabel |
“号召性用语”页上的标签按钮将用户引导至视频广告的最终到达网址。 |
actionHeadline |
与“号召性用语”一起显示的额外文字按钮来提供背景信息,鼓励用户点击该按钮。 |
InFeedVideoAdInfo
信息流视频广告格式的表示形式。
JSON 表示法 |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
字段 | |
---|---|
headline |
广告的标题。 |
description1 |
广告的第一行文字。 |
description2 |
广告的第二行文字。 |
thumbnail |
要使用的视频缩略图。 |
VideoThumbnail
枚举可能的视频缩略图类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定类型。 |
UNKNOWN |
接收的值在此版本中未知。这是一个仅用于响应的值。 |
DEFAULT_THUMBNAIL |
默认缩略图。可以自动生成,也可以由用户上传。 |
THUMBNAIL_1 |
由视频生成的缩略图 1。 |
THUMBNAIL_2 |
由视频生成的缩略图 2。 |
THUMBNAIL_3 |
由视频生成的缩略图 3。 |
VideoResponsiveAdInfo
视频自适应广告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
短标题所用文字素材资源的列表。目前仅支持短标题的单个值。 |
longHeadlines[] |
用于长标题的文字素材资源列表。目前仅支持长标题的单个值。 |
descriptions[] |
用于说明文字素材资源的列表。目前仅支持说明的单个值。 |
callToActions[] |
用于按钮的文字素材资源列表,例如“号召性用语”按钮。目前仅支持为按钮使用一个值。 |
videos[] |
广告所用 YouTube 视频素材资源的列表。目前仅支持为 YouTube 视频素材资源使用一个值。 |
companionBanners[] |
随播横幅广告使用的图片素材资源列表。目前仅支持为随播横幅广告素材资源提供一个值。 |
breadcrumb1 |
与显示网址一起在广告中显示的文字的第一部分。 |
breadcrumb2 |
与显示网址一起在广告中显示的文字的第二部分。 |
ResponsiveSearchAdInfo
自适应搜索广告。
采用自适应搜索广告格式制作广告,可以根据客户的搜索字词向其展示更丰富的文字信息以及更切实相关的广告内容。制作自适应搜索广告时,您只需输入多个标题和广告内容描述即可;随着时间的推移,Google Ads 会自动测试各种不同的组合,通过机器学习技术逐渐摸索出效果最好的组合。通过调整广告内容,使其更贴近潜在客户的需求搜索字词,自适应搜索广告可以提升广告系列的效果。
有关详情,请访问 https://support.google.com/google-ads/answer/7684791
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
path1 |
可附加到广告中网址的第一部分文字。 |
path2 |
可附加到广告中网址的第二部分文字。仅当同时设置了 |
LegacyResponsiveDisplayAdInfo
旧版自适应展示广告。此类广告被标记为“自适应广告”在 Google Ads 界面中查看。
JSON 表示法 |
---|
{
"formatSetting": enum ( |
字段 | |
---|---|
formatSetting |
指定投放广告采用的格式。默认为 ALL_FORMAT。 |
shortHeadline |
短版本的广告标题。 |
longHeadline |
长版本的广告标题。 |
description |
广告的广告内容描述。 |
businessName |
广告中的商家名称。 |
allowFlexibleColor |
广告主同意使用灵活的颜色。如果为 true,则系统可根据需要以不同颜色投放广告。如果为 false,则系统会以指定颜色或中性颜色投放广告。默认值为 |
accentColor |
广告的强调色,采用十六进制格式,例如 #ffffff 表示白色。如果设置了 |
mainColor |
广告的主颜色,以十六进制格式表示,例如 #ffffff 表示白色。如果设置了 |
callToActionText |
广告的号召性用语。 |
logoImage |
广告中使用的徽标图片的 MediaFile 资源名称。 |
squareLogoImage |
广告中使用的方形徽标图片的 MediaFile 资源名称。 |
marketingImage |
广告中使用的营销图片的 MediaFile 资源名称。 |
squareMarketingImage |
广告中使用的方形营销图片的 MediaFile 资源名称。 |
pricePrefix |
价格之前的前缀。例如,“低至”。 |
promoText |
用于动态格式自适应广告的宣传文字。例如,“两日运费免费”。 |
DisplayAdFormatSetting
枚举展示广告格式设置。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
ALL_FORMATS |
文字、图片和原生广告格式。 |
NON_NATIVE |
文字和图片格式。 |
NATIVE |
例如,原生格式广告的格式呈现由发布商控制,而不受 Google 控制。 |
AppAdInfo
应用广告。
JSON 表示法 |
---|
{ "mandatoryAdText": { object ( |
字段 | |
---|---|
mandatoryAdText |
必填广告文字。 |
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
images[] |
可以与广告一起展示的图片素材资源列表。 |
youtubeVideos[] |
可与广告一起展示的 YouTube 视频素材资源列表。 |
html5MediaBundles[] |
可与广告一起使用的媒体包素材资源列表。 |
AdMediaBundleAsset
在广告中使用的媒体包素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此媒体包的素材资源资源名称。 |
LegacyAppInstallAdInfo
只能由少数精选客户使用的旧版应用安装广告。
JSON 表示法 |
---|
{
"appStore": enum ( |
字段 | |
---|---|
appStore |
提供移动应用的应用商店。 |
appId |
移动应用的 ID。 |
headline |
广告的标题。 |
description1 |
广告的第一行广告内容描述。 |
description2 |
广告的第二行广告内容描述。 |
LegacyAppInstallAdAppStore
旧版应用安装广告中的应用商店类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中未知的值。 |
APPLE_APP_STORE |
Apple iTunes。 |
GOOGLE_PLAY |
Google Play |
WINDOWS_STORE |
Windows 应用商店。 |
WINDOWS_PHONE_STORE |
Windows Phone Store。 |
CN_APP_STORE |
该应用托管在中国应用商店中。 |
ResponsiveDisplayAdInfo
自适应展示广告。
JSON 表示法 |
---|
{ "marketingImages": [ { object ( |
字段 | |
---|---|
marketingImages[] |
在广告中使用的营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x314,宽高比必须为 1.91:1 (+-1%)。必须至少选择一个 |
squareMarketingImages[] |
在广告中使用的方形营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 300x300,宽高比必须为 1:1 (+-1%)。必须至少提供一个方形 |
logoImages[] |
在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 512x128,宽高比必须为 4:1 (+-1%)。搭配 |
squareLogoImages[] |
在广告中使用的方形徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。搭配 |
headlines[] |
广告的短格式标题。最大长度为 30 个字符。可以指定至少 1 个和最多 5 个标题。 |
longHeadline |
必须提供长格式标题。最大长度为 90 个字符。 |
descriptions[] |
广告的描述性文字。最大长度为 90 个字符。可以指定至少 1 个和最多 5 个标题。 |
youtubeVideos[] |
(可选)广告的 YouTube 视频。最多可以指定 5 个视频。 |
formatSetting |
指定投放广告采用的格式。默认为 ALL_FORMAT。 |
controlSpec |
各种广告素材控件的规范。 |
businessName |
广告主/品牌名称。最大展示宽度为 25。 |
mainColor |
广告的主颜色,以十六进制格式表示,例如 #ffffff 表示白色。如果设置了 |
accentColor |
广告的强调色,采用十六进制格式,例如 #ffffff 表示白色。如果设置了 |
allowFlexibleColor |
广告主同意使用灵活的颜色。如果为 true,则系统可根据需要以不同颜色投放广告。如果为 false,则系统会以指定颜色或中性颜色投放广告。默认值为 |
callToActionText |
广告的号召性用语文字。最大展示宽度为 30。 |
pricePrefix |
价格之前的前缀。例如,“低至”。 |
promoText |
用于动态格式自适应广告的宣传文字。例如,“两日运费免费”。 |
ResponsiveDisplayAdControlSpec
自适应展示广告的各种广告素材控制规范。
JSON 表示法 |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
字段 | |
---|---|
enableAssetEnhancements |
广告客户是否已选择启用素材资源自动美化功能。 |
enableAutogenVideo |
广告客户是否已选择启用自动生成的视频功能。 |
LocalAdInfo
本地广告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。投放广告时,系统会从此列表中选择标题。必须指定至少 1 个标题,最多 5 个。 |
descriptions[] |
说明的文字素材资源列表。投放广告时,系统会从此列表中选择广告内容描述。必须指定至少 1 条广告内容描述(最多 5 条)。 |
callToActions[] |
号召性用语文字素材资源列表。广告投放时,系统将从此列表中选择号召性用语。必须指定至少 1 条、最多 5 条号召性用语。 |
marketingImages[] |
可与广告一起展示的营销图片素材资源的列表。图片尺寸必须为 314x600 像素或 320x320 像素。必须指定至少 1 个图片素材资源,但最多不能超过 20 个。 |
logoImages[] |
可与广告一起展示的徽标图片素材资源的列表。图片大小必须为 128x128 像素,且不超过 120KB。必须指定至少 1 个图片素材资源,但最多不能超过 5 个。 |
videos[] |
可与广告一起展示的 YouTube 视频素材资源列表。必须指定视频素材资源,但不能超过 20 个。 |
path1 |
可选文字的第一部分,可附加到广告中的网址。 |
path2 |
可选文字的第二部分,可附加到广告中的网址。仅当同时设置了 |
DisplayUploadAdInfo
通用类型的展示广告。具体的广告格式由 displayUploadProductType
字段控制,该字段用于确定广告中需要包含的数据类型。
JSON 表示法 |
---|
{ "displayUploadProductType": enum ( |
字段 | |
---|---|
displayUploadProductType |
此广告的产品类型。如需了解详情,请参阅有关枚举的注释。 |
联合字段 media_asset 。构成广告的素材资源数据。media_asset 只能是下列其中一项: |
|
mediaBundle |
要在广告中使用的媒体包素材资源。有关适用于 HTML5_UPLOAD_AD 的媒体包的信息,请参阅 https://support.google.com/google-ads/answer/1722096 属于动态产品类型一部分的媒体包使用一种特殊格式,该格式需要通过 Google Web Designer 创建。如需了解详情,请参阅 https://support.google.com/webdesigner/answer/7543898。 |
DisplayUploadProductType
枚举与展示广告上传相关的商品类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
此版本中的值未知。 |
HTML5_UPLOAD_AD |
HTML5 上传广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。 |
DYNAMIC_HTML5_EDUCATION_AD |
HTML5 动态教育广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于教育广告系列。 |
DYNAMIC_HTML5_FLIGHT_AD |
HTML5 动态航班广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于投放广告系列。 |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
动态 HTML5 酒店及房屋租赁广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于酒店广告系列。 |
DYNAMIC_HTML5_JOB_AD |
动态 HTML5 求职招聘广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于求职招聘广告系列。 |
DYNAMIC_HTML5_LOCAL_AD |
动态 HTML5 本地广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于本地广告系列。 |
DYNAMIC_HTML5_REAL_ESTATE_AD |
动态 HTML5 房地产广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于房地产广告系列。 |
DYNAMIC_HTML5_CUSTOM_AD |
动态 HTML5 自定义广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于自定义广告系列。 |
DYNAMIC_HTML5_TRAVEL_AD |
动态 HTML5 旅游广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于旅游广告系列。 |
DYNAMIC_HTML5_HOTEL_AD |
动态 HTML5 酒店广告。对于此商品类型,需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于酒店广告系列。 |
AppEngagementAdInfo
利用应用互动广告,您可以撰写旨在鼓励用户在应用中采取特定操作(比如登记、购买或预订机票)的广告文字。通过自适应展示广告,您可以将用户引导至您应用的特定部分,以便他们更轻松快捷地找到所需内容。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
images[] |
可以与广告一起展示的图片素材资源列表。 |
videos[] |
可与广告一起展示的视频素材资源列表。 |
ShoppingComparisonListingAdInfo
比价购物广告。
JSON 表示法 |
---|
{ "headline": string } |
字段 | |
---|---|
headline |
广告的标题。必须填写此字段。允许的长度介于 25 到 45 个字符之间。 |
AppPreRegistrationAdInfo
应用预注册广告会链接到您在 Google Play 上的应用或游戏详情,并且可以在 Google Play、YouTube(仅限插播广告)以及展示广告网络中的其他应用和移动网站上投放。这有助于激发用户对应用或游戏的兴趣,并在应用或游戏发布前预先吸引安装群体。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
images[] |
图片素材资源 ID 列表,其中的图片可与广告一起显示。 |
youtubeVideos[] |
YouTube 视频资产 ID 列表,其中的视频可与广告一起展示。 |
DemandGenMultiAssetAdInfo
一种多素材资源需求开发广告。
JSON 表示法 |
---|
{ "marketingImages": [ { object ( |
字段 | |
---|---|
marketingImages[] |
要在广告中使用的营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x314,宽高比必须为 1.91:1 (+-1%)。如果不存在 squareMarketingImages,则该属性为必需。与 |
squareMarketingImages[] |
在广告中使用的方形营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 300x300,宽高比必须为 1:1 (+-1%)。如果 marketingImages 不存在,则为必需。与 |
portraitMarketingImages[] |
在广告中使用的纵向营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 480x600,宽高比必须为 4:5 (+-1%)。与 |
logoImages[] |
要在广告中使用的徽标图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。可以指定至少 1 个到 5 个徽标图片。 |
headlines[] |
广告的标题文字素材资源。显示宽度上限为 30。可以指定至少 1 个和最多 5 个标题。 |
descriptions[] |
广告的描述性文字。最大显示宽度为 90。可以指定至少 1 到 5 条广告内容描述。 |
businessName |
广告客户/品牌名称。最大显示宽度为 25。必填。 |
callToActionText |
号召性用语文字。 |
leadFormOnly |
指示此广告是否必须与潜在客户表单一起投放的布尔值选项。 |
DemandGenCarouselAdInfo
轮播式需求开发广告。
JSON 表示法 |
---|
{ "businessName": string, "logoImage": { object ( |
字段 | |
---|---|
businessName |
必需。广告客户/品牌名称。 |
logoImage |
必需。在广告中使用的徽标图片。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。 |
headline |
必需。广告的标题。 |
description |
必需。广告的描述性文字。 |
callToActionText |
号召性用语文字。 |
carouselCards[] |
必需。随广告一起展示的轮播卡片。最小值 2 最大值 10。 |
AdDemandGenCarouselCardAsset
在广告中使用的需求开发轮播卡片素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此轮播式发现广告卡片的资产资源名称。 |
DemandGenVideoResponsiveAdInfo
需求开发视频自适应广告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
短标题所用文字素材资源的列表。 |
longHeadlines[] |
用于长标题的文字素材资源列表。 |
descriptions[] |
用于说明文字素材资源的列表。 |
videos[] |
广告所用 YouTube 视频素材资源的列表。 |
logoImages[] |
在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。 |
breadcrumb1 |
与显示网址一起在广告中显示的文字的第一部分。 |
breadcrumb2 |
与显示网址一起在广告中显示的文字的第二部分。 |
businessName |
必需。广告客户/品牌名称。 |
callToActions[] |
用于“号召性用语”的 CallToActionAsset 类型素材资源按钮。 |
AdCallToActionAsset
在广告中使用的号召性用语素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此号召性用语素材资源的资源名称。 |
DemandGenProductAdInfo
一个产品需求开发广告。
JSON 表示法 |
---|
{ "breadcrumb1": string, "breadcrumb2": string, "businessName": { object ( |
字段 | |
---|---|
breadcrumb1 |
与显示网址一起在广告中显示的文字的第一部分。 |
breadcrumb2 |
与显示网址一起在广告中显示的文字的第二部分。 |
businessName |
必需。广告客户/品牌名称。 |
headline |
必需。用于短标题的文字素材资源。 |
description |
必需。用于广告内容描述的文字素材资源。 |
logoImage |
必需。在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。 |
callToAction |
用于“号召性用语”的 CallToActionAsset 类型的素材资源按钮。 |
TravelAdInfo
此类型没有字段。
一则旅游广告。