營銷活動資料物件 - 行銷活動管理

定義營銷活動。

注意事項

您無法再新增、更新或擷取僅支援動態搜尋廣告的活動。 您現有行銷活動的行銷活動類型已從 「DynamicSearchAds」 更新為 「Search」。 廣告群組現在被視為「動態」廣告群組，但沒有任何結構化變更，也就是它們包含與之前相同的自動目標和動態搜尋廣告。

注意事項

自 2021 年 4 月起，手動的一般地飯店活動) 只能搭配對象行銷活動和記錄活動 (使用。 如果您嘗試為任何其他行銷活動類型設定手動的}，則會忽略要求，而不會發生錯誤，而且會將申請策略設定為增強的的。。

自 2021 年 4 月起，您無法為廣告群組或關鍵詞設定任何報價策略。 您只能在營銷活動層級設定申請策略。 如果您嘗試設定廣告群組或關鍵詞的報價策略，則會忽略要求而不會發生錯誤。 廣告群組和關鍵詞會繼承其營銷活動的報價策略。

語法

<xs:complexType name="Campaign" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AudienceAdsBidAdjustment" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="BudgetType" nillable="true" type="tns:BudgetLimitType" />
    <xs:element minOccurs="0" name="DailyBudget" nillable="true" type="xs:double" />
    <xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="DealIds" nillable="true" type="q8:ArrayOflong">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ExperimentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q9="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q9:ArrayOfKeyValuePairOfstringstring" />
    <xs:element xmlns:q10="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="GoalIds" nillable="true" type="q10:ArrayOflong">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MultimediaAdsBidAdjustment" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:CampaignStatus" />
    <xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
    <xs:element minOccurs="0" name="CampaignType" nillable="true" type="tns:CampaignType" />
    <xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
    <xs:element minOccurs="0" name="BudgetId" nillable="true" type="xs:long" />
    <xs:element xmlns:q11="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Languages" nillable="true" type="q11:ArrayOfstring" />
    <xs:element minOccurs="0" name="AdScheduleUseSearcherTimeZone" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="BidStrategyId" nillable="true" type="xs:long">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

元素

Campaign 物件具有下列元素：AdScheduleUseSearcherTimeZone、AudienceAdsBidAdjustment、將架構、BidStrategyId、BudgetId、BudgetType、CampaignType、DailyBudget、DealIds、ExperimentId、FinalUrlSuffix、ForwardCompatibilityMap、GoalIds、Id、Languages、MultimediaAdsBidAdjustment、Name、Settings、Status、SubType、TimeZone、TrackingUrlTemplate、UrlCustomParameters。

