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)
  },
  "discoveryCampaignSettings": {
    object (DiscoveryCampaignSettings)
  },
  "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)
  },
  "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)
  }
  // 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)

旅遊廣告活動設定。
discoveryCampaignSettings

object (DiscoveryCampaignSettings)

探索廣告活動設定。
realTimeBiddingSetting

object (RealTimeBiddingSetting)

即時出價設定；只有指定 Ad Exchange 聯播網的廣告活動才能使用這項功能。
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)

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

設定出價策略時，您可以選擇使用出價配置來建立標準出價策略，或設定「biddingStrategy」欄位建立組合出價策略。

這是唯讀欄位。
accessibleBiddingStrategy

string

僅供輸出。AccessibleBiddingStrategy 的資源名稱為唯讀檢視畫面，內含由「出價策略」識別的附加組合出價策略中未受限的屬性。如果廣告活動未使用組合策略，則為空白。所有能共用策略並讀取 AccessibleBiddingStrategy 資源的客戶，都能使用未受限制的策略屬性。反之，受限制的屬性則只有策略擁有者及其管理員可使用。受限制的屬性只能從出價策略資源中讀取。
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_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)

僅供輸出。廣告活動升級為最高成效廣告活動的相關資訊。
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。廣告活動的出價策略。

必須為廣告活動組合 (透過出價策略服務建立) 或標準組合。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)

標準「目標廣告投資報酬率」出價策略會自動爭取最高收益，同時平均分配特定目標廣告投資報酬率。
targetSpend

object (TargetSpend)

「標準目標支出」出價策略會自動設定出價，在您的預算範圍內儘可能爭取點擊。
percentCpc

object (PercentCpc)

標準單次點擊出價策略，也就是出價只花了一些商品或服務的廣告價格。
targetCpm

object (TargetCpm)

可自動調整每千次曝光費用的出價策略。

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 這個廣告活動中至少有 1 個廣告已遭拒登。
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 與此應用程式安裝廣告活動相關聯的應用程式，並未在廣告活動的指定國家/地區發布。
APP_PARTIALLY_RELEASED 與這項應用程式安裝廣告活動相關聯的應用程式，在廣告活動的指定國家/地區有部分發布。
HAS_ASSET_GROUPS_DISAPPROVED 這個廣告活動中至少有一個素材資源群組已遭拒登。
HAS_ASSET_GROUPS_LIMITED_BY_POLICY 這個廣告活動中，至少有一個素材資源群組受到政策限制。
MOST_ASSET_GROUPS_UNDER_REVIEW 這個廣告活動中大多數的素材資源群組都待審查。

CampaignStatus

廣告活動的可能狀態。

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

CampaignServingStatus

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

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

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

這個值僅供回應使用。
SERVING 放送中。
NONE 無。
ENDED 已結束。
PENDING Pending.
SUSPENDED 已停權。

BiddingStrategySystemStatus

出價策略的可能系統狀態。

