Loại báo cáo: truy cập

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ó