廣告活動的成效指標和設定屬性。
這份報表只能透過非同步要求傳回 (也就是透過 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 |
相容 |
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。 | 屬性 | 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 群組編號。請注意，部分指標沒有 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 |
相容 |
sitelinkDisplayText |
依據網站連結區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個網站連結。這一欄會傳回每列的網站連結顯示文字。 | 區隔 | String |
相容 |
sitelinkDescription1 |
依據網站連結區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個網站連結。這一欄會傳回每列的網站連結說明 1。 | 區隔 | String |
相容 |
sitelinkDescription2 |
依據網站連結區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個網站連結。這一欄會傳回每列的網站連結說明 2。 | 區隔 | String |
相容 |
sitelinkLandingPageUrl |
依據網站連結區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個網站連結。這一欄會在每個資料列傳回網站連結的到達網頁網址。 | 區隔 | String |
相容 |
sitelinkClickserverUrl |
依據網站連結區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個網站連結。這一欄會傳回每個網站連結網站連結的 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 |
相容 |
appId |
依據應用程式額外資訊區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個應用程式額外資訊。此欄會傳回應用程式 ID (如果有的話)。 | 區隔 | String |
相容 |
appStore |
依據應用程式額外資訊區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個應用程式額外資訊。此欄會傳回應用程式商店類型 (Apple App Store、Google Play 商店) (如果有的話)。 | 區隔 | App store |
相容 |
feedItemId |
依據動態饋給項目區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個動態饋給項目。這一欄會傳回每列的 DS 資訊提供項目列編號。 | 區隔 | ID |
相容 |
feedId |
依據動態饋給項目區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個動態饋給項目。這一欄會傳回每列的 DS 資訊提供表格編號。 | 區隔 | ID |
相容 |
feedType |
依據動態饋給項目區隔報表；每列及其匯總指標會拆分成多個資料列，分別代表每個動態饋給項目。這一欄會傳回每列的資訊提供項目類型。 | 區隔 | Feed type |
相容 |