مدیریت پاسخ گزارش کار سادهای نیست، بهویژه اگر بخواهید راهحل شما انعطافپذیر و مستقل از ابعاد و سنجههای واقعی باشد که در گزارش خود انتخاب کردهاید.
خوشبختانه، پاسخ گزارش بسیار کامل است و اطلاعات مفید زیادی را شامل میشود.
سرصفحهها
میتوانید از اطلاعات برگرداندهشده در سرصفحهها برای انتخاب نحوه قالببندی یک سنجه خاص استفاده کنید. این اطلاعات شامل نوع سنجه (مثلاً اینکه ارز، نسبت، یا شمارش است) و نوع ارز (اگر ارزش پولی باشد) میشود.
مثال:
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
ردیفها
در اینجا نتایج واقعی گزارش را دریافت میکنید. هر ردیف پاسخ نشاندهنده یک ردیف گزارش است که براساس ابعاد انتخابی شما معنای متفاوتی دارد.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]مجموع و میانگینها
وقتی گزارشی را اجرا میکنید، آرایههای کاربردی totals و averages را نیز دریافت میکنید که حاوی مقداری برای هر سنجه مناسب خواهد بود.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}تاریخ شروع و پایان
اگر از تاریخهای نسبی استفاده میکنید، گاهی اوقات دانستن تاریخهای شروع و پایان محاسبهشده میتواند مفید باشد.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}