廣告活動的成效指標和設定屬性。
這份報表只能透過非同步要求 (也就是透過 Reports.request() 方法) 傳回。
要求摘錄
傳送一般 Reports.request() 要求主體，但指定 "reportType": "campaign"。
{
...
"reportType": "campaign",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
針對報表中要傳回或篩選的每個資料欄，指定下表所列的 columnName。您也可以視需要指定 headerText、startDate 和 endDate。請注意，部分欄無法篩選；請參閱下表中的「可篩選」欄。
columnName | 說明 | 行為 | 類型 | 是否可篩選 |
|---|---|---|---|---|
status |
campaignStatus 屬性的別名。 |
屬性 | Status |
是 |
engineStatus |
外部引擎帳戶中的廣告活動其他狀態。可能的狀態 (視外部帳戶類型而定) 包括 disapproved、budget constrained 等。 |
屬性 | String |
是 |
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 |
是 |
campaign |
廣告活動名稱： | 屬性 | String |
是 |
campaignId |
DS 廣告活動 ID。 | 屬性 | ID |
是 |
campaignStatus |
廣告活動狀態：Active、Paused 或 Removed。請注意，廣告活動、廣告群組、關鍵字、廣告和指定目標各自有其狀態。請參閱「狀態」。 |
屬性 | Status |
是 |
campaignEngineId |
外部引擎帳戶中的廣告活動 ID。 | 屬性 | ID |
是 |
campaignStartDate |
廣告活動的開始日期。 | 屬性 | Date |
是 |
campaignEndDate |
廣告活動結束日期。 | 屬性 | Date |
是 |
bingAdsBudgetType |
如何控管 Bing Ads 廣告活動的預算：Daily budget、Monthly even spend、Monthly accelerated spend、Daily accelerated spend 或 Daily even spend。 |
屬性 | Microsoft Advertising budget type |
是 |
dailyBudget |
廣告活動的每日預算。 | 屬性 | Money |
是 |
monthlyBudget |
廣告活動的每月預算。 | 屬性 | Money |
是 |
deliveryMethod |
廣告活動的預算放送方式：Standard 或 Accelerated。 |
屬性 | Budget delivery method |
是 |
adWordsBidStrategy |
Google Ads 為這個廣告活動使用的出價策略：Manual cpc、Manual cpm、Percent cpa、Budget optimizer 或 Conversion optimizer。採用 DS 出價策略的廣告活動會設為 Manual cpc 或 Manual cpm。 |
屬性 | AdWords bid strategy |
是 |
yahooJapanBidStrategy |
出價策略 Yahoo! JAPAN 會為這個廣告活動使用：Manual cpc 或 Budget optimizer。採用 DS 出價策略的廣告活動會設為 Manual cpc。 |
屬性 | Yahoo! JAPAN bid strategy |
是 |
keywordNearMatchEnabled |
是否為廣告活動啟用關鍵字近似比對功能：Enabled 或 Disabled。 |
屬性 | Keyword match setting |
是 |
campaignMobileBidAdjustment |
行動出價的調整幅度百分比。舉例來說，0.2 代表增加 20%，因此行動出價是預設出價的 1.2 倍。有效值的範圍會因外部引擎而異。 | 屬性 | Number |
是 |
campaignTabletBidAdjustment |
平板電腦出價的調整幅度百分比。舉例來說，0.2 代表增加 20%，因此平板電腦出價是預設出價的 1.2 倍。有效值的範圍會因外部引擎而異。 | 屬性 | Number |
是 |
campaignDesktopBidAdjustment |
調整電腦版出價的百分比。舉例來說，0.2 代表增加 20%，因此電腦版出價是預設出價的 1.2 倍。有效值的範圍會因外部引擎而異。 | 屬性 | Number |
是 |
networkTarget |
廣告活動放送的聯播網類型。 | 屬性 | String |
否 |
yahooGeoTargets |
Yahoo Search Marketing 廣告活動的地理指定目標。請參閱下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
campaignLabels |
直接指派給這個廣告活動的標籤名稱 (不含沿用標籤)。 | 屬性 | String list |
是 |
campaignType |
表示廣告活動類型：Manual、Inventory、Inventory - PLA、Shopping、Comparison shopping、Mobile app install、Universal app 或 Smart shopping。 |
屬性 | Campaign type |
是 |
effectiveBidStrategyId |
指派給此實體或由此實體繼承的出價策略 DS ID。 | 屬性 | ID |
是 |
effectiveBidStrategy |
指派給此實體或由此實體繼承的出價策略名稱。 | 屬性 | String |
是 |
bidStrategyInherited |
表示這個實體的出價策略是否已沿用。 | 屬性 | Boolean |
是 |
deviceTargets |
在廣告活動層級指定裝置，即 Desktop、Mobile、Tablet 或 Other 的組合。 |
屬性 | String |
否 |
effectiveDeviceTargets |
在廣告活動層級指定裝置，即 Desktop、Mobile、Tablet 或 Other 的組合。 |
屬性 | String |
否 |
languageTargets |
廣告活動層級的指定語言。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
countryTargets |
廣告活動包含的指定國家/地區。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
provinceTargets |
廣告活動指定的省份。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
metroTargets |
廣告活動包含的都會區指定目標。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
cityTargets |
廣告活動包含的城市指定目標。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
effectiveCountryTargets |
廣告活動包含的指定國家/地區。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
effectiveProvinceTargets |
廣告活動指定的省份。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
effectiveMetroTargets |
廣告活動包含的都會區指定目標。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
effectiveCityTargets |
廣告活動包含的城市指定目標。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
excludedCountryTargets |
廣告活動排除的國家/地區指定目標。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
excludedProvinceTargets |
廣告活動排除的省份指定目標。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
excludedMetroTargets |
從廣告活動中排除的大都會區指定目標。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
excludedCityTargets |
從廣告活動中排除的城市指定目標。下載上傳範本和地理/語言代碼。 | 屬性 | String |
否 |
effectiveLabels |
繼承或直接指派給這個廣告活動的所有標籤名稱。 | 屬性 | String list |
是 |
clicksWithFeedItemShowing |
在動態饋給項目顯示時，點選廣告中的任何連結。這個欄只會在動態饋給項目報表或以動態饋給項目欄區隔的報表中傳回值。 | 指標 | Integer |
是 |
costWithFeedItemShowing |
動態饋給項目顯示時，所有廣告的費用。這個欄只會在動態饋給項目報表或以動態饋給項目欄區隔的報表中傳回值。 | 指標 | Money |
是 |
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 |
是 |
sitelinkDisplayText |
依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個資料欄會傳回每個資料列的網站連結顯示文字。 | 區隔 | String |
是 |
sitelinkDescription1 |
依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個資料欄會傳回每個資料列的網站連結說明 1。 | 區隔 | String |
是 |
sitelinkDescription2 |
依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個資料欄會傳回每個資料列的網站連結說明 2。 | 區隔 | String |
是 |
sitelinkLandingPageUrl |
依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個欄會傳回每個資料列的網站連結到達網頁網址。 | 區隔 | String |
是 |
sitelinkClickserverUrl |
依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個欄會傳回每個資料列的 sitelink 的 Clickserver 網址。 | 區隔 | String |
是 |
locationBusinessName |
依據已升級的地點額外資訊 (已連結至商家檔案帳戶) 區隔報表；每個資料列及其匯總指標會拆分為多個資料列，每個資料列代表一個有指標可供查看的地點。這個資料欄會傳回每個資料列的地點商家名稱。 | 區隔 | String |
是 |
locationCategory |
依據已升級的地點額外資訊 (已連結至商家檔案帳戶) 區隔報表；每個資料列及其匯總指標會拆分為多個資料列，每個資料列代表一個有指標可供查看的地點。這個欄會傳回每個資料列的地點類別。 | 區隔 | String |
是 |
locationDetails |
依據已升級的地點額外資訊 (已連結至商家檔案帳戶) 區隔報表；每個資料列及其匯總指標會拆分為多個資料列，每個資料列代表一個有指標可供查看的地點。這個欄會傳回每個資料列的位置詳細資料。 | 區隔 | String |
是 |
locationFilter |
依據已升級的地點額外資訊 (已連結至商家檔案帳戶) 區隔報表；每個資料列及其匯總指標會拆分為多個資料列，每個資料列代表一個有指標可供查看的地點。這個欄會傳回每個資料列的位置篩選器。 | 區隔 | String |
否 |
callPhoneNumber |
依據來電額外資訊區隔報表，每個列及其匯總指標會分割為多個列，每個來電額外資訊一個。這個資料欄會傳回通話額外資訊的電話號碼。 | 區隔 | String |
是 |
callCountryCode |
依據來電額外資訊區隔報表，每個列及其匯總指標會分割成多個列，每個來電額外資訊一個。這個欄會傳回每個資料列的通話擴充功能國家/地區代碼。 | 區隔 | String |
是 |
callIsTracked |
依據來電額外資訊區隔報表，每個列及其匯總指標會分割成多個列，每個來電額外資訊一個。如果要追蹤通話擴充功能的通話，這個欄會傳回 true，否則傳回 false。 | 區隔 | Boolean |
是 |
callCallOnly |
依據來電額外資訊區隔報表，每個列及其匯總指標會分割成多個列，每個來電額外資訊一個。如果來電額外資訊只顯示電話號碼，這一欄會傳回 true；如果額外資訊同時顯示電話號碼和連結，則傳回 false。 | 區隔 | Boolean |
是 |
callConversionTracker |
依據來電額外資訊區隔報表，每個列及其匯總指標會分割成多個列，每個來電額外資訊一個。這個欄會傳回與動態饋給項目相關聯的轉換追蹤器名稱 (如果有的話)。 | 區隔 | String |
是 |
callConversionTrackerId |
依據來電額外資訊區隔報表，每個列及其匯總指標會分割成多個列，每個來電額外資訊一個。這個欄會傳回與電話號碼額外資訊相關聯的轉換追蹤器 ID (如有)。 | 區隔 | ID |
是 |
appId |
依應用程式擴充功能區隔報表，每個列及其匯總指標會分割成多個列，每個應用程式擴充功能一個。這個欄會傳回應用程式 ID (如果有的話)。 | 區隔 | String |
是 |
appStore |
依應用程式擴充功能區隔報表，每個列及其匯總指標會分割成多個列，每個應用程式擴充功能一個。這個欄會傳回應用程式商店類型 (Apple App Store、Google Play 商店)，如果有則會傳回。 | 區隔 | App store |
是 |
feedItemId |
依動態饋給項目區隔報表，每個列及其匯總指標會拆分成多個列，每個動態饋給項目對應一個列。這個欄位會傳回每個資料列的 DS 動態饋給項目資料列 ID。 | 區隔 | ID |
是 |
feedId |
依動態饋給項目區隔報表，每個列及其匯總指標會拆分成多個列，每個動態饋給項目一個。這個欄會傳回每個資料列的動態饋給資料表 ID。 | 區隔 | ID |
是 |
feedType |
依動態饋給項目區隔報表，每個列及其匯總指標會拆分成多個列，每個動態饋給項目對應一個列。這個欄會傳回每個資料列的動態饋給項目類型。 | 區隔 | Feed type |
是 |