報表類型：廣告客戶

廣告客戶報表資料，包括：

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

要求摘錄

傳送一般的 Reports.request() 或 Reports.generate() 要求主體，但請指定 "reportType": "advertiser"。

{
...
  "reportType": "advertiser",
  "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	相容
dfaAdvertiserId	與這個 DS 廣告客戶相關聯的 Campaign Manager 廣告客戶編號。	屬性	ID	相容
dfaNetworkId	與這個 DS 廣告客戶相關聯的 Campaign Manager 聯播網編號。	屬性	ID	相容
dfaNetworkTimeZone	與這個 DS 廣告客戶相關聯的 Campaign Manager 聯播網時區，格式為 IANA 時區資料庫格式，例如 America/New_York。	屬性	String	相容
advertiserCurrencyCode	廣告客戶採用 ISO 4217 格式的貨幣代碼。	屬性	String	相容
googleAnalyticsTimeZone	連結至此 DS 廣告客戶的 Google Analytics (分析) 資料檢視所在時區。使用 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 群組編號。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。	區隔	ID	相容
floodlightGroupTag	依據 Floodlight 群組區隔報表；每列及其匯總指標會拆分成多列，每列最多一個 Floodlight 群組。這一欄會傳回每列的 Floodlight 群組代碼。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。	區隔	String	相容
floodlightActivity	依據 Floodlight 活動區隔報表；每列及其匯總指標會拆分成多個資料列，每個 Floodlight 活動最多一個。這一欄會傳回每列的 Floodlight 活動名稱。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。	區隔	String	相容
floodlightActivityId	依據 Floodlight 活動區隔報表；每列及其匯總指標會拆分成多個資料列，每個 Floodlight 活動最多一個。這一欄會傳回每列的 DS Floodlight 活動編號。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。	區隔	ID	相容
floodlightActivityTag	依據 Floodlight 活動區隔報表；每列及其匯總指標會拆分成多個資料列，每個 Floodlight 活動最多一個。這一欄會傳回每列的 Floodlight 活動廣告代碼。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。	區隔	String	相容