- JSON 表示法
- FinalAppUrl
- AppUrlOperatingSystemType
- AdType
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- AdVideoAssetInfo
- AdVideoAssetInventoryPreferences
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- AdAppDeepLinkAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- AppPreRegistrationAdInfo
- DemandGenMultiAssetAdInfo
- DemandGenCarouselAdInfo
- AdDemandGenCarouselCardAsset
- DemandGenVideoResponsiveAdInfo
- AdCallToActionAsset
- DemandGenProductAdInfo
- TravelAdInfo
廣告。
JSON 表示法 |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
欄位 | |
---|---|
resourceName |
不可變動。廣告的資源名稱。廣告資源名稱的格式如下:
|
finalUrls[] |
廣告完成所有跨網域重新導向後,可能會導向的最終到達網址清單。 |
finalAppUrls[] |
使用者已安裝特定應用程式時,在行動裝置上使用的最終應用程式網址清單。 |
finalMobileUrls[] |
廣告的所有跨網域重新導向後,可能的最終行動版網址清單。 |
urlCustomParameters[] |
可用於在 |
type |
僅供輸出。廣告類型。 |
devicePreference |
廣告的裝置偏好設定。您只能指定行動裝置的偏好設定。設定這項偏好設定後,系統會在行動裝置上優先顯示這則廣告,廣告仍可顯示在其他裝置類型上,例如在沒有其他廣告可用的情況下。如果未指定 (沒有裝置偏好設定),則會指定所有裝置。只有部分廣告類型支援這項功能。 |
urlCollections[] |
廣告的其他網址,已標記專屬 ID,可從廣告中的其他欄位參照。 |
systemManagedResourceSource |
僅供輸出。如果這則廣告是由系統管理,這個欄位會顯示來源。這是唯讀欄位。 |
id |
僅供輸出。廣告編號。 |
trackingUrlTemplate |
用於建構追蹤網址的網址範本。 |
finalUrlSuffix |
建構最終到達網址時要使用的尾碼。 |
displayUrl |
部分廣告格式在廣告說明中顯示的網址。 |
addedByGoogleAds |
僅供輸出。表示這則廣告是由 Google Ads 自動新增,而非使用者新增。舉例來說,如果系統根據現有廣告的成效自動建立新廣告建議,就可能發生這種情況。 |
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_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
標有專屬 ID 的網址集合。
JSON 表示法 |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
欄位 | |
---|---|
finalUrls[] |
可能的最終到達網址清單。 |
finalMobileUrls[] |
可能的最終行動版網址清單。 |
urlCollectionId |
這個 UrlCollection 例項的專屬 ID。 |
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 |
圖片名稱。如果圖片是使用 MediaFile 建立,則為 MediaFile 的名稱。如果圖片是使用位元組建立,則此值為空白。 |
聯集欄位 image 。要用來建立 ImageAd 的圖片。您可以透過下列兩種方式的其中之一指定此值。1. 現有的 MediaFile 資源。2. 原始圖片資料以位元組為單位。image 只能是下列其中一項: |
|
imageAsset |
廣告使用的圖片素材資源。 |
data |
原始圖片資料以位元組為單位。 Base64 編碼字串。 |
adIdToCopyImageFrom |
廣告 ID 複製圖片來源 |
AdImageAsset
廣告中使用的圖片素材資源。
JSON 表示法 |
---|
{ "asset": string } |
欄位 | |
---|---|
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 的廣告空間偏好設定清單。這個欄位只能用於設定探索廣告回應式影片廣告。在放送期間,系統會優先使用已設定廣告空間素材資源偏好設定的影片素材資源,而非同一個廣告中的其他影片。舉例來說,假設這則廣告放送至特定廣告空間。伺服器會先嘗試比對符合該廣告空間偏好的影片。只有在找不到符合偏好設定且可用於特定廣告插播位置的影片時,系統才會選擇沒有偏好設定的影片。 |
AdVideoAssetInventoryPreferences
YouTube 影片素材資源的廣告空間偏好設定。
JSON 表示法 |
---|
{ "inFeedPreference": boolean, "inStreamPreference": boolean, "shortsPreference": boolean } |
欄位 | |
---|---|
inFeedPreference |
如果為 true,選擇在動態消息中放送的影片時,系統會優先使用具有此廣告空間偏好設定的 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
代表串流外影片廣告格式 (廣告會與動態消息一同顯示,並自動播放,但沒有聲音)。
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 就會自動測試各種不同的組合,逐漸找出成效最佳者。回應式搜尋廣告會根據潛在顧客的搜尋字詞顯示關聯性更高的廣告內容,因此有助於提升廣告活動成效。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
欄位 | |
---|---|
headlines[] |
標題的文字素材資源清單。廣告放送時,系統會從這份清單中選取標題。 |
descriptions[] |
說明文字的文字素材資源清單。廣告放送時,系統會從這份清單中選取說明。 |
path1 |
可附加至廣告網址的文字第一部分。 |
path2 |
可附加至廣告網址的文字第二部分。只有在 |
LegacyResponsiveDisplayAdInfo
舊版回應式多媒體廣告。這類廣告在 Google Ads 使用者介面中標示為「回應式廣告」。
JSON 表示法 |
---|
{
"formatSetting": enum ( |
欄位 | |
---|---|
formatSetting |
指定廣告的放送格式。預設值為 ALL_FORMATS。 |
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[] |
可與廣告搭配使用的媒體套件素材資源清單。 |
appDeepLink |
可與廣告搭配使用的應用程式深層連結素材資源。 |
AdMediaBundleAsset
廣告中使用的媒體組合素材資源。
JSON 表示法 |
---|
{ "asset": string } |
欄位 | |
---|---|
asset |
這個媒體組合的 Asset 資源名稱。 |
AdAppDeepLinkAsset
廣告中使用的應用程式深層連結。
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。最低尺寸為 600 x 314,顯示比例必須是 1.91:1 (+-1%)。至少需要一個 |
squareMarketingImages[] |
要用於廣告的正方形行銷圖片。有效的圖片類型為 GIF、JPEG 和 PNG。最小尺寸為 300 x 300,顯示比例必須為 1:1 (+-1%)。至少須有一個方形 |
logoImages[] |
要在廣告中使用的標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。最小尺寸為 512 x 128,顯示比例必須是 4:1 (+-1%)。與 |
squareLogoImages[] |
要在廣告中使用的正方形標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128 x 128,顯示比例必須為 1:1 (+-1%)。與 |
headlines[] |
廣告的短格式廣告標題。長度上限為 30 個半形字元。最多可指定 5 個廣告標題。 |
longHeadline |
必須提供長廣告標題。長度上限為 90 個半形字元。 |
descriptions[] |
廣告的說明文字。長度上限為 90 個半形字元。最多可指定 5 個廣告標題。 |
youtubeVideos[] |
廣告的選用 YouTube 影片。最多可指定 5 部影片。 |
formatSetting |
指定廣告的放送格式。預設值為 ALL_FORMATS。 |
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[] |
列出可能與廣告一併顯示的標誌圖像素材資源。圖片必須為 128 x 128 像素,且大小不得超過 120 KB。至少須指定 1 項,最多 5 項圖片素材資源。 |
videos[] |
列出可能與廣告一併顯示的 YouTube 影片素材資源。必須指定至少 1 個,最多 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。最低尺寸為 600 x 314,顯示比例必須是 1.91:1 (+-1%)。如果沒有 squareMarketingImages,則為必填項目。與 |
squareMarketingImages[] |
要在廣告中使用的正方形行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。最小尺寸為 300 x 300,顯示比例必須為 1:1 (+-1%)。如果沒有 marketingImages,則為必要屬性。與 |
portraitMarketingImages[] |
要在廣告中使用的直向行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。最小尺寸為 480 x 600,顯示比例必須為 4:5 (+-1%)。與 |
tallPortraitMarketingImages[] |
要用於廣告的長型直向行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。最小尺寸為 600x1067,顯示比例必須為 9:16 (+-1%)。與 |
logoImages[] |
要在廣告中使用的標誌圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128 x 128,顯示比例必須為 1:1 (+-1%)。最多可指定 5 張標誌圖片。 |
headlines[] |
廣告的標題文字素材資源。顯示寬度上限為 30。最多可指定 5 個廣告標題。 |
descriptions[] |
廣告的說明文字。顯示寬度上限為 90。最多可指定 5 則說明。 |
businessName |
廣告主/品牌名稱。顯示寬度上限為 25。必填。 |
callToActionText |
行動號召文字。 |
leadFormOnly |
布林值選項,指出這則廣告是否必須與待開發客戶表單一併放送。 |
DemandGenCarouselAdInfo
需求開發輪轉廣告。
JSON 表示法 |
---|
{ "businessName": string, "logoImage": { object ( |
欄位 | |
---|---|
businessName |
必要欄位。廣告主/品牌名稱。 |
logoImage |
必要欄位。要在廣告中使用的標誌圖片。大小下限為 128 x 128,顯示比例必須為 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。大小下限為 128 x 128,顯示比例必須為 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。大小下限為 128 x 128,顯示比例必須為 1:1 (+-1%)。 |
callToAction |
用於「行動號召」按鈕的 CallToActionAsset 類型素材資源。 |
TravelAdInfo
這個類型沒有任何欄位。
旅遊廣告。