API Báo cáo Search Ads 360 cũ sẽ ngừng hoạt động và ngừng hoạt động từ ngày 30 tháng 6 năm 2024. Xin lưu ý rằng API Lượt chuyển đổi Search Ads 360 không bị ảnh hưởng và sẽ tiếp tục được hỗ trợ. Mọi hoạt động phát triển báo cáo mới đều phải sử dụng API Báo cáo Search Ads 360 mới.

Kể từ tháng 4 năm 2024, hệ thống sẽ trả về lỗi supportedApiVersion trong khi yêu cầu báo cáo. Xem chi tiết tại đây.

Bạn cũng nên di chuyển mọi hoạt động triển khai Search Ads 360 hiện có sang API mới. Hãy xem Bắt đầu và Hướng dẫn di chuyển API Báo cáo Search Ads 360 mới để biết thêm thông tin.

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

Loại báo cáo: sản phẩm được quảng cáo

Chỉ số về hiệu suất, thuộc tính cấu hình và thuộc tính khoảng không quảng cáo cho các 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 chiến dịch mua sắm.

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

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