Skip to main content

Build Reports in Intelligence

LiveRamp Clean Room's integrated visualization tool, Intelligence, enables users to take the outputs of clean room questions and question runs and create reports and dashboards encompassing charts, tables, and other visualizations.

Reports are visual representations of a clean room question output and consist of table joins as referenced in Clean Room and Question Navigation Guide.

This article walks you through building a report in Intelligence to visualize data queried in a clean room.

To access Intelligence, enter a clean room and select Intelligence from the navigation pane.

Defining a Query

There are two ways to define a query in Intelligence:

  • Define a query using the query editor

  • Define a query using the SQL editor

Define a Query With the Query Editor

  1. In Intelligence, go to the collection where you want your report to live and select NewQuestion.

  2. Pick your starting data table by selecting a clean room from the dropdown, followed by a source data table for the question you want to create a report for.

    hi_select_question_data.png
  3. In Query Editor, select the join data icon image idm3593 and then select the source metadata table for your question.

    hi_join_data.png
  4. Select the Run ID to join the data and metadata tables on.

    hi_select_runid.png
  5. Under "Summarize", select one or more metrics to include in your report, starting with how each metric should be calculated (such as sum of), and the columns by which you want to group those metrics. Metrics and columns will populate based on what is in the source tables.

    hi_select_dimension.png

    Other report options related to your source data include:

    • Custom Expression: Custom metrics calculation. For more information, see "Custom expressions".

      hi_custom_exp.png
    • Filters: Filter your report output by specific columns.

    • Sort: Select a metric to sort in ascending or descending order in your report output.

    • Row Limit: Set a cap on the number of rows in your report output.

    • Custom Column: Create a new column based on a custom expression.

  6. Once the report output has been defined, click Visualize. You can navigate back to the Query Editor by clicking the show editor icon image idm3618 in the upper right-hand side of your screen.

Define a Query Using the SQL Editor

  1. From the collection where you want your report to live, select NewSQL Query.

  2. Pick your starting data table by selecting a clean room from the dropdown.

    sql_editor.png
  3. Use the SQL Editor to author your query.

    • Click the play icon mceclip2__20_.png to preview your results. The preview chart or table will show below the SQL Editor.

    • Click the expand icon mceclip3__17_.png to minimize or maximize the SQL Editor.

    • If you have field filters within your query, use the variable iconC-FBOC_Migration-Meta_UI.png to define the variables to use the filter widgets.

  4. Once the report output has been defined, click Visualization to customize your report.

    image idm3643

Customize the Visualization

Once you click Visualize, Intelligence will create a report in a default format (such as bar chart). Click Visualization to change the type of visual.

hi_visualize.png

Click Settings to customize the different components of your visual. Depending on the type of visual selected, the options under "Settings" will differ. See the options below for the most common types of visuals - bar charts, line charts, and tables.

Bar Charts and Line Charts

  • Data Tab: Change axes display names, value displays, and rearrange metrics and dimensions within your report.

    • Click the three dots next to a dimension to change the dimension name, bar or line color, display type (line VS bar), axis position and the ability to display values on the bars or lines.

    • Click the three dots next to a metric to change the style (currency, percentage, etc), separator style (100,000 VS 100 000,00), number of decimal places, and to add a prefix ($) or suffix (%).

      image idm3653
      image idm3658
  • Display Tab: Change additional display components (ie stacked VS non-stacked bars), add a goal line, and display values on bars or lines.

    hi_display_tab.png
  • Axes Tab: Change axes labels, hide label, and change how markings are displayed (i.e. compact, angled).

    hi_axes_tab.png

Tables

  • Columns Tab: Change column names and display types, create a pivot table, and rearrange the column order.

    • Click the three dots next to a dimension to change the column name and display type (i.e. text, link).

    • Click the three dots next to a metric to change the column name, style (currency, percentage, etc), separator style (100,000 VS 100 000,00), number of decimal places, and to add a prefix ($) or suffix (%).

      image idm3673
      image idm3678
  • Conditional Formatting Tab: Add rules to change the color of the cells in the table if they meet certain conditions.

    image idm3683

Save the Report

Once you complete your customizations, give your report a name and an optional description, and confirm it is saved in the correct collection. Click Save.

image idm3688