Export an Audience

In this article, you’ll learn the basics for how to export an audience in the GrowthLoop application. If you need a refresher on how to build an audience, check out create an audience.

Requirements

Before exporting an audience, you’ll need to have your destination set up in GrowthLoop. Here is a library of destination tutorials you can review.

Each destination has unique set-up requirements for successfully exporting an audience, which are covered in the relevant destination page.

Export a New Audience

Navigate to the audience you’d like to export, and select ‘Export’ from the dropdown menu on the right hand side.

The ‘Create Export’ modal should appear, listing all of the destinations you’ve connected to your GrowthLoop application.

After selecting your desired destination, you’ll be asked to configure your export settings:

• Export Name: Any name you want to assign to this export, defaults to Audience name. This name will not be passed on to destinations and is only used to differentiate exports in the GrowthLoop app.
• Campaign Type: ‘Ongoing’ or ‘One Time’. ‘Ongoing’ means that the audience export will be repeated on a periodic schedule.
• Frequency: The time interval to set for Ongoing campaign types. This will overrule the default frequency sync set when you first create a destination.
• Timing fields
  • Start: ‘Now’ or a specified date and time. Selecting ‘Now’, will trigger an export within the next 15 minutes.
  • End: ‘Never’ or a specified date and time. Not applicable for ‘One Time’ campaigns.
  • Select days of the week: Multi-choice for each day of the week, starting with Sunday. By default, all days of the week are selected. Not applicable for ‘Weekly’ or ‘Monthly’ frequencies.
• Personalization Fields: Additional fields from your ‘Customers’ dataset to send to the selected destination. This option will only appear for destinations that support personalization fields, which are typically email destinations or CSV exports.

Depending on the destination, you may be required to confirm the ‘Match Fields’ in a separate screen or a tab beside ‘Export Settings’. In some cases, you can alter the match fields to maximize the chances of matching with customer records in your destination.

After specifying the export settings and match fields, you can click the ‘Export’ button at the bottom.

📘

Note

If you attempt to re-export to the same destination, the tile will appear grayed out (except for CSV and bucket destinations such as S3 and GCS). To proceed, you can either:

• Update the export settings by clicking "Manage" on the Exports tab, then clicking the "Run" button. Or
• Create a new audience for export.

Managing Audience Exports

After an audience export has been initiated, an ‘Exports’ tab will appear in the Audience Builder UI. This ‘Exports’ tab contains a summary of all audience destinations and export runs, including details about added, removed, and rejected records. Below is a breakdown of what each column represents:

• Destination – The platform where the audience is being sent (e.g., Iterable).
• Status – Indicates whether the export is processing, successfully completed, or encountered errors.
• Export Time – The timestamp when the export was initiated.
• Added – The number of records added to the audience and sent to the destination.
• Removed – The number of records removed from the audience because they no longer meet the criteria.
• Rejected – The number of records that failed to export due to errors (e.g., formatting issues, missing data).
• Export ID – A unique identifier for the export run, which can be referenced in logs or troubleshooting.
• Error Details – Provides additional information if any records were rejected during export.

📘

Note

• If your audience has a treatment/control split applied, only customer records randomly assigned to the Treatment group will be exported. The number of records sent for export may differ slightly from the Treatment number in the Audience Builder UI
• For exports to the Snowflake destination, removals will not appear in the 'Removed' column, meaning all exported records are logged as 'Added,' even if they were previously removed and re-added.

Disabling exports

‍Its possible to disable an export by un-checking the ‘Enabled’ box on the left hand side.

Trigger an export

For Ongoing campaigns, you can manually trigger new export runs by clicking the ‘Run’ button on the right hand side.

Note: For one-time campaigns, clicking the ‘Run’ button willnot trigger a new export run, even though a success message may appear.

Modifying an export schedule

It’s also possible to modify the export schedule by selecting ‘Manage’ from the dropdown menu beside the ‘Run’ button.

You can modify the frequency, End date and days of the week for any Ongoing campaigns. If the Start date is set for a future date, its also possible to update this value.

Changing export type

You can also convert One Time campaigns into Ongoing by selecting the same ‘Manage’ option.

Note: It is not possible to convert Ongoing campaigns into One Time.

Export Audiences via API

In addition to the GrowthLoop interface, you can trigger any audience export through the GrowthLoop API.

Through the GrowthLoop API you can:

1. List all Exports: View a list of all Exports you have setup for audiences.
2. Get an Export: View a specific Export with its Export Metadata and Export ID
3. Trigger Export: Trigger a specific Export utilizing its Export ID

You can view and test the GrowthLoop API in our API Reference.

Experiencing any issues exporting Audiences? Reach out to us at [email protected] and we’ll be in touch shortly!