關鍵字的成效指標和設定屬性。
這份報表只能透過非同步要求傳回 (也就是透過 Reports.request() 方法)。
要求摘錄
傳送一般的 Reports.request() 要求主體,但指定 "reportType": "keyword"
。
{ ... "reportType": "keyword", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
針對您要在報表中傳回或篩選的每個資料欄,指定下表中列出的 columnName
。您也可以視需要指定 headerText、startDate 和 endDate。請注意,部分欄無法篩選;請參閱下表中的「可篩選」。
columnName | 說明 | 行為 | 類型 | 可篩選 |
---|---|---|---|---|
status |
關鍵字的狀態:Active 、Paused 或 Removed 。請注意,廣告活動、廣告群組、關鍵字和廣告各有各自的狀態。請參閱狀態。 |
屬性 | Status |
相容 |
engineStatus |
在外部引擎帳戶,關鍵字的額外狀態。可能出現的狀態 (取決於外部帳戶類型) 包括 criterion rarely served 、criterion below first page bid 、criterion low quality score 、review 、campaign paused 等。 |
屬性 | String |
相容 |
creationTimestamp |
關鍵字建立時間戳記,格式為 ISO 8601。 | 屬性 | Timestamp |
相容 |
lastModifiedTimestamp |
關鍵字最近一次修改的時間戳記,採用 ISO 8601 格式。 | 屬性 | Timestamp |
相容 |
agency |
代理商名稱。 | 屬性 | String |
相容 |
agencyId |
DS 代理商 ID。 | 屬性 | ID |
相容 |
advertiser |
廣告客戶名稱。 | 屬性 | String |
相容 |
advertiserId |
DS 廣告客戶 ID。 | 屬性 | ID |
相容 |
account |
引擎帳戶名稱。 | 屬性 | String |
相容 |
accountId |
DS 引擎帳戶 ID。 | 屬性 | ID |
相容 |
accountEngineId |
外部引擎帳戶內的帳戶 ID。 | 屬性 | String |
相容 |
accountType |
引擎帳戶類型:Google AdWords 、Bing Ads 、Yahoo Japan Listing Ads 、Yahoo Search Marketing 、Yahoo Gemini 、Baidu 或 Comparison Shopping 。 |
屬性 | Engine type |
相容 |
campaign |
廣告活動名稱: | 屬性 | String |
相容 |
campaignId |
DS 廣告活動編號。 | 屬性 | ID |
相容 |
campaignStatus |
包含此項目的廣告活動狀態。 | 屬性 | Status |
相容 |
adGroup |
廣告群組名稱: | 屬性 | String |
相容 |
adGroupId |
DS 廣告群組編號。 | 屬性 | ID |
相容 |
adGroupStatus |
包含這個項目的廣告群組狀態。 | 屬性 | Status |
相容 |
keywordId |
DS 關鍵字編號。如果值為 0,表示關鍵字未歸功。 | 屬性 | ID |
相容 |
keywordMatchType |
關鍵字比對類型:Broad 、Exact 、Phrase 或 Content 。 |
屬性 | Match type |
相容 |
keywordText |
關鍵字文字。 | 屬性 | String |
相容 |
keywordEngineId |
外部引擎帳戶的關鍵字 ID。 | 屬性 | ID |
相容 |
keywordMaxCpc |
覆寫廣告群組的最高單次點擊出價,並設定您願意為這個特定關鍵字所支付的最高金額。如果這個欄位空白,關鍵字將使用廣告群組的最高單次點擊出價。 | 屬性 | Money |
相容 |
effectiveKeywordMaxCpc |
這個關鍵字目前採用的最高單次點擊出價。這個值會和廣告群組的最高單次點擊出價相同;如果關鍵字會覆寫廣告群組的設定,則會使用關鍵字本身的最高單次點擊出價。 | 屬性 | Money |
相容 |
keywordLandingPage |
使用者按下廣告後會前往的最終到達網址。詳情請參閱到達網頁和 Clickserver 網址。 | 屬性 | String |
相容 |
keywordClickserverUrl |
DS 用於追蹤活動的網址。使用者點擊廣告時,系統會先造訪 Clickserver 網址,然後再重新導向至最終到達網頁。詳情請參閱到達網頁和 Clickserver 網址。 | 屬性 | String |
相容 |
isDisplayKeyword |
指出這是用於製作多媒體廣告和刊登位置報表的預留位置關鍵字。 | 屬性 | Boolean |
相容 |
keywordMaxBid |
如果這個關鍵字是由 DS 出價策略管理,則出價策略絕對不會提高出價。請參閱為關鍵字套用出價策略一文。 | 屬性 | Money |
相容 |
keywordMinBid |
如果這個關鍵字是由 DS 出價策略管理,則出價策略的出價絕對不會低於這個上限。請參閱為關鍵字套用出價策略一文。 | 屬性 | Money |
相容 |
keywordUrlParams |
在到達網頁中加入額外網址參數。請參閱新增網址參數一文。 | 屬性 | String |
相容 |
bingKeywordParam2 |
Bing Ads 關鍵字的 Param2。 | 屬性 | String |
相容 |
bingKeywordParam3 |
Bing Ads 關鍵字的 Param3。 | 屬性 | String |
相容 |
keywordLabels |
直接指派給這個關鍵字的標籤名稱;不含沿用的標籤。 | 屬性 | String list |
相容 |
qualityScoreCurrent |
僅限 Google Ads 和 Bing Ads。關鍵字在引擎上的品質分數 (QS) 值的最新值。請注意,無論報表的時間範圍為何,此欄一律都會回報關鍵字的最新 QS。 | 屬性 | Integer |
相容 |
topOfPageBidCurrent |
僅限 Google Ads。這個預估值可以推算出您的廣告必須定期顯示在搜尋結果上方的目前單次點擊出價。請注意,無論報表的時間範圍為何,此欄一律會回報目前所需的單次點擊出價。 | 屬性 | Money |
相容 |
effectiveBidStrategyId |
指派給這個實體的出價策略 DS ID,或由這個實體沿用的出價策略 ID。 | 屬性 | ID |
相容 |
effectiveBidStrategy |
指派給這個實體的出價策略名稱,或是此實體沿用的出價策略名稱。 | 屬性 | String |
相容 |
bidStrategyInherited |
指出這個實體的出價策略是否沿用。 | 屬性 | Boolean |
相容 |
effectiveLabels |
沿用或直接指派給這個關鍵字的所有標籤名稱。 | 屬性 | String list |
相容 |
dfaActions |
Campaign Manager 動作總數。 | 指標 | Integer |
相容 |
dfaRevenue |
Campaign Manager 交易所產生的匯總收益。 | 指標 | Money |
相容 |
dfaTransactions |
Campaign Manager 交易總數。 | 指標 | Integer |
相容 |
dfaWeightedActions |
Campaign Manager 操作的加權總和。 | 指標 | Number |
相容 |
dfaActionsCrossEnv |
Campaign Manager 跨環境操作總數。 | 指標 | Number |
相容 |
dfaRevenueCrossEnv |
Campaign Manager 跨環境交易所產生的匯總收益。 | 指標 | Money |
相容 |
dfaTransactionsCrossEnv |
Campaign Manager 跨環境交易的總數。 | 指標 | Number |
相容 |
dfaWeightedActionsCrossEnv |
Campaign Manager 跨環境動作的加權總和。 | 指標 | Number |
相容 |
avgCpc |
平均單次點擊出價。 | 指標 | Money |
相容 |
avgCpm |
平均千次曝光出價。 | 指標 | Money |
相容 |
avgPos |
平均排名。 | 指標 | Number |
相容 |
clicks |
匯總點擊次數。 | 指標 | Integer |
相容 |
cost |
支付給引擎帳戶的匯總費用。 | 指標 | Money |
相容 |
ctr |
平均點閱率。 | 指標 | Number |
相容 |
impr |
曝光總數。 | 指標 | Integer |
相容 |
adWordsConversions |
廣告客戶已設定的資料,會顯示在 Google Ads「轉換」欄中。建立 Google Ads 轉換動作後,廣告客戶可以選擇是否要在「轉換報表」欄中計算這些轉換。 | 指標 | Number |
相容 |
adWordsConversionValue |
Google Ads 轉換的匯總價值。 | 指標 | Number |
相容 |
adWordsViewThroughConversions |
Google Ads 瀏覽後轉換總數。 | 指標 | Integer |
相容 |
visits |
DS 造訪總數。 | 指標 | Integer |
相容 |
qualityScoreAvg |
僅限 Google Ads 和 Bing Ads。在報表範圍中,所有日期及關鍵字的引擎品質分數 (QS) 曝光次數加權平均值。 | 指標 | Number |
相容 |
topOfPageBidAvg |
僅限 Google Ads。這個預估值表示在報表時間範圍內,您的廣告要定期顯示在搜尋結果上方上方的平均單次點擊出價。 | 指標 | Money |
相容 |
date |
將報表按日期區隔;每列及其匯總指標會拆分成多列,每列代表一天。這一欄會傳回每列的日期。 | 區隔 | Date |
相容 |
monthStart |
以月份區隔報表;每一列和其中的匯總指標會拆分成多列,每月各列一個。這一欄會傳回每列每月的第一天。 | 區隔 | Date |
相容 |
monthEnd |
以月份區隔報表;每一列和其中的匯總指標會拆分成多列,每月各列一個。此欄會傳回每列每月最後一天。 | 區隔 | Date |
相容 |
quarterStart |
以季度區隔報告;每列及其匯總指標會分成多個資料列,每季一個。這一欄會傳回每列季度的第一天。 | 區隔 | Date |
相容 |
quarterEnd |
以季度區隔報告;每列及其匯總指標會分成多個資料列,每季一個。此欄會傳回每列季度的最後一天。 | 區隔 | Date |
相容 |
weekStart |
以星期 (星期日到星期六) 區隔報表;每列及其匯總指標會分成好幾列,每欄一個星期。此欄會傳回每列的第一天 (星期日)。 | 區隔 | Date |
相容 |
weekEnd |
以星期 (星期日到星期六) 區隔報表;每列及其匯總指標會分成好幾列,每欄一個星期。這一欄會傳回每列最後一天 (週六)。 | 區隔 | Date |
相容 |
yearStart |
報表是按年份劃分;每列及其匯總指標會分成好幾列,每列每年。此欄會傳回每列的第一天。 | 區隔 | Date |
相容 |
yearEnd |
報表是按年份劃分;每列及其匯總指標會分成好幾列,每列每年。此欄會傳回每列一年的最後一天。 | 區隔 | Date |
相容 |
deviceSegment |
依照裝置區隔報表;每一列和其中的匯總指標會拆分成多列,每列顯示一個裝置區隔。這一欄會傳回每列的裝置區隔。 | 區隔 | Device segment |
相容 |
floodlightGroup |
依據 Floodlight 群組區隔報表;每列及其匯總指標會拆分成多列,每列最多一個 Floodlight 群組。這一欄會傳回每列的 Floodlight 群組名稱。請注意,部分指標沒有 Floodlight 區隔值,例如點擊和造訪次數。 | 區隔 | String |
相容 |
floodlightGroupId |
依據 Floodlight 群組區隔報表;每列及其匯總指標會拆分成多列,每列最多一個 Floodlight 群組。這一欄會傳回每列的 DS Floodlight 群組編號。請注意,部分指標沒有 Floodlight 區隔值,例如點擊和造訪次數。 | 區隔 | ID |
相容 |
floodlightGroupTag |
依據 Floodlight 群組區隔報表;每列及其匯總指標會拆分成多列,每列最多一個 Floodlight 群組。這一欄會傳回每列的 Floodlight 群組代碼。請注意,部分指標沒有 Floodlight 區隔值,例如點擊和造訪次數。 | 區隔 | String |
相容 |
floodlightActivity |
依據 Floodlight 活動區隔報表;每列及其匯總指標會拆分成多個資料列,每個 Floodlight 活動最多一個。這一欄會傳回每列的 Floodlight 活動名稱。請注意,部分指標沒有 Floodlight 區隔值,例如點擊和造訪次數。 | 區隔 | String |
相容 |
floodlightActivityId |
依據 Floodlight 活動區隔報表;每列及其匯總指標會拆分成多個資料列,每個 Floodlight 活動最多一個。這一欄會傳回每列的 DS Floodlight 活動編號。請注意,部分指標沒有 Floodlight 區隔值,例如點擊和造訪次數。 | 區隔 | ID |
相容 |
floodlightActivityTag |
依據 Floodlight 活動區隔報表;每列及其匯總指標會拆分成多個資料列,每個 Floodlight 活動最多一個。這一欄會傳回每列的 Floodlight 活動廣告代碼。請注意,部分指標沒有 Floodlight 區隔值,例如點擊和造訪次數。 | 區隔 | String |
相容 |
ad |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每一列中傳回廣告名稱。 | 區隔 | String |
相容 |
adId |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每列傳回廣告的 DS ID。 | 區隔 | ID |
相容 |
isUnattributedAd |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會指出此列中的指標無法歸因於特定廣告。 | 區隔 | Boolean |
相容 |
adHeadline |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每列傳回廣告標題。 | 區隔 | String |
相容 |
adHeadline2 |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每個資料列傳回廣告標題 2。不適用於部分引擎。 | 區隔 | String |
相容 |
adHeadline3 |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。此欄會在每列傳回廣告標題 3。不適用於部分引擎。 | 區隔 | String |
相容 |
adDescription1 |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每列中傳回廣告的說明行 1。 | 區隔 | String |
相容 |
adDescription2 |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每列中傳回廣告的說明行 2。 | 區隔 | String |
相容 |
adDisplayUrl |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每列傳回廣告顯示網址。 | 區隔 | String |
相容 |
adLandingPage |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每個資料列中傳回廣告的到達網頁。 | 區隔 | String |
相容 |
adType |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每一列中傳回廣告類型:Text 或 Product 。 |
區隔 | Ad type |
相容 |
adPromotionLine |
依照廣告區隔報表;每列及其匯總指標會分成多個資料列,每個廣告最多一個。這一欄會在每個資料列傳回產品廣告的宣傳行。 | 區隔 | String |
相容 |