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ả 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 cho một nhà quảng cáo.
Yêu cầu trích dẫn
Gửi thông báo
Reports.request() hoặc
Reports.generate()
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,
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 |
|---|---|---|---|---|
status |
Trạng thái của nhà quảng cáo: Active, Paused hoặc Removed. |
phân bổ | Status |
Có |
creationTimestamp |
Dấu thời gian tạo nhà quảng cáo, đượ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 nhà quảng cáo, đượ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ó |
dfaAdvertiserId |
Mã nhận dạng của nhà quảng cáo Campaign Manager được liên kết với nhà quảng cáo DS này. | phân bổ | ID |
Có |
dfaNetworkId |
Mã nhận dạng mạng Campaign Manager được liên kết với nhà quảng cáo DS này. | phân bổ | ID |
Có |
dfaNetworkTimeZone |
Múi giờ của mạng Campaign Manager 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. |
phân bổ | String |
Có |
advertiserCurrencyCode |
Mã đơn vị tiền tệ của nhà quảng cáo theo định dạng ISO 4217. | phân bổ | 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. |
phân bổ | String |
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 qua Campaign Manager 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 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ó |
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. Trả về dưới dạng một 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. Trả về dưới dạng một số từ 0 đến 0,9 hoặc nếu tỷ lệ này lớn hơn 0,9, thì trả về dưới dạng chuỗi > 90%. |
chỉ số | Impression share |
Có |
searchRankLostImpressionShare |
Chỉ Google Ads và Bing Ads. Tỷ lệ 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 Thứ hạng quảng cáo thấp. Trả về dưới dạng một số từ 0 đến 0,9 hoặc nếu tỷ lệ này lớn hơn 0,9, thì trả về dưới dạng chuỗi > 90%. |
chỉ số | Impression share |
Có |
displayImpressionShare |
Chỉ dành cho 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. Trả về dưới dạng một 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ỉ dành cho Google Ads. Tỷ lệ phần trăm thời gian mà quảng cáo của bạn đã không xuất hiện trên Mạng Hiển thị do không đủ ngân sách. Trả về dưới dạng một số từ 0 đến 0,9 hoặc nếu tỷ lệ này lớn hơn 0,9, thì trả về dưới dạng chuỗi > 90%. |
chỉ số | Impression share |
Có |
displayRankLostImpressionShare |
Chỉ dành cho 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 Xếp hạng quảng cáo thấp. Trả về dưới dạng một số từ 0 đến 0,9 hoặc nếu tỷ lệ này lớn hơn 0,9, thì trả về dưới dạng chuỗi > 90%. |
chỉ số | Impression share |
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ó |
absoluteTopImpressionPercentage |
Tỷ lệ phần trăm số lượt hiển thị quảng cáo của bạn được xuất hiện dưới dạng quảng cáo đầu tiên phía trên kết quả tìm kiếm tự nhiên. | chỉ số | Impression share |
Có |
searchAbsoluteTopImpressionShare |
Số lượt hiển thị bạn nhận được ở vị trí đầu tiên (quảng cáo hiển thị đầu tiên phía trên kết quả tìm kiếm tự nhiê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 xuất hiện ở bất kỳ vị trí nào phía trên kết quả tìm kiếm tự nhiên. | chỉ số | Impression share |
Có |
searchTopImpressionShare |
Số lượt hiển thị 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 tự nhiê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 biết tần suất quảng cáo của bạn không xuất hiện ở phía trên kết quả tìm kiếm tự nhiê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 Thứ 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 Thứ 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à 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ó |