AdGroup

廣告群組。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}
欄位
resourceName

string

無法變更。廣告群組的資源名稱。廣告群組資源名稱的格式為：

customers/{customerId}/adGroups/{adGroupId}
status

enum (AdGroupStatus)

廣告群組的狀態。
type

enum (AdGroupType)

無法變更。廣告群組的類型。
adRotationMode

enum (AdGroupAdRotationMode)

廣告群組的廣告輪播模式。
urlCustomParameters[]

object (CustomParameter)

這份對應清單是用於取代 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中的自訂參數代碼。
optimizedTargetingEnabled

boolean

如果已啟用最佳化指定目標對像功能，則為 True。最佳化指定目標對象取代目標對象擴展。
displayCustomBidDimension

enum (TargetingDimension)

可讓廣告主指定要執行絕對出價的指定目標維度。這種情況僅適用於只指定多媒體廣告聯播網，並未指定搜尋聯播網的廣告活動。
targetingSetting

object (TargetingSetting)

指定目標相關功能的設定。
audienceSetting

object (AudienceSetting)

無法變更。目標對象相關功能設定。
effectiveTargetCpaSource

enum (BiddingSource)

僅供輸出。有效目標單次轉換出價的來源。這是唯讀欄位。
effectiveTargetRoasSource

enum (BiddingSource)

僅供輸出。有效目標廣告投資報酬率的來源。這是唯讀欄位。
labels[]

string

僅供輸出。這個廣告群組所附加標籤的資源名稱。
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

應從這個廣告群組排除的素材資源欄位類型。這個廣告群組不會沿用包含這些欄位類型的素材資源連結。
excludedParentAssetSetTypes[]

enum (AssetSetType)

應從這個廣告群組排除的素材資源組合類型。這個廣告群組不會沿用較高層級的素材資源組合連結。地區群組類型 (GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP 和 STATIC_LOCATION_GROUP) 是 LOCATION_SYNC 的子項類型。因此，如果這個欄位已設定 LOCATION_SYNC，所有地區群組素材資源組合就無法連結至這個廣告群組，而且所有地點額外資訊 (LE) 和經銷地點額外資訊 (ALE) 都不會在這個廣告群組中放送。目前僅支援 LOCATION_SYNC。
id

string (int64 format)

僅供輸出。廣告群組的 ID。
name

string

廣告群組的名稱。

這是必填欄位，新建廣告群組時不得留空。

最多只能包含 255 個 UTF-8 全形字元。

而且不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
baseAdGroup

string

僅供輸出。如果是草稿或實驗廣告群組，這個欄位是建立此廣告群組的基礎廣告群組的資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組，則這個欄位為空值。

如果是基礎廣告群組，這個欄位等同於廣告群組資源名稱。

這是唯讀欄位。
trackingUrlTemplate

string

用來建構追蹤網址的網址範本。
campaign

string

無法變更。廣告群組所屬的廣告活動。
cpcBidMicros

string (int64 format)

最高單次點擊出價。
effectiveCpcBidMicros

string (int64 format)

僅供輸出。出價策略的值會是「手動單次點擊出價」、「成本效益管理系統」、「宣傳排名勝出率」或「目標排名勝出率」的出價策略，否則其值會是空值。
cpmBidMicros

string (int64 format)

最高千次曝光出價。
targetCpaMicros

string (int64 format)

目標單次轉換出價。如果廣告群組的廣告活動出價策略是「TargetCpa」或「盡量爭取轉換」(設有 targetCpa 欄位)，則這個欄位會覆寫廣告活動出價策略中指定的目標單次轉換出價。否則系統會忽略這個值。
cpvBidMicros

string (int64 format)

單次收視出價。
targetCpmMicros

string (int64 format)

廣告客戶願意為每千次廣告曝光支付的平均金額 (以百萬分之一表示)。
targetRoas

number

目標廣告投資報酬率會覆寫目標廣告投資報酬率。如果廣告群組的廣告活動出價策略是 TargetRoas 或 MaxConversionValue (已設定 targetRoas 欄位)，則此欄位會覆寫廣告活動出價策略中指定的目標廣告投資報酬率。否則系統會忽略這個值。
percentCpcBidMicros

string (int64 format)

單次點擊出價百分比，以某些商品或服務的廣告價格一小部分表示。分數的有效範圍為 [0,1]，此處儲存的值是 1,000,000 * [fraction]。
finalUrlSuffix

string

用於將參數附加至最終到達網址的網址範本。
effectiveTargetCpaMicros

string (int64 format)

僅供輸出。有效目標單次轉換出價。這是唯讀欄位。
effectiveTargetRoas

number

僅供輸出。有效的目標廣告投資報酬率。這是唯讀欄位。

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

boolean

無法變更。如果為 true，這個廣告群組會使用目標對象資源來指定目標對象。如果設為 false，這個廣告群組可能會改用目標對象區隔條件。