Các chỉ số về hiệu suất và thuộc tính cấu hình cho mục nguồn cấp dữ liệu (ví dụ: đường liên kết của trang web, vị trí, cuộc gọi hoặc ứng dụng).
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": "feedItem"
.
{ ... "reportType": "feedItem", "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 mục nguồn cấp dữ liệu: Active , Paused hoặc Removed . |
thuộc tính | Status |
Có |
engineStatus |
Trạng thái bổ sung của mục nguồn cấp dữ liệu trong tài khoản công cụ bên ngoài. Các trạng thái có thể xảy ra (tuỳ thuộc vào loại tài khoản bên ngoài) bao gồm review , active , v.v. |
thuộc tính | String |
Có |
creationTimestamp |
Dấu thời gian tạo mục mục nguồn cấp dữ liệu, có định dạng theo ISO 8601. | thuộc tính | Timestamp |
Có |
lastModifiedTimestamp |
Dấu thời gian của sửa đổi gần đây nhất của mục nguồn cấp dữ liệu, 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ó |
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ó |
sitelinkDisplayText |
Văn bản hiển thị của liên kết trang web của mục nguồn cấp dữ liệu. | thuộc tính | String |
Có |
sitelinkDescription1 |
Dòng mô tả 1 của đường liên kết trang web của mục trong nguồn cấp dữ liệu. | thuộc tính | String |
Có |
sitelinkDescription2 |
Mô tả liên kết trang web 2 của mục nguồn cấp dữ liệu. | thuộc tính | String |
Có |
sitelinkLandingPageUrl |
URL trang đích của đường liên kết của mục trong nguồn cấp dữ liệu. | thuộc tính | String |
Có |
sitelinkClickserverUrl |
Tên URL máy chủ lượt nhấp của đường liên kết của mục trong nguồn cấp dữ liệu. | thuộc tính | String |
Có |
locationBusinessName |
Tên của một doanh nghiệp được xác định trong phần mở rộng về địa điểm đã nâng cấp. | thuộc tính | String |
Có |
locationCategory |
Danh mục được xác định cho một doanh nghiệp trong phần mở rộng về địa điểm đã nâng cấp. | thuộc tính | String |
Có |
locationDetails |
Thông tin chi tiết về một doanh nghiệp được xác định trong phần mở rộng về địa điểm đã nâng cấp. | thuộc tính | String |
Có |
callPhoneNumber |
Số điện thoại của phần mở rộng về cuộc gọi. | thuộc tính | String |
Có |
callCountryCode |
Mã quốc gia của phần mở rộng về cuộc gọi. | thuộc tính | String |
Có |
callIsTracked |
Trả về true nếu các cuộc gọi của phần mở rộng về cuộc gọi được theo dõi, false nếu không được theo dõi. | thuộc tính | Boolean |
Có |
callCallOnly |
Trả về true nếu phần mở rộng về cuộc gọi được thiết lập để chỉ hiển thị số điện thoại. Trả về false nếu cả lệnh gọi và đường liên kết đều hiển thị. | thuộc tính | Boolean |
Có |
callConversionTracker |
Tên của trình theo dõi lượt chuyển đổi liên kết với phần mở rộng về cuộc gọi này (nếu có). | thuộc tính | String |
Có |
callConversionTrackerId |
Mã của công cụ theo dõi lượt chuyển đổi liên kết với mục nguồn cấp dữ liệu này, nếu có. | thuộc tính | ID |
Có |
appId |
Mã ứng dụng được xác định cho một phần mở rộng về ứng dụng. | thuộc tính | String |
Có |
appStore |
Loại cửa hàng ứng dụng (Apple App Store, Cửa hàng Google Play) được xác định cho một tiện ích ứng dụng. | thuộc tính | App store |
Có |
feedItemId |
Mã hàng của nguồn cấp dữ liệu. | thuộc tính | ID |
Có |
feedId |
Id bảng nguồn cấp dữ liệu | thuộc tính | ID |
Có |
clicksWithFeedItemShowing |
Nhấp vào bất kỳ liên kết nào trong quảng cáo trong khi mục nguồn cấp dữ liệu được hiển thị. Cột này chỉ trả về một giá trị trong báo cáo mục nguồn cấp dữ liệu hoặc trong báo cáo được phân đoạn theo cột mục nguồn cấp dữ liệu. | chỉ số | Integer |
Có |
costWithFeedItemShowing |
Chi phí của tất cả các quảng cáo khi mục nguồn cấp dữ liệu đang hiển thị. Cột này chỉ trả về một giá trị trong báo cáo mục nguồn cấp dữ liệu hoặc trong báo cáo được phân đoạn theo cột mục nguồn cấp dữ liệu. | chỉ số | Money |
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ó |
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ó |
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ó |