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)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "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。
primaryStatus

enum (AdGroupPrimaryStatus)

僅供輸出。綜覽資料，以便瞭解廣告群組無法放送或未最佳放送的原因。
primaryStatusReasons[]

enum (AdGroupPrimaryStatusReason)

僅供輸出。說明廣告群組無法放送或無法正常放送的原因。
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 * [尺度]。
finalUrlSuffix

string

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

string (int64 format)

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

number

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

AdGroupStatus

廣告群組的可能狀態。

列舉
UNSPECIFIED 尚未指定狀態。
UNKNOWN

這個版本無法得知接收到的值。

這個值僅供回應使用。
ENABLED 廣告群組已啟用。
PAUSED 廣告群組已暫停。
REMOVED 廣告群組已移除。

AdGroupAdRotationMode

廣告群組可能的廣告輪播模式。

列舉
UNSPECIFIED 尚未指定廣告輪播模式。
UNKNOWN

這個版本無法得知接收到的值。

這個值僅供回應使用。
OPTIMIZE 根據點擊或轉換最佳化廣告群組廣告。
ROTATE_FOREVER 永遠平均輪播。

AudienceSetting

指定目標對象的設定。

JSON 表示法 
{
  "useAudienceGrouped": boolean
}
欄位
useAudienceGrouped

boolean

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

AdGroupPrimaryStatus

廣告群組的可能狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ELIGIBLE 廣告群組符合放送資格。
PAUSED 廣告群組已暫停。
REMOVED 廣告群組已移除。
PENDING 該廣告群組日後可能會放送。
NOT_ELIGIBLE 這個廣告群組不符合放送資格。
LIMITED 廣告群組的放送權限受限。

AdGroupPrimaryStatusReason

可能的廣告群組狀態原因。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
CAMPAIGN_REMOVED 使用者指定的廣告活動狀態已移除。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
CAMPAIGN_PAUSED 使用者指定的廣告活動狀態已暫停。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
CAMPAIGN_PENDING 這個廣告活動的放送時間設在未來。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻
CAMPAIGN_ENDED 這個廣告活動的目標使用者指定時間已過。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
AD_GROUP_PAUSED 使用者指定的廣告群組狀態已暫停。為 adPrimaryStatus.PAUSED 提供貢獻。
AD_GROUP_REMOVED 使用者指定的廣告群組狀態已移除。支援 個廣告群組 PrimaryStatus.REMOVED。
AD_GROUP_INCOMPLETE 這個廣告群組的建立作業尚未完成。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
KEYWORDS_PAUSED 這個廣告群組中使用者指定的關鍵字狀態目前都處於暫停狀態。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
NO_KEYWORDS 這個廣告群組中沒有符合資格的關鍵字。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
AD_GROUP_ADS_PAUSED 這個廣告群組中使用者指定的廣告群組廣告狀態都已暫停。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
NO_AD_GROUP_ADS 這個廣告群組中沒有符合資格的廣告群組廣告。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
HAS_ADS_DISAPPROVED 至少有一則廣告遭到拒登時的政策狀態原因。為多個 廣告群組 PrimaryStatus 提供協助。
HAS_ADS_LIMITED_BY_POLICY 至少有一則廣告受到政策限制時，政策狀態原因。為多個 廣告群組 PrimaryStatus 提供協助。
MOST_ADS_UNDER_REVIEW 多數廣告正在等候審查時的政策狀態原因。為 adPrimaryStatus.PENDING 提供貢獻。
CAMPAIGN_DRAFT 該廣告群組所屬的廣告活動。為 adPrimaryStatus.NOT_ELIGIBLE 提供貢獻。
AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY 廣告群組因活動量過低而暫停。為 adPrimaryStatus.PAUSED 提供貢獻。