共用方式為

關鍵詞數據物件 - 營銷活動管理

  • 發行項

定義關鍵詞。

關鍵詞是尋找產品或服務時所搜尋的單字或片語。 例如，關鍵詞可以是下列任一項：

  • 鞋
  • 郵輪假期
  • 紐約的課堂課程

如上所示，關鍵詞可以只是單一字組、數個字組，甚至是片語。 在搜尋廣告的內容中，所有這些都稱為關鍵詞。

重要事項

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

語法

<xs:complexType name="Keyword" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Bid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:KeywordEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q32="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q32:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q33="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q33:ArrayOfstring" />
    <xs:element xmlns:q34="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q34:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MatchType" nillable="true" type="tns:MatchType" />
    <xs:element minOccurs="0" name="Param1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param3" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:KeywordStatus" />
    <xs:element minOccurs="0" name="Text" 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:sequence>
</xs:complexType>

元素

Keyword 物件具有下列元素：Bid、WizardScheme、DestinationUrl、ApprovalStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、MatchType、Param1、Param2、Param3、Status、Text、TrackingUrlTemplate、UrlCustomParameters。

元素 描述 資料類型
出價 每次有人按下您的廣告時，您想要支付的最大金額。

您使用相同的關鍵詞來向其他廣告商進行報價，因此一般而言，較高的報價有助於讓您的廣告顯示在搜尋結果頁面上更理想的位置。

您可以為每個關鍵詞設定自定義的報價，而不是使用預設的廣告群組層級的約定。 關鍵詞的自定義標示會覆寫這些特定關鍵詞的廣告群組默認報價。 透過自定義的報價，您可以將時間和金錢放在最獲利的關鍵詞上，但需要花更多時間來管理個別的報價。

如果未設定關鍵詞層級的比對，則會使用 Ad 群組 Bid 。 如需詳細資訊，請參閱 預算和中標策略。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 若要刪除關鍵詞 bid 並使用 AdGroup 預設比對類型 bid，請將 Bid 物件的 Amount 元素設定為 null。		 出價
函數架構 您要如何管理您的報價的中標策略類型。

如需每個營銷活動類型的支援中標價策略的詳細資訊，請參閱 預算和約價策略。

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

加： 自選。 如果您未設定此元素，則預設會使用 InheritFromParentBiddingScheme 。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 函數架構
DestinationUrl 當使用者按兩下廣告時，要帶使用者前往的網頁URL。 如果指定，則會使用關鍵詞的目的地 URL;否則會使用廣告的目的地 URL。

重要： 自 2018 年 11 月起，無法新增或更新關鍵詞目的地 URL。 您可以改用 最終 URL 。 如需詳細資訊，請參閱將 關鍵詞目的地 URL 移轉至最終 URL。

加： 不允許
更新： 不允許		 string
編輯狀態 關鍵詞的編輯檢閱狀態，指出關鍵詞是否擱置檢閱、已核准或已取消核准。

加： 唯讀
更新： 唯讀		 KeywordEditorialStatus
FinalAppUrls 供日後使用。 AppUrl 陣 列
FinalMobileUrls 行動登陸頁面 URL。 如果指定，則會使用關鍵詞的最終行動URL;否則，會使用廣告的最終行動URL。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 字串陣列
FinalUrls 登陸頁面 URL。 如果指定，則會使用關鍵詞的最終URL;否則，會使用廣告的最終 URL。

下列驗證規則適用於最終 URL 和最終行動 URL。
- URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 您最多可以為 FinalUrls 和FinalMobileUrls 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。
- 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。
- 最終 URL 必須是以 http:// 或 https:// 開頭且格式正確的 URL。
- 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。
- 如果裝置喜好設定設定為行動裝置，您可能無法指定 FinalMobileUrls 。 另請注意，如果已設定 TrackingUrlTemplate 或 UrlCustomParameters 元素，則至少需要一個最終 URL。 如需詳細資訊，請參閱 URL 追蹤與升級的 URL。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 字串陣列
FinalUrlSuffix 最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。		 KeyValuePairOfstringstring 陣 列
標識碼 系統產生的 關鍵詞標識碼。

