報表類型：轉換

與轉換相關的原始事件資料。

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

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

要求摘錄

傳送一般的 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 相容
campaignStatus 包含此項目的廣告活動狀態。 屬性 Status 相容
adGroup 廣告群組名稱： 屬性 String 相容
adGroupId DS 廣告群組編號。 屬性 ID 相容
adGroupStatus 包含這個項目的廣告群組狀態。 屬性 Status 相容
keywordId DS 關鍵字編號。如果值為 0，表示關鍵字未歸功。 屬性 ID 相容
keywordMatchType 關鍵字比對類型：Broad、Exact、Phrase 或 Content。 屬性 Match type 相容
keywordText 關鍵字文字。 屬性 String 相容
productTargetId DS 商品目標編號。 屬性 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 與這個轉換相關聯的產品編號。 屬性 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 就會產生一組 ID。視線上的 Floodlight 指示而定，如果是線上轉換，則等於 ConversionId 欄或 FloodlightOrderId 欄。 屬性 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 轉換最近修改的 UTC 時間戳記。 屬性 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 相容