[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003eAdSense report responses provide comprehensive data including headers for metric formatting, rows for results, and totals/averages for calculations.\u003c/p\u003e\n"],["\u003cp\u003eHeaders specify the type and currency of each metric, enabling adaptable handling of report data.\u003c/p\u003e\n"],["\u003cp\u003eReport rows contain the actual values for each dimension and metric selected in the report.\u003c/p\u003e\n"],["\u003cp\u003eTotals and averages are included, with ratios only having an average returned in the totals array.\u003c/p\u003e\n"],["\u003cp\u003eResponses may include the calculated start and end dates when using relative date ranges in reports.\u003c/p\u003e\n"]]],["Report responses include `headers` specifying metric types (e.g., currency, ratio) and formats. `Rows` contain the report's data, with each row's cells corresponding to header-defined metrics and dimensions. `Totals` and `averages` arrays provide aggregate values for relevant metrics, with ratios shown in `totals` only, and `startdate` and `enddate` show calculated date ranges. This detailed structure allows for flexible processing of report data independent of the chosen dimensions and metrics.\n"],null,["# Handle the Results\n\nHandling a report response is not trivial, particularly if you want your solution to be flexible and independent of the actual dimensions and metrics you chose in your report.\n\nThankfully, the report response is pretty complete and includes a lot of useful information.\n\nHeaders\n-------\n\nYou can use the information returned in the headers to choose how to format a particular metric. It includes information on what type of metric it is, whether it's a currency, ratio or tally for example, and what currency it's in, if it's a monetary value.\n\n**Example:**\n\n```carbon\n\"headers\": [\n { \"name\": \"MONTH\", \"type\": \"DIMENSION\" },\n { \"name\": \"CLICKS\", \"type\": \"METRIC_TALLY\" },\n { \"name\": \"EARNINGS\", \"type\": \"METRIC_CURRENCY\", \"currency\": \"USD\" },\n { \"name\": \"AD_REQUESTS_COVERAGE\", \"type\": \"METRIC_RATIO\" }\n]\n```\n\n\u003cbr /\u003e\n\nRows\n----\n\nThis is where you get the actual report results. Each response row represents a report row, which has a different meaning based on your chosen dimensions.\n\n\u003cbr /\u003e\n\n```text\n\"rows\": [\n { \"cells\":\n [ {\"value\": \"2021-01\"}, {\"value\": \"278\"}, {\"value\": \"63.12\"}, {\"value\": \"0.9998\"} ],\n [ {\"value\": \"2021-02\"}, {\"value\": \"39\"}, {\"value\": \"8.46\"}, {\"value\": \"0.9998\"} ]\n }\n]\n```\n\n\u003cbr /\u003e\n\nTotals and averages\n-------------------\n\nWhen you run a report, you also get back the `totals` and `averages` utility arrays, which will contain a value for each appropriate metric.\n| **Note:** If it doesn't make sense for a metric to have a total, if it's a ratio for example, the only calculated value will be the average. However, it will be returned in the `totals` array, instead of the `averages` array.\n\n\u003cbr /\u003e\n\n```text\n\"totals\": {\n \"cells\": [\n {}, {\"value\": \"317\"}, {\"value\": \"71.58\"}, {\"value\": \"0.9998\"}\n ]\n},\n\"averages\": {\n \"cells\": [\n {}, {\"value\": \"158\"}, {\"value\": \"71.58\"}, {\"value\": \"0.9998\"}\n ]\n}\n```\n\n\u003cbr /\u003e\n\nStart and end Dates\n-------------------\n\nIf you're using [relative dates](/adsense/management/reporting/date_ranges#relative), it may sometimes be useful to know what the calculated start and end dates are.\n\n\u003cbr /\u003e\n\n```text\n\"startDate\": {\"year\": 2021, \"month\": 1, \"day\": 1},\n\"endDate\": {\"year\": 2021, \"month\": 2, \"day\": 28}\n```\n\n\u003cbr /\u003e\n\nNext steps\n----------\n\n- [Filtering](/adsense/management/reporting/filtering)\n- [Running Large Reports](/adsense/management/reporting/large_reports)"]]
