Báo cáo có trả tiền và không phải trả tiền cho thấy những 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.
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": "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,
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 |
|---|---|---|---|---|
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ó |
searchQuery |
Những cụm từ tìm kiếm mà người dùng Google đã nhập. | phân bổ | 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à:
|
phân bổ | 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ần nhấp vào các kết quả tìm kiếm không phải trả tiền cho trang web của bạn sau khi có ai đó đã nhập Cụm từ tìm kiếm. | chỉ số | Integer |
Có |
paidAndOrganicClicks |
Số lần nhấp vào 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 sau khi có ai đó đã 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 trang kết quả tìm kiếm hoặc trên trang web trong Mạng Google sau khi có ai đó đã nhập SearchQuery. | chỉ số | Integer |
Có |
organicQueries |
Tổng số lần người dùng đã nhập Cụm từ tìm kiếm và xem í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 số các quảng cáo hoặc í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ó |
paidCtr |
Tỷ lệ nhấp cho một quảng cáo, là tần suất những người thấy quảng cáo của bạn kết thúc bằng việc 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 cuối cùng nhấp vào kết quả không phải trả tiền và chuyển đến 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 cuối cùng nhấp vào một trong hai quảng cáo và đến 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ó ai đó nhập Cụm từ tìm kiếm. | chỉ số | Number |
Có |
organicAvgPos |
Vị trí hàng đầu trung bình của các kết quả tìm kiếm không phải trả tiền cho trang web của bạn. | chỉ số | Number |
Có |
paidCostPerClick |
Chi phí trung bình cho mỗi lượt nhấp vào một quảng cáo. Đây là số tiền trung bình bạn trả mỗi khi có người dùng nhấp vào quảng cáo của bạn. | 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 một 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ó |
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 hàng đó đượ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 hàng đó đượ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à 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 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à 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 nhóm quảng cáo trong phạm vi báo cáo. Cột này trả về mã nhóm quảng cáo DS. | phân khúc | ID |
Có |
keywordId |
Phân đoạn báo cáo theo từ khoá; 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 từ khoá 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ừ khoá; 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 từ khoá 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ừ khoá; 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 từ khoá 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ó |