Campaign

廣告活動。

JSON 表示法 
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
欄位
resourceName

string

不可變動。廣告活動的資源名稱。廣告活動資源名稱的格式如下：

customers/{customerId}/campaigns/{campaignId}
primaryStatus

enum (CampaignPrimaryStatus)

僅供輸出。廣告活動的主要狀態。

提供廣告活動無法放送或無法放送的最佳方式的洞察資料。廣告活動及其相關實體的修改內容可能需要一段時間才會反映在這個狀態中。
primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

僅供輸出。廣告活動的主要狀態原因。

提供廣告活動無法放送或無法放送的最佳方式的洞察資料。系統會匯總這些原因，藉此判斷整體 CampaignPrimaryStatus。
status

enum (CampaignStatus)

廣告活動的狀態。

新增廣告活動時，狀態預設為「已啟用」。
servingStatus

enum (CampaignServingStatus)

僅供輸出。廣告活動的廣告放送狀態。
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

僅供輸出。廣告活動出價策略的系統狀態。
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

廣告活動的廣告放送最佳化狀態。
advertisingChannelType

enum (AdvertisingChannelType)

不可變動。廣告活動中廣告的主要放送目標。您可以在 networkSettings 中調整指定目標選項。

這個欄位為必填欄位，建立新廣告活動時不得留空。

只能在建立廣告活動時設定。廣告活動建立完成後，就無法變更這個欄位。
advertisingChannelSubType

enum (AdvertisingChannelSubType)

不可變動。可選的 advertisingChannelType 精修項目。必須是父項管道類型的有效子類型。

只能在建立廣告活動時設定。廣告活動建立完成後，就無法變更這個欄位。
urlCustomParameters[]

object (CustomParameter)

用於在 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中替換自訂參數代碼的對應項目清單。
localServicesCampaignSettings

object (LocalServicesCampaignSettings)

在地生活服務廣告活動相關設定。
travelCampaignSettings

object (TravelCampaignSettings)

旅遊廣告活動的設定。
demandGenCampaignSettings

object (DemandGenCampaignSettings)

需求開發廣告活動的設定。
videoCampaignSettings

object (VideoCampaignSettings)

影片廣告活動的設定。
realTimeBiddingSetting

object (RealTimeBiddingSetting)

即時出價設定，這項功能僅適用於指定 Ad Exchange 聯播網的廣告活動。
networkSettings

object (NetworkSettings)

廣告活動的聯播網設定。
hotelSetting

object (HotelSettingInfo)

不可變動。廣告活動的飯店設定。
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

用於控制動態搜尋廣告 (DSA) 的設定。
shoppingSetting

object (ShoppingSetting)

用於控制購物廣告活動的設定。
targetingSetting

object (TargetingSetting)

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

object (GeoTargetTypeSetting)

廣告地理指定目標的設定。
localCampaignSetting

object (LocalCampaignSetting)

在地廣告活動的設定。
appCampaignSetting

object (AppCampaignSetting)

與應用程式廣告活動相關的設定。
labels[]

string

僅供輸出。附加至這個廣告活動的標籤資源名稱。
experimentType

enum (CampaignExperimentType)

僅供輸出。廣告活動類型：正常、草稿或實驗。
biddingStrategyType

enum (BiddingStrategyType)

僅供輸出。出價策略類型。

您可以設定出價企劃書來建立標準出價策略，也可以設定 biddingStrategy 欄位來建立組合出價策略，藉此建立出價策略。

這是唯讀欄位。
accessibleBiddingStrategy

string

僅供輸出。AccessibleBiddingStrategy 的資源名稱，這是「biddingStrategy」所識別的已附加組合出價策略的無限制屬性唯讀檢視畫面。如果廣告活動未使用組合策略，則為空白。所有共用策略的客戶都能使用無限制策略屬性，這些屬性會從 AccessibleBiddingStrategy 資源讀取。相反地，只有策略擁有者客戶和其管理員可以使用受限制的屬性。受限屬性只能從 BiddingStrategy 資源讀取。
frequencyCaps[]

object (FrequencyCapEntry)

限制每位使用者看到此廣告活動廣告的頻率。
videoBrandSafetySuitability

enum (BrandSafetySuitability)

個別廣告活動層級的品牌安全設定。可讓您選取廣告空間類型，在符合品牌形象的內容中顯示廣告。請參閱 https://support.google.com/google-ads/answer/7515513。
vanityPharma

object (VanityPharma)

說明沒有品牌標誌的藥品廣告如何顯示。
selectiveOptimization

object (SelectiveOptimization)

這個廣告活動的選擇性最佳化設定，包括一組轉換動作，用於為這個廣告活動進行最佳化。這項功能僅適用於使用 MULTI_CHANNEL 做為 AdvertisingChannelType，以及使用 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 做為 AdvertisingChannelSubType 的應用程式廣告活動。
optimizationGoalSetting

object (OptimizationGoalSetting)

這個廣告活動的最佳化目標設定，包括一組最佳化目標類型。
trackingSetting

object (TrackingSetting)

僅供輸出。追蹤資訊的廣告活動層級設定。
paymentMode

enum (PaymentMode)

