--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/support/adfox/en/statistics/reports/index.md - https://yandex.com/support/adfox/ru/statistics/reports/index.md - href: en/statistics/reports/index.md type: text/markdown title: Markdown version - href: ../../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/adfox/en/llms.txt # Reports Adfox reports contain information about responses, impressions, clicks, and CTR in real time and for the selected period. You can generate reports for the last three years. ## Report types {#types} All available reports are grouped into categories: {% cut "Common" %} - [Campaign](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-campaign-report). - [Day](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-daily-report). - [Events](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-event-reports). - [Time of day](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-daytime-reports). - [Day of the week](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-weekday-reports). - [Sites](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-site-reports). - [Advertisers](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-adv-reports). - [Assistants/campaigns reconciliation check](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-checkout-reports). - [Ad campaigns including “IMS”](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#fraud-report). {% endcut %} {% cut "Advanced" %} - [Direct sales in Telegram](../../telegram#statistics). - [Categories](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-category-reports). - [Banner types](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-bannertype-reports). - [Browsers](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-browser-reports). - [Device types](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-device-reports). - [Device manufacturer](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-brand-reports). - [Operating system](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-os-reports). - [Usage (Yandex Audience segments)](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-usage-reports). - [Industry](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-branch-reports). - [Site owner/campaigns reconciliation check](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#owner-checkout-reports). - [Geography](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-geo-reports). {% endcut %} {% cut "Audience metrics" %} - [Cumulative](https://yandex.com/support/adfox/en/statistics/reports/auditorial-reports.md). - [Daily](https://yandex.com/support/adfox/en/statistics/reports/auditorial-reports.md). - [Distribution of users by frequency](https://yandex.com/support/adfox/en/statistics/reports/auditorial-reports.md). - [Campaign reach](https://yandex.com/support/adfox/en/statistics/reports/auditorial-reports.md). {% endcut %} {% cut "Monetization" %} - [Google monetization](https://yandex.com/support/adfox/en/statistics/reports/monetization-reports.md#google-monetization-reports). - [Header Bidding by monetizer](https://yandex.com/support/adfox/en/statistics/reports/monetization-reports.md#hb-monetizator-report). - [Header Bidding by monetizer (by site/section/platform)](https://yandex.com/support/adfox/en/statistics/reports/monetization-reports.md#hb-monetizator-side-report). {% endcut %} {% cut "Monetization rewards" %} - By monetizers. - By site, monetizers. - By sites, platforms, monetizers. - YAN by sites, sections, ad units, and placements. Read more about reports in the [Monetization rewards](https://yandex.com/support/adfox/en/statistics/reports/revenue-reports.md) section. {% endcut %} {% cut "By traffic" %} - [Inventory (Yandex Audience segments)](https://yandex.com/support/adfox/en/statistics/reports/traffic-reports.md#inventory-yandex). - [Google inventory without rejections](https://yandex.com/support/adfox/en/statistics/reports/traffic-reports.md#inventory-google). {% endcut %} All users can create custom reports based on the available ones. [Administrator](https://yandex.com/support/adfox/en/support/glossary.md#A-ru) and [assistant](https://yandex.com/support/adfox/en/settings/users/assistant.md) users can edit the available reports and [create custom reports](#custom): both new and based on those available. ## Create a report {#create} You can create reports at various levels. {% list tabs %} - Account level You can use account-level reports to view summary data on campaigns, advertisers, monetizers, and other parameters. To create a report: 1. Go to the **Reports** tab in the main menu. 1. The Report Builder will open with default settings. Set up other parameters as shown in [Step 3](#set-parameters). 1. Select the report timeframe from the list at the top of the screen or specify the desired dates in the calendar. 1. Click **Build a report**. A data chart and table are displayed below on the page. - At the campaign level On the **Campaigns** → **Commercial** tab, you can view impressions, clicks, and CTR of the campaign for a selected period. To view detailed statistics: 1. Click **Report** under the campaign name. 1. The Report Builder will open with default settings. Set up other parameters as shown in [Step 3](#set-parameters). 1. Select the report timeframe from the list at the top of the screen or specify the desired dates in the calendar. 1. Click **Build a report**. A data chart and table are displayed below on the page. - At the site, section, or placement level The report shows banner responses, impressions, clicks, and the section or platform CTR. To build a report: 1. Navigate to the object (site, section, or placement) and click ![](../../_images/reports.svg)**Reports** next to its name. 1. The Report Builder will open with default settings. Set up other parameters as shown in [Step 3](#set-parameters). 1. Select the report timeframe from the list at the top of the screen or specify the desired dates in the calendar. 1. Click **Build a report**. A data chart and table are displayed below on the page. {% endlist %} ### Step 1. Choose a report template or create a custom report {#choose-report} You can create a report from a template in Adfox. Hover over the **Reports** tab in the left menu and choose the report template you want from the list. If you can't find a perfect template, select the most relevant one. You can add more parameters later. {% note tip %} To quickly find a report template, start typing its name in the search box or select the relevant group from the list. {% endnote %} {% cut "Templates are grouped into categories" %} {% cut "Common" %} - [Campaign](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-campaign-report). - [Day](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-daily-report). - [Events](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-event-reports). - [Time of day](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-daytime-reports). - [Day of the week](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-weekday-reports). - Campaigns (NEW). - [Sites](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-site-reports). - [Advertisers](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-adv-reports). - [Assistants/campaigns reconciliation check](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#general-checkout-reports). - [Ad campaigns including “IMS”](https://yandex.com/support/adfox/en/statistics/reports/general-reports.md#fraud-report). {% endcut %} {% cut "Advanced" %} - [Direct sales in Telegram (by channels)](../../telegram#statistics). - [Categories](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-category-reports). - [Banner types](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-bannertype-reports). - [Browsers](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-browser-reports). - [Device types](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-device-reports). - [Device manufacturer](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-brand-reports). - [Operating system](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-os-reports). - [By geography](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-geo-reports). - [By usage (Yandex Audience segments)](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-usage-reports). - By usage (DMP segments). - Turbo banner types. - [Industry](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#add-branch-reports). - [Site owners/campaigns reconciliation check](https://yandex.com/support/adfox/en/statistics/reports/additional-reports.md#owner-checkout-reports). {% endcut %} {% cut "Audience metrics" %} - [Cumulative](https://yandex.com/support/adfox/en/statistics/reports/auditorial-reports.md). - [Daily](https://yandex.com/support/adfox/en/statistics/reports/auditorial-reports.md). {% endcut %} {% cut "Monetization" %} - [Google monetization](https://yandex.com/support/adfox/en/statistics/reports/monetization-reports.md#google-monetization-reports). - [Header Bidding by monetizer](https://yandex.com/support/adfox/en/statistics/reports/monetization-reports.md#hb-monetizator-report). - [Header Bidding by monetizer (by site)](https://yandex.com/support/adfox/en/statistics/reports/monetization-reports.md#hb-monetizator-side-report). {% endcut %} {% cut "By gender and age" %} - Ad requests and impressions by gender/age overlap. - Banner impressions and responses by campaign with targeting by demographics. {% endcut %} {% cut "By traffic" %} - [Inventory (Yandex Audience segments)](https://yandex.com/support/adfox/en/statistics/reports/traffic-reports.md#inventory-yandex). - Inventory (DMP segments). - [Google inventory without rejections](https://yandex.com/support/adfox/en/statistics/reports/traffic-reports.md#inventory-google). {% endcut %} {% cut "For planning" %} - By inventory. - Only amounts. - By country. - By Russian city. {% endcut %} {% cut "Monetization rewards" %} - By monetizers. - By sites and monetizers. - By sites, placements, and monetizers. - YAN by sites, sections, ad units, and placements. Read more about reports in the [Monetization rewards](https://yandex.com/support/adfox/en/statistics/reports/revenue-reports.md) section. {% endcut %} {% cut "By user characteristics" %} - exclusive - content - page - exclGroup - topic {% endcut %} {% endcut %} Saved reports appear in **My reports**. You can also create a report manually. To do this: - Go to **Reports** from the main menu and click **Create a new report** in the list. ### Step 2. Specify the report dates {#choose-date} Select the report timeframe from the list at the top of the screen or specify the desired dates in the calendar. ![](../../_images/choose-dates-new.png){style="border: solid 1px #cccccc"} ### Step 3. Configure dimensions, metrics, and filters {#set-parameters} If you're using a template to create your report, the main parameters will be set automatically. You can always add new parameters or remove parameters that are already in place. If you're creating a report from scratch, you will need to set all the parameters manually. {% list tabs %} - Dimensions Determine the parameters that the report data is grouped by. To add a dimension parameter, click ![](../../_images/plus.png =30x) in the dimensions section and select the values you need from the list. The parameters you choose will appear on the right side of the modal window. When a report is generated, dimensions are applied in the order they're listed in the settings. Change the order of dimensions by dragging and dropping their names in the modal window or on the panel. You can remove any elements you don't need by clicking ![](../../_images/delete.png =20x). - Metrics Statistical metrics that you want to check for the selected data range. To add a metric, click ![](../../_images/plus.png =30x) in the metrics section and select the values you need from the list. Check the metric's meaning in the [Glossary](https://yandex.com/support/adfox/en/support/glossary.md) or by hovering over ![](../../_images/controls-tooltip.png =20x) next to the metric name. The metrics you choose will appear on the right side of the modal window. When a report is generated, dimensions are applied in the order they're listed in the settings. Change the order of metrics by dragging and dropping their names in the modal window or on the panel. You can remove any elements you don't need by clicking ![](../../_images/delete.png =20x). - Filters Filters define the data that your report will be based on. You can set filters for a specific site, ad unit, platform, and so on. To add a filter: 1. Click ![](../../_images/legend-new.png =20x)**Filters**. 1. The filter bar will appear. To open the list of available filters, click ![](../../_images/plus.png =30x). 1. Select the parameter you want to use to filter your report data. In the window that opens, you can search for a parameter or choose from the relevant group. 1. Specify a value for the selected parameter: choose from the drop-down list or enter it manually. {% endlist %} #### Limits to data in charts {#limits} When choosing parameters, please keep in mind that the chart in your report may be incomplete if there is too much data. This restriction is applied to avoid issues when rendering charts. For reports with a lot of data, all the rows in the table are sorted by the selected metrics in descending order and only the first 500 rows are taken into account when rendering the report chart. Moreover, the chart includes only those dimensions whose data for the selected period has made it into the first 500 rows. If a dimension's data is excluded from the first 500 rows, the dimension won't be shown in the chart at all. If you wish to display all of the report's data on the chart, you can limit the amount of data listed in the report via filters, shorten the report period, or reduce the number of dimensions in the report. You don't need to limit the number of metrics used in the report, because they don't affect the number of rows displayed in the table. #### Report setup example {#example} ##### Traffic analysis by campaign   To build a report, select the **Campaign name** dimension and the **Total ad requests**, **Revenue** metrics. Evaluate how requests are distributed among campaigns and how much revenue each of them brings. Based on this data, you can evaluate how effective each campaign is. For example, if fewer requests generate more revenue, this is a profitable campaign. ##### Site performance analysis   You can use the report data to identify traffic losses at each impression stage. To build a report, select the **Site name** dimension and the following metrics: - **Total ad requests** - **Banner ad responses** - **Impressions** - **Renders** - **Total ad requests without rejections** - **Unfilled ad responses** The number of banner impressions and responses may differ because of the campaign visibility settings. If there are a lot of unfilled ad responses, change your campaign settings: more restrictions cause fewer impressions. {% cut "What the report settings fields look like" %} ![](../../_images/report-settings-1.png){style="border: solid 1px #cccccc"; width="700px";} ![](../../_images/report-settings-2.png){style="border: solid 1px #cccccc"; width="700px";} {% endcut %} ### Step 4. Click **Build a report**. {#start-report} A chart and a data table will then appear at the bottom of the page. ## Viewing a report {#view} The report is available as a chart and a table. {% list tabs %} - Chart You can display a line chart or a bar chart. To choose a chart type, use the drop-down menu above the chart on the right. To adjust chart detail, select a period on the “Details” panel: year, month, day, hour, or “not specified”. The horizontal axis displays the following information: * For line charts: dimensions by period. * For bar charts: dimensions by category. To remove a dimension from the chart, disable it in the dimension list on the right. The metric values are on the vertical axis. When you create a chart, all metrics are shown by default. You can enable or disable the metric display from the list above the chart. If you wish to view the exact value of a metric, hover your cursor over the corresponding row or column. A field with the name and value of the desired metric will then be displayed. If needed, you can toggle the chart by clicking ![](../../_images/chart.png =25x) **Graph** on the right side of the report settings panel. - Table You can choose the table type: * Simplified data table. * Hierarchical table with grouped data. Hierarchical tables display structured data, with low-level items nested inside higher-level items. Click ![](../../_images/icon-table.png =60x) to switch from a simplified table to a hierarchical table. You can sort table data by any column — just click the column name. The data will be sorted, and an arrow icon (↑ or ↓) will appear next to the column header, showing the sort direction. You can sort the following data: * Parameters with a numeric value may be sorted in descending or ascending order. * Parameters with a text value may be sorted alphabetically. To reorder columns, change the order of metrics or dimensions in the report settings. {% endlist %} ## More report actions Use the options next to the report name to: > Add report parameters: - ![](../../_images/icon-save.svg =20x): Name the report and save it to **My reports** in the side menu. - ![](../../_images/icon-share.png =20x): Copy the report link and share it with others (only authorized Adfox users can view the report). > Rename or delete a report (available only for saved “My reports”): - ![](../../_images/kebab-banner.png =25x) → **Rename it**: Set custom names for your reports, even those generated from standard templates. - ![](../../_images/kebab-banner.png =25x) → **Delete**: Delete a generated report. This also works for reports from the **My reports** group in the side menu. ## Save a report {#save} To save the report in XLSX format, click ![](../../_images/csv-xlsx.png =18x). You'll find this option on the right side of the data area. - ![](../../_images/csv-xlsx.png =18x): Stores the report locally as an XLSX or a CSV file. - ![](../../_images/copy-link.png): To copy a link to the report (the report will only be available to authorized Adfox users). - **Save**: Save the report to the **Saved** tab in the left menu. {% note alert %} This feature is only available for [administrator](https://yandex.com/support/adfox/en/support/glossary.md#A-ru) and [assistant](https://yandex.com/support/adfox/en/settings/users/assistant.md) roles. {% endnote %} ## Contact support Send an email