Các 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 bán nhờ quảng cáo tìm kiếm có trả tiền.
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": "productLeadAndCrossSell"
.
{ ... "reportType": "productLeadAndCrossSell", "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 |
---|---|---|---|---|
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ó |
crossSellAverageUnitPrice |
Giá trung bình được báo cáo cho doanh số bán một sản phẩm khi sản phẩm đó được bán do quảng cáo một sản phẩm khác | chỉ số | Money |
Có |
crossSellCostOfGoodsSold |
Tổng chi phí bán sản phẩm khi bán một sản phẩm nhờ quảng cáo một sản phẩm khác. | chỉ số | Money |
Có |
crossSellGrossFromUnitsSold |
Tổng doanh thu từ việc bán một sản phẩm nhờ quảng cáo một sản phẩm khác. | chỉ số | Money |
Có |
crossSellGrossProfitMargin |
Biên lợi nhuận gộp cho một sản phẩm cụ thể khi bán được nhờ quảng cáo một sản phẩm khác. | chỉ số | Number |
Có |
crossSellRevenueFromUnitsSold |
Tổng doanh thu từ việc bán kèm (doanh thu được tạo ra từ việc quảng cáo một sản phẩm khác). | chỉ số | Money |
Có |
crossSellUnitsSold |
Số lượng đơn vị sản phẩm đã bán được nhờ bán kèm. (Số lượng đơn vị sản phẩm đã bán được nhờ quảng cáo một sản phẩm khác.) | chỉ số | Number |
Có |
leadAverageUnitPrice |
Giá trung bình được báo cáo cho doanh số bán một sản phẩm khi quảng cáo về sản phẩm đó. | chỉ số | Money |
Có |
leadCostOfGoodsSold |
Tổng chi phí bán sản phẩm khi bán được một sản phẩm nhờ quảng cáo sản phẩm đó. | chỉ số | Money |
Có |
leadGrossProfitFromUnitsSold |
Tổng doanh thu từ việc bán một sản phẩm nhờ quảng cáo sản phẩm đó. | chỉ số | Money |
Có |
leadGrossProfitMargin |
Biên lợi nhuận gộp cho một sản phẩm cụ thể do quảng cáo trực tiếp sản phẩm đó. | chỉ số | Number |
Có |
leadRevenueFromUnitsSold |
Tổng doanh thu mà một sản phẩm mang lại nhờ quảng cáo sản phẩm đó. | chỉ số | Money |
Có |
leadUnitsSold |
Số đơn vị sản phẩm đã bán được nhờ quảng cáo sản phẩm. | chỉ số | Number |
Có |
productUnitsSold |
Tổng số đơn vị sản phẩm đã bán. | chỉ số | Number |
Có |
productRevenueFromUnitsSold |
Tổng doanh thu tạo ra từ một sản phẩm (sử dụng giá được báo cáo trên mỗi sản phẩm). | chỉ số | Money |
Có |
productAverageUnitPrice |
Giá trung bình được báo cáo cho việc bán một sản phẩm (sử dụng giá được báo cáo trên mỗi sản phẩm). | chỉ số | Money |
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ó |