Các chỉ số về hiệu suất và thuộc tính cấu hình của từ khoá.
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()).
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": "keyword".
{
...
"reportType": "keyword",
"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 |
|---|---|---|---|---|
status |
Trạng thái của từ khóa: 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. |
thuộc tính | Status |
Có |
engineStatus |
Trạng thái bổ sung của từ khoá trong tài khoản công cụ bên ngoài. Các trạng thái có thể xảy ra (tuỳ thuộc vào loại tài khoản bên ngoài) bao gồm criterion rarely served, criterion below first page bid, criterion low quality score, review, campaign paused, v.v. |
thuộc tính | String |
Có |
creationTimestamp |
Dấu thời gian tạo từ khóa, được định dạng theo ISO 8601. | thuộc tính | Timestamp |
Có |
lastModifiedTimestamp |
Dấu thời gian của sửa đổi gần đây nhất của từ khóa, được định dạng theo ISO 8601. | thuộc tính | Timestamp |
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ó |
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ục 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ó |
keywordId |
ID từ khóa DS. Giá trị 0 cho biết từ khoá chưa được phân bổ. | thuộc tính | ID |
Có |
keywordMatchType |
Loại so khớp từ khóa: Broad, Exact, Phrase hoặc Content. |
thuộc tính | Match type |
Có |
keywordText |
Văn bản từ khoá. | thuộc tính | String |
Có |
keywordEngineId |
Mã của từ khoá trong tài khoản công cụ bên ngoài. | thuộc tính | ID |
Có |
keywordMaxCpc |
Ghi đè CPC tối đa của nhóm quảng cáo và đặt số tiền tối đa bạn muốn trả nếu có ai đó nhấp vào quảng cáo cho từ khoá cụ thể này. Nếu trường này trống, thì từ khoá sẽ sử dụng CPC tối đa của nhóm quảng cáo. | thuộc tính | Money |
Có |
effectiveKeywordMaxCpc |
CPC (chi phí mỗi lượt nhấp tối đa) có hiệu lực cho từ khoá 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 từ khoá ghi đè cài đặt của nhóm quảng cáo, thì CPC tối đa riêng của từ khoá. | thuộc tính | Money |
Có |
keywordLandingPage |
URL cuối cùng mà người dùng sẽ truy cập sau khi nhấp vào quảng cáo của bạn. Xem URL trang đích và URL máy chủ lượt nhấp. | thuộc tính | String |
Có |
keywordClickserverUrl |
URL mà DS sử dụng để theo dõi hoạt động. Người dùng nhấp vào quảng cáo sẽ truy cập URL máy chủ lượt nhấp trước, sau đó mới được chuyển hướng đến trang đích cuối cùng. Xem URL trang đích và URL máy chủ lượt nhấp. | thuộc tính | String |
Có |
isDisplayKeyword |
Cho biết liệu đây có phải là từ khoá giữ chỗ được dùng cho báo cáo hiển thị và báo cáo vị trí hay không. | thuộc tính | Boolean |
Có |
keywordMaxBid |
Nếu từ khóa này được một chiến lược giá thầu DS quản lý, thì chiến lược giá thầu này sẽ không bao giờ tăng giá thầu vượt quá giới hạn này. Xem bài viết Áp dụng chiến lược giá thầu cho từ khóa. | thuộc tính | Money |
Có |
keywordMinBid |
Nếu từ khóa này được một chiến lược giá thầu DS quản lý, thì chiến lược giá thầu này sẽ không bao giờ giảm giá thầu xuống dưới giới hạn này. Xem bài viết Áp dụng chiến lược giá thầu cho từ khóa. | thuộc tính | Money |
Có |
keywordUrlParams |
Đã thêm các tham số URL khác vào trang đích. Vui lòng xem bài viết Thêm tham số URL. | thuộc tính | String |
Có |
bingKeywordParam2 |
Param2 của từ khóa Bing Ads. | thuộc tính | String |
Có |
bingKeywordParam3 |
Param3 của một từ khoá Bing Ads. | thuộc tính | String |
Có |
keywordLabels |
Tên của nhãn được chỉ định trực tiếp cho từ khóa này sẽ không bao gồm nhãn kế thừa. | thuộc tính | String list |
Có |
qualityScoreCurrent |
Chỉ Google Ads và Bing Ads. Giá trị gần đây nhất của Điểm chất lượng (QS) của công cụ cho từ khóa. Lưu ý rằng cột này luôn báo cáo QS mới nhất cho một từ khoá bất kể phạm vi thời gian của báo cáo. | thuộc tính | Integer |
Có |
topOfPageBidCurrent |
Chỉ Google Ads. Khoảng giá thầu CPC hiện tại cần thiết để quảng cáo của bạn xuất hiện thường xuyên ở các vị trí hàng đầu phía trên kết quả tìm kiếm. Lưu ý rằng cột này luôn báo cáo CPC hiện cần thiết, bất kể phạm vi thời gian của báo cáo. | thuộc tính | Money |
Có |
effectiveBidStrategyId |
ID DS của chiến lược giá thầu được chỉ định cho thực thể này hoặc được pháp nhân này kế thừa. | thuộc tính | 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 pháp nhân này kế thừa. | thuộc tính | 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. | thuộc tính | Boolean |
Có |
effectiveLabels |
Tên của tất cả các nhãn được kế thừa hoặc được chỉ định trực tiếp cho từ khóa này. | thuộc tính | String list |
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ó |
avgCpc |
Chi phí trung bình cho mỗi lượt nhấp. | chỉ số | Money |
Có |
avgCpm |
Giá mỗi nghìn lần hiển thị trung bình. | 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 |
Chi phí tổng hợp được 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 một hành động chuyển đổi trên Google Ads được tạo, nhà quảng cáo có thể chọn 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ó |
qualityScoreAvg |
Chỉ Google Ads và Bing Ads. Điểm chất lượng trung bình của trọng số lượt hiển thị (QS) của công cụ, tính trên tất cả các ngày và từ khoá trong phạm vi báo cáo. | chỉ số | Number |
Có |
topOfPageBidAvg |
Chỉ Google Ads. Khoảng giá thầu CPC trung bình cần thiết trong phạm vi thời gian của báo cáo để quảng cáo của bạn xuất hiện thường xuyên ở các vị trí hàng đầu phía trên kết quả tìm kiế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ó |
ad |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về tên của quảng cáo trong mỗi hàng. | phân khúc | String |
Có |
adId |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về ID DS của quảng cáo trong mỗi hàng. | phân khúc | ID |
Có |
isUnattributedAd |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này 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. | phân khúc | Boolean |
Có |
adHeadline |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về dòng tiêu đề của quảng cáo trong mỗi hàng. | phân khúc | String |
Có |
adHeadline2 |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về dòng tiêu đề 2 của quảng cáo trong mỗi hàng. Không áp dụng cho một số công cụ. | phân khúc | String |
Có |
adHeadline3 |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về dòng tiêu đề 3 của quảng cáo trong mỗi hàng. Không áp dụng cho một số công cụ. | phân khúc | String |
Có |
adDescription1 |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về dòng mô tả 1 của quảng cáo trong mỗi hàng. | phân khúc | String |
Có |
adDescription2 |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về dòng mô tả 2 của quảng cáo trong mỗi hàng. | phân khúc | String |
Có |
adDisplayUrl |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về URL hiển thị của quảng cáo trong mỗi hàng. | phân khúc | String |
Có |
adLandingPage |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về trang đích của quảng cáo trong mỗi hàng. | phân khúc | String |
Có |
adType |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về loại quảng cáo trong mỗi hàng: Text hoặc Product. |
phân khúc | Ad type |
Có |
adPromotionLine |
Phân đoạn báo cáo theo quảng cáo; 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 quảng cáo. Cột này trả về dòng quảng cáo của quảng cáo sản phẩm trong mỗi hàng. | phân khúc | String |
Có |