廣告活動的付款模式。
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。
performanceMaxUpgrade

object (PerformanceMaxUpgrade)

僅供輸出。有關升級為最高成效廣告活動的廣告活動資訊。
assetAutomationSettings[]

object (AssetAutomationSetting)

包含每個 AssetAutomationType 的選擇加入/退出狀態。請參閱各項素材資源自動化類型列舉的說明文件，瞭解預設的選擇加入/退出行為。
keywordMatchType

enum (CampaignKeywordMatchType)

廣告活動的關鍵字比對類型。將比對類型設為「廣泛」，即可為廣告活動中的所有關鍵字設定廣泛比對。
id

string (int64 format)

僅供輸出。廣告活動 ID。
name

string

廣告活動名稱。

這個欄位為必填欄位，建立新廣告活動時不得留空。

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

string

用於建構追蹤網址的網址範本。
audienceSetting

object (AudienceSetting)

不可變動。目標對象相關功能的設定。
baseCampaign

string

僅供輸出。草稿或實驗廣告活動的基礎廣告活動資源名稱。對於基礎廣告活動，這個值等於 resourceName。

這是唯讀欄位。
campaignBudget

string

廣告活動預算的資源名稱。
startDate

string

廣告活動在服務對象客戶所在時區開始的日期，格式為 YYYY-MM-DD。
campaignGroup

string

這個廣告活動所屬廣告活動群組的資源名稱。
endDate

string

以 YYYY-MM-DD 格式顯示的廣告活動結束日，以服務對象所在時區為準。建立廣告活動時，預設為 2037 年 12 月 30 日，表示廣告活動會無限期放送。如要將現有廣告活動設為無限期放送，請將這個欄位設為 2037-12-30。
finalUrlSuffix

string

尾碼，用於在透過並行追蹤放送的到達網頁中附加查詢參數。
optimizationScore

number

僅供輸出。廣告活動的最佳化分數。

最佳化分數可用來預估廣告活動設定可能達到的成效。分數範圍為 0% (0.0) 到 100% (1.0)，100% 代表廣告活動能全面發揮效益。未評分的廣告活動的這個欄位為空值。

請參閱「關於最佳化分數」：https://support.google.com/google-ads/answer/9061546。

這是唯讀欄位。
urlExpansionOptOut

boolean

代表已停用網址擴充功能，以便指定更多網址。如果已停用 (值為 true)，系統只會指定素材資源群組中的最終到達網址，或是廣告客戶在 Google Merchant Center 或業務資料動態饋給中指定的網址。如果已選擇 (false)，則會指定整個網域。這個欄位只能設定最高成效廣告活動，預設值為 false。
hotelPropertyAssetSet

string

不可變動。旅遊目標專用最高成效廣告活動中飯店房源組合的資源名稱。
listingType

enum (ListingType)

不可變動。這個廣告活動放送的廣告類型。此欄位僅限用於最高成效廣告活動。

聯集欄位 campaign_bidding_strategy。廣告活動的出價策略。

必須是嵌入廣告活動的組合 (透過 BiddingStrategy 服務建立) 或標準出價策略。campaign_bidding_strategy 只能是下列其中一項：
biddingStrategy

string

廣告活動使用的組合出價策略資源名稱。
commission

object (Commission)

佣金是一種自動出價策略，廣告客戶只需支付轉換價值的特定部分。
manualCpa

object (ManualCpa)

標準手動單次轉換出價策略。手動出價策略，可讓廣告主為廣告主指定的動作設定出價。僅適用於在地生活服務廣告活動。
manualCpc

object (ManualCpc)

標準手動單次點擊出價策略。使用者按次付費的手動點擊出價。
manualCpm

object (ManualCpm)

標準手動千次曝光出價策略。手動曝光出價，使用者以每千次曝光付費。
manualCpv

object (ManualCpv)

這是一種出價策略，可設定每次影片觀看的付費金額。
maximizeConversions

object (MaximizeConversions)

標準的「盡量爭取轉換」出價策略，可在預算範圍內自動爭取最多轉換。
maximizeConversionValue

object (MaximizeConversionValue)

標準的「盡量提高轉換價值」出價策略會自動設定出價，在預算範圍內盡量提高收益。
targetCpa

object (TargetCpa)

這是一種標準的目標單次轉換出價策略，可自動設定出價，按您設定的目標單次轉換出價盡量爭取轉換。
targetImpressionShare

object (TargetImpressionShare)

目標曝光比重出價策略。這是一種自動出價策略，可設定出價，以達到所選曝光百分比。
targetRoas

object (TargetRoas)

標準目標廣告投資報酬率出價策略：自動提高收益，同時平均達到特定目標廣告投資報酬率 (ROAS)。
targetSpend

object (TargetSpend)

這是一種自動設定出價的出價策略，旨在協助您在預算範圍內盡量爭取點擊。
percentCpc

object (PercentCpc)

標準單次點擊出價百分比出價策略，出價是某些商品或服務廣告價格的一部分。
targetCpm

object (TargetCpm)

自動調整千次曝光出價的出價策略。
fixedCpm

object (FixedCpm)

採用固定千次曝光出價的手動出價策略。
targetCpv

