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