「付費和隨機」報表會顯示哪些搜尋字詞曾觸發您的廣告在 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 |
使用者輸入 searchQuery 後點擊廣告的次數。 | 指標 | Integer |
相容 |
organicClicks |
使用者輸入「SearchQuery」後,您網站的非付費搜尋結果獲得的點擊次數。 | 指標 | Integer |
相容 |
paidAndOrganicClicks |
使用者按下「搜尋查詢」後,在您的其中一則廣告或非付費搜尋結果帶來的點擊次數。 | 指標 | Integer |
相容 |
paidImpressions |
使用者輸入 searchQuery 後,廣告在搜尋結果網頁或 Google 聯播網網站上顯示的次數。 | 指標 | Integer |
相容 |
organicQueries |
使用者進入 SearchQuery,並瀏覽過至少一則您網站的自然搜尋結果的次數。 | 指標 | Integer |
相容 |
paidAndOrganicQueries |
使用者輸入了至少 1 則廣告或至少 1 則隨機搜尋結果。 | 指標 | Integer |
相容 |
paidCtr |
廣告的點閱率,也就是使用者看到「SearchQuery」後,看到您的廣告。 | 指標 | Number |
相容 |
organicCtr |
使用者看到您網站的非付費搜尋結果後,實際點擊搜尋結果的比率。 | 指標 | Number |
相容 |
paidAndOrganicCtr |
使用者看到你的網站上任一則廣告或非搜尋結果搜尋結果後,在點擊您的廣告後,前往該網站的比率。 | 指標 | Number |
相容 |
paidAvgPos |
使用者輸入「QueryQuery」後,廣告的顯示位置。 | 指標 | 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 |
依廣告群組區隔報表;每列及其匯總指標會拆分成多個資料列,分別顯示在報表範圍內的每個廣告群組。這一欄會傳回 DS 廣告群組編號。 | 區隔 | ID |
相容 |
keywordId |
以關鍵字區隔報表;每列及其匯總指標會拆分成多個資料列,分別代表報表範圍內的每個關鍵字。這一欄會傳回 DS 關鍵字編號。 | 區隔 | ID |
相容 |
keywordMatchType |
以關鍵字區隔報表;每列及其匯總指標會拆分成多個資料列,分別代表報表範圍內的每個關鍵字。這一欄會傳回關鍵字比對類型。 | 區隔 | Match type |
相容 |
keywordText |
以關鍵字區隔報表;每列及其匯總指標會拆分成多個資料列,分別代表報表範圍內的每個關鍵字。此欄會傳回關鍵字文字。 | 區隔 | String |
相容 |