與造訪相關的原始事件資料。每次消費者點擊廣告並重新導向至到達網頁時,就算是一次造訪。
這份報表只能由非同步要求 (也就是透過 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 |
是 |