關鍵字的成效指標和設定屬性。
這份報表只能由非同步要求 (也就是透過 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。 | 屬性 | ID |
是 |
campaignStatus |
含有這個項目的廣告活動狀態。 | 屬性 | Status |
是 |
adGroup |
廣告群組名稱： | 屬性 | String |
是 |
adGroupId |
DS 廣告群組 ID。 | 屬性 | 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) 的最近值。請注意，不論報表時間範圍為何，這一欄一律會回報關鍵字的最新品質分數。 | 屬性 | Integer |
是 |
topOfPageBidCurrent |
僅適用於 Google Ads。這一欄可推算要讓廣告經常顯示在搜尋結果上方頂端位置，您目前需要的單次點擊出價。請注意，不論報表時間範圍為何，這一欄一律會回報目前所需的單次點擊出價。 | 屬性 | Money |
是 |
effectiveBidStrategyId |
指派給這個實體的出價策略 DS 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 群組 ID。請注意，部分指標並沒有 Floodlight 區隔值，例如點擊次數和造訪次數。 | 區隔 | ID |
是 |
floodlightGroupTag |
依 Floodlight 群組區隔報表；每個資料列及其匯總指標會分成多個資料列，每個 Floodlight 群組最多可以顯示一列。此欄會傳回每列的 Floodlight 群組代碼。請注意，部分指標並沒有 Floodlight 區隔值，例如點擊次數和造訪次數。 | 區隔 | String |
是 |
floodlightActivity |
依 Floodlight 活動區隔報表；每個資料列及其匯總指標會分成多個列，每個 Floodlight 活動最多可以顯示一列。此欄會傳回各列的 Floodlight 活動名稱。請注意，部分指標並沒有 Floodlight 區隔值，例如點擊次數和造訪次數。 | 區隔 | String |
是 |
floodlightActivityId |
依 Floodlight 活動區隔報表；每個資料列及其匯總指標會分成多個列，每個 Floodlight 活動最多可以顯示一列。此欄會傳回每列的 DS Floodlight 活動 ID。請注意，部分指標並沒有 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 |
是 |