付費和自然搜尋報表會顯示符合下列條件的搜尋字詞:觸發您的廣告使其在 Google 上顯示、觸發 Google 顯示您網站的非付費 (隨機) 搜尋結果,或是同時符合以上兩種情形的搜尋字詞。您必須先為報表涵蓋目標引擎帳戶設定付費和自然報表,報表才會傳回結果。
這份報表只能由非同步要求 (也就是透過 Reports.request() 方法)。
要求摘錄
定期傳送
Reports.request()
但指定 "reportType": "paidAndOrganic"
{ ... "reportType": "paidAndOrganic", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
對於要在報表中傳回或篩選的資料欄中,
指定下表所列的 columnName
。
您也可以選擇指定
headerText、
startDate,
和 endDate。
請注意,部分資料欄無法篩選;請參閱「可篩選」。
columnName | 說明 | 行為 | 類型 | 是否可篩選 |
---|---|---|---|---|
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 |
是 |
searchQuery |
Google 使用者輸入的搜尋字詞。 | 屬性 | String |
是 |
serpType |
Google 使用者點擊的搜尋結果類型。 可能的值為:
|
屬性 | SERP type |
是 |
paidClicks |
使用者輸入搜尋查詢後點擊廣告的次數。 | 指標 | Integer |
是 |
organicClicks |
使用者輸入搜尋查詢後,您網站的非付費搜尋結果點擊次數。 | 指標 | Integer |
是 |
paidAndOrganicClicks |
這是指使用者在輸入搜尋查詢後,點擊其中一則廣告或您網站的非付費搜尋結果的次數。 | 指標 | Integer |
是 |
paidImpressions |
使用者輸入搜尋查詢後,廣告在搜尋結果網頁或 Google 聯播網網站上出現的次數。 | 指標 | Integer |
是 |
organicQueries |
使用者輸入 searchQuery 並看到至少一筆您網站自然搜尋結果的總次數。 | 指標 | Integer |
是 |
paidAndOrganicQueries |
使用者輸入搜尋查詢後,看到至少一則您的廣告或至少一個您網站的自然搜尋結果的總次數。 | 指標 | Integer |
是 |
paidCtr |
廣告的點閱率,也就是使用者輸入搜尋查詢後決定按下廣告的頻率。 | 指標 | Number |
是 |
organicCtr |
使用者看到您網站的非付費搜尋結果後,點擊該結果並到達您網站的比率。 | 指標 | Number |
是 |
paidAndOrganicCtr |
使用者看到您其中一則廣告或無付費搜尋結果後,點擊任一項目並到達您網站的比率。 | 指標 | Number |
是 |
paidAvgPos |
廣告在使用者輸入搜尋查詢後顯示的平均排名。 | 指標 | Number |
是 |
organicAvgPos |
這是指您網站的非付費搜尋結果平均最高排名。 | 指標 | Number |
是 |
paidCostPerClick |
廣告的平均單次點擊出價。這是指每當有人按下您的廣告時,您所支付的平均金額。 | 指標 | Money |
是 |
date |
依日期區隔報表系統會將每個資料列和其匯總指標拆分為多個資料列 (每列一個)。此欄會傳回每列的日期。 | 區隔 | Date |
是 |
monthStart |
依月份區隔報表;系統會將每個資料列及其匯總指標拆分為多個資料列,每個月一列。此欄會傳回每列當月的第一天。 | 區隔 | Date |
是 |
monthEnd |
依月份區隔報表;系統會將每個資料列及其匯總指標拆分為多個資料列,每個月一列。此欄會傳回每列當月的最後一天。 | 區隔 | Date |
是 |
quarterStart |
按季區隔報表;每個資料列及其匯總指標都會拆分成多個資料列,每季各一列。這個資料欄會傳回每列季度的第一天。 | 區隔 | Date |
是 |
quarterEnd |
按季區隔報表;每個資料列及其匯總指標都會拆分成多個資料列,每季各一列。此欄會傳回每列季末的最後一天。 | 區隔 | Date |
是 |
weekStart |
依週區隔報表 (從週日到週六);系統會將每個資料列和其匯總指標分成多個資料列 (每週一列)。此欄會傳回每列的第一天 (星期日)。 | 區隔 | Date |
是 |
weekEnd |
依週區隔報表 (從週日到週六);系統會將每個資料列和其匯總指標分成多個資料列 (每週一列)。此欄會傳回每列的最後一天 (星期六)。 | 區隔 | Date |
是 |
yearStart |
依年份區隔報表;系統會將每個資料列及其匯總指標分割為多個資料列 (每列一個)。此欄會傳回每列的第一天。 | 區隔 | Date |
是 |
yearEnd |
依年份區隔報表;系統會將每個資料列及其匯總指標分割為多個資料列 (每列一個)。此欄會傳回每列的最後一天。 | 區隔 | Date |
是 |
campaign |
依廣告活動區隔報表;每列及其匯總指標分成多個列,報表範圍內的每個廣告活動都有一個資料列。此欄會傳回廣告活動名稱。 | 區隔 | String |
是 |
campaignId |
依廣告活動區隔報表;每列及其匯總指標分成多個列,報表範圍內的每個廣告活動都有一個資料列。此欄會傳回 DS 廣告活動 ID。 | 區隔 | ID |
是 |
adGroup |
依廣告群組區隔報表;每個資料列及其匯總指標都會分成多個列,報表範圍內每個廣告群組的各列。此欄會傳回廣告群組名稱。 | 區隔 | String |
是 |
adGroupId |
依廣告群組區隔報表;每個資料列及其匯總指標都會分成多個列,報表範圍內每個廣告群組的各列。此欄會顯示 Search Ads 360 廣告群組 ID。 | 區隔 | ID |
是 |
keywordId |
依關鍵字區隔報表每列及其匯總指標分成多個列,報表範圍中的每個關鍵字都有一列。此欄會傳回 DS 關鍵字 ID。 | 區隔 | ID |
是 |
keywordMatchType |
依關鍵字區隔報表每列及其匯總指標分成多個列,報表範圍中的每個關鍵字都有一列。此欄會傳回關鍵字比對類型。 | 區隔 | Match type |
是 |
keywordText |
依關鍵字區隔報表每列及其匯總指標分成多個列,報表範圍中的每個關鍵字都有一列。此欄會傳回關鍵字文字。 | 區隔 | String |
是 |