Search Ads 360 Reporting API cũ đã ngừng hoạt động. Giờ đây, bạn có thể tạo báo cáo bằng API Báo cáo Search Ads 360 mới.

Xin lưu ý rằng Search Ads 360 Conversion API không bị ảnh hưởng và sẽ tiếp tục được hỗ trợ.

Trang này được dịch bởi Cloud Translation API.

Loại báo cáo: lượt truy cập

Dữ liệu sự kiện chưa qua xử lý về 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 quảng cáo và được chuyển hướng đến một trang đích.

Báo cáo này chỉ có thể được trả về nếu có một yêu cầu không đồng bộ (tức là thông qua Reports.request()).

Bởi vì sự kiện xảy ra vào những 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 các thông tin sau:

startDate và endDate.
changedMetricsSinceTimestamp (changedAttributesSinceTimestamp không hợp lệ cho sự kiện).

Yêu cầu trích dẫn

Gửi thông báo Reports.request() nội dung yêu cầu 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, chỉ định columnName được liệt kê trong bảng bên dưới. Bạn cũng có thể tuỳ ý chỉ định headerText, startDate, và endDate. Lưu ý rằng một số cột không thể lọc được; tham khảo "Có thể lọc" trong bảng dưới đây.

`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 giá trị này luôn là `Active`.	phân bổ	`Status`	Có
`deviceSegment`	Phân khúc thiết bị mà lượt truy cập được phân bổ cho: `Desktop`, `Mobile`, `Tablet` hoặc `Other`.	phân bổ	`Device segment`	Có
`agency`	Tên công ty quảng cáo.	phân bổ	`String`	Có
`agencyId`	Mã công ty quảng cáo DS.	phân bổ	`ID`	Có
`advertiser`	Tên nhà quảng cáo.	phân bổ	`String`	Có
`advertiserId`	Mã nhận dạng nhà quảng cáo DS.	phân bổ	`ID`	Có
`account`	Tên tài khoản công cụ.	phân bổ	`String`	Có
`accountId`	Mã tài khoản công cụ DS.	phân bổ	`ID`	Có
`accountEngineId`	Mã của tài khoản trong tài khoản công cụ bên ngoài.	phân bổ	`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`.	phân bổ	`Engine type`	Có
`campaign`	Tên chiến dịch.	phân bổ	`String`	Có
`campaignId`	Mã chiến dịch DS.	phân bổ	`ID`	Có
`campaignStatus`	Trạng thái của chiến dịch chứa mục này.	phân bổ	`Status`	Có
`adGroup`	Tên nhóm quảng cáo.	phân bổ	`String`	Có
`adGroupId`	Mã nhóm quảng cáo DS.	phân bổ	`ID`	Có
`adGroupStatus`	Trạng thái của nhóm quảng cáo chứa mục này.	phân bổ	`Status`	Có
`keywordId`	Mã từ khoá DS. Giá trị 0 cho biết từ khoá không được phân bổ.	phân bổ	`ID`	Có
`keywordMatchType`	Loại đối sánh từ khóa: `Broad`, `Exact`, `Phrase` hoặc `Content`.	phân bổ	`Match type`	Có
`keywordText`	Văn bản từ khoá.	phân bổ	`String`	Có
`productTargetId`	Mã mục tiêu sản phẩm DS.	phân bổ	`ID`	Có
`productGroupId`	ID nhóm sản phẩm được liên kết với 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.	phân bổ	`ID`	Có
`ad`	Tên quảng cáo.	phân bổ	`String`	Có
`adId`	Mã quảng cáo DS. Giá trị 0 cho biết rằng quảng cáo không được phân bổ.	phân bổ	`ID`	Có
`isUnattributedAd`	Cho biết liệu các chỉ số trong hàng này có phải không thể phân bổ cho một quảng cáo cụ thể hay không. Ví dụ: một quảng cáo có định dạng không được hỗ trợ hoặc URL của máy chủ theo dõi lượt nhấp bị lỗi có thể khiến DS phân bổ chỉ số cho một quảng cáo.	phân bổ	`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 một tài khoản kho hàng trong DS.	phân bổ	`ID`	Có
`productId`	Mã của sản phẩm được nhấp vào.	phân bổ	`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.	phân bổ	`String`	Có
`productLanguage`	Ngôn ngữ (ISO 639-1) đã được đặt cho nguồn cấp dữ liệu Merchant Center có chứa dữ liệu về sản phẩm.	phân bổ	`String`	Có
`productStoreId`	Cửa hàng trong Quảng cáo kho hàng tại địa phương mà người dùng đã nhấp vào. Giá trị này phải khớp với mã cửa hàng dùng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn.	phân bổ	`String`	Có
`productChannel`	Kênh bán hàng của sản phẩm mà người dùng nhấp vào: `Online` hoặc `Local`.	phân bổ	`Product channel`	Có
`visitId`	Mã truy cập DS.	phân bổ	`ID`	Có
`visitSearchQuery`	Cụm từ tìm kiếm đã tạo ra lượt truy cập này.	phân bổ	`String`	Có
`visitDate`	Ngày (theo múi giờ của tài khoản công cụ) mà lượt truy cập diễn 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 các lượt truy cập vào ngày 1 tháng 5, hệ thống này sẽ tính tất cả lượt truy cập có `visitDate` là ngày 1 tháng 5.	phân bổ	`Date`	Có
`visitTimestamp`	Dấu thời gian UTC khi lượt truy cập diễn ra.	phân bổ	`Timestamp`	Có
`visitNetworkType`	Mạng quảng cáo đã tạo ra lượt truy cập này: `Content`, `Search` hoặc `Other`.	phân bổ	`Network type`	Có
`visitReferrer`	URL liên kết giới thiệu của lượt truy cập.	phân bổ	`String`	Có
`visitExternalClickId`	Một chuỗi riêng biệt cho mỗi lượt truy cập được truyền đến trang đích dưới dạng tham số URL `gclid`. Chỉ bật cho những nhà quảng cáo có tích hợp API chuyển đổi hoặc Google Analytics.	phân bổ	`String`	Có
`feedItemId`	Mã của hàng mục trong nguồn cấp dữ liệu được liên kết với lượt truy cập này.	phân bổ	`ID`	Có
`feedId`	Mã của bảng nguồn cấp dữ liệu liên kết với lượt truy cập này.	phân bổ	`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.	phân bổ	`Feed type`	Có