Báo cáo có trả tiền hiển thị các cụm từ tìm kiếm đã kích hoạt quảng cáo của bạn xuất hiện trên Google, kích hoạt Google hiển thị kết quả tìm kiếm không phải trả tiền (không phải trả tiền) cho trang web của bạn hoặc cả hai. Báo cáo chỉ trả về kết quả nếu bạn đã thiết lập báo cáo Có trả tiền và không phải trả tiền cho tài khoản công cụ mà bạn đang báo cáo.
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": "paidAndOrganic".
{
...
"reportType": "paidAndOrganic",
"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 |
|---|---|---|---|---|
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ó |
searchQuery |
Cụm từ tìm kiếm mà người dùng Google đã nhập. | thuộc tính | String |
Có |
serpType |
Loại kết quả tìm kiếm mà người dùng Google nhấp vào. Các giá trị có thể là:
|
thuộc tính | SERP type |
Có |
paidClicks |
Số lần ai đó nhấp vào quảng cáo sau khi nhập searchQuery. | chỉ số | Integer |
Có |
organicClicks |
Số lượt nhấp vào kết quả tìm kiếm không phải trả tiền trên trang web của bạn sau khi có người nào đó nhập querysearch. | chỉ số | Integer |
Có |
paidAndOrganicClicks |
Số lượt nhấp vào một trong các quảng cáo quảng cáo hoặc một kết quả tìm kiếm không phải trả tiền trên trang web của bạn sau khi có người nhập cụm từ tìm kiếm. | chỉ số | Integer |
Có |
paidImpressions |
Số lần quảng cáo đã xuất hiện trên một trang kết quả tìm kiếm hoặc trên một trang web trong Mạng Google sau khi có người nhập vào cụm từ tìm kiếm. | chỉ số | Integer |
Có |
organicQueries |
Tổng số lần người dùng đã nhập searchQuery và thấy ít nhất một kết quả tìm kiếm không phải trả tiền từ trang web của bạn. | chỉ số | Integer |
Có |
paidAndOrganicQueries |
Tổng số lần người dùng đã nhập cụm từ tìm kiếm và thấy ít nhất một trong các quảng cáo của bạn hoặc ít nhất một kết quả tìm kiếm không phải trả tiền trên trang web của bạn. | chỉ số | Integer |
Có |
paidCtr |
Tỷ lệ nhấp vào một quảng cáo. Tần suất này là tần suất những người nhìn thấy quảng cáo của bạn nhấp vào quảng cáo đó sau khi nhập cụm từ tìm kiếm. | chỉ số | Number |
Có |
organicCtr |
Tỷ lệ những người thấy kết quả tìm kiếm không phải trả tiền cho trang web của bạn kết thúc bằng cách nhấp vào kết quả không phải trả tiền và truy cập vào trang web của bạn. | chỉ số | Number |
Có |
paidAndOrganicCtr |
Tỷ lệ mà những người nhìn thấy một trong các quảng cáo của bạn hoặc kết quả tìm kiếm không phải trả tiền cho trang web của bạn sẽ nhấp vào và truy cập vào trang web của bạn. | chỉ số | Number |
Có |
paidAvgPos |
Vị trí trung bình mà quảng cáo xuất hiện sau khi có người nhập cụm từ tìm kiếm. | chỉ số | Number |
Có |
organicAvgPos |
Vị trí trung bình của kết quả tìm kiếm không phải trả tiền trên trang web của bạn. | chỉ số | Number |
Có |
paidCostPerClick |
Chi phí trung bình cho mỗi lượt nhấp của một quảng cáo. Đây là số tiền trung bình bạn phải trả mỗi khi có ai đó nhấp vào quảng cáo của mình. | 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ó |
campaign |
Phân đoạn báo cáo theo chiến dịch; 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 chiến dịch trong phạm vi báo cáo. Cột này trả về tên chiến dịch. | phân khúc | String |
Có |
campaignId |
Phân đoạn báo cáo theo chiến dịch; 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 chiến dịch trong phạm vi báo cáo. Cột này trả về mã chiến dịch DS. | phân khúc | ID |
Có |
adGroup |
Phân đoạn báo cáo theo nhóm quảng cáo; mỗi hàng và số liệu 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 nhóm quảng cáo trong phạm vi báo cáo. Cột này trả về tên nhóm quảng cáo. | phân khúc | String |
Có |
adGroupId |
Phân đoạn báo cáo theo nhóm quảng cáo; mỗi hàng và số liệu 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 nhóm quảng cáo trong phạm vi báo cáo. Cột này trả về ID nhóm quảng cáo DS. | phân khúc | ID |
Có |
keywordId |
Phân đoạn báo cáo theo từ khóa; 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 từ khóa trong phạm vi báo cáo. Cột này trả về mã từ khoá DS. | phân khúc | ID |
Có |
keywordMatchType |
Phân đoạn báo cáo theo từ khóa; 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 từ khóa trong phạm vi báo cáo. Cột này trả về kiểu khớp từ khoá. | phân khúc | Match type |
Có |
keywordText |
Phân đoạn báo cáo theo từ khóa; 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 từ khóa trong phạm vi báo cáo. Cột này trả về văn bản từ khoá. | phân khúc | String |
Có |