與造訪相關的原始事件資料。每次消費者點擊廣告並重新導向至到達網頁時,就算是一次造訪。
這份報表只能由非同步要求 (也就是透過 Reports.request() 方法)。
由於事件發生在特定日期,因此請在請求報表中指定 timeRange。 您可以指定下列其中一項:
要求摘錄
      定期傳送
      Reports.request()
      但指定 "reportType": "visit"
    
{
...
  "reportType": "visit",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}
        對於要在報表中傳回或篩選的資料欄中,
        指定下表所列的 columnName。
        您也可以選擇指定
        headerText、
        startDate,
        和 endDate。
        請注意,部分資料欄無法篩選;請參閱「可篩選」。
      
| columnName | 說明 | 行為 | 類型 | 是否可篩選 | 
|---|---|---|---|---|
| status | 造訪狀態。造訪次數無法變更,因此這個值一律為 Active。 | 屬性 | Status | 是 | 
| deviceSegment | 該次造訪所屬的裝置區隔: Desktop、Mobile、Tablet或Other。 | 屬性 | Device segment | 是 | 
| 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 關鍵字編號。如果值為 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 | 所點選產品的 ID。 | 屬性 | String | 是 | 
| productCountry | 針對使用者點選的產品所屬的商品目錄動態饋給,註冊的國家/地區 (ISO 3166 格式)。 | 屬性 | String | 是 | 
| productLanguage | 針對內含產品相關資料的 Merchant Center 動態饋給所設定的語言 (ISO 639-1)。 | 屬性 | String | 是 | 
| productStoreId | 使用者點擊店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給中使用的商店 ID 相符。 | 屬性 | String | 是 | 
| productChannel | 獲得點擊的產品銷售通路: Online或Local。 | 屬性 | Product channel | 是 | 
| visitId | DS 造訪 ID。 | 屬性 | ID | 是 | 
| visitSearchQuery | 產生這次造訪的搜尋查詢。 | 屬性 | String | 是 | 
| visitDate | 造訪發生的日期,以引擎帳戶的時區為準。這個日期用於匯總造訪次數。舉例來說,當 DS 匯總 5 月 1 日的造訪時,就會計算 visitDate為 5 月 1 日的所有造訪。 | 屬性 | Date | 是 | 
| visitTimestamp | 造訪發生時間的世界標準時間時間戳記 (UTC)。 | 屬性 | Timestamp | 是 | 
| visitNetworkType | 產生這次造訪的廣告聯播網: Content、Search或Other。 | 屬性 | Network type | 是 | 
| visitReferrer | 造訪的參照網址。 | 屬性 | String | 是 | 
| visitExternalClickId | 傳送至到達網頁的單次造訪專屬字串,以 gclid 網址參數的形式傳送至到達網頁。只有整合轉換 API 或 Google Analytics 的廣告客戶才會啟用。 | 屬性 | String | 是 | 
| feedItemId | 與這次造訪相關聯的動態饋給項目列 ID。 | 屬性 | ID | 是 | 
| feedId | 與這次造訪相關聯的動態饋給表格 ID。 | 屬性 | ID | 是 | 
| feedType | 與此次造訪相關聯的動態饋給類型。 | 屬性 | Feed type | 是 | 
