報表類型:轉換

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

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

由於事件發生在特定日期,因此請在請求報表中指定 timeRange。 您可以指定下列其中一項:

要求摘錄

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

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

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

columnName說明行為類型是否可篩選
status 轉換狀態:ActiveRemoved 屬性 Status
deviceSegment 轉換歸因的裝置區隔:DesktopMobileTabletOther 屬性 Device segment
floodlightGroup Floodlight 群組名稱。 屬性 String
floodlightGroupConversionType 這個群組中的 Floodlight 活動產生的轉換類型:ActionTransaction 屬性 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 AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaiduComparison Shopping 屬性 Engine type
campaign 廣告活動名稱: 屬性 String
campaignId DS 廣告活動 ID。 屬性 ID
campaignStatus 含有這個項目的廣告活動狀態。 屬性 Status
adGroup 廣告群組名稱: 屬性 String
adGroupId DS 廣告群組 ID。 屬性 ID
adGroupStatus 這個項目所屬廣告群組的狀態。 屬性 Status
keywordId DS 關鍵字編號。如果值為 0,表示關鍵字未歸因。 屬性 ID
keywordMatchType 關鍵字比對類型:BroadExactPhraseContent 屬性 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 與這次轉換相關聯的產品 ID。 屬性 String
productCountry 針對與這次轉換相關聯的商品目錄動態饋給,所註冊的國家/地區 (ISO 3166 格式)。 屬性 String
productLanguage 與這次轉換相關聯的產品語言 (ISO 639-1)。 屬性 String
productStoreId 與轉換相關聯的店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給中使用的商店 ID 相符。 屬性 String
productChannel 與轉換相關聯的產品銷售通路:OnlineLocal 屬性 Product channel
conversionId Search Ads 360 為每次轉換產生的 ID。 屬性 ID
advertiserConversionId 如果是離線轉換,這是廣告客戶提供的 ID。如果廣告客戶沒有指定這類 ID,Search Ads 360 就會產生這個 ID。如果是線上轉換,則視廣告客戶的 Floodlight 指示而定,這個欄位會等於 conversionId 欄或 FlolightOrderId 欄。 屬性 String
conversionType 轉換類型:ActionTransaction 屬性 Conversion type
conversionRevenue 該次轉換的總金額。 屬性 Money
conversionQuantity 由轉換記錄的項目數量,由 qty 參數決定。廣告客戶必須負責以動態方式填入參數 (例如轉換中的售出商品數量),否則預設值為 1。 屬性 Number
conversionDate 轉換發生的日期 (以 Campaign Manager 聯播網時區為準)。這個日期用於匯總轉換指標。舉例來說,當 DS 匯總 5 月 1 日的動作時,就會計算 conversionDate 為 5 月 1 日的所有操作轉換。 屬性 Date
conversionTimestamp 轉換發生的時間 (世界標準時間) 時間戳記。 屬性 Timestamp
conversionLastModifiedTimestamp 轉換最近修改項目的世界標準時間時間戳記。 屬性 Timestamp
conversionAttributionType 轉換歸因對象:VisitKeyword+Ad 屬性 Conversion attribution type
conversionVisitId 促成轉換的 DS 造訪 ID。 屬性 ID
conversionVisitTimestamp 促成轉換的造訪時間 (世界標準時間) 時間戳記。 屬性 Timestamp
conversionVisitExternalClickId 此為不重複字串,代表轉換所歸因的造訪,並以 gclid 網址參數的形式傳送至到達網頁。只有整合轉換 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