object (TargetCpv)

這是一種自動出價策略，可根據您設定的目標單次轉換費用，設定出價以提升成效。

CampaignPrimaryStatus

列舉說明可能的廣告活動主要狀態。提供廣告活動無法放送或無法放送的最佳方式的洞察資料。廣告活動及其相關實體的修改內容可能需要一段時間才會反映在這個狀態中。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ELIGIBLE 廣告活動符合放送資格。
PAUSED 使用者指定的廣告活動狀態已暫停。
REMOVED 系統會移除使用者指定的廣告活動狀態。
ENDED 使用者指定的廣告活動結束時間已過。
PENDING 廣告活動日後可能會放送。
MISCONFIGURED 廣告活動或相關聯的實體有使用者指定的設定不正確。
LIMITED 廣告活動或相關實體受到使用者指定設定的限制。
LEARNING 自動出價系統會根據使用者指定的廣告活動或相關實體變更進行調整。
NOT_ELIGIBLE 廣告活動不符合放送資格。

CampaignPrimaryStatusReason

列舉說明可能的廣告活動主要狀態原因。提供廣告活動無法放送或無法放送的最佳方式的洞察資料。系統會匯總這些原因，藉此判斷廣告活動的整體主要狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
CAMPAIGN_REMOVED 系統會移除使用者指定的廣告活動狀態。
CAMPAIGN_PAUSED 使用者指定的廣告活動狀態已暫停。
CAMPAIGN_PENDING 使用者指定的廣告活動開始時間為未來時間。
CAMPAIGN_ENDED 使用者指定的廣告活動結束時間已過。
CAMPAIGN_DRAFT 廣告活動是草稿。
BIDDING_STRATEGY_MISCONFIGURED 出價策略的使用者指定設定有誤。
BIDDING_STRATEGY_LIMITED 出價策略受使用者指定的設定限制，例如缺少資料或類似情況。
BIDDING_STRATEGY_LEARNING 自動出價系統會根據使用者指定的出價策略變更進行調整。
BIDDING_STRATEGY_CONSTRAINED 調整廣告活動的單次轉換成本/廣告投資報酬率目標，或許能提高轉換價值。
BUDGET_CONSTRAINED 預算會限制廣告活動的放送能力。
BUDGET_MISCONFIGURED 預算含有使用者指定的錯誤設定。
SEARCH_VOLUME_LIMITED 廣告活動未指定所有相關查詢。
AD_GROUPS_PAUSED 使用者指定的廣告群組狀態都已暫停。
NO_AD_GROUPS 這個廣告活動中沒有符合資格的廣告群組。
KEYWORDS_PAUSED 使用者指定的關鍵字狀態都已暫停。
NO_KEYWORDS 這個廣告活動中沒有符合資格的關鍵字。
AD_GROUP_ADS_PAUSED 使用者指定的廣告群組廣告狀態都已暫停。
NO_AD_GROUP_ADS 這個廣告活動中沒有符合資格的廣告群組廣告。
HAS_ADS_LIMITED_BY_POLICY 這個廣告活動中至少有一則廣告受到政策限制。
HAS_ADS_DISAPPROVED 這個廣告活動中至少有一則廣告遭到拒登。
MOST_ADS_UNDER_REVIEW 這個廣告活動中的大多數廣告都正在審核中。
MISSING_LEAD_FORM_EXTENSION 廣告活動有待開發客戶表單目標，但沒有待開發客戶表單額外資訊。
MISSING_CALL_EXTENSION 這個廣告活動有來電目標，但沒有任何來電額外資訊。
LEAD_FORM_EXTENSION_UNDER_REVIEW 待開發客戶表單額外資訊仍在審核中。
LEAD_FORM_EXTENSION_DISAPPROVED 待開發客戶額外資訊遭拒登。
CALL_EXTENSION_UNDER_REVIEW 來電額外資訊正在審核中。
CALL_EXTENSION_DISAPPROVED 來電額外資訊遭拒登。
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA 這個廣告活動沒有符合資格的行動應用程式廣告群組條件。
CAMPAIGN_GROUP_PAUSED 使用者指定的廣告活動群組狀態已暫停。
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED 與父項廣告活動群組相關聯的所有群組預算，已超過使用者指定的時間。
APP_NOT_RELEASED 與這項 ACi 廣告活動相關聯的應用程式並未在廣告活動的指定國家/地區推出。
APP_PARTIALLY_RELEASED 與這個 ACi 廣告活動相關聯的應用程式，已在廣告活動的目標國家/地區部分推出。
HAS_ASSET_GROUPS_DISAPPROVED 這個廣告活動中至少有一個素材資源群組遭拒登。
HAS_ASSET_GROUPS_LIMITED_BY_POLICY 這個廣告活動中至少有一個素材資源群組受到政策限制。
MOST_ASSET_GROUPS_UNDER_REVIEW 這個廣告活動中的多數素材資源群組仍在審核中。
NO_ASSET_GROUPS 這個廣告活動沒有符合資格的素材資源群組。
ASSET_GROUPS_PAUSED 這個廣告活動中的所有素材資源群組都已暫停。

CampaignStatus

