Chỉ số hiệu suất và thuộc tính cấu hình cho chiến lược giá thầu.
Báo cáo này chỉ có thể được trả về bằng một yêu cầu không đồng bộ (tức 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 hãy chỉ định "reportType": "bidStrategy".
{
...
"reportType": "bidStrategy",
"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 được liệt kê trong bảng bên dưới.
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 mục "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 chiến lược giá thầu: Active, Paused hoặc Removed. |
thuộc tính | Status |
Có |
creationTimestamp |
Dấu thời gian tạo chiến lược giá thầu, được định dạng theo ISO 8601. | thuộc tính | Timestamp |
Có |
lastModifiedTimestamp |
Dấu thời gian của lần sửa đổi gần đây nhất đối với chiến lược giá thầu, được định dạng theo ISO 8601. | thuộc tính | Timestamp |
Có |
agency |
Tên công ty quảng cáo. | thuộc tính | String |
Có |
agencyId |
Mã đại lý DS. | thuộc tính | ID |
Có |
advertiser |
Tên nhà quảng cáo. | thuộc tính | String |
Có |
advertiserId |
Mã nhận dạng nhà quảng cáo DS. | thuộc tính | ID |
Có |
bidStrategyId |
Mã chiến lược giá thầu DS. | thuộc tính | ID |
Có |
bidStrategy |
Tên chiến lược giá thầu. | thuộc tính | String |
Có |
bidStrategyGoal |
Mục tiêu của chiến lược giá thầu: Position, Conversions, Revenue, Clicks hoặc Advanced targeting. |
thuộc tính | Bid strategy goal |
Có |
floodlightOptimizationEnabled |
Liệu chiến lược giá thầu có nhắm đến các hoạt động Floodlight cụ thể hay không. | thuộc tính | Boolean |
Có |
ersTarget |
Tỷ lệ ERS (chia sẻ doanh thu hiệu quả) mục tiêu của chiến lược giá thầu. | thuộc tính | Number |
Có |
cpaTarget |
CPA mục tiêu (chi phí trên mỗi hành động) của chiến lược giá thầu. | thuộc tính | Money |
Có |
roasTarget |
Tỷ lệ ROAS (lợi tức trên chi tiêu quảng cáo) mục tiêu của chiến lược giá thầu. | thuộc tính | Number |
Có |
lowPosition |
Vị trí thấp nhất mong muốn (lớn hơn về mặt số) để hiển thị quảng cáo. Ví dụ: trong phạm vi vị trí từ 2 đến 5, 5 là lowPosition. |
thuộc tính | Number |
Có |
highPosition |
Vị trí mong muốn cao nhất (nhỏ hơn về mặt số) để hiển thị quảng cáo. Ví dụ: trong phạm vi vị trí từ 2 đến 5, 2 là highPosition. |
thuộc tính | Number |
Có |
bidStrategyMinBid |
Giá thầu thấp nhất có thể cho từ khoá trong chiến lược giá thầu này. | thuộc tính | Money |
Có |
bidStrategyMaxBid |
Giá thầu cao nhất có thể cho các từ khoá trong chiến lược giá thầu này. | thuộc tính | Money |
Có |
monthlySpendTarget |
Mức chi tiêu mục tiêu cho từng tháng của chiến lược giá thầu này. Nếu cần, DS sẽ tăng giá thầu để đảm bảo chi tiêu hết số tiền này. | thuộc tính | Money |
Có |
floodlightActivityTargetIds |
Danh sách được phân tách bằng dấu phẩy gồm các mã hoạt động Floodlight mà chiến lược giá thầu này nhắm đến. | thuộc tính | String |
Có |
dfaActions |
Tổng số hành động trên Campaign Manager. | chỉ số | Integer |
Có |
dfaRevenue |
Doanh thu tổng hợp được tạo bởi các giao dịch trên Campaign Manager. | chỉ số | Money |
Có |
dfaTransactions |
Tổng số giao dịch trên Campaign Manager. | chỉ số | Integer |
Có |
dfaWeightedActions |
Tổng trọng số của các hành động trên Campaign Manager. | chỉ số | Number |
Có |
dfaActionsCrossEnv |
Tổng số hành động trên Trình quản lý chiến dịch trên nhiều môi trường. | chỉ số | Number |
Có |
dfaRevenueCrossEnv |
Doanh thu tổng hợp được tạo bằng các giao dịch trên Campaign Manager trên nhiều môi trường. | chỉ số | Money |
Có |
dfaTransactionsCrossEnv |
Tổng số giao dịch trên nhiều môi trường của Trình quản lý chiến dịch. | chỉ số | Number |
Có |
dfaWeightedActionsCrossEnv |
Tổng 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 |
Chi phí trung bình cho mỗi lượt nhấp. | 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 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 để được báo cáo trong cột Lượt chuyển đổi trên Google Ads. Khi tạo một hành động chuyển đổi trên Google Ads, nhà quảng cáo có thể chọn xem 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à các 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 ngày. 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à các 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 tháng. Cột này trả về ngày đầu tiên của tháng trong 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à các 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 tháng. Cột này trả về ngày cuối cùng của 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à các 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 quý. Cột này trả về ngày đầu tiên của quý trong 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à các 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 quý. Cột này trả về ngày cuối cùng của quý trong mỗi hàng. | phân khúc | Date |
Có |
weekStart |
Phân đoạn báo cáo theo tuần (từ Chủ Nhật đến thứ Bảy); mỗi hàng và các 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 (từ Chủ Nhật đến thứ Bảy); mỗi hàng và các 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à các 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 năm. Cột này trả về ngày đầu tiên của 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à các 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 năm. Cột này trả về ngày cuối cùng của năm của mỗi hàng. | phân khúc | Date |
Có |