報表類型：產品廣告

針對在商品目錄動態饋給中定義的產品並透過購物廣告活動宣傳的產品，提供相關成效指標、設定屬性和商品目錄屬性。

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

要求摘錄

定期傳送 Reports.request() 但指定 "reportType": "productAdvertised" 

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

對於要在報表中傳回或篩選的資料欄中， 指定下表所列的 columnName。 您也可以選擇指定 headerText、 startDate, 和 endDate。 請注意，部分資料欄無法篩選；請參閱「可篩選」。

columnName說明行為類型是否可篩選
status 商品目錄帳戶中顯示的產品狀態：Active 或 Removed。 屬性 Status 是
creationTimestamp 商品目錄帳戶中顯示的產品建立時間戳記，採用 ISO 8601 格式。 屬性 Timestamp 是
lastModifiedTimestamp 在商品目錄帳戶中列出的產品最近修改時間戳記，以 ISO 8601 格式表示。 屬性 Timestamp 是
agency 代理商名稱。 屬性 String 是
agencyId DS 代理商 ID。 屬性 ID 是
advertiser 廣告客戶名稱。 屬性 String 是
advertiserId DS 廣告主 ID。 屬性 ID 是
productId 產品的商品 ID。 屬性 String 是
productCountry 產品商品目錄動態饋給的註冊國家/地區。 屬性 String 是
productLanguage 產品商品目錄動態饋給的註冊語言。 屬性 String 是
productMpn 產品商品的 MPN 屬性 (製造商零件編號)。 屬性 String 是
productColor 產品項目的 color [顏色] 屬性。 屬性 String 是
productSize 產品項目的 size 屬性。 屬性 String 是
productMaterial 產品項目的 material [材質] 屬性。 屬性 String 是
productPattern 產品項目的 pattern 屬性。 屬性 String 是
productAvailability 產品項目的 availability [供應情形] 屬性。 屬性 Product availability 是
productGender 產品項目的 gender 屬性。 屬性 String 是
productAgeGroup 產品項目的年齡層屬性。 屬性 String 是
productLandingPageUrl 產品項目的到達網頁屬性。 屬性 String 是
productCategory 產品的 google_product_category [Google 產品類別] 屬性。 屬性 String 是
productCategoryLevel1 產品商品的 google 產品類別層級 1 屬性。 屬性 String 是
productCategoryLevel2 產品商品的 google 產品類別層級 2 屬性。 屬性 String 是
productCategoryLevel3 產品商品的 google 產品類別層級 3 屬性。 屬性 String 是
productCategoryLevel4 產品商品的 google 產品類別層級 4 屬性。 屬性 String 是
productCategoryLevel5 產品商品的 google 產品類別層級 5 屬性。 屬性 String 是
productBrand 產品項目的 brand [品牌] 屬性。 屬性 String 是
productGtin 產品商品的GTIN屬性 (全球交易項目編號)， 屬性 String 是
productPrice 產品項目的 price 屬性。 屬性 Money 是
productSalePrice 產品項目的 price 屬性。 屬性 Money 是
productTypeLevel1 產品項目的產品類型分層 1 屬性。 屬性 String 是
productTypeLevel2 產品項目的產品類型 2 屬性屬性。 屬性 String 是
productTypeLevel3 產品項目的產品類型分層 3 屬性。 屬性 String 是
productTypeLevel4 產品項目的產品類型 4 屬性。 屬性 String 是
productTypeLevel5 產品項目的產品類型 5 屬性。 屬性 String 是
productCondition 產品項目的 condition [狀況] 屬性。 屬性 String 是
productCustomLabel0 產品項目的自訂標籤 0 屬性。 屬性 String 是
productCustomLabel1 產品項目的自訂標籤 1 屬性。 屬性 String 是
productCustomLabel2 產品項目的自訂標籤 2 屬性。 屬性 String 是
productCustomLabel3 產品項目的自訂標籤 3 屬性。 屬性 String 是
productCustomLabel4 產品項目的自訂標籤 4 屬性。 屬性 String 是
productCostOfGoodsSold 在商品目錄動態饋給中指定的產品銷售總費用。 屬性 Money 是
productStoreId 透過店面商品目錄廣告宣傳產品的商店。這組 ID 必須與店面產品動態饋給中使用的商店 ID 相符。 屬性 String 是
productChannel 產品項目的銷售通路屬性：Online 或 Local。 屬性 Product channel 是
productChannelExclusivity 產品商品的通路獨佔性屬性。 屬性 Product channel exclusivity 是
productItemGroupId 產品商品的商品群組 ID 屬性。 屬性 String 是
productTitle 產品項目的名稱屬性。 屬性 String 是
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 是
accountId DS 引擎帳戶 ID。 區隔 ID 是
campaignId 依廣告活動區隔報表。這一列會回傳與該列相關聯的 DS 廣告活動編號。 區隔 ID 是
adGroupId 依廣告群組區隔報表。這一列會回傳與該列相關的廣告群組編號。 區隔 ID 是