Loại báo cáo: productQuảng cáo

Các chỉ số về hiệu suất, thuộc tính cấu hình và thuộc tính kho hàng cho những sản phẩm được xác định trong nguồn cấp dữ liệu kho hàng và được quảng cáo trong một chiến dịch mua sắm.

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()).

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

{
...
  "reportType": "productAdvertised",
  "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 sản phẩm như được chỉ định trong tài khoản kho hàng: Active hoặc Removed. phân bổ Status
creationTimestamp Dấu thời gian tạo của sản phẩm như được nêu trong tài khoản kho hàng, có định dạng theo ISO 8601. phân bổ Timestamp
lastModifiedTimestamp Dấu thời gian sửa đổi gần đây nhất của sản phẩm như được nêu trong tài khoản kho hàng, nội dung sửa đổi, theo định dạng ISO 8601. phân bổ Timestamp
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
productId Mã mặt hàng của sản phẩm. phân bổ String
productCountry Quốc gia đã đăng ký nguồn cấp dữ liệu kho hàng của sản phẩm. phân bổ String
productLanguage Ngôn ngữ đã đăng ký cho nguồn cấp dữ liệu kho hàng của sản phẩm. phân bổ String
productMpn Thuộc tính MPN (Mã số linh kiện của nhà sản xuất) của một mặt hàng sản phẩm. phân bổ String
productColor Thuộc tính color của mặt hàng sản phẩm. phân bổ String
productSize Thuộc tính size (kích thước) của mặt hàng sản phẩm. phân bổ String
productMaterial Thuộc tính material [chất liệu] của mặt hàng sản phẩm. phân bổ String
productPattern Thuộc tính pattern [mẫu] của mặt hàng sản phẩm. phân bổ String
productAvailability Thuộc tính availability [tình trạng còn hàng] của mặt hàng sản phẩm. phân bổ Product availability
productGender Thuộc tính gender (giới tính) của mặt hàng sản phẩm. phân bổ String
productAgeGroup Thuộc tính age group (nhóm tuổi) của mặt hàng sản phẩm. phân bổ String
productLandingPageUrl Thuộc tính trang đích của một mặt hàng sản phẩm. phân bổ String
productCategory Thuộc tính google productcategory [danh mục sản phẩm của Google] của một mặt hàng sản phẩm. phân bổ String
productCategoryLevel1 Thuộc tính danh mục sản phẩm của Google cấp 1 của một mặt hàng sản phẩm. phân bổ String
productCategoryLevel2 Thuộc tính danh mục sản phẩm của Google cấp 2 của một mặt hàng sản phẩm. phân bổ String
productCategoryLevel3 Thuộc tính danh mục sản phẩm của Google cấp 3 của một mặt hàng sản phẩm. phân bổ String
productCategoryLevel4 Thuộc tính danh mục sản phẩm của Google cấp 4 của một mặt hàng sản phẩm. phân bổ String
productCategoryLevel5 Thuộc tính danh mục sản phẩm của Google cấp 5 của một mặt hàng sản phẩm. phân bổ String
productBrand Thuộc tính brand [thương hiệu] của mặt hàng sản phẩm. phân bổ String
productGtin Thuộc tính GTIN (Mã số sản phẩm thương mại toàn cầu) của một mặt hàng sản phẩm. phân bổ String
productPrice Thuộc tính price (giá) của một mặt hàng sản phẩm. phân bổ Money
productSalePrice Thuộc tính price (giá) của một mặt hàng sản phẩm. phân bổ Money
productTypeLevel1 Thuộc tính loại sản phẩm leve 1 của một mặt hàng sản phẩm. phân bổ String
productTypeLevel2 Thuộc tính loại sản phẩm leve 2 của một mặt hàng sản phẩm. phân bổ String
productTypeLevel3 Thuộc tính product type leve 3 của một mặt hàng sản phẩm. phân bổ String
productTypeLevel4 Thuộc tính loại sản phẩm leve 4 của một mặt hàng sản phẩm. phân bổ String
productTypeLevel5 Thuộc tính loại sản phẩm leve 5 của một mặt hàng sản phẩm. phân bổ String
productCondition Thuộc tính condition của mặt hàng sản phẩm. phân bổ String
productCustomLabel0 Thuộc tính nhãn tuỳ chỉnh 0 của một mặt hàng sản phẩm. phân bổ String
productCustomLabel1 Thuộc tính nhãn tuỳ chỉnh 1 của một mặt hàng sản phẩm. phân bổ String
productCustomLabel2 Thuộc tính nhãn tuỳ chỉnh 2 của một mặt hàng sản phẩm. phân bổ String
productCustomLabel3 Thuộc tính nhãn tuỳ chỉnh 3 của một mặt hàng sản phẩm. phân bổ String
productCustomLabel4 Thuộc tính nhãn tuỳ chỉnh 4 của một mặt hàng sản phẩm. phân bổ String
productCostOfGoodsSold Tổng chi phí bán một sản phẩm như được chỉ định trong nguồn cấp dữ liệu kho hàng. phân bổ Money
productStoreId Cửa hàng có một sản phẩm được quảng cáo trong Quảng cáo kho hàng tại địa phương. 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 Thuộc tính kênh bán hàng của mặt hàng sản phẩm: Online hoặc Local. phân bổ Product channel
productChannelExclusivity Thuộc tính kênh độc quyền của một mặt hàng sản phẩm. phân bổ Product channel exclusivity
productItemGroupId Thuộc tính id nhóm mặt hàng của một mặt hàng sản phẩm. phân bổ String
productTitle Thuộc tính tiêu đề của một mặt hàng sản phẩm. phân bổ String
dfaActions Tổng số hành động trên Campaign Manager. chỉ số Integer
dfaRevenue Tổng doanh thu do các giao dịch Campaign Manager tạo ra. chỉ số Money
dfaTransactions Tổng số giao dịch Campaign Manager. chỉ số Integer
dfaWeightedActions Tổng số hành động của Campaign Manager có trọng số. chỉ số Number
dfaActionsCrossEnv Tổng số hành động trên nhiều môi trường của Campaign Manager. chỉ số Number
dfaRevenueCrossEnv Tổng doanh thu do các giao dịch Campaign Manager trên nhiều môi trường tạo ra. chỉ số Money
dfaTransactionsCrossEnv Tổng số giao dịch qua Campaign Manager trên nhiều môi trường. chỉ số Number
dfaWeightedActionsCrossEnv Tổng số hành động có trọng số của các hành động trên Campaign Manager trên nhiều môi trường. chỉ số Number
avgCpc Giá mỗi nhấp chuột trung bình. chỉ số Money
avgCpm Chi phí trung bình cho mỗi nghìn lượt hiển thị. chỉ số Money
avgPos Vị trí trung bình. chỉ số Number
clicks Tổng hợp số lượt nhấp. chỉ số Integer
cost Tổng chi phí đã thanh toán cho(các) tài khoản công cụ. chỉ số Money
ctr Tỷ lệ nhấp trung bình. chỉ số Number
impr Tổng số lượt hiển thị. chỉ số Integer
adWordsConversions Dữ liệu mà nhà quảng cáo đã thiết lập sẽ được báo cáo trong cột Lượt chuyển đổi trên Google Ads. Khi một hành động chuyển đổi trên Google Ads được tạo, nhà quảng cáo có thể chọn xem có tính các lượt chuyển đổi đó trong cột Báo cáo lượt chuyển đổi hay không. chỉ số Number
adWordsConversionValue Giá trị tổng hợp của các lượt chuyển đổi trên Google Ads. chỉ số Number
adWordsViewThroughConversions Tổng số lượt chuyển đổi từ lượt xem hết trên Google Ads. chỉ số Integer
visits Tổng số lượt truy cập DS. chỉ số Integer
date Phân đoạn báo cáo theo ngày; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày của mỗi hàng. phân khúc Date
monthStart Phân đoạn báo cáo theo tháng; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày đầu tiên trong tháng của mỗi hàng. phân khúc Date
monthEnd Phân đoạn báo cáo theo tháng; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày cuối cùng trong tháng của mỗi hàng. phân khúc Date
quarterStart Phân đoạn báo cáo theo quý; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày đầu tiên trong quý của mỗi hàng. phân khúc Date
quarterEnd Phân đoạn báo cáo theo quý; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày cuối cùng của một quý của mỗi hàng. phân khúc Date
weekStart Phân đoạn báo cáo theo tuần (Chủ nhật đến thứ Bảy); mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày đầu tiên (Chủ nhật) của mỗi hàng. phân khúc Date
weekEnd Phân đoạn báo cáo theo tuần (Chủ nhật đến thứ Bảy); mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày cuối cùng (thứ Bảy) của mỗi hàng. phân khúc Date
yearStart Phân đoạn báo cáo theo năm; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày đầu tiên trong năm của mỗi hàng. phân khúc Date
yearEnd Phân đoạn báo cáo theo năm; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày cuối cùng trong năm trên mỗi hàng. phân khúc Date
deviceSegment Phân đoạn báo cáo theo thiết bị; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi phân đoạn thiết bị. Cột này trả về phân đoạn thiết bị của mỗi hàng. phân khúc Device segment
floodlightGroup Phân đoạn báo cáo theo nhóm Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi nhóm Floodlight. Cột này trả về tên nhóm Floodlight của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc String
floodlightGroupId Phân đoạn báo cáo theo nhóm Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi nhóm Floodlight. Cột này trả về mã nhóm Floodlight DS của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc ID
floodlightGroupTag Phân đoạn báo cáo theo nhóm Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi nhóm Floodlight. Cột này trả về thẻ nhóm Floodlight của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc String
floodlightActivity Phân đoạn báo cáo theo hoạt động Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi hoạt động Floodlight. Cột này trả về tên hoạt động Floodlight của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc String
floodlightActivityId Phân đoạn báo cáo theo hoạt động Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi hoạt động Floodlight. Cột này trả về mã hoạt động Floodlight của mỗi hàng DS. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc ID
floodlightActivityTag Phân đoạn báo cáo theo hoạt động Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi hoạt động Floodlight. Cột này trả về thẻ hoạt động Floodlight của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc String
accountId Mã tài khoản công cụ DS. phân khúc ID
campaignId Phân đoạn báo cáo theo chiến dịch. Hàng này trả về mã chiến dịch DS được liên kết với hàng. phân khúc ID
adGroupId Phân đoạn báo cáo theo nhóm quảng cáo. Hàng này trả về mã nhóm quảng cáo liên kết với hàng. phân khúc ID