針對在商品目錄動態饋給中定義的產品並透過購物廣告活動宣傳的產品,提供相關成效指標、設定屬性和商品目錄屬性。
這份報表只能由非同步要求 (也就是透過 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 |
是 |