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.

Fields

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.

Configuration

Follow these steps to set up and configure an export of a Lytics audience to Localytics.

  1. Navigate to Localytics in the Integrations section of Lytics. localytics
  2. Select Workflows from the menu on the left.
  3. Click New Workflow.
  4. Select Export Audiences.
  5. Select the authorization you created.
  6. From the Audiences list, select the Lytics audiences you would like to export to Localytics.
  7. Select the Existing Users checkbox to export users who are already in the selected Lytics audiences.
  8. Select the Localytics App that you want to send your Lytics audiences to.
  9. From the Profile ID Field dropdown, 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 Lytics will create the user with this ID.
  10. From the Special Profile Attributes list, 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.
  11. From the Attributes list, select the field in the Lytics audience user that you would like to send as Localytics profile attributes.
  12. Select the Audience Membership checkbox to send Lytics audience membership as an attribute of 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.
  13. Click Start Export. localytics export audience