- JSON 表示法
- CampaignPrimaryStatus
- CampaignPrimaryStatusReason
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- LocalServicesCampaignSettings
- CategoryBid
- TravelCampaignSettings
- DiscoveryCampaignSettings
- RealTimeBiddingSetting
- NetworkSettings
- HotelSettingInfo
- DynamicSearchAdsSetting
- ShoppingSetting
- AudienceSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- LocalCampaignSetting
- LocationSourceType
- AppCampaignSetting
- AppCampaignBiddingStrategyGoalType
- AppCampaignAppStore
- CampaignExperimentType
- FrequencyCapEntry
- FrequencyCapKey
- FrequencyCapLevel
- FrequencyCapEventType
- BrandSafetySuitability
- VanityPharma
- VanityPharmaDisplayUrlMode
- VanityPharmaText
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- PaymentMode
- PerformanceMaxUpgrade
- PerformanceMaxUpgradeStatus
- ListingType
- AssetAutomationSetting
- AssetAutomationType
- AssetAutomationStatus
- 佣金
- ManualCpa
- ManualCpc
- ManualCpm
- ManualCpv
- PercentCpc
- TargetCpm
- TargetCpmTargetFrequencyGoal
廣告活動。
JSON 表示法 |
---|
{ "resourceName": string, "primaryStatus": enum ( |
欄位 | |
---|---|
resourceName |
不可變動。廣告活動的資源名稱。廣告活動資源名稱的格式如下:
|
primaryStatus |
僅供輸出。廣告活動的主要狀態。 讓您深入瞭解廣告活動無法放送或無法正常放送的原因。您對廣告活動及相關實體所做的修改可能需要一段時間才會反映在這個狀態中。 |
primaryStatusReasons[] |
僅供輸出。廣告活動的主要狀態原因。 讓您深入瞭解廣告活動無法放送或無法正常放送的原因。這些原因會彙整在一起,以判定整體 CampaignPrimaryStatus。 |
status |
廣告活動狀態。 加入新的廣告活動後,狀態會預設為「已啟用」。 |
servingStatus |
僅供輸出。廣告活動的廣告放送狀態。 |
biddingStrategySystemStatus |
僅供輸出。廣告活動出價策略的系統狀態。 |
adServingOptimizationStatus |
廣告活動的廣告放送最佳化狀態。 |
advertisingChannelType |
不可變動。廣告活動中廣告的主要放送目標。您可以在 此為必填欄位,建立新廣告活動時不得空白。 只能在建立廣告活動時設定。廣告活動建立後即無法變更欄位。 |
advertisingChannelSubType |
不可變動。可選用的 只能在建立廣告活動時設定。廣告活動建立後即無法變更欄位。 |
urlCustomParameters[] |
這份清單會列出用來取代 |
localServicesCampaignSettings |
在地生活服務廣告活動的相關設定。 |
travelCampaignSettings |
旅遊廣告活動設定。 |
discoveryCampaignSettings |
探索廣告活動設定。 |
realTimeBiddingSetting |
即時出價設定;只有指定 Ad Exchange 聯播網的廣告活動才能使用這項功能。 |
networkSettings |
廣告活動的聯播網設定。 |
hotelSetting |
不可變動。廣告活動的飯店設定。 |
dynamicSearchAdsSetting |
控管動態搜尋廣告的設定。 |
shoppingSetting |
控管購物廣告活動的設定。 |
targetingSetting |
指定目標相關功能的設定。 |
geoTargetTypeSetting |
廣告的指定地理區域設定。 |
localCampaignSetting |
地區廣告活動的設定。 |
appCampaignSetting |
與應用程式廣告活動相關的設定。 |
labels[] |
僅供輸出。廣告活動所附加標籤的資源名稱。 |
experimentType |
僅供輸出。廣告活動類型:正常、草稿或實驗。 |
biddingStrategyType |
僅供輸出。出價策略類型。 設定出價策略時,您可以選擇使用出價配置來建立標準出價策略,或設定「 這是唯讀欄位。 |
accessibleBiddingStrategy |
僅供輸出。AccessibleBiddingStrategy 的資源名稱為唯讀檢視畫面,內含由「出價策略」識別的附加組合出價策略中未受限的屬性。如果廣告活動未使用組合策略,則為空白。所有能共用策略並讀取 AccessibleBiddingStrategy 資源的客戶,都能使用未受限制的策略屬性。反之,受限制的屬性則只有策略擁有者及其管理員可使用。受限制的屬性只能從出價策略資源中讀取。 |
frequencyCaps[] |
此清單用來限制每位使用者看到這個廣告活動的廣告的頻率。 |
videoBrandSafetySuitability |
僅供輸出。個別廣告活動層級的品牌安全設定。可透過選取廣告空間類型,讓廣告在符合品牌形象的內容中顯示。請參閱 https://support.google.com/google-ads/answer/7515513。 |
vanityPharma |
說明無品牌藥品廣告的顯示方式。 |
selectiveOptimization |
這個廣告活動的選擇性最佳化設定,包括一組要為這個廣告活動最佳化的轉換動作。這項功能僅適用於將 MULTI_CHANNEL 做為 AdvertisingChannelType 以及 APP_CAMPAIGN_FOR_ENGAGEMENT 做為 AdvertisingChannelSubType 的應用程式廣告活動。 |
optimizationGoalSetting |
這個廣告活動的最佳化目標設定,包括一組最佳化目標類型。 |
trackingSetting |
僅供輸出。廣告活動層級的追蹤資訊設定。 |
paymentMode |
廣告活動的付款模式。 |
excludedParentAssetFieldTypes[] |
應從這個廣告活動中排除的素材資源欄位類型。這個廣告活動不會沿用頂層包含這些欄位類型的素材資源連結。 |
excludedParentAssetSetTypes[] |
應從這個廣告活動中排除的素材資源組合類型。這個廣告活動不會沿用上層項目的素材資源組合連結。地區群組類型 (GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP 和 STATIC_LOCATION_GROUP) 是 LOCATION_SYNC 的子項類型。因此,如果為這個欄位設定 LOCATION_SYNC,所有地區群組素材資源組合都無法連結至這個廣告活動,而且所有地點額外資訊 (LE) 和經銷地點額外資訊 (ALE) 都不會在這個廣告活動底下放送。目前僅支援 LOCATION_SYNC。 |
performanceMaxUpgrade |
僅供輸出。廣告活動升級為最高成效廣告活動的相關資訊。 |
assetAutomationSettings[] |
包含每個 AssetAutomationType 的啟用/停用狀態。如要瞭解預設的啟用/退出行為,請參閱各素材資源自動化類型列舉的說明文件。 |
id |
僅供輸出。廣告活動的 ID。 |
name |
廣告活動名稱。 此為必填欄位,建立新廣告活動時不得空白。 這個值不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 |
trackingUrlTemplate |
用來建構追蹤網址的網址範本。 |
audienceSetting |
不可變動。目標對象相關功能設定。 |
baseCampaign |
僅供輸出。草稿或實驗廣告活動基礎廣告活動的資源名稱。如果是基礎廣告活動,這等於 這是唯讀欄位。 |
campaignBudget |
廣告活動的預算。 |
startDate |
廣告活動開始放送的日期,以 YYYY-MM-DD 格式表示。 |
campaignGroup |
這個廣告活動所屬的廣告活動群組。 |
endDate |
廣告活動的最後一天,以客戶的時區為 YYYY-MM-DD。建立後,預設值為 2037-12-30,表示廣告活動會無限期放送。如要將現有廣告活動設為無限期放送,請將這個欄位設為 2037-12-30。 |
finalUrlSuffix |
這個字尾用來將查詢參數附加至採用並行追蹤功能的到達網頁。 |
optimizationScore |
僅供輸出。廣告活動的最佳化分數。 最佳化分數可用來評估廣告活動設定的預期成效。範圍從 0% (0.0) 到 100% (1.0),100% 表示廣告活動能充分發揮潛力。若廣告活動未評分,則這個欄位為空值。 請參閱「關於最佳化分數」一文:https://support.google.com/google-ads/answer/9061546。 這是唯讀欄位。 |
urlExpansionOptOut |
代表選擇不為更多目標網址啟用網址擴展功能。如果選擇停用 (true),則系統只會指定素材資源群組中的最終到達網址,或是指定廣告主 Google Merchant Center 或業務資料動態饋給中指定的網址。如果選擇加入 (false),就會指定整個網域。只有最高成效廣告活動可設定這個欄位,預設值為 False。 |
hotelPropertyAssetSet |
不可變動。旅遊目標專用最高成效廣告活動的飯店房源組合。 |
listingType |
不可變動。這個廣告活動放送的廣告產品資訊類型。這個欄位不適用於最高成效廣告活動。 |
聯集欄位 必須為廣告活動組合 (透過出價策略服務建立) 或標準組合。 |
|
biddingStrategy |
廣告活動使用的組合出價策略。 |
commission |
佣金是一種自動出價策略,廣告客戶可支付一定的轉換價值。 |
manualCpa |
標準手動單次轉換出價策略。手動出價策略,可讓廣告客戶依廣告客戶指定的動作設定出價。僅適用於在地生活服務廣告活動。 |
manualCpc |
標準手動單次點擊出價策略。手動單次點擊出價,表示使用者必須按每次點擊付費。 |
manualCpm |
標準手動千次曝光出價策略。手動採用以曝光為基礎的出價,使用者按每千次曝光付費。 |
manualCpv |
這種出價策略會依每次影片收視可自行設定金額付費。 |
maximizeConversions |
標準「盡量爭取轉換」出價策略,會自動使用你的預算盡量爭取轉換。 |
maximizeConversionValue |
標準「盡量提高轉換價值」出價策略會自動設定出價,並利用您的預算盡量提高收益。 |
targetCpa |
「標準目標單次轉換出價」策略會自動設定出價,以根據您指定的目標單次轉換出價盡量爭取轉換。 |
targetImpressionShare |
目標曝光比重出價策略。這項自動出價策略會設定出價,以達到指定百分比的曝光量。 |
targetRoas |
標準「目標廣告投資報酬率」出價策略會自動爭取最高收益,同時平均分配特定目標廣告投資報酬率。 |
targetSpend |
「標準目標支出」出價策略會自動設定出價,在您的預算範圍內儘可能爭取點擊。 |
percentCpc |
標準單次點擊出價策略,也就是出價只花了一些商品或服務的廣告價格。 |
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 |
這個廣告活動中大多數的素材資源群組都待審查。 |
NO_ASSET_GROUPS |
這個廣告活動中沒有任何符合資格的素材資源群組。 |
ASSET_GROUPS_PAUSED |
這個廣告活動中的所有素材資源群組都已暫停。 |
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 ( |
欄位 | |
---|---|
categoryBids[] |
與 MANUAL_CPA 出價策略相關聯的類別層級出價。 |
CategoryBid
LocalServicesReportingCampaignSettings 中的類別出價。
JSON 表示法 |
---|
{ "categoryId": string, "manualCpaBidMicros": string } |
欄位 | |
---|---|
categoryId |
要採用出價的類別。例如「xcat:service_area_business_plumber」。 |
manualCpaBidMicros |
類別的手動單次轉換出價。出價必須高於該類別的相關預留價格。價值會以百萬分之一為單位,並以廣告主的幣別計價。 |
TravelCampaignSettings
旅遊廣告活動設定。
JSON 表示法 |
---|
{ "travelAccountId": string } |
欄位 | |
---|---|
travelAccountId |
不可變動。與旅遊廣告活動相關聯的旅遊帳戶 ID。 |
DiscoveryCampaignSettings
探索廣告活動設定。
JSON 表示法 |
---|
{ "upgradedTargeting": boolean } |
欄位 | |
---|---|
upgradedTargeting |
不可變動。指出這個廣告活動是否使用新版指定目標選項。如果將這個欄位設為 |
RealTimeBiddingSetting
即時出價設定;只有指定 Ad Exchange 聯播網的廣告活動才能使用這項功能。
JSON 表示法 |
---|
{ "optIn": boolean } |
欄位 | |
---|---|
optIn |
指出廣告活動是否選擇採用即時出價。 |
NetworkSettings
廣告活動的聯播網設定。
JSON 表示法 |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean, "targetYoutube": boolean, "targetGoogleTvNetwork": boolean } |
欄位 | |
---|---|
targetGoogleSearch |
廣告是否會與 google.com 搜尋結果一起顯示。 |
targetSearchNetwork |
廣告是否會在 Google 搜尋聯播網的夥伴網站上放送 (要求 |
targetContentNetwork |
廣告是否會在 Google 多媒體廣告聯播網的指定刊登位置上放送。刊登位置是使用刊登位置條件來指定。 |
targetPartnerSearchNetwork |
廣告是否會在 Google 合作夥伴聯播網上放送。這項功能僅適用於部分 Google 合作夥伴帳戶。 |
targetYoutube |
廣告是否會在 YouTube 上放送。 |
targetGoogleTvNetwork |
廣告是否會在 Google TV 聯播網上放送。 |
HotelSettingInfo
飯店廣告的廣告活動層級設定。
JSON 表示法 |
---|
{ "hotelCenterId": string } |
欄位 | |
---|---|
hotelCenterId |
不可變動。已連結的 Hotel Center 帳戶。 |
DynamicSearchAdsSetting
控管動態搜尋廣告的設定。
JSON 表示法 |
---|
{ "domainName": string, "languageCode": string, "feeds": [ string ], "useSuppliedUrlsOnly": boolean } |
欄位 | |
---|---|
domainName |
必要欄位。這項設定代表的網際網路網域名稱,例如「google.com」或「www.google.com」。 |
languageCode |
必要欄位。指定網域語言的語言代碼,例如「en」。 |
feeds[] |
與廣告活動相關的網頁動態饋給清單。 |
useSuppliedUrlsOnly |
廣告活動是否只使用廣告主提供的網址。 |
ShoppingSetting
購物廣告活動的設定。定義廣告活動可宣傳的產品涵蓋範圍,以及這個廣告活動如何與其他購物廣告活動互動。
JSON 表示法 |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "advertisingPartnerIds": [ string ], "merchantId": string, "campaignPriority": integer, "enableLocal": boolean } |
欄位 | |
---|---|
feedLabel |
要加進廣告活動的產品動態饋給標籤。只能設定一個 feedLabel 或 salesCountry。如果使用動態饋給標籤 (而不是銷售國家/地區),則動態饋給標籤欄位可接受相同格式的國家/地區代碼,例如「XX」。否則,可以是 Google Merchant Center 中用於動態饋給標籤的任何字串。 |
useVehicleInventory |
不可變動。是否指定車輛房源資訊清單。這個欄位僅適用於智慧購物廣告活動。如要在最高成效廣告活動中設定車輛產品資訊廣告空間,請改用 |
advertisingPartnerIds[] |
不可變動。廣告活動中合作的廣告合作夥伴廣告帳戶 ID。 |
merchantId |
不可變動。Merchant Center 帳戶的 ID。這是建立作業時的必填欄位。在購物廣告活動中無法變更這個欄位。 |
campaignPriority |
廣告活動的優先順序。優先順序較高的廣告活動,其優先順序將高於優先順序較低的廣告活動。購物廣告活動中的此欄位為必要欄位,值介於 0 到 2 (含) 之間。此為智慧購物廣告活動的選填欄位,但如有設定,則必須等於 3。 |
enableLocal |
是否要加入店面產品。 |
AudienceSetting
指定目標對象的設定。
JSON 表示法 |
---|
{ "useAudienceGrouped": boolean } |
欄位 | |
---|---|
useAudienceGrouped |
不可變動。如果為 true,這個廣告活動會使用目標對象資源來指定指定目標對象。如果設為 false,這個廣告活動可能會改用目標對象區隔條件。 |
GeoTargetTypeSetting
代表一組與指定地理區域廣告相關的設定。
JSON 表示法 |
---|
{ "positiveGeoTargetType": enum ( |
欄位 | |
---|---|
positiveGeoTargetType |
此特定廣告活動中用來指定正面地理區域的設定。 |
negativeGeoTargetType |
此特定廣告活動中用來排除指定地理區域的設定。 |
PositiveGeoTargetType
可能的正面指定地理區域類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
PRESENCE_OR_INTEREST |
表示只要使用者位於廣告客戶的目標地區或對其感興趣,廣告就會觸發。 |
SEARCH_INTEREST |
表示只要使用者搜尋廣告客戶的目標地區,就會觸發廣告。這項功能只適用於搜尋和標準購物廣告活動。 |
PRESENCE |
表示只要使用者位於或經常身在廣告客戶的目標地區,就會觸發廣告。 |
NegativeGeoTargetType
可能的排除指定地理區域類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
PRESENCE_OR_INTEREST |
表示如果使用者位於廣告主的排除地區或對其感興趣,就不會看到廣告。 |
PRESENCE |
表示如果使用者位於廣告主的排除地區,就無法看到廣告。 |
LocalCampaignSetting
地區廣告活動的廣告活動設定。
JSON 表示法 |
---|
{
"locationSourceType": enum ( |
欄位 | |
---|---|
locationSourceType |
這個地區廣告活動的地區來源類型。 |
LocationSourceType
地區來源的可能類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
GOOGLE_MY_BUSINESS |
與客戶連結的商家檔案相關聯的地點。 |
AFFILIATE |
經銷 (連鎖店) 門市位置。例如:Best Buy 商店的位置。 |
AppCampaignSetting
應用程式廣告活動的廣告活動層級設定。
JSON 表示法 |
---|
{ "biddingStrategyGoalType": enum ( |
欄位 | |
---|---|
biddingStrategyGoalType |
代表此應用程式廣告活動的出價策略應最佳化的目標。 |
appStore |
不可變動。發行這個特定應用程式的應用程式商店。 |
appId |
不可變動。用以識別行動應用程式的字串。 |
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 ( |
欄位 | |
---|---|
key |
特定展示頻率上限的鍵。同一個鍵不能有多個展示頻率上限。 |
cap |
此上限在指定時間範圍內允許的事件數量上限。 |
FrequencyCapKey
使用一組欄位做為展示頻率上限的鍵。同一個鍵不能超過一個展示頻率上限。
JSON 表示法 |
---|
{ "level": enum ( |
欄位 | |
---|---|
level |
要套用展示頻率上限的層級 (例如廣告群組廣告、廣告群組)。這個上限會套用至這個層級的所有實體。 |
eventType |
要套用展示頻率上限的事件類型 (例如曝光)。 |
timeUnit |
定義上限的時間單位,例如日、週。 |
timeLength |
展示頻率上限的持續時間。 |
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 |
當網站說明是本地藥局網址的顯示模式時,文字廣告的顯示網址會顯示的文字。 |
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[] |
選取一組用來最佳化這個廣告活動的轉換動作。 |
OptimizationGoalSetting
這個廣告活動的最佳化目標設定,包括一組最佳化目標類型。
JSON 表示法 |
---|
{
"optimizationGoalTypes": [
enum ( |
欄位 | |
---|---|
optimizationGoalTypes[] |
最佳化目標類型清單。 |
OptimizationGoalType
最佳化目標的類型
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅可當做傳回值使用。代表這個版本未知的值。 |
CALL_CLICKS |
針對來電點擊進行最佳化。「來電點擊轉換」是指使用者在觀看廣告後選取「撥打電話」聯絡商店的次數。 |
DRIVING_DIRECTIONS |
針對行車路線進行最佳化。行車路線轉換是指使用者在觀看廣告後,選取「取得路線」前往商店的次數。 |
APP_PRE_REGISTRATION |
針對預先註冊進行最佳化。「預先註冊轉換次數」是指在應用程式發布時接收通知的預先註冊註冊人數。 |
TrackingSetting
廣告活動層級的追蹤資訊設定。
JSON 表示法 |
---|
{ "trackingUrl": string } |
欄位 | |
---|---|
trackingUrl |
僅供輸出。用於動態追蹤的網址。 |
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 ( |
欄位 | |
---|---|
performanceMaxCampaign |
僅供輸出。指出廣告活動升級為哪個最高成效廣告活動。 |
preUpgradeCampaign |
僅供輸出。表示已升級為最高成效廣告活動的舊版廣告活動。 |
status |
僅供輸出。廣告活動已要求升級為最高成效廣告活動的升級狀態。 |
PerformanceMaxUpgradeStatus
廣告活動的最高成效廣告活動升級狀態列舉。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
UPGRADE_IN_PROGRESS |
正在升級為最高成效廣告活動。 |
UPGRADE_COMPLETE |
最高成效廣告活動升級為最高成效廣告活動的程序已完成。 |
UPGRADE_FAILED |
無法升級為最高成效廣告活動。廣告活動仍會照常放送,也就是嘗試升級前。 |
UPGRADE_ELIGIBLE |
廣告活動可升級為最高成效廣告活動。 |
ListingType
可用的產品資訊類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
VEHICLES |
這個廣告活動放送的是車輛廣告。 |
AssetAutomationSetting
素材資源自動化設定包含一組 AssetAutomationType 和「素材資源自動化」的啟用/停用狀態
JSON 表示法 |
---|
{ "assetAutomationType": enum ( |
欄位 | |
---|---|
assetAutomationType |
廣告主希望加入/退出素材資源自動化類型。 |
assetAutomationStatus |
素材資源自動化類型的啟用/停用狀態。 |
AssetAutomationType
素材資源自動化的類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅可當做傳回值使用。代表這個版本未知的值。 |
TEXT_ASSET_AUTOMATION |
文字素材資源自動化功能包括廣告標題和說明。根據預設,廣告主會選擇採用最高成效廣告活動,且會停用搜尋廣告活動。 |
AssetAutomationStatus
素材資源自動化的狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅可當做傳回值使用。代表這個版本未知的值。 |
OPTED_IN |
啟用這項功能後,系統就會產生及放送素材資源自動化類型。 |
OPTED_OUT |
如果選擇停用,系統將停止產生及放送素材資源自動化類型。 |
佣金
佣金是一種自動出價策略,廣告客戶可支付一定的轉換價值。
JSON 表示法 |
---|
{ "commissionRateMicros": string } |
欄位 | |
---|---|
commissionRateMicros |
佣金費率定義了廣告客戶須支付的轉換價值部分。佣金費率為 x 時應以 (x * 1,000,000) 的形式傳入這個欄位。舉例來說,106,000 代表佣金費率為 0.106 (10.6%)。 |
ManualCpa
這個類型沒有任何欄位。
手動出價策略,可讓廣告客戶依廣告客戶指定的動作設定出價。
ManualCpc
手動單次點擊出價,表示使用者必須按每次點擊付費。
JSON 表示法 |
---|
{ "enhancedCpcEnabled": boolean } |
欄位 | |
---|---|
enhancedCpcEnabled |
是否根據「轉換最佳化工具」資料調整出價。 |
ManualCpm
這個類型沒有任何欄位。
手動採用以曝光為基礎的出價,使用者按每千次曝光付費。
ManualCpv
這個類型沒有任何欄位。
根據觀看次數出價,使用者須為每次影片觀看付費。
PercentCpc
一種出價策略,也就是根據商品或服務,出價只佔廣告價格的一部分。
JSON 表示法 |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
欄位 | |
---|---|
cpcBidCeilingMicros |
出價策略可設定的出價上限。此為選填欄位,由廣告客戶輸入,以當地微量形式指定。注意:零值解讀方式與未定義出價上限相同。 |
enhancedCpcEnabled |
根據轉換發生的可能性,調高或調低每次競價的出價。個別出價可能會超過 cpcBidCeilingMicros,但廣告活動的平均出價金額則不應該。 |
TargetCpm
「目標千次曝光出價」是一種自動出價策略,可根據您指定的目標千次曝光出價設定出價,盡可能提高成效。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 goal 。出價目標的其他相關資訊。goal 只能是下列其中一項: |
|
targetFrequencyGoal |
目標頻率出價目標詳細資料。 |
TargetCpmTargetFrequencyGoal
目標頻率出價目標詳細資料。
JSON 表示法 |
---|
{
"targetCount": string,
"timeUnit": enum ( |
欄位 | |
---|---|
targetCount |
目標頻率計數代表您希望觸及單一使用者的次數。 |
timeUnit |
代表您要達到指定 targetCount 的時間範圍。 |