Exports
Allegro can export large lists — your purchases and your audience members — as CSV files. Exports are generated in the background, so you can start one and keep working: when the file is ready, Allegro emails you a download link and the export appears on the Exports page, ready to download.
To see your exports, go to Exports in the main navigation.
Starting an export
You start an export from the page whose data you want:
| Export | Where to start it |
|---|---|
| Purchases | The Export button on the Purchases page. |
| Audience members | The Export button on the Audience page. |
The export always reflects the filters and search active on that page when you click Export — so to export a subset, narrow the list first, then export. The whole matching set is included, not just the page you are viewing.
After you click Export, Allegro confirms that the export is being generated and that it will email you a link when it's ready. You don't need to stay on the page.
To keep the queue healthy, you can start up to three exports per minute. If you go over, Allegro asks you to wait a few seconds before trying again.
The Exports page
The Exports page lists every export across your organization, most recent first, and refreshes on its own while any export is still being generated. Each row shows:
| Column | Description |
|---|---|
| Type | What was exported — Purchases or Audience members. |
| Status | Where the export is in its lifecycle (see below). |
| Requested by | The admin who started the export. |
| Rows | The number of records in the file, once it has finished. |
| Size | The size of the generated file. |
| Created | When the export was started. |
| Download | A Download button, shown only while the file is available. |
Statuses
| Status | Meaning |
|---|---|
| Pending | The export is queued and waiting to start. |
| Processing | Allegro is building the file. |
| Completed | The file is ready to download. |
| Failed | Something went wrong while generating the file. Start a new export. |
| Expired | The file was completed but has passed its download window (see below). |
Downloading and retention
When an export completes, Allegro emails the admin who started it a link to the file, and a Download button appears on the export's row. Each file stays available for 7 days after it was created. After that the export is marked Expired, the file is removed, and the Download button no longer appears — start a new export to get a fresh copy.
Purchase and audience-member exports are standard CSV files you can open in any spreadsheet.
Purchase columns
For the exact columns in a purchases export, see Purchases.
Audience member columns
An audience-member export is named audience-members-YYYY-MM-DD.csv and starts
with these columns:
| Column | Description |
|---|---|
Member ID | The member's unique ID. |
Name | The member's display name, or blank if none is set. |
Email | The member's email address. |
Email Verified | Yes or No. |
Created At | When the member was first created (ISO 8601). |
Last Active At | When the member last generated an event, or blank if never. |
Active Products | Names of the products the member currently has an active entitlement to, comma-separated. |
Active Product Slugs | The same products by slug, comma-separated. |
Active Entitlements | The number of active entitlements the member holds. |
Entitlement Expires At | The soonest expiry among the member's active entitlements, or blank when they never expire. |
Login Providers | The login providers the member has connected (for example apple, google), comma-separated. |
Completed Purchases | The number of completed purchases. |
Lifetime Value | The total of all completed purchases as a plain decimal (for example 40.00). |
Lifetime Value Currency | The currency of the member's purchases (for example usd). |
Last Purchase At | When the member's most recent completed purchase was made, or blank if none. |
After these fixed columns, the file adds one column per
user attribute your organization has defined,
ordered by attribute name. Each cell holds that member's value for the attribute
(a boolean attribute reads Yes or No), and is left blank when the member has
no value.