AdGroup 資料物件 - 行銷活動管理
定義廣告營銷活動中的廣告群組。
注意事項
自 2024 年 7 月起，您無法再設定要將廣告顯示到 [同步搜尋][搜尋][ Only] 的搜尋網路。 如果您嘗試將它設定為 SyndicatedSearchOnly，則會傳回 CampaignServiceInvalidNetwork 錯誤。
<xs:complexType name="AdGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AdRotation" nillable="true" type="tns:AdRotation" />
<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="CommissionRate" nillable="true" type="tns:RateBid">
<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="CpcBid" nillable="true" type="tns:Bid" />
<xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q21="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q21:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="FrequencyCapSettings" nillable="true" type="tns:ArrayOfFrequencyCapSettings">
<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="Language" nillable="true" type="xs:string" />
<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="Network" nillable="true" type="tns:Network" />
<xs:element minOccurs="0" name="PercentCpcBid" nillable="true" type="tns:RateBid">
<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="PrivacyStatus" nillable="true" type="tns:AdGroupPrivacyStatus" />
<xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
<xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
<xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdGroupStatus" />
<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="UseOptimizedTargeting" 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="UsePredictiveTargeting" 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="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="AdGroupType" nillable="true" type="xs:string">
<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="CpvBid" nillable="true" type="tns:Bid">
<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="CpmBid" nillable="true" type="tns:Bid">
<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="McpaBid" nillable="true" type="tns:Bid">
<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>
元素
AdGroup 物件具有下列元素：AdGroupType、AdRotation、AdScheduleUseSearcherTimeZone、AudienceAdsBidAdjustment、ArrangeScheme、CommissionRate、BidBid、CpmBid、CpvBid、EndDate、FinalUrlSuffix、ForwardCompatibilityMap、FrequencyCapSettings、Id、Language、McpaBid、MultimediaAdsBidAdjustment， Name， Network， PercentCpcBid， PrivacyStatus， Settings， StartDate， Status， TrackingUrlTemplate， UrlCustomParameters， UseOptimizedTargeting， UsePredictiveTargeting.
| 元素 | 描述 | 資料類型 |
|---|---|---|
| AdGroupType | 廣告群組類型。 在 CampaignType 為 “Search” 的混合營銷活動中，不會設定 ExperimentId，而且 [設定] 已經有有效的 DynamicSearchAdsSetting，可能的值為 “SearchDynamic” 和 “SearchStandard”。 否則，「搜尋」活動內的廣告群組類型只能設定為 「SearchStandard」。。 如果廣告群組類型為 「SearchDynamic」，則您只能在此廣告群組內新增動態搜尋廣告。 如果廣告群組類型為 「SearchStandard」，則您可以在此廣告群組中新增展開的文字廣告或回應式搜尋廣告。 “DynamicSearchAds” 活動內的廣告群組類型只能設定為 “SearchDynamic”。 您不需要設定 「DynamicSearchAds」 活動的廣告群組類型，但請注意，當您擷取廣告群組時，此元素會設定為 “SearchDynamic”。 此欄位可以設定為 「Hotel」 或 「Search」 行銷活動類型的 HotelAds 。 無法為「物件」或「購物」營銷活動類型設定此元素。 當您在不支持的活動中擷取廣告群組時，將不會設定此元素。 加： 自選。 「搜尋」活動的預設值為 「SearchStandard」。 “DynamicSearchAds” 活動的預設值為 “SearchDynamic”。 更新： 唯讀。 您無法更新廣告群組類型。 |
string |
| AdRotation | 廣告輪替會設定如果您在廣告群組內有多個廣告，Microsoft Advertising 選取要提供哪些廣告的頻率。 由於一次只能顯示一個來自您帳戶的廣告，因此廣告輪替會優先處理在統計上較可能表現更好的廣告。 注意：廣告輪替不適用於產品廣告。 廣告旋轉 類型的 可能值為 OptimizeForClicks 和 RotateAdsEvenly。 如果設定為 OptimizeForClicks，Microsoft廣告會根據廣告特性或因素，例如關鍵詞、搜尋字詞、裝置或位置，將廣告群組中的廣告優先順序設定為最佳表現機會。 執行效能較佳的廣告會更頻繁地顯示，而其他廣告則會更不常提供。如果有的話。 如果設定為 RotateAdsEvenly，Microsoft Advertising 可在您的廣告之間提供更多旋轉平衡。 也就是說，特定廣告群組中的廣告有類似的機會顯示，以響應搜尋者的查詢。 如果廣告的廣告品質較低，則優先順序較低，因此顯示頻率較低，或完全不會顯示。 - RotateAdsEvenly 設定可讓效能較低的廣告顯示為效能較佳的廣告。 這可能會影響廣告群組效能。 - 如果您使用自動化的報價策略，例如 MaxClicks、MaxConversions、TargetCpa 或 TargetRoas，則會忽略 RotateAdsEvenly 設定，因為這些報價策略會優先處理效能較佳的廣告。 加： 自選。 預設值為 OptimizeForClicks。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
AdRotation |
| AdScheduleUseSearcherTimeZone | 判斷是要使用帳戶時區，還是廣告可傳遞之搜尋使用者的時區。 如果您想要在搜尋使用者的時區中顯示廣告，並將此屬性設定為 true ，否則將其設定為 false。 預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetAdGroupsByCampaignId 和 GetAdGroupsByIds 服務作業時，在 ReturnAdditionalFields 元素中包含 AdScheduleUseSearcherTimeZone 值。 加： 自選。 如果您未指定此元素或將其保留空白，則會設定 true 的預設值，並使用搜尋使用者的時區。 在 2020 年 9 月 30 日之後，如果您未指定此欄位或將其保留空白，則會設定預設值 false ，並使用帳戶時區。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
布爾 |
| AudienceAdsBidAdjustment | 調整您在基底廣告群組或關鍵詞廣告的上方或下方的廣告的報價量百分比。 如果客戶已針對Microsoft對象網路啟用，則此屬性可在搜尋活動中使用。 智慧 型購物活動無法使用此屬性。 支援的值為負 100 (-100) 到正 900 (900) 。 將約定調整為 -100% 將會防止對象廣告顯示此廣告群組。 如果您不想對觀眾廣告進行任何報價調整，請將此元素設定為零 (0) 。 如果此元素為 Null，您將繼承廣告群組的 Campaign 的 AudienceAdsBidAdjustment 設定。 加： 自選 更新： 自選。 只有當您同時將 UpdateAudienceAdsBidAdjustment 元素設定為 true 時，才會更新此屬性，否則會忽略此屬性。 如果廣告群組已經有原生報價調整，而且您想要移除它以有效地繼承廣告群組的 Campaign 的 AudienceAdsBidAdjustment 設定，請將此元素設定為 null。 |
int |
| 函數架構 | 您要如何管理您的報價的中標策略類型。 注意： 自 2021 年 4 月起，您無法為廣告群組或關鍵詞設定任何報價策略。 如果您嘗試設定廣告群組或關鍵詞的報價策略，則會忽略要求而不會發生錯誤。 廣告群組和關鍵詞會繼承其營銷活動的報價策略。 加： 自選。 如果您未設定此元素，則預設會使用 InheritFromParentBiddingScheme 。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
函數架構 |
| SecRate | 當某人預訂旅館並留在該處時，向廣告商收取的費率。 | RateBid |
| 馬來比斯比特 | 當使用者的查詢和廣告群組的關鍵詞相符時，使用廣泛、精確或片語比對比較的預設要使用。 最低和最大比對範圍取決於帳戶的貨幣。 如需詳細資訊，請參閱 貨幣。 在關鍵詞層級指定廣泛、精確或片語比對比標，會覆寫廣告群組的對應比對類型之致比標值。 加： 自選。 如果您未設定申請，則會根據您帳戶的貨幣將它設定為最小值。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
出價 |
| CpmBid | 手動 CPM 報價策略類型。 使用 ManualCpm (每千) 手動成本的報價策略，您會設定每千個曝光數所要支付的最高金額，Microsoft Advertising 每次都會使用這些報價。 預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetAdGroupsByCampaignId 和 GetAdGroupsByIds 服務作業時，在 ReturnAdditionalFields 元素中包含 CpmBid 值。 |
出價 |
| CpvBid | 手動 CPV 比對策略類型。 使用 ManualCpv (手動每一檢視成本) 的報價策略，您可以設定您想要在每次觀看或點選視訊廣告時支付的最高金額，Microsoft廣告每次都會使用這些報價。 預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetAdGroupsByCampaignId 和 GetAdGroupsByIds 服務作業時，在 ReturnAdditionalFields 元素中包含 Cpv 值。 |
出價 |
| EndDate | 廣告群組中的廣告到期日期。 如果您未指定結束日期，廣告將不會過期。 結束日期可以延長，讓廣告群組的廣告符合傳遞資格，即使在廣告群組過期之後也一樣。 結束日期包含在內。 例如，如果您將 EndDate 設定為 2020/12/31，廣告群組中的廣告將會在 2020 年 12 月 31 日下午 11：59 到期。 時間是以您在營銷活動層級指定的時區為基礎。 加： 自選。 若要在新增廣告群組時不設定結束日期，請將此元素設定為 Null。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 若要刪除現有的結束日期設定，並在更新廣告群組時有效地設定任何結束日期，請將結束日期設定為等於或晚於 2050 年 1 月 2 日。 當您下次擷取廣告群組時，此元素將會是 nil，也就是不會設定為 2050 年 1 月 2 日。 |
Date |
| FinalUrlSuffix | 最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。 |
string |
| ForwardCompatibilityMap | 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。 |
KeyValuePairOfstringstring 陣 列 |
| FrequencyCapSettings | 頻率上限的設定。 | FrequencyCapSettings 陣列 |
| 標識碼 | 系統產生的廣告群組標識碼。 加： 不允許。 更新： 唯讀和必要 |
長 |
| 語言 | 您的 廣告語言 設定會決定您撰寫廣告時將使用的語言，而且應該是客戶的語言。 重要： 如果在廣告群組和營銷活動層級設定語言，廣告群組層級語言將會覆寫行銷活動層級語言。 搜尋和購物活動支援的語言字串包括：芬蘭文、克羅埃西亞文、捷克文、丹麥文、荷蘭文、英文、愛沙尼亞文、芬蘭文、法文、德文、希臘文、匈牙利文、義大利文、拉脫維亞文、立陶宛文、馬特斯文、挪威文、波蘭文、葡萄牙文、羅馬尼亞文、斯洛伐克文、斯洛維尼亞文、西班牙文、瑞典文和傳統語言。 注意： 下列語言尚無法供所有人使用：匈牙利文、克羅埃西亞文、捷克文、愛沙尼亞文、希臘文、匈牙利文、拉脫維亞文、立陶宛文、馬特斯文、波蘭文、羅馬尼亞文、斯洛伐克文、斯洛維尼亞文。 針對動態搜尋廣告營銷活動，會忽略行銷活動和廣告群組層級語言設定，而改用網站 網域語言。 您應該將營銷活動 語言 設定為 [全部]，並將廣告群組層級語言保留空白。 對於對象行銷活動中的廣告群組，不支援廣告群組層級語言，而且您必須將廣告群組營銷活動的 Languages 元素設定 為 “All”。 加： 如果營銷活動已設定一或多個語言，則為選擇性，否則大部分的營銷活動類型都需要該語言。 不允許您在物件活動中為廣告群組設定此元素。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 若要移除語言並延後至營銷活動層級語言，請將這個項目設定為空字串值 (“”) 。 |
string |
| McpaBid | 手動 CPA 比對策略類型。 使用 ManualCpa (手動成本的每個動作) 的報價策略，您可以設定每個廣告商指定的大量動作。 | 出價 |
| MultimediaAdsBidAdjustment | 在基底廣告群組或關鍵詞中，調整多媒體廣告的報價百分比。 | int |
| 名稱 | 廣告群組的名稱。 此名稱在營銷活動內的所有作用中廣告群組中必須是唯一的。 名稱最多可以包含 256 個字元。 加： 必填 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
string |
| 網路 | 您想要顯示廣告的搜尋網路。 大部分營銷活動類型內廣告群組支持的網路值為 OwnedAndOperatedAndSyndicatedSearch 和 OwnedAndOperatedOnly。 針對對象營銷活動中的廣告群組，不支援廣告群組層級網路。 廣告群組位於Microsoft對象網路中。 針對 智慧型手機購物活動中的廣告群組，您無法設定網路。 服務會將網路設定為 OwnedAndOperatedAndSyndicatedSearch。 針對品牌購物活動中的廣告群組，除了 OwnedAndOperatedAndSyndicatedSearch 和 OwnedAndOperatedOnly 之外，僅支援 InHousePromotion 網路 (零售商網路) 。 如果您選取其中一個同步搜尋選項，您可以呼叫 SetNegativeSitesToAdGroups 或 SetNegativeSitesToCampaigns 作業，以防止廣告顯示在特定的同步搜尋網站上。 如需網路和廣告散發的詳細資訊，請參閱 關於廣告發佈 說明文章。 加： 自選。 預設值為 OwnedAndOperatedAndSyndicatedSearch。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
網路 |
| PercentCpcBid | 在每小時旅館總價格 (，包括稅金和費用) 等百分比的商家報價策略類型。 | RateBid |
| PrivacyStatus | 指出您的廣告群組目標準則是否太窄，例如 ProfileCriterion 對於對象營銷活動中的廣告群組而言太窄。 加： 唯讀 更新： 唯讀 |
AdGroupPrivacyStatus |
| 設定 | 通常會因營銷活動類型而異的廣告群組設定。 在設定清單中，每個設定類型最多可以包含一個物件，例如一個 TargetSetting。 TargetSetting 可以與任何行銷活動類型搭配使用，並判斷與此廣告群組相關聯的 Age、Audience、CompanyName、Gender、Industry 和 JobFunction 準則是否使用 [目標和報價] 選項或 [僅限申請] 目標選項。 在 TargetSetting 內，您可以有多個 TargetSettingDetail 物件，也就是每個 CriterionTypeGroup 一個。 加： 自選。 如果這個專案不包含 TargetSetting 物件，則所有準則類型群組的預設 bid 選項實際上是「僅限標價」。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
設定陣 列 |
| StartDate | 廣告群組中的廣告可以開始供應的日期;否則，服務可以在廣告群組開始使用時，開始在廣告群組中提供廣告。 開始日期包含在內。 例如，如果您將開始日期設定為 5/5/2021，廣告群組中的廣告將會在 2021 年 5 月 5 日上午 12：00 開始。 時間是以您在營銷活動層級指定的時區為基礎。 加： 自選。 如果您未設定開始日期，則預設為今天的日期，而且只要廣告群組狀態為作用中，服務就可以開始在廣告群組中提供廣告。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 提交廣告群組之後，也就是開始日期到達之後，就無法更新開始日期。 |
Date |
| 地位 | 廣告群組的狀態。 可能的值為 Active、 Expired 和 Paused。 [ 過期 ] 狀態是唯讀狀態。 加： 自選。 預設值為 Paused。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
AdGroupStatus |
| 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 |
| UseOptimizedTargeting | 這將會被取代。 請改 用 UsePredictiveTargeting 。 | 布爾 |
| UsePredictiveTargeting | 指出是否已針對 AdGroup 啟用預測性目標。 注意：UsePredictiveTargeting 僅適用於對象營銷活動。 加： 自選 更新： 自選。 |
布爾 |
需求
服務： CampaignManagementService.svc v13
命名空間： https://bingads.microsoft.com/CampaignManagement/v13
消費者
AddAdGroups
GetAdGroupsByCampaignId
GetAdGroupsByIds
UpdateAdGroups