Documentation / Product / Integrations / Localytics

Localytics: Export Audiences

Send Lytics audiences and user fields to Localytics to refine your targeting and improve engagement on your mobile marketing campaigns through Localytics. All existing members and new members of your selected Lytics audiences will be exported in real-time.

Integration Details

  • Implementation Type: Server-side.
  • Implementation Technique: REST APIs with audience triggers.
  • Frequency: Real-time, with a one-time backfill of the audience after setup.
  • Resulting Data: Lytics users that are members of the selected audiences are exported as Localytics profiles.

This integration utilizes the Localytics Profile API to create/update Localytics profiles. Once initiated, the workflow will:

  1. Run a backfill of the selected Lytics audiences, and create or update Localytics profiles.
  2. After a backfill, the workflow will receive real-time updates when a user enters or exits the audience.

Creating or updating a Localytics profile is done using the Profile ID Field which can be configured when setting up this workflow. If the Lytics user with selected Profile ID Field does not exist in Localytics, then Lytics will create a Localytics profile with that ID and fill their attributes with the ones selected in the workflow.

If the user being exported to Localytics already exists, then Lytics will update its attribute. The attribute values will be overwritten except for the lytics_audiences attribute. The update will happen only for the attributes that are selected during configuration. If the Localytics user has other attributes which are not in the workflow configuration, then those attributes will remain unchanged in Localytics.

For each user entering the audience, it will also create/update the lytics_audiences set attribute for the profile with the slug of Lytics audiences that the user is in. If this attribute already exists, Lytics will update its value depending on enter/exit, not overwrite it. For each user exiting the audience, the workflow will remove the Lytics audience slug from the lytics_audiences attribute of Localytics profile for that exit event.


You can export any Lytics user fields to Localytics as profile attributes. Lytics allows you to select user fields as part of the workflow configuration described below.


Follow these steps to set up and configure an export job for Localytics in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Localytics.
  2. Select the Export Audiences job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Select the audiences to export.
  5. Complete the configuration steps for your job. localytics export audience
  6. Select the Existing Users checkbox to export users who are already in the selected Lytics audiences.
  7. From the Localytics App input select the Localytics app to send your Lytics audiences to.
  8. From the Profile ID Field input select the field in the Lytics audience user that corresponds to Localytics profile ID. If a user does not exist for this ID in Localytics, then we will create the user with this ID. Note: Lytics users who do not have the selected ID field will be dropped.
  9. From the Special Profile Attributes input select the fields in the Lytics audience user that are special profile IDs in Localytics. Please refer to the Localytics documentation for more information on this.
  10. From the Attributes input select the field in the Lytics audience user that you would like to send as Localytics profile attributes.
  11. Select the Audience Membership checkbox to send Lytics audience membership as an attribute of the Localytics profile. Checking this will create a set attribute in Localytics with name lytics_audiences and populate it with Lytics audience slugs that the user is part of.
  12. Click Start Export.