報表類型：productAdvertisingd

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

這份報表只能透過非同步要求傳回 (也就是透過 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 產品的材質屬性。 屬性 String 相容
productPattern 產品商品的 pattern [圖案] 屬性。 屬性 String 相容
productAvailability 產品項目的 availability [供應情形] 屬性。 屬性 Product availability 相容
productGender 產品的 gender。 屬性 String 相容
productAgeGroup 產品的年齡層屬性。 屬性 String 相容
productLandingPageUrl 產品商品的到達網頁屬性。 屬性 String 相容
productCategory 產品的 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 產品的全球交易品項識別碼屬性 (全球交易品項識別碼) 。 屬性 String 相容
productPrice 產品商品的 price [價格] 屬性。 屬性 Money 相容
productSalePrice 產品商品的 price [價格] 屬性。 屬性 Money 相容
productTypeLevel1 產品的產品類型 1 屬性。 屬性 String 相容
productTypeLevel2 產品的產品類型 2 屬性。 屬性 String 相容
productTypeLevel3 產品的 product_leve 3 屬性。 屬性 String 相容
productTypeLevel4 產品的 product_leve 4 屬性。 屬性 String 相容
productTypeLevel5 產品的 product_leve 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 群組編號。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。 區隔 ID 相容
floodlightGroupTag 依據 Floodlight 群組區隔報表；每列及其匯總指標會拆分成多列，每列最多一個 Floodlight 群組。這一欄會傳回每列的 Floodlight 群組代碼。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。 區隔 String 相容
floodlightActivity 依據 Floodlight 活動區隔報表；每列及其匯總指標會拆分成多個資料列，每個 Floodlight 活動最多一個。這一欄會傳回每列的 Floodlight 活動名稱。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。 區隔 String 相容
floodlightActivityId 依據 Floodlight 活動區隔報表；每列及其匯總指標會拆分成多個資料列，每個 Floodlight 活動最多一個。這一欄會傳回每列的 DS Floodlight 活動編號。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。 區隔 ID 相容
floodlightActivityTag 依據 Floodlight 活動區隔報表；每列及其匯總指標會拆分成多個資料列，每個 Floodlight 活動最多一個。這一欄會傳回每列的 Floodlight 活動廣告代碼。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪次數。 區隔 String 相容
accountId DS 引擎帳戶 ID。 區隔 ID 相容
campaignId 按廣告活動區隔報表。這一列會傳回與列相關聯的 DS 廣告活動編號。 區隔 ID 相容
adGroupId 依廣告群組區隔報表。這列會傳回與此列相關聯的廣告群組編號。 區隔 ID 相容