Loại báo cáo: lượt chuyển đổi

Dữ liệu sự kiện chưa qua xử lý về lượt chuyển đổi.

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 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 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": "conversion".

{
...
  "reportType": "conversion",
  "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 chuyển đổi: Active hoặc Removed. phân bổ Status
deviceSegment Phân khúc thiết bị mà lượt chuyển đổi được phân bổ cho: Desktop, Mobile, Tablet hoặc Other. phân bổ Device segment
floodlightGroup Tên nhóm Floodlight. phân bổ String
floodlightGroupConversionType Loại lượt chuyển đổi do hoạt động Floodlight tạo ra trong nhóm này: Action hoặc Transaction. phân bổ Conversion type
floodlightGroupId Mã nhóm Floodlight DS. phân bổ ID
floodlightGroupTag Thẻ nhóm Floodlight. phân bổ String
floodlightActivity Tên hoạt động Floodlight. phân bổ String
floodlightActivityId Mã hoạt động Floodlight DS. phân bổ ID
floodlightActivityTag Thẻ hoạt động Floodlight. phân bổ String
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 Mã nhóm sản phẩm được liên kết với lượt chuyển đổi này. Chỉ những lượt chuyển đổi 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ảng không quảng cáo DS chứa sản phẩm liên kết với lượt chuyển đổi. 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 liên kết với lượt chuyển đổi này. 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 liên kết với lượt chuyển đổi này. phân bổ String
productLanguage Ngôn ngữ (ISO 639-1) của sản phẩm liên kết với lượt chuyển đổi này. phân bổ String
productStoreId Cửa hàng trong Quảng cáo kho hàng tại địa phương được liên kết với lượt chuyển đổi. 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 được liên kết với lượt chuyển đổi: Online hoặc Local. phân bổ Product channel
conversionId Mã nhận dạng mà Search Ads 360 tạo ra cho mỗi lượt chuyển đổi. phân bổ ID
advertiserConversionId Đối với lượt chuyển đổi ngoại tuyến, đây là mã do nhà quảng cáo cung cấp. Nếu nhà quảng cáo không chỉ định một mã nhận dạng như vậy, thì Search Ads 360 sẽ tạo một mã. Đối với lượt chuyển đổi trực tuyến, giá trị này bằng cột conversionId hoặc cột floodlightOrderId tuỳ thuộc vào chỉ dẫn của nhà quảng cáo trong Floodlight. phân bổ String
conversionType Loại chuyển đổi: Action hoặc Transaction. phân bổ Conversion type
conversionRevenue Tổng số tiền từ lượt chuyển đổi. phân bổ Money
conversionQuantity Số lượng mặt hàng mà lượt chuyển đổi ghi lại, do tham số qty xác định. Nhà quảng cáo có trách nhiệm tự động điền thông số (chẳng hạn như số lượng mặt hàng đã bán trong lượt chuyển đổi), nếu không, giá trị mặc định sẽ là 1. phân bổ Number
conversionDate Ngày (theo múi giờ của mạng Campaign Manager) khi diễn ra lượt chuyển đổi. Ngày này được dùng để tổng hợp các chỉ số về lượt chuyển đổi. Ví dụ: khi DS tổng hợp các hành động vào ngày 1 tháng 5, hệ thống này sẽ tính tất cả các lượt chuyển đổi hành động có conversionDate là ngày 1 tháng 5. phân bổ Date
conversionTimestamp Dấu thời gian UTC khi lượt chuyển đổi xảy ra. phân bổ Timestamp
conversionLastModifiedTimestamp Dấu thời gian UTC của lần sửa đổi gần đây nhất của lượt chuyển đổi. phân bổ Timestamp
conversionAttributionType Đối tượng đóng góp của lượt chuyển đổi: Visit hoặc Keyword+Ad. phân bổ Conversion attribution type
conversionVisitId Mã lượt truy cập DS mà lượt chuyển đổi được phân bổ. phân bổ ID
conversionVisitTimestamp Dấu thời gian UTC của lượt truy cập mà lượt chuyển đổi được phân bổ. phân bổ Timestamp
conversionVisitExternalClickId Một chuỗi riêng biệt dành cho lượt truy cập mà lượt chuyển đổi được phân bổ, đượ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
conversionSearchTerm Cụm từ tìm kiếm đã dẫn đến lượt chuyển đổi. phân bổ String
floodlightOriginalRevenue Doanh thu ban đầu, không thay đổi được liên kết với sự kiện Floodlight (theo đơn vị tiền tệ của báo cáo hiện tại) trước khi chỉ định về đơn vị tiền tệ của Floodlight sửa đổi. phân bổ Money
floodlightEventRequestString Chuỗi yêu cầu Floodlight của lượt chuyển đổi. phân bổ String
floodlightReferrer Trang web liên kết giới thiệu Floodlight của lượt chuyển đổi. phân bổ String
floodlightOrderId Mã đơn hàng Floodlight do nhà quảng cáo cung cấp cho lượt chuyển đổi. phân bổ String
feedItemId Mã của hàng mục trong nguồn cấp dữ liệu liên kết với lượt chuyển đổi 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 chuyển đổi 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 chuyển đổi này. phân bổ Feed type