產品群組的成效指標和設定屬性。產品群組報表與關鍵字報表有幾種差異:相關詳情請見這篇文章。
這份報表只能由非同步要求 (也就是透過 Reports.request() 方法)。
要求摘錄
定期傳送
Reports.request()
但指定 "reportType": "productGroup"
{ ... "reportType": "productGroup", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
對於要在報表中傳回或篩選的資料欄中,
指定下表所列的 columnName
。
您也可以選擇指定
headerText、
startDate,
和 endDate。
請注意,部分資料欄無法篩選;請參閱「可篩選」。
columnName | 說明 | 行為 | 類型 | 是否可篩選 |
---|---|---|---|---|
status |
產品群組的狀態。一律為 Active 。 |
屬性 | Status |
是 |
engineStatus |
外部引擎帳戶中產品群組的其他狀態。可能的狀態 (視外部帳戶類型而定) 包括review 、campaign paused 等。 |
屬性 | 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 |
是 |
productGroupId |
DS 產品群組 ID。DS 會產生這些 ID;即使產生的產品群組樹狀結構未變更,這些 ID 也可能會變更。瞭解詳情。 | 屬性 | ID |
是 |
productGroup |
用來定義產品群組的條件,例如 AND(CATEGORY="電子產品",BRAND = "範例")。 | 屬性 | String |
否 |
productGroupPartitionType |
產品群組的劃分類型:Subdivided 、Excluded 或 Biddable 。 |
屬性 | Product group partition type |
是 |
productGroupLandingPage |
產品群組到達網頁。請參閱到達網頁和 Clickserver 網址。 | 屬性 | String |
是 |
productGroupClickserverUrl |
DS 用於追蹤活動的網址。點擊廣告的使用者會先造訪 Clickserver 網址,然後由系統重新導向至最終到達網頁。請參閱到達網頁和 Clickserver 網址。 | 屬性 | String |
是 |
productGroupMaxCpc |
傳回為此產品群組設定的最高單次點擊出價 (如果有的話)。如果這個產品群組尚未設定最高單次點擊出價,則這個欄位為空白,且產品群組會沿用廣告群組的最高單次點擊出價設定。 | 屬性 | Money |
是 |
effectiveProductGroupMaxCpc |
此產品群組採用的最高單次點擊出價。這可能與廣告群組的最高單次點擊出價相同,如果商品目標覆寫了廣告群組的設定,請指定商品目標的最高單次點擊出價。 | 屬性 | Money |
是 |
productGroupMaxBid |
如果這個產品群組是由 DS 出價策略所管理,出價策略就不會將出價提高超過此上限。請參閱「將出價策略套用至產品群組」一文。 | 屬性 | Money |
是 |
productGroupMinBid |
如果這個產品群組是由 DS 出價策略所管理,出價策略就絕不會降低出價低於此上限。請參閱「將出價策略套用至產品群組」一文。 | 屬性 | Money |
是 |
effectiveBidStrategyId |
指派給這個實體的出價策略 DS ID,或由這個實體沿用。 | 屬性 | ID |
是 |
effectiveBidStrategy |
指派給這個實體的出價策略名稱,或是由這個實體沿用。 | 屬性 | String |
是 |
bidStrategyInherited |
指出這個實體的出價策略是否已沿用而來。 | 屬性 | Boolean |
是 |
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 |
是 |