列舉
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 缺少轉換追蹤 (沒有連線偵測 (ping)) 和/或智慧購物廣告活動 (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。

DiscoveryCampaignSettings

探索廣告活動設定。

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

boolean

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

RealTimeBiddingSetting

即時出價設定；只有指定 Ad Exchange 聯播網的廣告活動才能使用這項功能。

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

boolean

指出廣告活動是否選擇採用即時出價。

NetworkSettings

廣告活動的聯播網設定。

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

boolean

廣告是否會在 Google 搜尋聯播網的夥伴網站上放送 (要求 targetGoogleSearch 也必須是 true)。
targetContentNetwork

boolean

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

boolean

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

HotelSettingInfo

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

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

string (int64 format)

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

DynamicSearchAdsSetting

控管動態搜尋廣告的設定。

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,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
欄位
feedLabel

string

要加進廣告活動的產品動態饋給標籤。只能設定一個 feedLabel 或 salesCountry。如果使用動態饋給標籤 (而不是銷售國家/地區)，則動態饋給標籤欄位可接受相同格式的國家/地區代碼，例如「XX」。否則，可以是 Google Merchant Center 中用於動態饋給標籤的任何字串。
useVehicleInventory

boolean

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

string (int64 format)

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

string (int64 format)

不可變動。Merchant Center 帳戶的 ID。這是建立作業時的必填欄位。在購物廣告活動中無法變更這個欄位。
salesCountry

string

要納入廣告活動的產品銷售國家/地區。只能設定一個 feedLabel 或 salesCountry。欄位一經清除即無法變更。清除這個欄位後，如果您想設定銷售國家/地區，就必須使用 feedLabel。
campaignPriority

integer

廣告活動的優先順序。優先順序較高的廣告活動，其優先順序將高於優先順序較低的廣告活動。購物廣告活動中的此欄位為必要欄位，值介於 0 到 2 (含) 之間。此為智慧購物廣告活動的選填欄位，但如有設定，則必須等於 3。
enableLocal

boolean

是否要加入店面產品。

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

應用程式廣告活動出價策略的目標類型。

列舉
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 這是廣告活動的實驗版本。其中包含基礎廣告活動的部分修改內容，並將一定比例的流量從 BASE 廣告活動轉移到這個實驗廣告活動。

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 這項限制適用於影片廣告觀看次數。

BrandSafetySuitability

3 層品牌安全合適度控管工具。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
EXPANDED_INVENTORY 採用這個選項，您就能在符合我們營利標準的 YouTube 和影片合作夥伴的所有廣告空間中放送廣告。如果品牌想盡量在所有符合廣告播放資格的影片中放送廣告，即可採用這個選項；這些影片也包括措辭粗俗的喜劇或記錄片，或是標榜重度暴力的電玩遊戲。
STANDARD_INVENTORY 這個選項可讓您在適合大多數品牌的多元內容中顯示廣告，例如熱門音樂影片、紀錄片和電影預告片。決定內容的依據包括 YouTube 廣告友善內容規範，此規範會考量不雅用語的粗俗程度或出現頻率，或是主題的恰當性 (例如是否涉及敏感事件)。舉例來說，如果內容包含露骨色情或寫實暴力情節，或是屢次出現粗俗不雅用語，就無法顯示廣告。
LIMITED_INVENTORY 這個選項可讓你在不當語言與性暗示內容方面採用特別嚴格的規定，在適合品牌的少數內容中放送廣告，比 YouTube《廣告友善內容規範》更高。這個類別的影片能滿足較高的需求條件，特別是在不當語言和性暗示內容方面。舉例來說，選用這類廣告空間後，廣告不會在 YouTube 部分熱門音樂影片中顯示，也不會在 YouTube 與 Google 影片合作夥伴的其他流行文化內容中放送。

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_FOR_ENGAGEMENT 做為 AdvertisingChannelSubType 的應用程式廣告活動。

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

string

選取一組用來最佳化這個廣告活動的轉換動作。

OptimizationGoalSetting

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

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

enum (OptimizationGoalType)

最佳化目標類型清單。

OptimizationGoalType

最佳化目標的類型

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅可當做傳回值使用。代表這個版本未知的值。
CALL_CLICKS 針對來電點擊進行最佳化。「來電點擊轉換」是指使用者在觀看廣告後選取「撥打電話」聯絡商店的次數。
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)、BidStrategyType.TARGET_CPA 和預算類型.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_ELIBIGLE 廣告活動可升級為最高成效廣告活動。
UPGRADE_IN_PROGRESS 正在升級為最高成效廣告活動。
UPGRADE_COMPLETE 最高成效廣告活動升級為最高成效廣告活動的程序已完成。
UPGRADE_FAILED 無法升級為最高成效廣告活動。廣告活動仍會照常放送，也就是嘗試升級前。

ListingType

可用的產品資訊類型。

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

佣金

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

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)

出價策略可設定的出價上限。此為選填欄位，由廣告客戶輸入，以當地微量形式指定。注意：零值解讀方式與未定義出價上限相同。
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)

代表您要達到指定 targetCount 的時間範圍。

TargetFrequencyTimeUnit

列舉說明我們預計達到目標頻率的時間範圍。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
WEEKLY 最佳化出價以在一週內達到目標頻率。