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.
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 . |
phân bổ | Status |
Có |
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 |
Có |
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 |
Có |
agency |
Tên công ty quảng cáo. | phân bổ | String |
Có |
agencyId |
Mã công ty quảng cáo DS. | phân bổ | ID |
Có |
advertiser |
Tên nhà quảng cáo. | phân bổ | String |
Có |
advertiserId |
Mã nhận dạng nhà quảng cáo DS. | phân bổ | ID |
Có |
productId |
Mã mặt hàng của sản phẩm. | phân bổ | String |
Có |
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 |
Có |
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 |
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 sản phẩm. | phân bổ | String |
Có |
productColor |
Thuộc tính color của mặt hàng sản phẩm. | phân bổ | String |
Có |
productSize |
Thuộc tính size (kích thước) của mặt hàng sản phẩm. | phân bổ | String |
Có |
productMaterial |
Thuộc tính material [chất liệu] của mặt hàng sản phẩm. | phân bổ | String |
Có |
productPattern |
Thuộc tính pattern [mẫu] của mặt hàng sản phẩm. | phân bổ | String |
Có |
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 |
Có |
productGender |
Thuộc tính gender (giới tính) của mặt hàng sản phẩm. | phân bổ | String |
Có |
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 |
Có |
productLandingPageUrl |
Thuộc tính trang đích của một mặt hàng sản phẩm. | phân bổ | String |
Có |
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 |
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 sản phẩm. | phân bổ | 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 sản phẩm. | phân bổ | 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 sản phẩm. | phân bổ | 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 sản phẩm. | phân bổ | 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 sản phẩm. | phân bổ | String |
Có |
productBrand |
Thuộc tính brand [thương hiệu] của mặt hàng sản phẩm. | phân bổ | 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 sản phẩm. | phân bổ | String |
Có |
productPrice |
Thuộc tính price (giá) của một mặt hàng sản phẩm. | phân bổ | Money |
Có |
productSalePrice |
Thuộc tính price (giá) của một mặt hàng sản phẩm. | phân bổ | Money |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
productCondition |
Thuộc tính condition của mặt hàng sản phẩm. | phân bổ | String |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
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 |
Có |
productTitle |
Thuộc tính tiêu đề của một mặt hàng sản phẩm. | phân bổ | String |
Có |
dfaActions |
Tổng số hành động trên Campaign Manager. | chỉ số | Integer |
Có |
dfaRevenue |
Tổng doanh thu do các giao dịch Campaign Manager tạo ra. | chỉ số | Money |
Có |
dfaTransactions |
Tổng số giao dịch Campaign Manager. | chỉ số | Integer |
Có |
dfaWeightedActions |
Tổng số hành động của Campaign Manager có trọng số. | chỉ số | Number |
Có |
dfaActionsCrossEnv |
Tổng số hành động trên nhiều môi trường của Campaign Manager. | chỉ số | Number |
Có |
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 |
Có |
dfaTransactionsCrossEnv |
Tổng số giao dịch qua Campaign Manager trên nhiều môi trường. | chỉ số | Number |
Có |
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 |
Có |
avgCpc |
Giá mỗi nhấp chuột trung bình. | chỉ số | Money |
Có |
avgCpm |
Chi phí trung bình cho mỗi nghìn lượt hiển thị. | chỉ số | Money |
Có |
avgPos |
Vị trí trung bình. | chỉ số | Number |
Có |
clicks |
Tổng hợp số lượt nhấp. | chỉ số | Integer |
Có |
cost |
Tổng chi phí đã 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 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 |
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à 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 |
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ộ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 |
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ộ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 |
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 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 |
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 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 |
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 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 |
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 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 |
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ộ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 |
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ộ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 |
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ủ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 |
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 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 |
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 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 |
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 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 |
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ủ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 |
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ủ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 |
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ủ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 |
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 được liên kết với hàng. | 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. | phân khúc | ID |
Có |