Dữ liệu sự kiện thô về các lượt truy cập. Một lượt truy cập xảy ra mỗi khi người tiêu dùng nhấp vào một quảng cáo và được chuyển hướng đến một trang đích.
Chỉ có thể trả về báo cáo này bằng một yêu cầu không đồng bộ (nghĩa là thông qua phương thức Reports.request()).
Do các sự kiện xảy ra vào các ngày cụ thể, nên yêu cầu cho báo cáo này phải chỉ định timeRange. Bạn có thể chỉ định một trong những mục sau:
- startDate và endDate.
- ThayMetricsMetricsTimestamp (ChangeAttributes VìTimestamp không hợp lệ đối với các sự kiện).
Yêu cầu trích dẫn
Gửi nội dung yêu cầu Reports.request() thông thường, nhưng chỉ định "reportType": "visit"
.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Đối với mỗi cột mà bạn muốn trả về hoặc lọc trong báo cáo,
hãy chỉ định columnName
trong bảng dưới đây.
Bạn cũng có thể tuỳ ý chỉ định headerText, startDate và endDate.
Xin lưu ý rằng bạn không thể lọc một số cột. Hãy tham khảo phần "Có thể lọc" trong bảng bên dưới.
columnName | Mô tả | Hành vi | Loại | Có thể lọc |
---|---|---|---|---|
status |
Trạng thái của lượt truy cập. Các lượt truy cập là không thể thay đổi, vì vậy, đây luôn là Active . |
thuộc tính | Status |
Có |
deviceSegment |
Phân đoạn thiết bị mà lượt truy cập được phân bổ: Desktop , Mobile , Tablet hoặc Other . |
thuộc tính | Device segment |
Có |
agency |
Tên đại lý. | thuộc tính | String |
Có |
agencyId |
ID đại lý DS. | thuộc tính | ID |
Có |
advertiser |
Tên nhà quảng cáo. | thuộc tính | String |
Có |
advertiserId |
ID nhà quảng cáo DS. | thuộc tính | ID |
Có |
account |
Tên tài khoản công cụ. | thuộc tính | String |
Có |
accountId |
Mã tài khoản công cụ DS. | thuộc tính | ID |
Có |
accountEngineId |
Mã của tài khoản trong tài khoản công cụ bên ngoài. | thuộc tính | String |
Có |
accountType |
Loại tài khoản công cụ: Google AdWords , Bing Ads , Yahoo Japan Listing Ads , Yahoo Search Marketing , Yahoo Gemini , Baidu hoặc Comparison Shopping . |
thuộc tính | Engine type |
Có |
campaign |
Tên chiến dịch. | thuộc tính | String |
Có |
campaignId |
Mã chiến dịch DS. | thuộc tính | ID |
Có |
campaignStatus |
Trạng thái của chiến dịch chứa mục này. | thuộc tính | Status |
Có |
adGroup |
Tên nhóm quảng cáo. | thuộc tính | String |
Có |
adGroupId |
Mã nhóm quảng cáo DS. | thuộc tính | ID |
Có |
adGroupStatus |
Trạng thái của nhóm quảng cáo chứa mục này. | thuộc tính | Status |
Có |
keywordId |
ID từ khóa DS. Giá trị 0 cho biết từ khoá chưa được phân bổ. | thuộc tính | ID |
Có |
keywordMatchType |
Loại so khớp từ khóa: Broad , Exact , Phrase hoặc Content . |
thuộc tính | Match type |
Có |
keywordText |
Văn bản từ khoá. | thuộc tính | String |
Có |
productTargetId |
ID mục tiêu sản phẩm DS. | thuộc tính | ID |
Có |
productGroupId |
Mã nhóm sản phẩm có liên quan đến lượt truy cập này. Chỉ những lượt truy cập từ chiến dịch mua sắm mới có mã nhóm sản phẩm. Bạn không được dùng mã nhóm sản phẩm để tham gia. | thuộc tính | ID |
Có |
ad |
Tên quảng cáo. | thuộc tính | String |
Có |
adId |
ID quảng cáo DS. Giá trị 0 cho biết quảng cáo chưa được phân bổ. | thuộc tính | ID |
Có |
isUnattributedAd |
Cho biết liệu các chỉ số trong hàng này có thể phân bổ cho một quảng cáo cụ thể hay không. Ví dụ: quảng cáo có định dạng không được hỗ trợ hoặc URL máy chủ lượt nhấp không chính xác có thể ngăn DS phân bổ các chỉ số cho quảng cáo. | thuộc tính | Boolean |
Có |
inventoryAccountId |
Mã tài khoản kho hàng DS chứa sản phẩm mà người dùng đã nhấp vào. DS tạo mã này khi bạn liên kết tài khoản khoảng không quảng cáo trong DS. | thuộc tính | ID |
Có |
productId |
Mã của sản phẩm được nhấp vào. | thuộc tính | String |
Có |
productCountry |
Quốc gia (định dạng ISO 3166) đã đăng ký nguồn cấp dữ liệu kho hàng có chứa sản phẩm mà người dùng đã nhấp vào. | thuộc tính | String |
Có |
productLanguage |
Ngôn ngữ (ISO 639-1) đã được đặt cho nguồn cấp dữ liệu Merchant Center chứa dữ liệu về sản phẩm. | thuộc tính | String |
Có |
productStoreId |
Cửa hàng trong quảng cáo kho hàng tại địa phương được nhấp vào. Mã này phải khớp với mã cửa hàng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn. | thuộc tính | String |
Có |
productChannel |
Kênh bán sản phẩm mà người dùng nhấp vào: Online hoặc Local . |
thuộc tính | Product channel |
Có |
visitId |
Mã lượt truy cập DS. | thuộc tính | ID |
Có |
visitSearchQuery |
Truy vấn tìm kiếm đã tạo ra lượt truy cập này. | thuộc tính | String |
Có |
visitDate |
Ngày (theo múi giờ của tài khoản công cụ) khi lượt truy cập xảy ra. Ngày này được dùng để tổng hợp lượt truy cập. Ví dụ: khi DS tổng hợp lượt truy cập cho ngày 1 tháng 5, hệ thống sẽ tính tất cả các lượt truy cập có visitDate là ngày 1 tháng 5. |
thuộc tính | Date |
Có |
visitTimestamp |
Dấu thời gian UTC khi lượt truy cập xảy ra. | thuộc tính | Timestamp |
Có |
visitNetworkType |
Mạng quảng cáo đã tạo ra lượt truy cập này: Content , Search hoặc Other . |
thuộc tính | Network type |
Có |
visitReferrer |
URL liên kết giới thiệu của lượt truy cập. | thuộc tính | String |
Có |
visitExternalClickId |
Một chuỗi duy nhất cho mỗi lượt truy cập được chuyển vào trang đích dưới dạng tham số URL gclid. Chỉ được bật cho các nhà quảng cáo tích hợp API chuyển đổi hoặc tích hợp Google Analytics. | thuộc tính | String |
Có |
feedItemId |
ID của hàng mục nguồn cấp dữ liệu được liên kết với lượt truy cập này. | thuộc tính | ID |
Có |
feedId |
ID của bảng nguồn cấp dữ liệu được kết hợp với lượt truy cập này. | thuộc tính | ID |
Có |
feedType |
Loại nguồn cấp dữ liệu được liên kết với lượt truy cập này. | thuộc tính | Feed type |
Có |