Export an Audience
Learn how to configure your exports to downstream channels for audience activation.
In this article, youβll learn the basics for how to export an audience in the GrowthLoop application.
NoteIf you need a refresher on how to build an audience, check outΒ create an audience.
Prerequisites
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.
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 will appear, listing all of the destinations youβve connected to your GrowthLoop application. - After selecting your desired destination, you will be required to specify the
Match Fields
. This typically refers to the user identifiers (such as email, phone number, or device ID) that the destination platform uses to match and activate your audience. - Once you've mapped the appropriate fields from your table to the required match fields, 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
: Choose whether the export should begin "Now" or be "Scheduled" for a future time.- Selecting "Now" will trigger the export within the next 15 minutes.
- Selecting "Schedule" will prompt you to enter a specific Date, Time, and Timezone (see below).
Date
,Time
, andTimezone
: These fields appear when "Schedule" is selected under Start.Date
: The day the export should begin.Time
: The specific time on the selected date when the export should start.Timezone
: The time zone in which the scheduled export should occur (e.g., America/Los_Angeles). This ensures the export triggers at the correct local time.
End
: Set to "Never" or a specific end Date and Time. This option is not applicable for One-Time campaigns.Select days of the week
: Multi-select control for each day, starting with Sunday. By default, all days are selected. This field is not applicable for Weekly or Monthly frequencies.Personalization Fields
: Additional fields from your primary 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.
NoteIf you schedule an audience export with a daily frequency at a specific date and time (e.g., Tuesday at 6:00 AM EST), all future exports will also run at 6:00 AM EST unless changed.
- After specifying the
Export Settings
andMatch Fields
, you can click theExport
button at the bottom.
NoteIf 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 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.
NoteFor one-time campaigns, clicking the
Run
button will not trigger a new export, even if a success message appears. Additionally, clicking this button will override the scheduled daily run and reset it to the default schedule after the first run.
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.
NoteIt 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 andExport ID
Trigger Export
: Trigger a specific Export utilizing itsExport ID
You can view and test the GrowthLoop API in our API Reference.
NoteExperiencing any issues exporting Audiences? Reach out to us atΒ [email protected]Β and weβll be in touch shortly!
Updated 15 days ago