廣告活動的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ENABLED 廣告活動有效，可以放送廣告。
PAUSED 廣告活動已由使用者暫停。
REMOVED 廣告活動已移除。

CampaignServingStatus

廣告活動的可能放送狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援接收值。

這是僅供回應使用的值。
SERVING 服務中。
NONE 無。
ENDED 已結束。
PENDING Pending.
SUSPENDED 已停權。

BiddingStrategySystemStatus

BiddingStrategy 的可能系統狀態。

列舉
UNSPECIFIED 表示發生未預期的錯誤，例如找不到出價策略類型或狀態資訊。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ENABLED 這項出價策略正在運作，AdWords 沒有發現該策略有任何問題。
LEARNING_NEW 出價策略最近才建立或重新啟用，因此處於學習狀態。
LEARNING_SETTING_CHANGE 出價策略近期經過變更，因此處於學習狀態。
LEARNING_BUDGET_CHANGE 出價策略目前處於學習狀態，因為最近變更了預算。
LEARNING_COMPOSITION_CHANGE 出價策略近期的廣告活動、廣告群組或關鍵字數量發生變化，因此目前處於學習狀態。
LEARNING_CONVERSION_TYPE_CHANGE 出價策略會依據轉換報表，以及客戶最近修改的與出價策略相關的轉換類型。
LEARNING_CONVERSION_SETTING_CHANGE 出價策略依據轉換報表，而客戶最近變更了轉換設定。
LIMITED_BY_CPC_BID_CEILING 出價策略受出價上限限制。
LIMITED_BY_CPC_BID_FLOOR 出價策略受出價下限限制。
LIMITED_BY_DATA 過去幾週的轉換流量不足，因此出價策略受到限制。
LIMITED_BY_BUDGET 這項出價策略中的關鍵字，有相當一部分受到預算限制。
LIMITED_BY_LOW_PRIORITY_SPEND 出價策略的支出已降為次要，因此無法達到目標支出。
LIMITED_BY_LOW_QUALITY 這項出價策略中，有相當一部分關鍵字的品質分數偏低。
LIMITED_BY_INVENTORY 由於指定目標對象範圍太窄，出價策略無法完全用盡預算。
MISCONFIGURED_ZERO_ELIGIBILITY 缺少轉換追蹤 (沒有連線偵測) 和/或 SSC 再行銷名單。
MISCONFIGURED_CONVERSION_TYPES 出價策略依賴轉換報表，而客戶缺乏可根據這項策略回報的轉換類型。
MISCONFIGURED_CONVERSION_SETTINGS 出價策略取決於轉換報表，而客戶的轉換設定有誤。
MISCONFIGURED_SHARED_BUDGET 出價策略以外的廣告活動，會與策略中納入的廣告活動共用預算。
MISCONFIGURED_STRATEGY_TYPE 廣告活動採用無效的策略類型，因此無法放送。
PAUSED 出價策略未啟用。出價策略沒有任何有效的廣告活動、廣告群組或關鍵字。或者，沒有任何有效的預算連結至出價策略。
UNAVAILABLE 這項出價策略目前不支援狀態回報。
MULTIPLE_LEARNING 在問題期間，這項出價策略有多次 LEARNING_* 系統狀態。
MULTIPLE_LIMITED 在問題期間，這項出價策略有多次 LIMITED_* 系統狀態。
MULTIPLE_MISCONFIGURED 在問題期間，這項出價策略有多次 MISCONFIGURED_* 系統狀態。
MULTIPLE 在問題期間，這項出價策略有過多種系統狀態。

AdServingOptimizationStatus

列舉說明可能的放送狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援接收值。

這是僅供回應使用的值。
OPTIMIZE 廣告放送會根據廣告活動的點閱率進行最佳化。
CONVERSION_OPTIMIZE 廣告放送會根據廣告活動的點閱率 * 轉換次數進行最佳化。如果廣告活動未採用轉換最佳化工具出價策略，則預設為「最佳化」。
ROTATE 廣告會輪播 90 天，然後再改為「增加點擊」模式。
ROTATE_INDEFINITELY 與成效較佳的廣告輪播成效不佳的廣告，且不進行最佳化。
UNAVAILABLE 無法取得廣告放送最佳化狀態。

LocalServicesCampaignSettings

LocalServicesCampaign 子資源的設定。

JSON 表示法 
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
欄位
categoryBids[]

object (CategoryBid)

與 MANUAL_CPA 出價策略相關聯的類別層級出價。

CategoryBid

LocalServicesReportingCampaignSettings 中的類別出價。

JSON 表示法 
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
欄位
categoryId

string

要與出價建立關聯的類別。例如 xcat:service_area_business_plumber。
manualCpaBidMicros

string (int64 format)

類別的手動單次轉換出價。出價必須高於與該類別相關聯的預留價格。這個值會以微分和廣告客戶的貨幣計算。

TravelCampaignSettings

旅遊廣告活動的設定。

JSON 表示法 
{
  "travelAccountId": string
}
欄位
travelAccountId

string (int64 format)

不可變動。與旅遊廣告活動相關聯的旅遊帳戶 ID。

DemandGenCampaignSettings

需求開發廣告活動的設定。

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

boolean

