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:

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.

columnNameMô tảHành viLoạiCó 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
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
agency Tên công ty quảng cáo. phân bổ String
agencyId Mã công ty quảng cáo DS. phân bổ ID
advertiser Tên nhà quảng cáo. phân bổ String
advertiserId Mã nhận dạng nhà quảng cáo DS. phân bổ ID
account Tên tài khoản công cụ. phân bổ String
accountId Mã tài khoản công cụ DS. phân bổ ID
accountEngineId Mã của tài khoản trong tài khoản công cụ bên ngoài. phân bổ String
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
campaign Tên chiến dịch. phân bổ String
campaignId Mã chiến dịch DS. phân bổ ID
campaignStatus Trạng thái của chiến dịch chứa mục này. phân bổ Status
adGroup Tên nhóm quảng cáo. phân bổ String
adGroupId Mã nhóm quảng cáo DS. phân bổ ID
adGroupStatus Trạng thái của nhóm quảng cáo chứa mục này. phân bổ Status
keywordId Mã từ khoá DS. Giá trị 0 cho biết từ khoá không được phân bổ. phân bổ ID
keywordMatchType Loại đối sánh từ khóa: Broad, Exact, Phrase hoặc Content. phân bổ Match type
keywordText Văn bản từ khoá. phân bổ String
productTargetId Mã mục tiêu sản phẩm DS. phân bổ ID
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
ad Tên quảng cáo. phân bổ String
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
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
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
productId Mã của sản phẩm được nhấp vào. phân bổ String
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
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
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
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
visitId Mã truy cập DS. phân bổ ID
visitSearchQuery Cụm từ tìm kiếm đã tạo ra lượt truy cập này. phân bổ String
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
visitTimestamp Dấu thời gian UTC khi lượt truy cập diễn ra. phân bổ Timestamp
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
visitReferrer URL liên kết giới thiệu của lượt truy cập. phân bổ String
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
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
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
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