Chỉ số hiệu suất và thuộc tính cấu hình cho mục tiêu sản phẩm. Mục tiêu sản phẩm đã được các chiến dịch Quảng cáo danh sách sản phẩm của Google Ads sử dụng để chỉ định những sản phẩm nào trong tài khoản Google Merchant Center phải kích hoạt Quảng cáo danh sách sản phẩm (quảng cáo mua sắm) xuất hiện trong các tìm kiếm có liên quan trên Google. Mục tiêu sản phẩm và chiến dịch Quảng cáo danh sách sản phẩm đã được thay thế bằng chiến dịch Mua sắm trên Google Ads. Trên DS, bạn vẫn có thể yêu cầu báo cáo về các chỉ số trong quá khứ được phân bổ cho các chiến dịch Quảng cáo danh sách sản phẩm trước khi nâng cấp lên 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": "productTarget"
.
{ ... "reportType": "productTarget", "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 mục tiêu sản phẩm: Active , Paused hoặc Removed . Xin lưu ý rằng mỗi chiến dịch, nhóm quảng cáo, mục tiêu sản phẩm và quảng cáo đều có trạng thái riêng. Xem trạng thái. |
phân bổ | Status |
Có |
engineStatus |
Trạng thái bổ sung của mục tiêu sản phẩm trong tài khoản công cụ bên ngoài. Các trạng thái có thể có (tuỳ thuộc vào loại tài khoản bên ngoài) bao gồm review , campaign paused , v.v. |
phân bổ | String |
Có |
creationTimestamp |
Dấu thời gian tạo mục tiêu sản phẩm, được định dạng theo ISO 8601. | phân bổ | Timestamp |
Có |
lastModifiedTimestamp |
Dấu thời gian của lần sửa đổi gần đây nhất của mục tiêu sản phẩm, được định dạng theo 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ó |
account |
Tên tài khoản công cụ. | phân bổ | String |
Có |
accountId |
Mã tài khoản công cụ DS. | phân bổ | ID |
Có |
accountEngineId |
Mã của tài khoản trong tài khoản công cụ bên ngoài. | phân bổ | String |
Có |
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 |
Có |
campaign |
Tên chiến dịch. | phân bổ | String |
Có |
campaignId |
Mã chiến dịch DS. | phân bổ | ID |
Có |
campaignStatus |
Trạng thái của chiến dịch chứa mục này. | phân bổ | Status |
Có |
adGroup |
Tên nhóm quảng cáo. | phân bổ | String |
Có |
adGroupId |
Mã nhóm quảng cáo DS. | phân bổ | ID |
Có |
adGroupStatus |
Trạng thái của nhóm quảng cáo chứa mục này. | phân bổ | Status |
Có |
productTargetId |
Mã mục tiêu sản phẩm DS. | phân bổ | ID |
Có |
productTargetFilter |
Lọc các sản phẩm trong tài khoản Google Merchant Center có mục tiêu sản phẩm này. Bạn có thể chỉ định tiêu chí so khớp bằng các thuộc tính như mã sản phẩm, thương hiệu, v.v. | phân bổ | String |
Không |
productTargetEngineId |
Mã của mục tiêu sản phẩm trong tài khoản công cụ bên ngoài. | phân bổ | ID |
Có |
productTargetLandingPage |
Giá trị cho biết URL cuối cùng mà người dùng sẽ truy cập sau khi nhấp vào quảng cáo mua sắm của bạn. Xem Trang đích của quảng cáo Mua sắm. | phân bổ | String |
Có |
productTargetClickserverUrl |
URL mà DS sử dụng để theo dõi hoạt động. Người dùng nhấp vào quảng cáo mua sắm sẽ truy cập vào URL máy chủ lượt nhấp trước tiên, sau đó được chuyển hướng đến trang đích cuối cùng. Xem Trang đích của quảng cáo Mua sắm. | phân bổ | String |
Có |
productTargetLabels |
Tên của nhãn được chỉ định trực tiếp cho mục tiêu sản phẩm này; không bao gồm nhãn kế thừa. | phân bổ | String list |
Có |
productTargetMaxCpc |
Ghi đè CPC tối đa của nhóm quảng cáo và đặt số tiền tối đa bạn sẵn sàng trả nếu có ai đó nhấp vào quảng cáo sản phẩm cho mục tiêu sản phẩm cụ thể này. Nếu trường này trống, mục tiêu sản phẩm sẽ sử dụng CPC tối đa của nhóm quảng cáo. | phân bổ | Money |
Có |
effectiveProductTargetMaxCpc |
CPC tối đa (chi phí tối đa mỗi lượt nhấp) đang áp dụng cho mục tiêu sản phẩm này. Giá trị này sẽ giống với giá trị CPC tối đa của nhóm quảng cáo hoặc nếu mục tiêu sản phẩm ghi đè chế độ cài đặt của nhóm quảng cáo, thì CPC tối đa của riêng mục tiêu sản phẩm sẽ giống nhau. | phân bổ | Money |
Có |
productTargetMaxBid |
Nếu mục tiêu sản phẩm này được quản lý bằng chiến lược giá thầu DS, thì chiến lược giá thầu sẽ không bao giờ tăng giá thầu vượt quá hạn mức này. Xem Áp dụng chiến lược giá thầu cho mục tiêu sản phẩm. | phân bổ | Money |
Có |
productTargetMinBid |
Nếu mục tiêu sản phẩm này được quản lý bằng chiến lược giá thầu DS, thì chiến lược giá thầu sẽ không bao giờ giảm giá thầu thấp hơn giới hạn này. Xem Áp dụng chiến lược giá thầu cho mục tiêu sản phẩm. | phân bổ | Money |
Có |
effectiveBidStrategyId |
Mã DS của chiến lược giá thầu được chỉ định cho thực thể này hoặc được thực thể này kế thừa. | phân bổ | ID |
Có |
effectiveBidStrategy |
Tên của chiến lược giá thầu được chỉ định cho thực thể này hoặc được thực thể này kế thừa. | phân bổ | String |
Có |
bidStrategyInherited |
Cho biết liệu chiến lược giá thầu của thực thể này có được kế thừa hay không. | phân bổ | Boolean |
Có |
effectiveLabels |
Tên của tất cả các nhãn được kế thừa hoặc được gán trực tiếp cho mục tiêu sản phẩm này. | phân bổ | String list |
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ó |