不可變動。指定這個廣告活動是否使用升級版指定目標選項。將這個欄位設為 true 時，您可以在廣告群組層級使用指定地區和語言，而非標準廣告活動層級指定。這個欄位的預設值為 false，且只能在建立廣告活動時設定。

VideoCampaignSettings

影片廣告活動的設定。

JSON 表示法 
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
欄位
videoAdInventoryControl

object (VideoAdInventoryControl)

觸及廣告活動中回應式廣告容器的廣告空間控管。

VideoAdInventoryControl

如果廣告活動使用回應式廣告容器，廣告空間控制項會決定廣告可顯示在哪些廣告空間。這項功能僅適用於採用「TARGET_CPM」和「FIXED_CPM」出價策略的廣告活動。

JSON 表示法 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
欄位
allowInStream

boolean

判斷是否可使用 VideoResponsiveAds 放送串流內影片廣告。
allowInFeed

boolean

判斷是否可使用 VideoResponsiveAds 放送動態內影片廣告。
allowShorts

boolean

判斷是否可使用回應式影片廣告做為 Shorts 格式。

RealTimeBiddingSetting

即時出價設定，這項功能僅適用於指定 Ad Exchange 聯播網的廣告活動。

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

boolean

廣告活動是否已啟用即時出價。

NetworkSettings

廣告活動的聯播網設定。

JSON 表示法 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
欄位
targetSearchNetwork

boolean

廣告是否會在 Google 搜尋聯播網的合作夥伴網站上放送 (需要 targetGoogleSearch 也為 true)。
targetContentNetwork

boolean

廣告是否會在 Google 多媒體廣告聯播網的指定刊登位置放送。您可以使用「刊登位置」條件指定刊登位置。
targetPartnerSearchNetwork

boolean

廣告是否會在 Google 合作夥伴網路上放送。這項功能僅適用於部分 Google 合作夥伴帳戶。
targetYoutube

boolean

是否在 YouTube 上放送廣告。
targetGoogleTvNetwork

boolean

廣告是否會在 Google TV 聯播網上放送。

HotelSettingInfo

飯店廣告的廣告活動層級設定。

JSON 表示法 
{
  "hotelCenterId": string
}
欄位
hotelCenterId

string (int64 format)

不可變動。已連結的 Hotel Center 帳戶。

DynamicSearchAdsSetting

用於控制動態搜尋廣告 (DSA) 的設定。

JSON 表示法 
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
欄位
domainName

string

必要欄位。這個設定代表的網域名稱，例如「google.com」或「www.google.com」。
languageCode

string

必要欄位。指定網域語言的語言代碼，例如「en」。
feeds[]

string

與廣告活動相關聯的網頁動態饋給素材資源資源名稱清單。
useSuppliedUrlsOnly

boolean

廣告活動是否只使用廣告主提供的網址。

ShoppingSetting

購物廣告活動的設定。定義廣告活動可宣傳的產品範圍，以及這項廣告活動與其他購物廣告活動的互動方式。

JSON 表示法 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
欄位
feedLabel

string

要納入廣告活動的產品動態饋給標籤。只能設定 feedLabel 或 sales_country 其中一個。如果使用這個欄位取代 sales_country，動態饋給標籤欄位會接受相同格式的國家/地區代碼，例如：'XX'。否則可以是任何字串，用於 Google Merchant Center 中的動態饋給標籤。
useVehicleInventory

boolean

不可變動。是否指定車輛商品目錄廣告空間。這個欄位僅適用於智慧購物廣告活動。如要在最高成效廣告活動中設定車輛資訊動態饋給廣告空間，請改用 listingType。
advertisingPartnerIds[]

string (int64 format)

不可變動。廣告活動中合作的廣告合作夥伴廣告帳戶 ID。
merchantId

string (int64 format)

Merchant Center 帳戶 ID。這是建立作業的必填欄位。這個欄位無法變更，適用於購物廣告活動。
campaignPriority

integer

廣告活動優先順序。優先順序數字較高的廣告活動會優先於優先順序較低的廣告活動。購物廣告活動必須填入這個欄位，值介於 0 和 2 之間 (含頭尾)。智慧購物廣告活動可選擇使用這個欄位，但如果設定這個欄位，則必須設為 3。
enableLocal

boolean

是否納入店面產品。
disableProductFeed

boolean

停用選用產品動態饋給。這個欄位目前僅適用於需求開發廣告活動。如要進一步瞭解這項功能，請參閱 https://support.google.com/google-ads/answer/13721750。

AudienceSetting

指定目標對象設定。

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

boolean

不可變動。如果為 True，這個廣告活動就會使用目標對象資源進行指定目標對象。如果設為 false，這個廣告活動可能會改用目標對象區隔條件。

GeoTargetTypeSetting

代表與廣告地理指定相關的設定集合。

JSON 表示法 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
欄位
positiveGeoTargetType

enum (PositiveGeoTargetType)

這個特定廣告活動用於正向地理指定的設定。
negativeGeoTargetType

enum (NegativeGeoTargetType)

這個特定廣告活動的排除地理區域指定設定。

PositiveGeoTargetType

