Loại báo cáo: từ khoá

Chỉ số hiệu suất và thuộc tính cấu hình cho từ khoá.

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": "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, 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.

columnNameMô tảHành viLoạiCó 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. phân bổ 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ể có (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. phân bổ String Có
creationTimestamp Dấu thời gian tạo từ khoá, đượ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 từ khóa, đượ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ó
keywordId Mã từ khoá DS. Giá trị 0 cho biết từ khoá không được phân bổ. phân bổ ID Có
keywordMatchType Loại đối sánh từ khóa: Broad, Exact, Phrase hoặc Content. phân bổ Match type Có
keywordText Văn bản từ khoá. phân bổ String Có
keywordEngineId Mã của từ khoá trong tài khoản công cụ bên ngoài. phân bổ 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 sẵn sàng 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. phân bổ Money Có
effectiveKeywordMaxCpc CPC tối đa (chi phí tối đa mỗi lượt nhấp) 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á đang ghi đè chế độ cài đặt của nhóm quảng cáo, thì CPC tối đa của riêng từ khoá sẽ giống nhau. phân bổ 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. Hãy xem bài viết URL trang đích và URL máy chủ lượt nhấp. phân bổ 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 tiên, sau đó được chuyển hướng đến trang đích cuối cùng. Hãy xem bài viết URL trang đích và URL máy chủ lượt nhấp. phân bổ 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. phân bổ Boolean Có
keywordMaxBid Nếu từ khóa này do 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á hạn mức này. Xem bài viết Áp dụng chiến lược giá thầu cho từ khoá. phân bổ Money Có
keywordMinBid Nếu từ khoá này do 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 thấp hơn hạn mức này. Xem bài viết Áp dụng chiến lược giá thầu cho từ khoá. phân bổ Money Có
keywordUrlParams Đã thêm tham số URL bổ sung vào trang đích. Xem bài viết Thêm tham số URL. phân bổ String Có
bingKeywordParam2 Tham số 2 của từ khoá Bing Ads. phân bổ String Có
bingKeywordParam3 Tham số 3 của từ khoá Bing Ads. phân bổ String Có
keywordLabels Tên của các nhãn được gán trực tiếp cho từ khóa này; không bao gồm nhãn kế thừa. phân bổ 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 một từ khoá. Xin lưu ý rằng cột này luôn báo cáo điểm chất lượng mới nhất cho một từ khoá bất kể phạm vi thời gian của báo cáo. phân bổ Integer Có
topOfPageBidCurrent Chỉ dành cho Google Ads. Ước tính 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. Xin 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. 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 gán trực tiếp cho từ khóa 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ó
qualityScoreAvg Chỉ Google Ads và Bing Ads. Điểm trung bình lấy trọng số theo số lượt hiển thị của Điểm chất lượng (QS) của công cụ trong tất cả các ngày và từ khoá trong phạm vi báo cáo. chỉ số Number Có
topOfPageBidAvg Chỉ dành cho Google Ads. Ước tính 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à 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ó
ad Phân đoạn báo cáo theo quảng cáo; mỗi hàng và số liệu 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 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à số liệu 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 quảng cáo. Cột này trả về mã 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à số liệu 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 quảng cáo. Cột này 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. 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à số liệu 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 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à số liệu 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 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 được hỗ trợ trên 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à số liệu 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 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 được hỗ trợ trên 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à số liệu 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 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à số liệu 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 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à số liệu 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 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à số liệu 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 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à số liệu 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 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à số liệu 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 quảng cáo. Cột này trả về dòng khuyến mãi của quảng cáo sản phẩm trong mỗi hàng. phân khúc String Có