報表類型:帳戶

引擎帳戶的報表資料,包括:

  • 引擎帳戶所有廣告活動的成效指標。
  • 引擎帳戶的設定屬性。

要求摘錄

傳送一般 Reports.request()Reports.generate() 要求主體,但指定 "reportType": "account"

{
...
 
"reportType": "account",
 
"columns": [
   
{
     
"columnName": string,
     
"headerText": string,
     
"startDate": string,
     
"endDate": string
   
}
 
],
 
"filters": [
   
{
     
"column": {
       
"columnName": string,
     
},
     
...
   
},
   
...
 
],
...
}

針對報表中要傳回或篩選的每個資料欄,指定下表所列的 columnName。您也可以視需要指定 headerTextstartDateendDate。請注意,部分欄無法篩選;請參閱下表中的「可篩選」欄。

columnName說明行為類型是否可篩選
status 帳戶狀態:ActivePausedRemoved 屬性 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 AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaiduComparison 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