廣告群組。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
欄位 | |
---|---|
resourceName |
無法變更。廣告群組的資源名稱。廣告群組資源名稱的格式為:
|
status |
廣告群組的狀態。 |
type |
無法變更。廣告群組的類型。 |
adRotationMode |
廣告群組的廣告輪播模式。 |
urlCustomParameters[] |
這份對應清單是用於取代 |
optimizedTargetingEnabled |
如果已啟用最佳化指定目標對像功能,則為 True。最佳化指定目標對象取代目標對象擴展。 |
displayCustomBidDimension |
可讓廣告主指定要執行絕對出價的指定目標維度。這種情況僅適用於只指定多媒體廣告聯播網,並未指定搜尋聯播網的廣告活動。 |
targetingSetting |
指定目標相關功能的設定。 |
audienceSetting |
無法變更。目標對象相關功能設定。 |
effectiveTargetCpaSource |
僅供輸出。有效目標單次轉換出價的來源。這是唯讀欄位。 |
effectiveTargetRoasSource |
僅供輸出。有效目標廣告投資報酬率的來源。這是唯讀欄位。 |
labels[] |
僅供輸出。這個廣告群組所附加標籤的資源名稱。 |
excludedParentAssetFieldTypes[] |
應從這個廣告群組排除的素材資源欄位類型。這個廣告群組不會沿用包含這些欄位類型的素材資源連結。 |
excludedParentAssetSetTypes[] |
應從這個廣告群組排除的素材資源組合類型。這個廣告群組不會沿用較高層級的素材資源組合連結。地區群組類型 (GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP 和 STATIC_LOCATION_GROUP) 是 LOCATION_SYNC 的子項類型。因此,如果這個欄位已設定 LOCATION_SYNC,所有地區群組素材資源組合就無法連結至這個廣告群組,而且所有地點額外資訊 (LE) 和經銷地點額外資訊 (ALE) 都不會在這個廣告群組中放送。目前僅支援 LOCATION_SYNC。 |
id |
僅供輸出。廣告群組的 ID。 |
name |
廣告群組的名稱。 這是必填欄位,新建廣告群組時不得留空。 最多只能包含 255 個 UTF-8 全形字元。 而且不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 |
baseAdGroup |
僅供輸出。如果是草稿或實驗廣告群組,這個欄位是建立此廣告群組的基礎廣告群組的資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,則這個欄位為空值。 如果是基礎廣告群組,這個欄位等同於廣告群組資源名稱。 這是唯讀欄位。 |
trackingUrlTemplate |
用來建構追蹤網址的網址範本。 |
campaign |
無法變更。廣告群組所屬的廣告活動。 |
cpcBidMicros |
最高單次點擊出價。 |
effectiveCpcBidMicros |
僅供輸出。出價策略的值會是「手動單次點擊出價」、「成本效益管理系統」、「宣傳排名勝出率」或「目標排名勝出率」的出價策略,否則其值會是空值。 |
cpmBidMicros |
最高千次曝光出價。 |
targetCpaMicros |
目標單次轉換出價。如果廣告群組的廣告活動出價策略是「TargetCpa」或「盡量爭取轉換」(設有 targetCpa 欄位),則這個欄位會覆寫廣告活動出價策略中指定的目標單次轉換出價。否則系統會忽略這個值。 |
cpvBidMicros |
單次收視出價。 |
targetCpmMicros |
廣告客戶願意為每千次廣告曝光支付的平均金額 (以百萬分之一表示)。 |
targetRoas |
目標廣告投資報酬率會覆寫目標廣告投資報酬率。如果廣告群組的廣告活動出價策略是 TargetRoas 或 MaxConversionValue (已設定 targetRoas 欄位),則此欄位會覆寫廣告活動出價策略中指定的目標廣告投資報酬率。否則系統會忽略這個值。 |
percentCpcBidMicros |
單次點擊出價百分比,以某些商品或服務的廣告價格一小部分表示。分數的有效範圍為 [0,1],此處儲存的值是 1,000,000 * [fraction]。 |
finalUrlSuffix |
用於將參數附加至最終到達網址的網址範本。 |
effectiveTargetCpaMicros |
僅供輸出。有效目標單次轉換出價。這是唯讀欄位。 |
effectiveTargetRoas |
僅供輸出。有效的目標廣告投資報酬率。這是唯讀欄位。 |
AdGroupStatus
廣告群組可能的狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定狀態。 |
UNKNOWN |
這個版本不支援收到的值。 此值僅用於回應。 |
ENABLED |
廣告群組已啟用。 |
PAUSED |
廣告群組已暫停。 |
REMOVED |
廣告群組已移除。 |
AdGroupType
列舉廣告群組可能的類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定類型。 |
UNKNOWN |
這個版本不支援收到的值。 此值僅用於回應。 |
SEARCH_STANDARD |
搜尋廣告活動的預設廣告群組類型。 |
DISPLAY_STANDARD |
多媒體廣告活動的預設廣告群組類型。 |
SHOPPING_PRODUCT_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 |
平均輪播。 |
AudienceSetting
指定目標對象的設定。
JSON 表示法 |
---|
{ "useAudienceGrouped": boolean } |
欄位 | |
---|---|
useAudienceGrouped |
無法變更。如果為 true,這個廣告群組會使用目標對象資源來指定目標對象。如果設為 false,這個廣告群組可能會改用目標對象區隔條件。 |