報表類型：productGroup

產品群組的成效指標和設定屬性。產品群組報表與關鍵字報表有幾種差異：相關詳情請見這篇文章。

這份報表只能由非同步要求 (也就是透過 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 是