廣告的成效指標和設定屬性。
這份報表只能透過非同步要求 (也就是透過 Reports.request() 方法) 傳回。
要求摘錄
傳送一般 Reports.request() 要求主體，但指定 "reportType": "ad"。
{
...
"reportType": "ad",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
針對報表中要傳回或篩選的每個資料欄，指定下表所列的 columnName。您也可以視需要指定 headerText、startDate 和 endDate。請注意，部分欄無法篩選；請參閱下表中的「可篩選」欄。
columnName | 說明 | 行為 | 類型 | 是否可篩選 |
|---|---|---|---|---|
status |
廣告狀態：Active、Paused 或 Removed。請注意，廣告活動、廣告群組、關鍵字和廣告各自有其狀態。請參閱「狀態」。 |
屬性 | Status |
是 |
engineStatus |
外部引擎帳戶中的廣告其他狀態。可能的狀態 (視外部帳戶類型而定) 包括 active、eligible、creative deleted、creative approved family safe 等。 |
屬性 | 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 |
包含這項商品的廣告活動狀態。 | 屬性 | Status |
是 |
adGroup |
廣告群組名稱： | 屬性 | String |
是 |
adGroupId |
DS 廣告群組 ID。 | 屬性 | ID |
是 |
adGroupStatus |
包含這項商品的廣告群組狀態。 | 屬性 | Status |
是 |
ad |
廣告名稱。 | 屬性 | String |
是 |
adId |
DS 廣告 ID。如果值為 0，表示廣告未歸因。 | 屬性 | ID |
是 |
adEngineId |
外部引擎帳戶中的廣告 ID。 | 屬性 | ID |
是 |
isUnattributedAd |
指出這一列中的指標是否無法歸因於特定廣告。舉例來說，如果廣告採用不支援的格式，或是 Clickserver 網址有誤，DS 就無法將成效歸因給廣告。 | 屬性 | Boolean |
是 |
adHeadline |
廣告標題。 | 屬性 | String |
是 |
adHeadline2 |
廣告標題 2 (部分引擎不支援)。 | 屬性 | String |
是 |
adHeadline3 |
廣告標題 3 (部分引擎不支援)。 | 屬性 | String |
是 |
adDescription1 |
廣告說明行 1。 | 屬性 | String |
是 |
adDescription2 |
廣告說明行 2 (部分引擎不支援)。 | 屬性 | String |
是 |
adDisplayUrl |
廣告顯示網址。 | 屬性 | String |
是 |
adLandingPage |
廣告到達網頁。請參閱「到達網頁和 Clickserver 網址」。 | 屬性 | String |
是 |
adType |
廣告類型：Text、Product、Dynamic search、Mobile app install、Call-Only、Expanded text 或 Expanded dynamic search。 |
屬性 | Ad type |
是 |
adPromotionLine |
廣告宣傳行。產品廣告的簡短宣傳訊息。 | 屬性 | String |
是 |
adLabels |
直接指派給這個廣告的標籤名稱 (不含沿用標籤)。 | 屬性 | String list |
是 |
adPathField1 |
廣告路徑欄位 1。系統會將路徑欄位 1 和 2 與 adDisplayUrl 合併，形成廣告中顯示的網址。 | 屬性 | String |
是 |
adPathField2 |
廣告路徑欄位 2。系統會將路徑欄位 1 和 2 與 adDisplayUrl 合併，形成廣告中顯示的網址。 | 屬性 | String |
是 |
effectiveLabels |
繼承或直接指派給這則廣告的所有標籤名稱。 | 屬性 | String list |
是 |
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 |
是 |
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 |
是 |