# Export Lists

Learn the general process of exporting Performance Analytics data and review specific examples.

All data in Performance Analytics can be exported in a number of formats via the download
feature. In this document we'll look at the general process of exporting
Performance Analytics data, then we'll examine the specific example of exporting a list of
users that have directly opened a notification or rich message.

In this tutorial, you will first learn how to export report data, then follow steps to export specific types of report data.

## Export Data

In this section we look at the general process of exporting Performance Analytics data.

1. Go to *Reports » Performance Analytics*.
1. Select a dashboard and find the report you would like to download.
1. If you are on a default dashboard, click 
 and select
   *Download Data...*. If you clicked the tile to open the report or opened
   the report from a Space, instead click **Download Results**.
1. Specify Download Options:
   * **File Format:** The format of the download: *TXT*, *Excel
   Spreadsheet*, *CSV*, *JSON*, *HTML*, *Markdown*, or *PNG (Image of
   Visualization)*.
   * **Results:** *With visualization options applied* or *As displayed in the data table*.
   * **Values:** *Unformatted* means special characters are truncated
   from values, and values will be rounded to the nearest integer, e.g.,
   "1.13%" is rounded to "1%". As a general rule, the *Unformatted* option
   is good for discrete values, e.g., a count of devices, while *Formatted*
   is a good option for non-discrete values, such as percentages.
   * **Limit:** *Results in Table* exports all results currently visible
   in the table. *All Results* exports every result fetched by the query.
   Select *Custom*, to define a cutoff row for the download, e.g., enter
   *5000* to download of the first 5,000 records.
   * **Filename:** Enter a descriptive filename.
1. Click **Download** and save the file. If you'd like to view the
   data in the browser instead, click **Open in Browser**, and it
   will open in a new browser tab.

## Notifications

Generate a list of users that directly opened a specific push notification.

1. Go to *Reports » Performance Analytics*.
1. Select the *Revenue* dashboard.
1. In the *Messages* report, locate the row for the message
   you want to analyze, then click its value in the *Direct Response Count*
   column.
1. Download the data as described in
   [Export Data](#export-data).

## Rich Pages

<!-- This is super wrong and I couldn't figure out how to immediately fix it. --Kristina -->

Generate a list of users that directly opened a specific rich message.

1. **Go to the Messages dashboard.**

1. In the *Top 50 Rich App Pages* report, **locate the row for the Message you
   want to analyze**, then **click its value in the *Read Count*
   column.**
1. **Click the arrow next to Filters to display the full menu.**

1. **Edit the Rich Pushes Occurred Date range**, and set the value of *is on
   or after* to the day before the message send date:
   ![Setting the Rich Pushes Occurred Date filter](https://www.airship.com/docs/images/ins-rich-push-occurred-date_hu_7e71cab9f2087089.webp)
   
   *Setting the Rich Pushes Occurred Date filter*
   This configuration is necessary to ensure you capture rich message reads
   occurring in every time zone.

1. **Click the Run button** to refresh the query.

1. **Download the data** as described in
   [Export Audience Lists](#export-audience-list).

## Ad IDs {#ins-tutorial-ad-ids}

Generate a list of Ad IDs for users that made a purchase. Please visit our
[Ad IDs topic guide](https://www.airship.com/docs/guides/audience/ad-ids/) for use cases and
technical details.

> **Warning:** Your app must:
> 
> 1.  Send the *limit ad tracking* field from your app, and
> 1.  Not target users with ads who have *limit ad tracking* enabled. A value of
>    Unknown or Limit Ad Tracking = Yes or Unknown means you cannot send
>    ads to these users.


1. Go to *Reports » Performance Analytics*.

1. Select the *Revenue* dashboard.

1. In the *Custom Events Table* report, locate the *purchased* row and click
   its value in the *Event Count* column.

1. Click **Explore from Here**.

1. Make these changes in the left side menu:
   * In *Custom Events » Dimensions*, click the row for *Platform*.
   * In *User IDs » Dimensions*, click the row for *Device ID* to
   unselect it, and click the row for *Ad ID*.
   * Click **Filter** for *Limit Ad Tracking Enabled* to add
   the row to the Filters menu, then set the value of *is equal to* to "No."

1. Download the data as described in
   [Export Data](#export-data).

1. (Optional) Create a custom audience on Facebook. Follow
   [Facebook's instructions: Create a Customer List Custom Audience](https://www.facebook.com/business/help/170456843145568?id=2469097953376494)
   to create a Custom Audience or Lookalike Audience using the downloaded
   file. File must be in TXT or CSV format.

## Export Audience Lists {#export-audience-list}

You can [segment your audience](https://www.airship.com/docs/guides/audience/segmentation/segmentation/) using
an [Uploaded List](https://www.airship.com/docs/reference/glossary/#uploaded_list). First,
follow these steps to download a CSV of device identifiers. Second, [upload the list of users](https://www.airship.com/docs/guides/audience/segmentation/audience-lists/uploaded/##uploading-your-list) to your project, using the
file you just downloaded.

This example downloads all your Daily Active Users,

1. Go to *Reports » Performance Analytics*.
1. Select the *Overview* dashboard.
1. In the *Daily Active Users* report, click its value.
1. Click **Explore from Here**.
1. Download the data as described in
   [Export Data](#export-data), using these values:
   * **File Format**: CSV
   * **Values**: Unformatted
   * **Limit**: All Results