關鍵字

發行項
11/13/2024

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

方法

方法名稱	傳回類型	說明
adParams	AdParamSelector	取得選取器，用來取得廣告中用於這個關鍵字的所有替代參數。
applyLabel (字串名稱)	void	將標籤套用至這個關鍵字。
投標	KeywordBidding	取得用來管理這個關鍵字的報價金額的方法。
clearDestinationUrl	void	移除這個關鍵字的目的地 URL。
使	void	啟用這個關鍵字。
getAdGroup	AdGroup	取得這個關鍵字所屬的廣告群組。
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 或目的地 URL 包含 {Param1}、{Param2}或 {Param3} 動態替代字串，則會在廣告中使用替代值。

傳回

類型	說明
AdParamSelector	選取器，其中包含這個關鍵字的替代參數清單。

applyLabel (字串名稱)

將標籤套用至關鍵字。

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

引數

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

傳回

類型	說明
void	會傳回 nothing。

投標

取得用來管理這個關鍵字的報價金額的方法。

傳回

類型	說明
KeywordBidding	包含用來管理這個關鍵字的報價金額的方法。

clearDestinationUrl

移除這個關鍵字的目的地 URL。

傳回

類型	說明
void	會傳回 nothing。

使

啟用這個關鍵字。

傳回

類型	說明
void	會傳回 nothing。

getAdGroup

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

傳回

類型	說明
AdGroup	這個關鍵字所屬的廣告群組。

getApprovalStatus

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

傳回

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

getCampaign

取得這個關鍵字所屬的行銷活動。

傳回

類型	說明
行銷活動	這個關鍵字所屬的行銷活動。

getEntityType

傳回此實體的類型。

傳回

類型	描述
字串	此實體的類型，也就是關鍵字。

getId

取得可唯一識別這個關鍵字的識別碼。

傳回

類型	描述
字串	可唯一識別這個關鍵字的識別碼。

getFirstPageCpc

取得廣告在提要欄位上顯示所需的預估報價。

傳回

類型	說明
double	廣告顯示在提要欄位上所需的預估報價。

getMatchType

取得這個關鍵字的比對類型。

傳回

類型	描述
字串	關鍵字的相符類型。可能的值為：廣泛短語確切如需這些類型的相關資訊，請參閱什麼是關鍵字比對類型，以及如何使用它們？

getQualityScore

取得這個關鍵字的品質分數。

傳回

類型	說明
整數	關鍵字的品質分數。分數的範圍是 1 到 10 (最高) 。如果無法計算關鍵字的品質分數，這個方法會傳回 Null。分數會藉由測量關鍵字和登陸頁面與客戶搜尋詞彙的相關性，顯示廣告在市集上的競爭力。如需詳細資訊，請參閱關鍵字效能報告。

getStats

取得這個關鍵字效能資料。

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

傳回

類型	說明
統計	關鍵字的效能資料。例如，按一下和曝光。

getText

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

如果比對類型很廣泛，關鍵字就是書籍;如果關鍵字使用廣泛類型修飾詞，則為+books。
如果比對類型為片語，關鍵字為「books」
如果相符類型完全相符，關鍵字為[hardcover books]

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

傳回

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

getTopOfPageCpc

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

傳回

類型	說明
double	廣告顯示在組織搜尋結果上方所需的預估報價。

isEnabled

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

傳回

類型	說明
布林值	如果啟用這個關鍵字，則為 true ;否則為 false。

isPaused

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

傳回

類型	說明
布林值	如果暫停這個關鍵字，則為 true ;否則為 false。

類型	說明
LabelSelector	選取器，用來篩選與這個關鍵字相關聯的標籤清單。

暫停

暫停這個關鍵字。

傳回

類型	說明
void	會傳回 nothing。

刪除

移除這個關鍵字。

傳回

類型	說明
void	會傳回 nothing。

removeLabel (字串名稱)

從關鍵字移除標籤。

引數

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

傳回

類型	說明
void	會傳回 nothing。

setAdParam (int index， string insertionText)

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

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

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

引數

名稱	類型	描述
index	int	要設定之替代參數的索引。有效的索引值為 1 到 3，包含在內。使用 1 表示 Param1,2 用於 Param2,3 用於 Param3。
insertionText	字串	要設定替代參數的文字。

傳回

類型	說明
void	會傳回 nothing。

Url

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

傳回

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

共用方式為

關鍵字

方法