# Brain Feature Summary report

{% admonition type="danger" name="This API is deprecated and will be removed in July 2026" %}
  The new API docs can be found here: https://apidocs.mediamath.com/apis/reporting-api
{% /admonition %}

## The Brain Feature Summary report

Sample usage: GET https://api.mediamath.com/reporting/v1/std/brain_feature_summary/meta?v1

### Background

The Brain Feature Summary report provides transparency into how the Brain optimizes.  The Brain Feature Summary Report centralizes impression features, such as Exchange, Site, Creative Size or Day of Week, that have the largest predictive impact.  Features are a column of dataset used as an input to the model. For example; device_model, day_of_week or browser. Descriptions of Current Brain Features are available here.  Feature values are not listed in the report. This report gives you transparency into the importance of each Brain Feature at the aggregated level.

The information in this report is provided when a new Brain model is generated, but some days in the reporting period may be missing (which is normal). Depending on the training data, we may not always generate a new model so you may see gaps (not all days will generate the report). The report time rollups are updated daily, typically before 18:00 UTC. The data contained for the date in the report will be for the latest model picked up on that day and loaded into reporting.  Retention is on a rolling 30 days, with a date range therefore of up to 30 days.  T1 continues to train Brain models just in case the campaign is set live again, maximizing your opportunity to take advantage of the Brain Optimization on spend. Once there is no more training data (after 23 days of no activity) T1 will stop generating new models until spend recommences.

The information included in the Brain Feature Summary report is not relevant in the following circumstances:
* Campaigns powered by a Custom Brain
* CPA/ROI strategies within a campaign using 3rd-party attribution
* CPA strategies within a campaign with post-view attribution discounted below 100%

### How to run a Brain Feature Summary report via T1 instead of by API:
1. Navigate to the Reports module
2. Click on the Data Export tab
3. Type the name of the report in the File Name field
4. Select the Brain Feature Summary report from the Report Type drop-down list
5. Select the date range you want your report to cover
6. Select Agency, Advertiser and Campaign from the relevant drop-down lists
7. Select your preferred Dimensions

### The Brain Feature Summary report itself
This report exports multiple campaigns and Goal Types at once.

### Sample CSV view of a Brain Feature Summary report

| | A | B | C | D | E | F | G | H | I |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | start_date | end_date | organization_id | advertiser_id | agency_id | campaign_id | model_goal | feature |
| 2 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | category_id |
| 3 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | id_vintage |
| 4 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | week_part |
| 5 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | exchange_viewability_rate |
| 6 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | region_id |
| 7 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | conn_speed |
| 8 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | day_of_week |
| 9 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | browser_version |
| 10 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | site_id |
| 11 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | exchange_id_cs_site_id |
| 12 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | day_part |
| 13 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | dma_id |
| 14 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | deal_id |
| 15 | 10/8/2019 | 10/8/2019 | 100001 | 10002 | 10003 | 111111 | cpa | os_id |

### What's in the Brain Feature Summary report
| Column | Example* | Description |
|---|---|---|
| Start Date | 8/31/2019 | Date when these values were being used in bidding. |
| End Date | 8/31/2019 | Date when these values were being used in bidding. |
| Organization ID | 100001 | |
| Agency ID | 10002 |
| Advertiser ID | 10003 |
| Campaign ID | 111111 | MediaMath unique ID for campaign. |
| Model Goal | CPA, ROI, CPC, etc. | The Goal Type that the model was trained for. Each Goal Type will have a different Brain model. |
| Feature |isp_id, day_of_week, size, week_part, category_id | The Dimension used as input into the Brain Machine Learning model. For a full list, see here. |
| Position | 0, 1, 2, 3, 4, ..., 99 | For bottom_features, a Position of 0 means it had the lowest "Mean".  For top_features, a Position of 0 means it had the highest "Mean". |
| Index | 2.1925095 | The index column gives you a comparative indication of the relative importance of features based on normalized attribution, at an aggregated level. While the values might not make much sense for a global understanding of the model, the index gives an indication of what the model sees as important features when its trained. The higher the Index number, the higher the importance. |

*Note: Only 1 value will appear, not a comma-delimited list, although feature_value may be a pipe-delimited list)


Endpoint: GET /brain_feature_summary/meta