元素	描述	資料類型
AdScheduleUseSearcherTimeZone	判斷是要使用帳戶時區，還是廣告可傳遞之搜尋使用者的時區。 如果您想要在搜尋使用者的時區中顯示廣告，並將此屬性設定為 true ，否則將其設定為 false。 預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetCampaignsByAccountId 和 GetCampaignsByIds 服務作業時，在 ReturnAdditionalFields 元素中包含 AdScheduleUseSearcherTimeZone 值。 加： 自選。 如果您未指定此元素或將其保留空白， 則會設定 false 的預設值，並使用帳戶時區。 更新： 自選。 如果未設定更新的值，則此設定不會變更。	布爾
AudienceAdsBidAdjustment	調整您在基底廣告群組或關鍵詞廣告的上方或下方的廣告的報價量百分比。 如果客戶已針對Microsoft對象網路啟用，則此屬性可在搜尋活動中使用。 智慧 型購物活動無法使用此屬性。 支援的值為負 100 (-100) 到正 900 (900) 。 將報價調整設定為 -100，將會防止針對此營銷活動顯示觀眾廣告。 如果您想要使用基底廣告群組或關鍵詞) ，而不是指定對象廣告的任何約定調整，請將此元素設定為零 (0。 最佳做法是一律指定報價調整值。 如果您將此元素設定為 Null，則會使用系統預設的約定調整。 系統預設的約定調整目前為零 (0) ，而且可能會變更。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。	int
函數架構	您要如何管理您的報價的中標策略類型。 如需每個營銷活動類型的支援中標價策略的詳細資訊，請參閱 預算和約價策略。 重要： 對於某些中標策略類型，系統會忽略您的報價和廣告輪替設定，並透過 通用事件 追蹤標籤 (轉換追蹤，而且需要轉換目標) 。 如需包括支援位置的詳細資訊，請 參閱讓 Microsoft Advertising 使用報價策略來管理您的報價。 如果營銷活動使用 MaxConversionValueBiddingScheme 或 TargetImpressionShareBiddingScheme 比對策略，則此元素預設為 nil 或空白。 若要取得 MaxConversionValueBiddingScheme 或 TargetImpressionShareBiddingScheme 物件，請在呼叫 GetCampaignsByAccountId 和 GetCampaignsByIds 服務作業時，在 ReturnAdditionalFields 元素中包含個別的 MaxConversionValueBiddingScheme 和 TargetImpressionShareBiddingScheme 值。 加： 自選。 搜尋和 DynamicSearchAds 活動的預設參與策略類型是 EnhancedCpcBiddingScheme。 大部分購物活動的預設參與策略類型是 EnhancedCpcBiddingScheme;不過， 智慧型購物活動 唯一支援的參與策略類型是 MaxConversionsBiddingScheme 和 MaxConversionValueBiddingScheme。 對象行銷活動支持的參與策略類型為 EnhancedCpcBiddingScheme、 ManualCpcBiddingScheme、 ManualCpmBiddingScheme 和 TargetCpaBiddingScheme。 針對記錄活動支持的參與策略類型為 [委派][BiddingScheme]、 [ManualCpcBiddingScheme] 和 [PercentCpcBiddingScheme]。 效能上限行銷活動支持的參與策略是具有選擇性 TCPA) 的 MaxConversionsBiddingScheme (，以及具有選擇性 TROAS) 的 MaxConversionValueBiddingScheme (。 新影片營銷活動支持的參與策略為 ManualCpmBiddingScheme 和 ManualCpvBiddingScheme。 注意： 自 2024 年 5 月起，您無法再針對物件原生行銷活動使用手動的一般地比對策略。 您只能針對對象顯示和視訊行銷活動，以及針對記錄活動使用手動的。。 我們將會自動將任何現有的手動 AUDIENCE 物件原生行銷活動轉換為增強的。。 如果您嘗試為任何其他行銷活動類型設定手動的}，則會忽略要求，而不會發生錯誤，而且會將申請策略設定為增強的的。。 自 2021 年 4 月起，您無法為廣告群組或關鍵詞設定任何報價策略。 您只能在營銷活動層級設定申請策略。 如果您嘗試設定廣告群組或關鍵詞的報價策略，則會忽略要求而不會發生錯誤。 廣告群組和關鍵詞會繼承其營銷活動的報價策略。 更新： 自選。 如果未設定更新的值，則此設定不會變更。	函數架構
BidStrategyId	系統產生的 BidStrategy 識別符，此活動與帳戶中的其他行銷活動共用。 如果欄位是空的，則營銷活動不會使用組合的報價策略。 如果欄位不是空的，而且值大於零，則營銷活動會使用組合的報價策略。 如果營銷活動使用產品群組的評定策略，而您偏好使用自己的報價策略，請將此欄位設定為 '0'， (零) 。 注意：智慧型手機購物活動或效能最大值行銷活動不支援組合參與策略。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。	長
BudgetId	此營銷活動與帳戶中其他行銷活動共用之 預算 的唯一Microsoft Advertising標識符。 如果值不是 Null 且大於零，則營銷活動會使用共享預算。 如果值為 Null，則行銷活動不會使用共享預算。 如果營銷活動使用共享預算，而您偏好使用自己的預算，例如 DailyBudget 金額，請將此元素設定為 『0』 (零) 並將 DailyBudget 設定為有效的預算金額。 注意：智慧型手機購物活動或效能上限行銷活動不支援共享預算。 使用 智慧型手機購物活動時，您必須設定 DailyBudget 金額。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。	長
BudgetType	預算類型會決定預算的花費方式。 可能的值為 DailyBudgetAccelerated 和 DailyBudgetStandard。 DailyBudgetAccelerated 預算類型僅適用於使用未共用行銷活動層級預算的對象活動。 在共用預算的內容中，預算類型是只讀屬性，不論營銷活動是否使用共用預算，一律會傳回此屬性。 若要判斷營銷活動是否使用共享預算，請檢查 BudgetId 元素的值，如上所述。 使用實驗活動時，您無法設定 Budget、 BudgetType 或 Status。 實驗活動的預算和狀態一律繼承自基底營銷活動設定。 加： 如果未設定 BudgetId ，則為必要專案。 如果營銷活動使用共用預算，則為唯讀。 更新： 如果未設定 BudgetId ，則為選擇性。 如果未設定更新的值，則此設定不會變更。 如果營銷活動使用共用預算，則不允許。 如果您嘗試更新具有共用預算之營銷活動的預算類型，服務會傳回 CampaignServiceCannotUpdateSharedBudget 錯誤碼。	BudgetLimitType
CampaignType	營銷活動類型會判斷營銷活動是「物件」、「動態搜尋廣告」、「搜尋」、「購物活動」、「旅館廣告」或「效能上限」。 加： 自選。 如果未指定，則會使用 Search 的預設值。 更新： 不允許。	CampaignType
DailyBudget	每日花在營銷活動中的金額。 如果未設定 BudgetId ，您必須設定每日預算金額。 您的預算是目標;您實際的支出可能更高或更低。 變化是由許多因素所造成，例如一周中不同天數內的不同流量，或自動偵測和退款詐騙點選，可在點擊后的幾個小時內將金錢還給營銷活動。 Microsoft Advertising 會預期並自動補償波動，而且通常會將超額時間保持在每日限制的 100% 以下。 另請注意，Microsoft廣告不需要您的營銷活動預算高於廣告群組和關鍵詞的報價。 換句話說，廣告群組和關鍵詞的報價會獨立於營銷活動預算之外進行驗證。 在共用預算的內容中，預算金額是一個只讀屬性，不論營銷活動是否使用共用預算，一律會傳回此屬性。 當營銷活動與共用預算相關聯時，傳回的數量會是共用預算的金額。 若要判斷營銷活動是否使用共享預算，請檢查 BudgetId 元素的值，如上所述。 使用實驗活動時，您無法設定 Budget、 BudgetType 或 Status。 實驗活動的預算和狀態一律繼承自基底營銷活動設定。 加： 如果未設定 BudgetId ，則為必要專案。 如果營銷活動使用共用預算，則為唯讀。 更新： 如果未設定 BudgetId ，則為選擇性。 如果未設定更新的值，則此設定不會變更。 如果營銷活動使用共用預算，則不允許。 如果您嘗試更新具有共用預算之營銷活動的預算金額，服務會傳回 CampaignServiceCannotUpdateSharedBudget 錯誤碼。	雙
DealIds	對應至已新增交易的唯一系統標識符清單。 標識符清單會直接對應至要求中的交易清單。 清單的專案可能會傳回為 Null。 對於未新增交易的每個清單索引，對應的專案會是 Null。	long 陣列
ExperimentId	系統產生的 實驗標識碼。 此元素僅針對實驗活動設定，也就是已根據另一個搜尋活動為 A/B 測試建立的活動。 基底活動不會包含實驗標識碼。 同樣地，在實驗已 升級 為獨立行銷活動之後，此元素會是空的，即使該活動先前是實驗活動也一樣。 使用實驗活動時，您無法設定 Budget、 BudgetType 或 Status。 實驗活動的預算和狀態一律繼承自基底營銷活動設定。 如果您想要變更實驗的預算，您必須變更基底行銷活動的預算。 接著會根據您的實驗 TrafficSplitPercent 設定來分割值變更。 加： 唯讀 更新： 唯讀	長
FinalUrlSuffix	最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。	string
ForwardCompatibilityMap	用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。	KeyValuePairOfstringstring 陣 列
GoalIds	保留。	long 陣列
識別碼	營銷活動的唯Microsoft廣告標識符。 加： 唯讀 更新： 必填	長
語言	您的 廣告語言 設定會決定您撰寫廣告時將使用的語言，而且應該是客戶的語言。 重要： 如果在廣告群組和營銷活動層級設定語言，廣告群組層級語言將會覆寫行銷活動層級語言。 您可以在清單中個別指定多個語言，或如果您想要以所有語言為目標，只包含一個設定為 All 的清單專案。 搜尋和購物活動支援的語言字串為：羅馬尼亞文、挪威文、克羅埃西亞文、捷克文、丹麥文、荷蘭文、英文、愛沙尼亞文、芬蘭文、法文、德文、希臘文、匈牙利文、義大利文、日文、拉脫維亞文、立陶宛文、芬蘭文、葡萄牙文、羅馬尼亞文、斯洛伐克文、斯洛維尼亞文、西班牙文、瑞典文和傳統語言。 注意： 下列語言尚不適用於所有人：匈牙利文、克羅埃西亞文、捷克文、愛沙尼亞文、希臘文、匈牙利文、日文、拉脫維亞文、立陶宛文、馬特斯文、波蘭文、羅馬尼亞文、斯洛伐克文、斯洛維尼亞文。 針對對象行銷活動，您必須包含所有語言，也就是將此元素設定為All。 針對動態搜尋廣告營銷活動，會忽略行銷活動和廣告群組層級語言設定，而改用網站 網域語言。 您應該將營銷活動語言設定為 [全部]，並將廣告群組層級 語言 保留空白。 加： 對象營銷活動為必要專案，否則此元素為選擇性專案。 如果未設定任何營銷活動語言，則需要營銷活動內每個廣告群組的語言。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 一旦設定行銷活動語言，您就無法刪除所有語言。 您在更新期間指定的語言清單會取代先前的設定，也就是不會附加至現有的語言集。	字串陣列
MultimediaAdsBidAdjustment	保留。	int
名稱	營銷活動的名稱。 此名稱在帳戶內所有作用中或暫停的活動中必須是唯一的。 名稱最多可以包含 128 個字元。 當服務比較名稱與現有的營銷活動名稱時，會執行不區分大小寫的比較。 加： 必填 更新： 自選。 如果未設定更新的值，則此設定不會變更。	string
設定	依營銷活動類型而異的支持設定。 注意： VerifiedTrackingSetting 目前無法使用。 在設定清單中，每個設定類型最多可以包含一個物件，例如一個 TargetSetting。 如果 CampaignType 設定為 Search ，而且未設定 ExperimentId 元素，此列表可以選擇性地包含 DynamicSearchAdsSetting 物件。 實驗活動和實驗的基底營銷活動不能包含動態搜尋廣告設定。 如果您想要將此行銷活動用於實驗，請勿包含動態搜尋廣告設定。 如果現有的實驗已經以此行銷活動為基礎，您就無法更新營銷活動以包含動態搜尋廣告設定。 如果 CampaignType 設定為 Shopping，此列表必須包含 ShoppingSetting 物件。 如果 CampaignType 設定為 Audience，此清單不一定包含 ShoppingSetting 對象，視物件行銷活動是否支援產品廣告而定。 如果 CampaignType 設定為 DynamicSearchAds，此列表必須包含 DynamicSearchAdsSetting 物件。 如果 CampaignType 設定為 Hotel，此列表必須包含 HotelSetting 物件。 如果 CampaignType 設定為 PerformanceMax，此列表必須包含 PerformanceMaxSetting 物件。 如果效能上限活動與商店相關聯，它也支援 ShoppingSetting。 TargetSetting 可以搭配執行最大效能以外的任何行銷活動類型使用，並判斷與此行銷活動相關聯的物件準則是使用 [目標和報價] 選項或 [僅限標價] 目標選項。 在 TargetSetting 中，您可以有一個 TargetSettingDetail 物件，也就是每個支援的 CriterionTypeGroup 一個。 營銷活動層級目標設定目前唯一支援的準則類型值是 「物件」。 根據預設，不會傳回 TargetSetting 物件。 若要取得此物件，請在呼叫 GetCampaignsByAccountId 和 GetCampaignsByIds 服務作業時，在 ReturnAdditionalFields 元素中包含 TargetSetting 值。 加： 如果 CampaignType 設定為 DynamicSearchAds 或 Shopping，則為必要項目，否則此元素為選擇性專案。 如果這個專案不包含 TargetSetting 物件，則所有準則類型群組的預設 bid 選項實際上是「僅限標價」。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 DynamicSearchAdsSetting 和 ShoppingSetting 對象無法在更新期間移除。	設定陣 列
地位	營銷活動的狀態。 可能的值為 Active 和 Paused。 如果預算耗盡，服務會自動暫停營銷活動。 使用實驗活動時，您無法設定 Budget、 BudgetType 或 Status 實驗活動的預算和狀態一律繼承自基底營銷活動設定。 加： 自選。 預設值為 Paused。 更新： 自選。 如果未設定更新的值，則此設定不會變更。	CampaignStatus
SubType	營銷活動子類型。 如果未設定子類型，則會根據營銷活動類型建立營銷活動。 如果子類型設定為 AudienceVideoAds ，且行銷活動類型為 Audience，則行銷活動會是視訊對象營銷活動。 如果子類型設定為 ShoppingSmartAds，則該行銷活動是Microsoft智慧型手機購物活動。 如果子類型設定為 ShoppingSponsoredProductAd，則該行銷活動是品牌的Microsoft 購物活動。 加： 選擇性且不適用於大部分的營銷活動類型。 針對Microsoft 智慧型手機購物活動 ，您必須將子類型設定為 ShoppingSmartAds。 針對Microsoft 品牌的購物活動 ，您必須將子類型設定為 ShoppingSponsoredProductAd。 更新： 唯讀	string
TimeZone	此數據行已被取代。 營銷活動的運作時區。 時區用於報告和套用廣告群組的開始和結束日期。 如需可能的值，請參閱 時區。 使用實驗活動時，您無法設定 Budget、 BudgetType、 Status 或 TimeZone。 實驗活動的預算、狀態和時區一律繼承自基底營銷活動設定。 加： 必填 更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果營銷活動包含或曾經包含處於作用中或暫停狀態的廣告群組，您可能不會更新時區。	string
TrackingUrlTemplate	要作為營銷活動中所有 URL 預設使用的追蹤範本。 下列驗證規則適用於追蹤範本。 如需支援的範本和參數的詳細資訊，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？ - 針對較低層級實體定義的追蹤範本，例如廣告會覆寫針對較高層級實體設定的範本，例如營銷活動。 如需詳細資訊，請參閱 實體限制。 - 追蹤範本的長度限製為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。 - 追蹤範本必須是格式正確的 URL，開頭為下列其中一項： http://、 https://、 {lpurl} 或 {unescapedlpurl}。 - Microsoft Advertising 不會驗證自定義參數是否存在。 如果您在追蹤範本中使用自定義參數，但它們不存在，則登陸頁面 URL 會包含自定義參數的索引鍵和值佔位元，而不需替代。 例如，如果您的追蹤範本是 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} ，且 { _season} 或 {_promocode} 都未定義於行銷活動、廣告群組、準則、關鍵詞或廣告層級，則登陸頁面 URL 會相同。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。	string
UrlCustomParameters	用於 URL 追蹤的自訂索引鍵和值參數集合。 Microsoft Advertising 會接受您在 CustomParameters 物件中包含的前 8 個 CustomParameter 物件，而且如果您包含超過 8 個自定義參數，則會傳回錯誤。 每個 CustomParameter 都包含 Key 和 Value 元素。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 將 UrlCustomParameters 元素設定為 null 或空白，以保留任何現有的自定義參數。 若要移除所有自定義參數，請將 CustomParameters 物件的 Parameters 元素設定為 null 或空白。 若要移除自定義參數的子集，請在 CustomParameters 物件的 Parameters 元素中指定您想要保留的自定義參數。	CustomParameters

需求

服務： CampaignManagementService.svc v13
命名空間： https://bingads.microsoft.com/CampaignManagement/v13

消費者

AddCampaigns
GetCampaignsByAccountId
GetCampaignsByIds
UpdateCampaigns