What Are Custom Reports?
Custom Reports let you generate complex or large reports without waiting for them to load. Instead of processing your report inside the browser, Commerce Max generates it as a background job, meaning you can configure it, submit it, and move on.

You build each report by selecting a report type, choosing your dimensions and metrics, and setting your filters. Every report can be tailored to your specific goals, whether you're analyzing performance across your entire account, comparing trends for a specific campaign format, or pulling detailed breakdowns by search term or page type.
Custom Reports ensure:
More reliable reporting for all users.
Reduced timeouts and loading delays.
Smooth performance, even for large datasets.
Report Types
When you create a new report, one of the first steps is selecting a Report Type. Your selection shapes everything that follows: the dimensions, metrics, and filter options available will update to match the analytical scope you choose.
Four report types are available:
Report Type | What it covers |
|---|---|
Onsite Account Activity | An account-level view of activity across all your campaigns, including both Sponsored Products and Onsite Display. Use this type to analyze performance holistically without being limited to a single campaign format. |
Onsite Sponsored Products | Campaign-level analysis scoped to Onsite Sponsored Product campaigns. |
Onsite Display | Campaign-level analysis scoped to Onsite Display campaigns. |
Offsite | Campaign-level analysis scoped to Offsite campaigns. |

How To Generate a Custom Report
Navigate to the Analytics tab and click Custom Reports.
Click +New Report.
Add a Report Name and select format and cadance of the export.
Select your date range.
Select a Report Type based on what you want to analyze.
In the Dimensions section, select which fields appear as columns in your report.
In the Metrics section, select the performance metrics you want to include in your report. You can choose as many as you want.
In the Filters section, define which rows to include in your results. You can filter on any available field — including fields you have not added as dimensions. For example, filter to a specific campaign without adding Campaign as a column in your output.
Click Build Report.

Your report will begin processing in the background. Once submitted, it will show one of the following statuses:
Scheduled: Waiting to begin processing at the scheduled time.
Building: Currently being generated.
Ready: Ready to view or download.
Failed: Unable to generate.
Expired: The download file has passed the 7-day retention period.
Dimensions Available in Custom Reports Only
The following dimensions are available in Custom Reports only. They are not available in the standard Analytics reports. Because these dimensions generate large, row-heavy datasets, processing them in a standard report view can cause slow load times, timeouts, and incomplete results — especially across longer date ranges or larger accounts. Custom Reports handle them in the background and deliver results as a downloadable file.
Dimension | What it shows |
|---|---|
Page type | The type of page where your ad was served (e.g., search results, category, home). |
Search term | The exact shopper search query that triggered your ad. |
Stemmed search term | A normalized version of the search query, grouping variations of the same term. |
Search term type | The match type used to associate a search term with keywords entered for the campaign: Entered (matches exactly what was entered manually), Searched (matches what a shopper searched on the retailer's site), or Null (all other cases, corresponding to automatic keywords). |
Search term targeting | Whether targeting was Manual (the search term matches a keyword you added, or a stemmed variation of one) or Automatic (all other search terms added via the automated keyword tool). |
Targeted keyword type | The match intent of the keyword: branded, conquesting, or generic. |
Served category | The product category page where your ad appeared. |
Environment | The device environment where your ad was shown (e.g., web, mobile, app). |
Custom Report FAQs
How can custom reports make reporting easier?
Custom Reports lets you create exports around the dimensions and metrics that matter most to your business. You can tailor the columns, time period, and filters to match your reporting needs, then download a clearly organized file for analysis, business reviews, or client conversations.
What is a report type, and how do I choose one?
A report type sets the analytical scope of your report and determines which dimensions, metrics, and filters are available. Choose Onsite Account Activity if you want to analyze performance across all your campaigns — including both Sponsored Products and Onsite Display — in a single report. Choose Onsite Sponsored Products, Onsite Display, or Offsite if you want campaign-level analysis scoped to a specific format.
Can I filter my results without adding a field as a column?
Yes. The Filters section is separate from the Dimensions section. You can filter to specific campaigns, line items, or other available fields without those fields appearing as columns in your downloaded report.
What happened to my existing saved reports?
Existing saved reports are carried forward without data loss. Each report will be mapped to the closest report type, or clearly identified if an exact mapping isn't possible. You will not need to rebuild your reports.
How will I know when my report is ready?
The Reports Library checks report status automatically every 10 seconds while the browser tab is active. Status values include Scheduled, Building, Ready, Expired, or Failed.
Why did my report fail?
Reports may fail if:
The dataset is too large.
A selected field is invalid.
There’s a temporary system issue.
Try reducing the date range or filters, then resubmit. If it still fails, please contact our customer support team.
Can I leave the page while the report is generating?
Yes. Reports continue to process even if you move to another section, close your browser, or log out.
Can I download my report in different formats?
Yes, reports can be downloaded as Excel (.xlsx) or CSV, and this can only be selected when the report is being built, not after it's generated.
Do I need to regenerate the same report later?
Custom reports get deleted after 7 days. Within that period, you can regenerate the report if the underlying data has changed. Otherwise, you can reuse the same download.
What does the Month time dimension do?
Month groups report rows at monthly granularity, making it easier to analyze trends without manually aggregating daily exports. Select Month in the Time dimension group; you can also save and reload it when you edit the report.
Can I control the order of columns in the downloaded report?
Yes. Drag selected dimensions and metrics into the order you need. The chosen order is saved with the report and preserved in the downloaded file. When you move a dimension, its selected filters move with it.
How are downloaded report filenames generated?
Reports Library downloads retain the generated filename base and append a sanitized version of the saved report name. Spaces and unsafe filename characters are replaced with underscores, repeated underscores are collapsed, and the appended name is trimmed and length-limited. Save the report with a descriptive name before downloading.
Why are some dimensions only available in Custom Reports?
Dimensions like Page Type, Search Term, Targeted Keyword Type, Served Category, and Environment generate large datasets. Processing them in a standard report view can cause slow load times, timeouts, and incomplete results, especially across longer date ranges or larger accounts.
Custom Reports handle these datasets in the background and deliver results as a downloadable file, so you always get complete and reliable data. For the full list of dimensions available exclusively in Custom Reports, see the What Are Custom Reports? step.
