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ề 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": "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,
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 quảng cáo: Active, Paused hoặc Removed. Xin lưu ý rằng mỗi 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. |
phân bổ | 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. |
phân bổ | String |
Có |
creationTimestamp |
Dấu thời gian tạo quảng cáo, đượ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 quảng cáo gần đây nhất, đượ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ó |
ad |
Tên quảng cáo. | phân bổ | String |
Có |
adId |
Mã quảng cáo DS. Giá trị 0 cho biết rằng quảng cáo không được phân bổ. | phân bổ | ID |
Có |
adEngineId |
Mã của quảng cáo trong tài khoản công cụ bên ngoài. | phân bổ | ID |
Có |
isUnattributedAd |
Cho biết liệu các chỉ số trong hàng này có phải không 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 bị lỗi có thể khiến DS phân bổ chỉ số cho một quảng cáo. | phân bổ | Boolean |
Có |
adHeadline |
Dòng tiêu đề quảng cáo. | phân bổ | String |
Có |
adHeadline2 |
Dòng tiêu đề quảng cáo 2; không được hỗ trợ đối với một số công cụ. | phân bổ | String |
Có |
adHeadline3 |
Dòng tiêu đề quảng cáo 3; không được hỗ trợ đối với một số công cụ. | phân bổ | String |
Có |
adDescription1 |
Dòng mô tả quảng cáo 1. | phân bổ | String |
Có |
adDescription2 |
Dòng mô tả quảng cáo 2; không được hỗ trợ đối với một số công cụ. | phân bổ | String |
Có |
adDisplayUrl |
URL hiển thị của quảng cáo. | phân bổ | String |
Có |
adLandingPage |
Trang đích quảng cáo. Hãy xem bài viết URL trang đích và URL máy chủ lượt nhấp. | phân bổ | 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. |
phân bổ | Ad type |
Có |
adPromotionLine |
Dòng quảng cáo. Thông điệp quảng cáo ngắn cho quảng cáo sản phẩm. | phân bổ | String |
Có |
adLabels |
Tên của nhãn được chỉ định trực tiếp cho quảng cáo này; không bao gồm nhãn kế thừa. | phân bổ | 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 hiển thị trên quảng cáo. | phân bổ | 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 hiển thị trên quảng cáo. | phân bổ | String |
Có |
effectiveLabels |
Tên của tất cả các nhãn được kế thừa hoặc gán trực tiếp cho quảng cáo 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 trên nhiều môi trường trong Campaign Manager. | 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 từ Campaign Manager. | 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 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ó |