ניהול התוצאות

הטיפול בתגובה לדוחות אינו פשוט, במיוחד אם רוצים שהפתרון יהיה גמיש ובלתי תלוי במאפיינים ובמדדים שבחרתם בדוח.

למרבה המזל, התשובה לדיווח מלאה למדי וכוללת הרבה מידע שימושי.

כותרות

אפשר להשתמש במידע שמוחזר בכותרות כדי לבחור את הפורמט של מדד מסוים. הוא כולל מידע על סוג המדד הזה, למשל אם מדובר במטבע, ביחס או בשערי, ובאיזה מטבע הוא משמש, אם מדובר בערך כספי.

דוגמה:

"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}

השלבים הבאים