關於造訪的原始事件資料。每次消費者點擊廣告並重新導向至到達網頁時，就算是一次造訪。
這份報表只能透過非同步要求傳回 (也就是透過 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 |
相容 |
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 |
點擊的產品 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 網址參數的形式傳送至到達網頁。只適用於已啟用 Conversion API 整合或 Google Analytics (分析) 整合的廣告客戶。 | 屬性 | String |
相容 |
feedItemId |
與此造訪相關聯的資訊提供項目列編號。 | 屬性 | ID |
相容 |
feedId |
與這次造訪相關聯的動態饋給表格 ID。 | 屬性 | ID |
相容 |
feedType |
與此造訪相關的資訊提供類型。 | 屬性 | Feed type |
相容 |