引擎帳戶的報表資料,包括:
- 引擎帳戶所有廣告活動的成效指標。
- 引擎帳戶的設定屬性。
要求摘錄
傳送一般 Reports.request() 或 Reports.generate() 要求主體,但指定 "reportType": "account"
。
{
...
"reportType": "account",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
針對報表中要傳回或篩選的每個資料欄,指定下表所列的 columnName
。您也可以視需要指定 headerText、startDate 和 endDate。請注意,部分欄無法篩選;請參閱下表中的「可篩選」欄。
columnName | 說明 | 行為 | 類型 | 是否可篩選 |
---|---|---|---|---|
status |
帳戶狀態:Active 、Paused 或 Removed 。 |
屬性 | Status |
是 |
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 |
是 |
accountCurrencyCode |
引擎帳戶的貨幣代碼,採用 ISO 4217 格式。 | 屬性 | String |
是 |
accountTimeZone |
引擎帳戶的時區,採用 IANA 時區資料庫格式,例如 America/New_York 。 |
屬性 | String |
是 |
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 |
是 |
searchImpressionShare |
僅適用於 Google Ads 和 Bing Ads。將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。傳回的值介於 0.1 到 1 之間,如果分享比例小於 0.1,則會傳回字串 < 10% 。 |
指標 | Impression share |
是 |
searchBudgetLostImpressionShare |
僅適用於 Google Ads 和 Bing Ads。廣告因為預算不足而無法在搜尋聯播網上顯示的次數百分比。傳回值為 0 到 0.9 之間的數字,如果比重大於 0.9,則傳回值為字串 > 90% 。 |
指標 | Impression share |
是 |
searchRankLostImpressionShare |
僅適用於 Google Ads 和 Bing Ads。廣告因為廣告評級偏低而無法在搜尋聯播網上顯示的次數百分比。傳回值為 0 到 0.9 之間的數字,如果比重大於 0.9,則傳回值為字串 > 90% 。 |
指標 | Impression share |
是 |
displayImpressionShare |
僅限 Google Ads。將您在多媒體廣告聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。傳回的值介於 0.1 到 1 之間,如果分享比例小於 0.1,則會傳回字串 < 10% 。 |
指標 | Impression share |
是 |
displayBudgetLostImpressionShare |
僅限 Google Ads。廣告因為預算不足,無法在多媒體廣告聯播網中顯示的次數百分比。傳回值為 0 到 0.9 之間的數字,如果比重大於 0.9,則傳回值為字串 > 90% 。 |
指標 | Impression share |
是 |
displayRankLostImpressionShare |
僅限 Google Ads。廣告因為廣告評級偏低而無法在多媒體廣告聯播網中顯示的次數百分比。傳回值為 0 到 0.9 之間的數字,如果比重大於 0.9,則傳回值為字串 > 90% 。 |
指標 | Impression share |
是 |
qualityScoreAvg |
僅適用於 Google Ads 和 Bing Ads。在報表範圍內,針對所有天數和關鍵字,根據曝光次數加權計算引擎的品質分數 (QS)。 | 指標 | Number |
是 |
topOfPageBidAvg |
僅限 Google Ads。預估報表時間範圍內,讓廣告經常顯示在搜尋結果頂端所需的平均單次點擊出價。 | 指標 | Money |
是 |
absoluteTopImpressionPercentage |
廣告曝光顯示於自然搜尋結果上方第一則廣告的百分比。 | 指標 | Impression share |
是 |
searchAbsoluteTopImpressionShare |
廣告在絕對頂端位置 (自然搜尋結果上方的第一則廣告) 獲得的曝光次數,除以您有資格在頂端位置獲得的預估曝光次數後得出的百分比。 | 指標 | Impression share |
是 |
topImpressionPercentage |
廣告曝光顯示於自然搜尋結果上方任一處的百分比。 | 指標 | Impression share |
是 |
searchTopImpressionShare |
廣告在頂端位置 (自然搜尋結果上方的任一位置) 獲得的曝光次數,相較於您有資格在頂端位置獲得的預估曝光次數。 | 指標 | Impression share |
是 |
searchBudgetLostAbsoluteTopImpressionShare |
估算廣告因預算偏低,而無法在自然搜尋結果上方顯示為第一則廣告的頻率。 | 指標 | Impression share |
是 |
searchBudgetLostTopImpressionShare |
可幫助您瞭解廣告因預算偏低,而無法顯示於自然搜尋結果上方任一位置的頻率。 | 指標 | Impression share |
是 |
searchRankLostAbsoluteTopImpressionShare |
估算廣告因為廣告評級不佳,而無法在自然搜尋結果上方顯示為第一則廣告的頻率。 | 指標 | Impression share |
是 |
searchRankLostTopImpressionShare |
估算廣告因為廣告評級不佳,而無法顯示於自然搜尋結果上方任一位置的頻率。 | 指標 | Impression share |
是 |
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 |
是 |