可能的肯定地理區域指定目標類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
PRESENCE_OR_INTEREST 指定廣告主指定地區的使用者，或對該地區感興趣的使用者，會觸發廣告。
SEARCH_INTEREST 指定使用者搜尋廣告客戶指定的地區時，系統會觸發廣告。這項功能只能用於搜尋和標準購物廣告活動。
PRESENCE 指定廣告在使用者位於廣告客戶指定的地區或經常出現在該地區時觸發。

NegativeGeoTargetType

可能的排除地理區域指定目標類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個值在這個版本中未知。
PRESENCE_OR_INTEREST 指定如果使用者位於廣告客戶排除的地點，或對該地感興趣，則系統不會向該使用者顯示廣告。
PRESENCE 指定如果使用者位於廣告客戶排除的地點，系統就會將該使用者排除在廣告放送對象之外。

LocalCampaignSetting

地區廣告活動的廣告活動設定。

JSON 表示法 
{
  "locationSourceType": enum (LocationSourceType)
}
欄位
locationSourceType

enum (LocationSourceType)

這個本地廣告活動的地區來源類型。

LocationSourceType

地區來源的可能類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
GOOGLE_MY_BUSINESS 與客戶已連結商家檔案相關聯的地點。
AFFILIATE 經銷 (連鎖) 門市地點。例如 Best Buy 商店地點。

AppCampaignSetting

應用程式廣告活動的廣告活動層級設定。

JSON 表示法 
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
欄位
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

代表這個應用程式廣告活動的出價策略應以哪個目標進行最佳化調整。
appStore

enum (AppCampaignAppStore)

不可變動。發布此特定應用程式的應用程式商店。
appId

string

不可變動。用於唯一識別行動應用程式的字串。

AppCampaignBiddingStrategyGoalType

應用程式廣告活動 BiddingStrategy 的目標類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST 盡量增加應用程式安裝次數。單次安裝出價是目標單次安裝出價。
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST 目標是盡可能提高應用程式安裝所產生的所選應用程式內轉換數量。單次安裝出價是目標單次安裝出價。
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST 目標是盡量提高應用程式安裝所產生的所選應用程式內轉換數量。單次應用程式內轉換出價是每次應用程式內轉換的目標費用。請注意，由於長期轉換尚未發生，因此實際單次轉換出價一開始可能會高於目標單次轉換出價。
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND 盡量提高所有轉換的價值，例如安裝 + 所選應用程式內轉換，同時達到或超越目標廣告投資報酬率。
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME 盡可能提高應用程式的預先註冊次數。
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST 盡量提高應用程式安裝次數，而不設定目標單次安裝出價。

AppCampaignAppStore

描述應用程式廣告活動應用程式商店的列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
APPLE_APP_STORE Apple App Store。
GOOGLE_APP_STORE Google Play。

CampaignExperimentType

指出這個廣告活動是一般廣告活動、草稿廣告活動還是實驗廣告活動。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
BASE 這是一般廣告活動。
DRAFT 這是廣告活動的草稿版本。它與基礎廣告活動有些許差異，但不會放送或累積指標。
EXPERIMENT 這是廣告活動的實驗版本。實驗廣告活動與基礎廣告活動有些許差異，且部分流量會從基礎廣告活動轉移到實驗廣告活動。

FrequencyCapEntry

規則，指定廣告 (或某些廣告組合) 在特定時間範圍內向使用者顯示的次數上限。

JSON 表示法 
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
欄位
key

object (FrequencyCapKey)

特定展示頻率上限的鍵。同一個鍵最多只能有一個展示頻率上限。
cap

integer

這個上限會限制在指定時間範圍內允許的事件數量上限。

FrequencyCapKey

一組用作展示頻率上限鍵的欄位。同一個鍵最多只能有一個展示頻率上限。

JSON 表示法 
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
欄位
level

enum (FrequencyCapLevel)

要套用展示頻率上限的層級 (例如廣告群組廣告、廣告群組)。上限會套用至這個層級的所有實體。
eventType

enum (FrequencyCapEventType)

上限適用的事件類型 (例如曝光)。
timeUnit

enum (FrequencyCapTimeUnit)

定義上限的時間單位 (例如天、週)。
timeLength

integer

展示頻率上限的時間單位數。

FrequencyCapLevel

要套用展示頻率上限的層級 (例如廣告群組廣告、廣告群組)。上限會套用至這個層級的所有資源。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
AD_GROUP_AD 上限會套用至廣告群組廣告層級。
AD_GROUP 上限會套用至廣告群組層級。
CAMPAIGN 上限會套用至廣告活動層級。

FrequencyCapEventType

上限適用的事件類型 (例如曝光)。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
IMPRESSION 上限適用於廣告曝光。
VIDEO_VIEW 上限適用於影片廣告觀看次數。

VanityPharma

說明沒有品牌標誌的藥品廣告如何顯示。

JSON 表示法 
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
欄位
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

藥品廣告網址的顯示模式。
vanityPharmaText

enum (VanityPharmaText)

當您為虛擬藥品網址選取「網站說明」顯示模式時，文字廣告的顯示網址會顯示這段文字。

VanityPharmaDisplayUrlMode

