關鍵字

包含管理關鍵字的方法。 如需關鍵字的相關資訊，請參閱 關鍵字。

方法

方法名稱 傳回類型 描述
adParams AdParamSelector 取得用來取得廣告中針對此關鍵字所用的所有替代參數的選取器。
applyLabel (字串名稱) void 將標籤套用至此關鍵字。
出價 KeywordBidding 取得用來管理此關鍵字出價金額的方法。
clearDestinationUrl void 移除這個關鍵字的連結網址。
[啟用] void 啟用此關鍵字。
getAdGroup 廣告群組 取得此關鍵字所屬的廣告群組。
getApprovalStatus 字串 取得此關鍵字的編輯核准狀態。
getCampaign 行銷活動 取得此關鍵字所屬的廣告活動。
getEntityType 字串 取得此實體的類型。
getFirstPageCpc double 取得需要出現在搜尋結果第一頁的預估出價。
getId 字串 取得唯一識別此關鍵字的識別碼。
getMatchType 字串 取得此關鍵字的比對類型。
getQualityScore 整數 取得此關鍵字的品質評分。
getStats 統計資料 取得此關鍵字的廣告成效資料。
getText 字串 取得關鍵字的文字。
getTopOfPageCpc double 取得需要出現在搜尋結果頂端的預估出價。
isEnabled 布林值 取得布林值，指出是否已啟用此關鍵字。
isPaused 布林值 取得布林值，指出此關鍵字是否已暫停。
標籤 LabelSelector 取得用來篩選與此關鍵字相關聯之標籤清單的 選取器 。
暫停 void 暫停此關鍵字。
remove void 移除此關鍵字。
removeLabel (字串名稱) void 移除此關鍵字的標籤。
setAdParam (int index， string insertionText) void 新增替代參數，並將其值設定為指定的文字。
URL KeywordUrls 取得用來管理此關鍵字的最終 URL、追蹤範本和自訂參數的方法。

adParams

取得此關鍵字廣告中使用的所有替代參數的選取器。

如果廣告標題、文字、顯示網址或目的地 URL 包含 {Param1}、{Param2} 或 {Param3} 動態替代字串，則廣告中會使用替代值。

傳回

類型 描述
AdParamSelector 包含此關鍵字替代參數清單的選取器。

applyLabel (字串名稱)

將標籤套用至關鍵字。

一個關鍵字最多可以套用 50 個標籤。 如需將標籤新增至關鍵字的範例，請參閱 使用標籤。

引數

名稱 類型 描述
Name 字串 標籤的區分大小寫的名稱。 若要取得此帳戶中可套用的標籤清單，請參閱 AdsApp.labels。

傳回

類型 描述
void 會傳回 nothing。

出價

取得用來管理此關鍵字出價金額的方法。

傳回

類型 描述
KeywordBidding 包含用來管理此關鍵字出價金額的方法。

clearDestinationUrl

移除這個關鍵字的連結網址。

傳回

類型 描述
void 會傳回 nothing。

[啟用]

啟用此關鍵字。

傳回

類型 描述
void 會傳回 nothing。

getAdGroup

取得此關鍵字所屬的廣告群組。

傳回

類型 描述
廣告群組 此關鍵字所屬的廣告群組。

getApprovalStatus

取得此關鍵字的編輯核准狀態。

傳回

類型 描述
字串 關鍵字的編輯核准狀態。 狀態指出關鍵字是否正在檢閱、已核准或不允許。 可能的值為：
  • 已核准
  • APPROVED_LIMITED
  • 未核准
  • UNDER_REVIEW
如需這些狀態值如何對應至 Bing Ads API 的相關資訊，請參閱 對應編輯核准狀態值。

getCampaign

取得此關鍵字所屬的廣告活動。

傳回

類型 描述
行銷活動 此關鍵字所屬的廣告活動。

getEntityType

傳回此實體的類型。

傳回

類型 描述
字串 此實體的類型，即 關鍵字。

getId

取得唯一識別此關鍵字的識別碼。

傳回

類型 描述
字串 唯一識別此關鍵字的 ID。

getFirstPageCpc

