報表類型：造訪

與造訪相關的原始事件資料。每次消費者點擊廣告並重新導向至到達網頁時，就算是一次造訪。

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

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

• startDate 和 endDate。
• changedMetricsSinceTimestamp (changedAttributesSinceTimestamp 不是活動有效。

要求摘錄

定期傳送 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	是