Chỉ số hiệu suất và thuộc tính cấu hình cho quảng cáo.
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": "ad".
{
...
"reportType": "ad",
"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 quảng cáo: Active, Paused hoặc Removed. Xin lưu ý rằng chiến dịch, nhóm quảng cáo, từ khoá và quảng cáo đều có trạng thái riêng. Xem trạng thái. |
thuộc tính | Status |
Có |
engineStatus |
Trạng thái bổ sung của quảng cáo 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 active, eligible, creative deleted, creative approved family safe, v.v. |
thuộc tính | String |
Có |
creationTimestamp |
Dấu thời gian tạo quảng cáo, đượ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 của quảng cáo, đượ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ó |
account |
Tên tài khoản công cụ. | thuộc tính | String |
Có |
accountId |
Mã tài khoản công cụ DS. | thuộc tính | ID |
Có |
accountEngineId |
Mã của tài khoản trong tài khoản công cụ bên ngoài. | thuộc tính | 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. |
thuộc tính | Engine type |
Có |
campaign |
Tên chiến dịch. | thuộc tính | String |
Có |
campaignId |
Mã chiến dịch DS. | thuộc tính | ID |
Có |
campaignStatus |
Trạng thái của chiến dịch chứa mặt hàng này. | thuộc tính | Status |
Có |
adGroup |
Tên nhóm quảng cáo. | thuộc tính | String |
Có |
adGroupId |
Mã nhóm quảng cáo DS. | thuộc tính | ID |
Có |
adGroupStatus |
Trạng thái của nhóm quảng cáo chứa mục này. | thuộc tính | Status |
Có |
ad |
Tên quảng cáo. | thuộc tính | String |
Có |
adId |
Mã nhận dạng cho quảng cáo DS. Giá trị 0 cho biết quảng cáo không được phân bổ. | thuộc tính | ID |
Có |
adEngineId |
Mã của quảng cáo trong tài khoản công cụ bên ngoài. | thuộc tính | ID |
Có |
isUnattributedAd |
Cho biết liệu các chỉ số trong hàng này có thể phân bổ cho một quảng cáo cụ thể hay không. Ví dụ: một quảng cáo có định dạng không được hỗ trợ hoặc URL của máy chủ theo dõi lượt nhấp không chính xác có thể ngăn DS phân bổ chỉ số cho một quảng cáo. | thuộc tính | Boolean |
Có |
adHeadline |
Dòng tiêu đề quảng cáo. | thuộc tính | String |
Có |
adHeadline2 |
Dòng tiêu đề 2 của quảng cáo; không có sẵn cho một số công cụ. | thuộc tính | String |
Có |
adHeadline3 |
Dòng tiêu đề 3 của quảng cáo; không có sẵn cho một số công cụ. | thuộc tính | String |
Có |
adDescription1 |
Dòng mô tả 1 của quảng cáo. | thuộc tính | String |
Có |
adDescription2 |
Dòng mô tả 2 của quảng cáo; không áp dụng cho một số công cụ. | thuộc tính | String |
Có |
adDisplayUrl |
URL hiển thị của quảng cáo. | thuộc tính | String |
Có |
adLandingPage |
Trang đích của quảng cáo. Xem phần URL của trang đích và máy chủ theo dõi lượt nhấp. | thuộc tính | String |
Có |
adType |
Loại quảng cáo: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text hoặc Expanded dynamic search. |
thuộc tính | Ad type |
Có |
adPromotionLine |
Dòng quảng cáo. Thông điệp quảng bá ngắn cho quảng cáo sản phẩm. | thuộc tính | String |
Có |
adLabels |
Tên của các nhãn được chỉ định trực tiếp cho quảng cáo này; không bao gồm các nhãn kế thừa. | thuộc tính | String list |
Có |
adPathField1 |
Trường đường dẫn quảng cáo 1. Các trường Đường dẫn 1 và 2 được kết hợp với adDisplayUrl để tạo thành URL xuất hiện trên quảng cáo. | thuộc tính | String |
Có |
adPathField2 |
Trường đường dẫn quảng cáo 2. Các trường Đường dẫn 1 và 2 được kết hợp với adDisplayUrl để tạo thành URL xuất hiện trên quảng cáo. | thuộc tính | String |
Có |
effectiveLabels |
Tên của tất cả nhãn được kế thừa hoặc được chỉ định trực tiếp cho quảng cáo này. | thuộc tính | String list |
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ó |
deviceSegment |
Phân đoạn báo cáo theo thiết bị; 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, tối đa là một hàng cho mỗi phân khúc 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à các chỉ số tổng hợp của hàng đó đượ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. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn theo Floodlight, chẳng hạn như 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à các chỉ số tổng hợp của hàng đó đượ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ề mã nhóm DS 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 theo Floodlight, chẳng hạn như 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à các chỉ số tổng hợp của hàng đó đượ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. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn theo Floodlight, chẳng hạn như 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à các chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa là 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 theo Floodlight, chẳng hạn như 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à các chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa là một hàng cho mỗi hoạt động Floodlight. Cột này trả về mã hoạt động Floodlight của 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 theo Floodlight, chẳng hạn như 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à các chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa là 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 theo Floodlight, chẳng hạn như lượt nhấp và lượt truy cập. | phân khúc | String |
Có |