Documentation / Product / Integrations / Segment.com

Segment: Export

With this export you can send Lytics audiences to Segment as Identify or Track events. Using Segment you can send this data downstream to multiple other tools.

Integration Details

  • Implementation Type: Server-side.
  • Implementation Technique: REST APIs with audience triggers.
  • Frequency: Real-time, with an optional one-time backfill of the audience after setup.
  • Resulting Data: Lytics users that are a member of the selected audience(s) are exported to Segment via Identify or Track events.

This integration utilizes the Segment API to send user data. Once the user initiates the job, it will run a backfill of users if configured to do so. Segment will then receive real-time updates when a user enters or exits the choosen audience. For each user the integration will:

  1. Create an Identify or Track event payload with the Lytics user field data selected according to job configuration.
  2. Append the audience_{audience_name} as boolean (true or false) field if the event type selected at configuration is Identify. Here true specifies the Enter event and false specifies Exit event.
  3. If the Track event was selected at configuration, it will append the field event with a value of "enter" or "exit".
  4. Send the Event to Segment.

Fields

Segment supports various fields for Identify or Track payload. Please refer to Segment's Identify and Track documentation for more information. As mentioned above, the audience_{audience_name} and event fields are added in addition to the default payload depending on the event type. Lytics allows you to send additional fields as part of traits for Identify events and properties field for Track events.

Configuration

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

Note: Before running this job you will need to set up a Source in your Segment account, this may be a Custom Source or a Legacy Project Source this will be the source where Lytics writes data in Segment. You will need to know your write key for your source. See Segment's documentation for directions on how to obtain your write key.

  1. Select Segment from the list of providers.
  2. Select the Export job type from the list.
  3. This job does not require an authorization.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the audience to export.
  7. Enter your Segment write key in Segment.com Write Key for the target Segment source. Finding your write key.
  8. Select the User ID field to match users in Segment. See Segment's documentation for more information about user IDs.
  9. Select the Anonymous ID field to match users as anonymous in Segment. See Segment's documentation about Anonymous IDs for more information. Note: User ID or Anonymous ID must be set.
  10. Select the Event type.
  11. Select the user Export Fields to export. By default, all fields will be sent.
  12. Select Existing Users to add users who already exist in the selected Lytics audience.
  13. Click Start Export.

    segment-export