取得廣告在側邊欄上顯示所需的預估出價。

傳回

類型 描述
double 廣告要在側邊欄顯示所需的預估出價。

getMatchType

取得此關鍵字的比對類型。

傳回

類型 描述
字串 關鍵字的比對類型。 可能的值為：
  • 廣泛
  • 字詞
  • EXACT
如需這些類型的詳細資訊，請參閱 什麼是關鍵字比對類型？以及如何使用它們？

getQualityScore

取得此關鍵字的品質評分。

傳回

類型 描述
整數 關鍵字的品質評分。 分數介於 1 到 10 的範圍內 (最高) 。 如果無法計算關鍵字的品質評分，這個方法會傳回 NULL。

此分數會顯示廣告在市場的競爭力如何，方法是衡量關鍵字和登陸頁面與客戶搜尋字詞的相關性。 如需詳細資訊，請參閱 關鍵字廣告成效報表。

getStats

取得此關鍵字廣告成效資料。

若要呼叫這個方法，您必須在關鍵字選取器的鏈結中包含其中一個forDateRange方法。

傳回

類型 描述
統計資料 關鍵字的廣告成效資料。 例如，點選數和曝光數。

getText

取得關鍵字的文字。 文字包含關鍵字的比對類型語法 （如果有）。 例如：

  • 如果比對類型為廣泛比對類型，則關鍵字為 books，如果關鍵字使用廣泛類型修飾詞，則關鍵字為 +books
  • 如果比對類型為片語，則關鍵字為 “books”
  • 如果比對類型完全符合，則關鍵字為 [精裝書]

如需這些類型的詳細資訊，請參閱 什麼是關鍵字比對類型？以及如何使用它們？

傳回

類型 描述
字串 關鍵字的文字。

getTopOfPageCpc

取得廣告顯示在組織搜尋結果上方所需的預估出價。

傳回

類型 描述
double 廣告要顯示在自然搜尋結果上方所需的預估出價。

isEnabled

取得布林值，指出是否已啟用此關鍵字。

傳回

類型 描述
布林值 如果已啟用此關鍵字，則為 True ;否則為 false。

isPaused

取得布林值，指出此關鍵字是否已暫停。

傳回

類型 描述
布林值 如果此關鍵字已暫停，則為 True ;否則為 false。

標籤

取得用來篩選與此關鍵字相關聯之標籤清單的 選取器 。

傳回

類型 描述
LabelSelector 用來篩選與此關鍵字相關聯的標籤清單的選取器。

暫停

暫停此關鍵字。

傳回

類型 描述
void 會傳回 nothing。

移除

移除此關鍵字。

傳回

類型 描述
void 會傳回 nothing。

removeLabel (字串名稱)

移除關鍵字中的標籤。

引數

名稱 類型 描述
Name 字串 標籤的區分大小寫的名稱。 若要取得與此關鍵字相關聯的標籤清單，請參閱 標籤。

傳回

類型 描述
void 會傳回 nothing。

setAdParam (int index， string insertionText)

新增替代參數，並將其值設定為指定的文字。 如果 substitution 參數存在，則會覆寫其文字。

如果廣告標題、文字、顯示網址或最終 URL 包含 {Param1}、{Param2} 或 {Param3} 動態替代字串時，就會在廣告中使用替代值。 如需限制和使用這些參數的資訊，請參閱 參數 1、 參數 2 和 參數 3。

如果範本指定了 {param1：default}、{param2：default} 或 {param3：default} 預留位置，則追蹤範本中也會使用替代值。

引數

名稱 類型 描述
index int 要設定的替代參數索引。 有效的索引值為 1 到 3（含）。 使用 1 來表示參數 1、使用 2 來表示參數 2，以及使用 3 來表示參數 3。
insertionText 字串 要設定替代參數的文字。

傳回

類型 描述
void 會傳回 nothing。

URL

取得用來管理此關鍵字的最終 URL、追蹤範本和自訂參數的方法。

傳回

類型 描述
KeywordUrls 包含關鍵字的最終 URL、追蹤範本和自訂參數所使用的方法。

另請參閱

  • Last updated on