加： 唯讀
更新： 必填		 長
MatchType 要比較關鍵詞和用戶搜尋字詞的相符類型。

加： 必填
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 MatchType
Param1 如果廣告的標題、文字、顯示 URL 或目的地 URL 包含 {Param1} 動態替代字串，則要作為廣告替代值的字串串。

雖然您可以使用 {Param1} 來指定廣告的目的地 URL，但建議您不要這麼做。 相反地，您應該設定關鍵詞的 DestinationUrl 元素。

字串最多可以包含 1,022 個字元。 實際的限制取決於參考替代字串的項目長度。 例如，文字廣告標題的長度最多可以包含 25 個字元。

在廣告復本中實作動態文字時，您應該提供預設字串，例如{Param1：default}，如果關鍵詞的 Param1 為 Null 或空白，或包含 Param1 替代值，則會造成展開的字符串超過元素的限制;否則，廣告將不會與這個關鍵詞一起使用。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。

另請注意，如果廣告群組只有一個廣告，而且該廣告使用 {Param1}，但未提供預設字串，例如 {Param1：default}，則您必須為該替代提供有效的 Param1 值。 否則無法新增或更新這個關鍵詞。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
Param2 如果標題、文字、顯示 URL 或目的地 URL 包含 {Param2} 動態替代字串，則要作為廣告替代值的字串。

一般而言，您會在廣告的標題或文字中使用 {Param2} 替代字串 (廣告複製描述) 元素。

字串最多可以包含 70 個字元。 實際的限制取決於參考替代字串的項目長度。 例如，文字廣告標題的長度最多可以包含 25 個字元。

在廣告復本中實作動態文字時，您應該提供預設字串串，例如{Param2：default}，如果關鍵詞的 Param2 為 Null 或空白，或包含 Param2 替代值，則會造成展開的字符串超過元素的限制;否則，廣告將不會與這個關鍵詞一起使用。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。

另請注意，如果廣告群組只有一個廣告，而且該廣告使用 {Param2}，但未提供預設字串，例如 {Param2：default}，則您必須為該替代提供有效的 Param2 值。 否則無法新增或更新這個關鍵詞。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
Param3 如果標題、文字、顯示 URL 或目的地 URL 包含 {Param3} 動態替代字串，則要作為廣告替代值的字串。

一般而言，您會在廣告的標題或文字 (廣告複製描述) 元素中使用 {Param3} 替代字串。

字串最多可以包含 70 個字元。 實際的限制取決於參考替代字串的項目長度。 例如，文字廣告標題的長度最多可以包含 25 個字元。

在廣告復本中實作動態文字時，您應該提供預設字串串，例如{Param3：default}，如果關鍵詞的 Param3 為 Null 或空白，或包含 Param3 替代值，則會造成展開的字符串超過元素的限制;否則，廣告將不會與這個關鍵詞一起使用。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。

另請注意，如果廣告群組只有一個廣告，而且該廣告使用 {Param3}，但未提供預設字串，例如 {Param3：default}，則您必須為該替代提供有效的 Param3 值。 否則無法新增或更新這個關鍵詞。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
地位 關鍵詞的狀態。 根據預設，狀態會設定為 [作用中]。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 KeywordStatus
發簡訊 關鍵詞文字。 文字最多可以包含100個字元。 您應該在為關鍵詞所屬的廣告群組指定之 Language 值的地區設定中指定 關鍵詞。

加： 必填
更新： 唯讀		 string
TrackingUrlTemplate 要作為所有 FinalUrls 和FinalMobileUrls 預設值的追蹤範本。

下列驗證規則適用於追蹤範本。 如需支援的範本和參數的詳細資訊，請參閱 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
Namespace： https://bingads.microsoft.com/CampaignManagement/v13

消費者

AddKeywords
GetKeywordsByAdGroupId
GetKeywordsByEditorialStatus
GetKeywordsByIds
UpdateKeywords