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 be passed on to destinations that accept names for customer segments or lists.
- 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.
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.
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
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 will not 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:
- List all Exports: View a list of all Exports you have setup for audiences.
- Get an Export: View a specific Export with its Export Metadata and
Export ID
- 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!
Updated 5 months ago