報表類型：轉換

轉換的原始事件資料。

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

由於事件會在特定日期發生，因此這份報表的要求必須指定 timeRange。您可以指定下列任一項目：

startDate 和 endDate。
changedMetricsSinceTimestamp (changedAttributesSinceTimestamp 不適用於事件)。

要求摘錄

傳送一般 Reports.request() 要求主體，但指定 "reportType": "conversion"。

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

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

`columnName`	說明	行為	類型	是否可篩選
`status`	轉換的狀態：`Active` 或 `Removed`。	屬性	`Status`	是
`deviceSegment`	轉換歸因的裝置區隔：`Desktop`、`Mobile`、`Tablet` 或 `Other`。	屬性	`Device segment`	是
`floodlightGroup`	Floodlight 群組名稱。	屬性	`String`	是
`floodlightGroupConversionType`	這個群組中 Floodlight 活動產生的轉換類型：`Action` 或 `Transaction`。	屬性	`Conversion type`	是
`floodlightGroupId`	DS Floodlight 群組 ID。	屬性	`ID`	是
`floodlightGroupTag`	Floodlight 群組代碼。	屬性	`String`	是
`floodlightActivity`	Floodlight 活動名稱。	屬性	`String`	是
`floodlightActivityId`	DS Floodlight 活動 ID。	屬性	`ID`	是
`floodlightActivityTag`	Floodlight 活動代碼。	屬性	`String`	是
`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`	是
`keywordId`	DS 關鍵字 ID。如果值為 0，表示關鍵字未歸因。	屬性	`ID`	是
`keywordMatchType`	關鍵字比對類型：`Broad`、`Exact`、`Phrase` 或 `Content`。	屬性	`Match type`	是
`keywordText`	關鍵字文字。	屬性	`String`	是
`productTargetId`	DS 產品目標 ID。	屬性	`ID`	是
`productGroupId`	與此轉換相關聯的產品群組 ID。只有購物廣告活動的轉換才會有產品群組 ID。請勿使用產品群組 ID 進行彙整。	屬性	`ID`	是
`ad`	廣告名稱。	屬性	`String`	是
`adId`	DS 廣告 ID。如果值為 0，表示廣告未歸因。	屬性	`ID`	是
`isUnattributedAd`	指出這一列中的指標是否無法歸因於特定廣告。舉例來說，如果廣告採用不支援的格式，或是 Clickserver 網址有誤，DS 就無法將成效歸因給廣告。	屬性	`Boolean`	是
`inventoryAccountId`	包含與轉換相關聯產品的 DS 商品目錄帳戶 ID。當你在 DS 中連結商品目錄帳戶時，DS 就會產生這個 ID。	屬性	`ID`	是
`productId`	與此轉換相關聯的產品 ID。	屬性	`String`	是
`productCountry`	為內含與此轉換相關聯產品的商品目錄動態饋給註冊的國家/地區 (ISO 3166 格式)。	屬性	`String`	是
`productLanguage`	與此轉換相關聯的產品語言 (ISO 639-1)。	屬性	`String`	是
`productStoreId`	與轉換相關的店面商品目錄廣告。這組 ID 必須與店面產品動態饋給中使用的商店 ID 相符。	屬性	`String`	是
`productChannel`	與轉換相關聯的產品銷售通路：`Online` 或 `Local`。	屬性	`Product channel`	是
`conversionId`	Search Ads 360 為每筆轉換產生的 ID。	屬性	`ID`	是
`advertiserConversionId`	對於離線轉換，這是廣告客戶提供的 ID。如果廣告主未指定此類 ID，Search Ads 360 就會產生一個。如果是線上轉換，這個欄會等於 conversionId 欄或 floodlightOrderId 欄，具體取決於廣告主的 Floodlight 操作說明。	屬性	`String`	是
`conversionType`	轉換類型：`Action` 或 `Transaction`。	屬性	`Conversion type`	是
`conversionRevenue`	轉換的總金額。	屬性	`Money`	是
`conversionQuantity`	轉換記錄的項目數量，由 `qty` 參數決定。廣告主必須負責以動態方式填入參數 (例如轉換中售出的商品數量)，否則系統會將其預設為 1。	屬性	`Number`	是
`conversionDate`	發生轉換的日期 (以 Campaign Manager 聯播網時區為準)。系統會使用這個日期進行轉換指標匯總。舉例來說，當 DS 匯總 5 月 1 日的動作時，會計算所有 `conversionDate` 為 5 月 1 日的動作轉換。	屬性	`Date`	是
`conversionTimestamp`	轉換發生時的世界標準時間戳記。	屬性	`Timestamp`	是
`conversionLastModifiedTimestamp`	轉換最近一次修改的時間戳記 (世界標準時間)。	屬性	`Timestamp`	是
`conversionAttributionType`	轉換歸因於哪個廣告：`Visit` 或 `Keyword+Ad`。	屬性	`Conversion attribution type`	是
`conversionVisitId`	轉換歸因的 DS 造訪 ID。	屬性	`ID`	是
`conversionVisitTimestamp`	轉換歸因的造訪時間戳記 (以世界標準時間為準)。	屬性	`Timestamp`	是
`conversionVisitExternalClickId`	轉換歸因於哪次造訪的專屬字串，會以 `gclid` 網址參數的形式傳遞至到達網頁。僅適用於已整合 Conversion API 或 Google Analytics 的廣告客戶。	屬性	`String`	是
`conversionSearchTerm`	促成轉換的搜尋字詞。	屬性	`String`	是
`floodlightOriginalRevenue`	修改 Floodlight 貨幣指示前，與 Floodlight 事件相關聯的原始收益 (以目前報表的貨幣計算)。	屬性	`Money`	是
`floodlightEventRequestString`	轉換的 Floodlight 要求字串。	屬性	`String`	是
`floodlightReferrer`	轉換的 Floodlight 轉介網站。	屬性	`String`	是
`floodlightOrderId`	廣告主為轉換提供的 Floodlight 訂單 ID。	屬性	`String`	是
`feedItemId`	與此轉換相關聯的動態饋給項目資料列 ID。	屬性	`ID`	是
`feedId`	與此轉換相關聯的動態饋給表格 ID。	屬性	`ID`	是
`feedType`	與此轉換相關聯的動態饋給類型。	屬性	`Feed type`	是