Dữ liệu báo cáo cho các nhà quảng cáo, bao gồm:
- Chỉ số hiệu suất trên tất cả các tài khoản công cụ và chiến dịch của nhà quảng cáo.
- Các thuộc tính cấu hình của một nhà quảng cáo.
Yêu cầu trích dẫn
Gửi một nội dung yêu cầu Reports.request() hoặc Reports.generate() thông thường, nhưng chỉ định "reportType": "advertiser".
{
...
"reportType": "advertiser",
"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 nhà quảng cáo: Active, Paused hoặc Removed. |
thuộc tính | Status |
Có |
creationTimestamp |
Dấu thời gian tạo quảng cáo, được định dạng theo ISO 8601. | thuộc tính | Timestamp |
Có |
lastModifiedTimestamp |
Dấu thời gian của lần sửa đổi gần đây nhất của nhà quảng cáo, 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ó |
dfaAdvertiserId |
ID của nhà quảng cáo Campaign Manager được liên kết với nhà quảng cáo DS này. | thuộc tính | ID |
Có |
dfaNetworkId |
Mã của mạng Campaign Manager được liên kết với nhà quảng cáo DS này. | thuộc tính | ID |
Có |
dfaNetworkTimeZone |
Múi giờ của mạng Campaign Manager được liên kết với nhà quảng cáo DS này ở định dạng Cơ sở dữ liệu múi giờ IANA, chẳng hạn như America/New_York. |
thuộc tính | String |
Có |
advertiserCurrencyCode |
Mã đơn vị tiền tệ của nhà quảng cáo ở định dạng ISO 4217. | thuộc tính | String |
Có |
googleAnalyticsTimeZone |
Múi giờ của chế độ xem Google Analytics được liên kết với nhà quảng cáo DS này. Sử dụng định dạng Cơ sở dữ liệu múi giờ IANA, chẳng hạn như America/New_York. |
thuộc tính | String |
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ó |
searchImpressionShare |
Chỉ Google Ads và Bing Ads. Số lượt hiển thị mà bạn nhận được trên Mạng Tìm kiếm chia cho số lượt hiển thị ước tính mà bạn đủ điều kiện để nhận. Được trả về dưới dạng số từ 0,1 đến 1 hoặc nếu phần chia sẻ nhỏ hơn 0,1, thì chuỗi < 10%. |
chỉ số | Impression share |
Có |
searchBudgetLostImpressionShare |
Chỉ Google Ads và Bing Ads. Phần trăm thời gian mà quảng cáo của bạn đã không được hiển thị trên Mạng tìm kiếm do không đủ ngân sách. Được trả về dưới dạng số từ 0 đến 0, 9 hoặc nếu phần chia sẻ lớn hơn 0, 9 dưới dạng chuỗi > 90%. |
chỉ số | Impression share |
Có |
searchRankLostImpressionShare |
Chỉ Google Ads và Bing Ads. Phần trăm số lần quảng cáo của bạn không được hiển thị trên Mạng tìm kiếm do Xếp hạng quảng cáo thấp. Được trả về dưới dạng số từ 0 đến 0, 9 hoặc nếu phần chia sẻ lớn hơn 0, 9 dưới dạng chuỗi > 90%. |
chỉ số | Impression share |
Có |
displayImpressionShare |
Chỉ Google Ads. Số lượt hiển thị mà bạn nhận được trên Mạng Hiển thị chia cho số lượt hiển thị ước tính mà bạn đủ điều kiện để nhận. Được trả về dưới dạng số từ 0,1 đến 1 hoặc nếu phần chia sẻ nhỏ hơn 0,1, thì chuỗi < 10%. |
chỉ số | Impression share |
Có |
displayBudgetLostImpressionShare |
Chỉ Google Ads. Phần trăm thời gian mà quảng cáo của bạn đã không được hiển thị trên Mạng Hiển thị do không đủ ngân sách. Được trả về dưới dạng số từ 0 đến 0, 9 hoặc nếu phần chia sẻ lớn hơn 0, 9 dưới dạng chuỗi > 90%. |
chỉ số | Impression share |
Có |
displayRankLostImpressionShare |
Chỉ Google Ads. Phần trăm số lần quảng cáo của bạn không được hiển thị trên Mạng Hiển thị do Xếp hạng quảng cáo thấp. Được trả về dưới dạng số từ 0 đến 0, 9 hoặc nếu phần chia sẻ lớn hơn 0, 9 dưới dạng chuỗi > 90%. |
chỉ số | Impression share |
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ó |
absoluteTopImpressionPercentage |
Phần trăm hiển thị quảng cáo của bạn được hiển thị là quảng cáo đầu tiên phía trên kết quả tìm kiếm không phải trả tiền. | chỉ số | Impression share |
Có |
searchAbsoluteTopImpressionShare |
Số lượt hiển thị mà bạn nhận được ở vị trí đầu tiên (quảng cáo đầu tiên phía trên kết quả tìm kiếm không phải trả tiền) chia cho số lượt hiển thị ước tính mà bạn đủ điều kiện nhận được ở vị trí hàng đầu. | chỉ số | Impression share |
Có |
topImpressionPercentage |
Tỷ lệ phần trăm số lượt hiển thị quảng cáo của bạn xuất hiện ở bất kỳ vị trí nào phía trên kết quả tìm kiếm không phải trả tiền. | chỉ số | Impression share |
Có |
searchTopImpressionShare |
Số lượt hiển thị mà bạn nhận được ở vị trí hàng đầu (bất kỳ vị trí nào phía trên kết quả tìm kiếm không phải trả tiền) so với số lượt hiển thị ước tính mà bạn đủ điều kiện nhận được ở vị trí hàng đầu. | chỉ số | Impression share |
Có |
searchBudgetLostAbsoluteTopImpressionShare |
Ước tính tần suất quảng cáo của bạn không phải là quảng cáo đầu tiên phía trên kết quả tìm kiếm không phải trả tiền do ngân sách thấp. | chỉ số | Impression share |
Có |
searchBudgetLostTopImpressionShare |
Giúp bạn hiểu tần suất quảng cáo của bạn không xuất hiện ở bất kỳ vị trí nào phía trên kết quả tìm kiếm không phải trả tiền do ngân sách thấp. | chỉ số | Impression share |
Có |
searchRankLostAbsoluteTopImpressionShare |
Ước tính tần suất quảng cáo của bạn không phải là quảng cáo đầu tiên phía trên kết quả tìm kiếm không phải trả tiền do Xếp hạng quảng cáo thấp. | chỉ số | Impression share |
Có |
searchRankLostTopImpressionShare |
Ước tính tần suất quảng cáo của bạn không hiển thị ở bất kỳ vị trí nào phía trên kết quả tìm kiếm không phải trả tiền do Xếp hạng quảng cáo thấp. | chỉ số | Impression share |
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ó |