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.

πŸ“˜

Note

If 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

  1. Navigate to the audience you’d like to export, and select Export from the dropdown menu on the right hand side.
  2. The Create Export modal will appear, listing all of the destinations you’ve connected to your GrowthLoop application.
  3. 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.
  4. Once you've mapped the appropriate fields from your table to the required match fields, you’ll be asked to configure your Export Settings:
    1. 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.
    2. Campaign Type: "Ongoing" or "One Time". "Ongoing" means that the audience export will be repeated on a periodic schedule.
    3. Frequency: The time interval to set for Ongoing campaign types. This will overrule the default frequency sync set when you first create a destination.
    4. Timing fields
      1. Start: Choose whether the export should begin "Now" or be "Scheduled" for a future time.
        1. Selecting "Now" will trigger the export within the next 15 minutes.
        2. Selecting "Schedule" will prompt you to enter a specific Date, Time, and Timezone (see below).
      2. Date, Time, and Timezone: These fields appear when "Schedule" is selected under Start.
        1. Date: The day the export should begin.
        2. Time: The specific time on the selected date when the export should start.
        3. 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.
      3. End: Set to "Never" or a specific end Date and Time. This option is not applicable for One-Time campaigns.
      4. 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.
      5. 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.
πŸ“˜

Note

If 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.

  1. 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 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 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.

πŸ“˜

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.

πŸ“˜

Note

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