報表類型:productGroup

產品群組的成效指標和設定屬性。產品群組報表與關鍵字報表的差異如下:瞭解詳情

這份報表只能透過非同步要求傳回 (也就是透過 Reports.request() 方法)。

要求摘錄

傳送一般的 Reports.request() 要求主體,但指定 "reportType": "productGroup"

{
...
  "reportType": "productGroup",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

針對您要在報表中傳回或篩選的每個資料欄,指定下表中列出的 columnName。您也可以視需要指定 headerTextstartDateendDate。請注意,部分欄無法篩選;請參閱下表中的「可篩選」。

columnName說明行為類型可篩選
status 產品群組的狀態。一律為 Active 屬性 Status 相容
engineStatus 外部引擎帳戶產品群組的額外狀態。可能出現的狀態 (取決於外部帳戶類型) 包括 reviewcampaign 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 AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaiduComparison Shopping 屬性 Engine type 相容
campaign 廣告活動名稱: 屬性 String 相容
campaignId DS 廣告活動編號。 屬性 ID 相容
campaignStatus 包含此項目的廣告活動狀態。 屬性 Status 相容
adGroup 廣告群組名稱: 屬性 String 相容
adGroupId DS 廣告群組編號。 屬性 ID 相容
adGroupStatus 包含這個項目的廣告群組狀態。 屬性 Status 相容
productGroupId DS 產品群組編號。DS 會產生這些 ID,即使最終的樹狀結構未變更,系統也可能會變更這些 ID。瞭解詳情 屬性 ID 相容
productGroup 用來定義產品群組的條件,例如 AND(CATEGORY="Electronics",BRAND = "example")。 屬性 String
productGroupPartitionType 產品群組的分區類型:SubdividedExcludedBiddable 屬性 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。 屬性 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 相容