Việc xử lý phản hồi báo cáo không hề đơn giản, đặc biệt nếu bạn muốn giải pháp của mình linh hoạt và độc lập với các thứ nguyên và chỉ số thực tế mà bạn chọn trong báo cáo của mình.
Rất may là phản hồi trong báo cáo khá đầy đủ và có nhiều thông tin hữu ích.
Tiêu đề
Bạn có thể sử dụng thông tin được trả về trong tiêu đề để chọn cách định dạng một chỉ số cụ thể. Báo cáo này bao gồm thông tin về loại chỉ số, đó là đơn vị tiền tệ, tỷ lệ hay tổng giá trị, ví dụ: sử dụng đơn vị tiền tệ nào và là giá trị tiền tệ.
Ví dụ:
"headers": [
{ "name": "MONTH", "type": "DIMENSION" },
{ "name": "CLICKS", "type": "METRIC_TALLY" },
{ "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" },
{ "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" }
]
Hàng
Đây là nơi bạn nhận được kết quả báo cáo thực tế. Mỗi hàng phản hồi đại diện cho một hàng báo cáo, có ý nghĩa khác nhau dựa trên các phương diện bạn chọn.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]
Tổng số và trung bình
Khi chạy báo cáo, bạn cũng sẽ nhận lại các mảng tiện ích totals và averages. Các mảng này sẽ chứa giá trị cho từng chỉ số thích hợp.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}
Ngày bắt đầu và ngày kết thúc
Nếu đang sử dụng ngày tương đối, đôi khi bạn nên biết ngày bắt đầu và ngày kết thúc được tính toán là gì.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}