列舉說明藥品廣告網址可能的顯示模式。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
MANUFACTURER_WEBSITE_URL 將藥品行銷網址替換為製造商網站網址。
WEBSITE_DESCRIPTION 將自用藥品網站網址替換為網站說明。

VanityPharmaText

描述可能文字的列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
PRESCRIPTION_TREATMENT_WEBSITE_EN 處方治療網站，網站內容為英文。
PRESCRIPTION_TREATMENT_WEBSITE_ES 處方治療網站，網站內容為西班牙文 (Sitio de tratamientos con receta)。
PRESCRIPTION_DEVICE_WEBSITE_EN 處方器材網站，網站內容為英文。
PRESCRIPTION_DEVICE_WEBSITE_ES 處方器材網站，網站內容為西班牙文 (Sitio de dispositivos con receta)。
MEDICAL_DEVICE_WEBSITE_EN 醫療器材網站，網站內容以英文呈現。
MEDICAL_DEVICE_WEBSITE_ES 醫療器材網站，網站內容為西班牙文 (Sitio de dispositivos médicos)。
PREVENTATIVE_TREATMENT_WEBSITE_EN 預防性治療網站，網站內容為英文。
PREVENTATIVE_TREATMENT_WEBSITE_ES 預防性治療網站，網站內容為西班牙文 (Sitio de tratamientos preventivos)。
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN 處方避孕網站，網站內容為英文。
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES 處方避孕網站，網站內容為西班牙文 (Sitio de anticonceptivos con receta)。
PRESCRIPTION_VACCINE_WEBSITE_EN 處方疫苗網站，網站內容為英文。
PRESCRIPTION_VACCINE_WEBSITE_ES 處方疫苗網站，網站內容為西班牙文 (Sitio de vacunas con receta)。

SelectiveOptimization

這個廣告活動的選擇性最佳化設定，包括一組轉換動作，用於為這個廣告活動進行最佳化。這項功能僅適用於使用 MULTI_CHANNEL 做為 AdvertisingChannelType，以及使用 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 做為 AdvertisingChannelSubType 的應用程式廣告活動。

JSON 表示法 
{
  "conversionActions": [
    string
  ]
}
欄位
conversionActions[]

string

為這個廣告活動最佳化轉換動作時，所選取的資源名稱組合。

OptimizationGoalSetting

這個廣告活動的最佳化目標設定，包括一組最佳化目標類型。

JSON 表示法 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
欄位
optimizationGoalTypes[]

enum (OptimizationGoalType)

最佳化目標類型的清單。

OptimizationGoalType

最佳化目標類型

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
CALL_CLICKS 針對來電點擊進行最佳化。來電點擊轉換是指使用者在觀看廣告後，選取「Call」與商家聯絡的次數。
DRIVING_DIRECTIONS 針對行車路線進行最佳化。駕駛路線轉換是指使用者在觀看廣告後，選取「取得路線」前往商家的次數。
APP_PRE_REGISTRATION 針對預先註冊進行最佳化。預先註冊轉換是指在應用程式推出時，收到通知的預先註冊註冊次數。

TrackingSetting

追蹤資訊的廣告活動層級設定。

JSON 表示法 
{
  "trackingUrl": string
}
欄位
trackingUrl

string

僅供輸出。用於動態追蹤的網址。

PaymentMode

列舉可用的付款模式。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
CLICKS 單次互動付費。
CONVERSION_VALUE 單次轉換付費價值。只有 AdvertisingChannelType.HOTEL、BiddingStrategyType.COMMISSION 和 BudgetType.STANDARD 的廣告活動支援這個模式。
CONVERSIONS 按轉換付費。只有 AdvertisingChannelType.DISPLAY (不含 AdvertisingChannelSubType.DISPLAY_GMAIL)、BiddingStrategyType.TARGET_CPA 和 BudgetType.FIXED_CPA 的廣告活動支援此模式。客戶也必須符合這個模式的資格。詳情請參閱 Customer.eligibility_failure_reasons。
GUEST_STAY 房客入住付費金額。只有 AdvertisingChannelType.HOTEL、BiddingStrategyType.COMMISSION 和 BudgetType.STANDARD 的廣告活動支援這個模式。

PerformanceMaxUpgrade

廣告活動升級為最高成效廣告活動的相關資訊。

JSON 表示法 
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
欄位
performanceMaxCampaign

string

僅供輸出。要升級的最高成效廣告活動資源名稱。
preUpgradeCampaign

string

僅供輸出。升級為最高成效廣告活動的舊版廣告活動資源名稱。
status

enum (PerformanceMaxUpgradeStatus)

僅供輸出。要求升級為最高成效廣告活動的廣告活動升級狀態。

PerformanceMaxUpgradeStatus

廣告活動的最高成效廣告活動升級狀態列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
UPGRADE_IN_PROGRESS 升級為最高成效廣告活動的作業正在進行中。
UPGRADE_COMPLETE 升級為最高成效廣告活動已完成。
UPGRADE_FAILED 升級為最高成效廣告活動失敗。廣告活動仍會照常放送，直到升級作業完成為止。
UPGRADE_ELIGIBLE 廣告活動符合升級為最高成效廣告活動的資格。

ListingType

可能的產品資訊類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
VEHICLES 這個廣告活動會放送車輛廣告。

AssetAutomationSetting

素材資源自動化設定包含 AssetAutomationType 和素材資源自動化選擇加入/退出狀態的組合

JSON 表示法 
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
欄位
assetAutomationType

enum (AssetAutomationType)

廣告主想選擇加入/退出素材資源自動化類型。
assetAutomationStatus

enum (AssetAutomationStatus)

素材資源自動化類型的選擇加入/退出狀態。

AssetAutomationType

素材資源自動化類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
TEXT_ASSET_AUTOMATION 文字素材資源自動化功能包括廣告標題和說明。根據預設，廣告主會啟用最高成效廣告活動，並停用搜尋廣告活動。

AssetAutomationStatus

素材資源自動化功能的狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
OPTED_IN 啟用後，系統就會產生並放送素材資源自動化類型。
OPTED_OUT 選擇不採用的素材資源自動化類型將停止產生及放送。

CampaignKeywordMatchType

列舉，說明廣告活動的關鍵字比對類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
BROAD 廣告活動層級廣泛比對。

佣金

佣金是一種自動出價策略，廣告客戶會支付轉換價值的特定部分。

JSON 表示法 
{
  "commissionRateMicros": string
}
欄位
commissionRateMicros

string (int64 format)

佣金費率會定義廣告客戶要支付的轉換價值部分。佣金費率 x 應以 (x * 1,000,000) 的形式傳入這個欄位。舉例來說，106,000 代表佣金費率為 0.106 (10.6%)。

ManualCpa

這個類型沒有任何欄位。

手動出價策略，可讓廣告主為廣告主指定的動作設定出價。

ManualCpc

使用者按次付費的手動點擊出價。

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

boolean

是否根據轉換最佳化工具資料強化出價。

ManualCpm

這個類型沒有任何欄位。

手動曝光出價，使用者按每千次曝光付費。

ManualCpv

這個類型沒有任何欄位。

以觀看次數為基礎的出價，使用者需為每部影片觀看次數付費。

PercentCpc

出價策略，出價為某些商品或服務宣傳價格的一部分。

JSON 表示法 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
欄位
cpcBidCeilingMicros

string (int64 format)

出價策略可設定的最高出價上限。這是廣告客戶輸入的選填欄位，並在當地微型廣告中指定。注意：系統會將零值解讀為未定義 bid_ceiling 的情況。
enhancedCpcEnabled

boolean

根據轉換的可能性，向上或向下調整每次競價的出價。個別出價可以超過 cpcBidCeilingMicros，但廣告活動的平均出價金額不得超過該值。

TargetCpm

目標千次曝光出價是一種自動出價策略，可根據您設定的目標千次曝光出價，設定出價以提升成效。

JSON 表示法 
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
欄位
聯集欄位 goal。與出價目標相關的其他資訊。goal 只能是下列其中一項：
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

目標頻率出價目標詳細資料。

TargetCpmTargetFrequencyGoal

目標頻率出價目標詳細資料。

JSON 表示法 
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
欄位
targetCount

string (int64 format)

目標頻率計數，代表您希望觸及單一使用者的次數。
timeUnit

enum (TargetFrequencyTimeUnit)

表示您希望在多長時間內達到指定目標數量的時間範圍。

固定千次曝光出價

固定千次曝光出價出價策略。採用固定千次曝光出價的手動出價策略。

JSON 表示法 
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
欄位
goal

enum (FixedCpmGoal)

固定千次曝光出價目標。決定確切的出價最佳化參數。
聯集欄位 goal_info。與出價目標相關的其他資訊。goal_info 只能是下列其中一項：
targetFrequencyInfo

object (FixedCpmTargetFrequencyGoalInfo)

目標頻率出價目標詳細資料。

FixedCpmGoal

列舉說明固定千次曝光出價策略目標的項目。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
REACH 盡量提高觸及數，也就是這個廣告活動中看到廣告的使用者人數。
TARGET_FREQUENCY 目標頻率千次曝光出價出價方。調整出價，以指定頻率觸及單一使用者。

FixedCpmTargetFrequencyGoalInfo

固定千次曝光出價策略的目標頻率出價目標詳細資料。只有在出價策略的目標為 TARGET_FREQUENCY 時才適用。

JSON 表示法 
{
  "targetCount": string,
  "timeUnit": enum (FixedCpmTargetFrequencyTimeUnit)
}
欄位
targetCount

string (int64 format)

目標頻率計數代表廣告客戶希望向單一使用者放送廣告的次數。
timeUnit

enum (FixedCpmTargetFrequencyTimeUnit)

表示您希望在多長時間內達到指定目標數量的時間範圍。

FixedCpmTargetFrequencyTimeUnit

這個列舉會說明在使用「固定千次曝光出價」出價策略時，系統會在哪個時間範圍內調整出價，以符合目標頻率。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
MONTHLY 在 30 天內，將出價最佳化以達到目標頻率。

TargetCpv

這個類型沒有任何欄位。

目標單次收視出價出價策略。這是一種自動出價策略，可根據您設定的目標單次轉換費用，設定出價以提升成效。