Sync rolling segments with external systems

Prev Next

Can’t see this option?

This feature is not enabled on projects by default. To enable it, contact your Account Manager.

You can automate the sync of your rolling segment data with your external system by configuring a rolling segment Destination. Every time a rolling segment updates on its hourly schedule, a list of users who have been added or removed is sent to your system using a webhook.

The data payload for this event will always include each user's user_id. If the customer_id is enabled on the project, then customer_id will also be included in the payload. User IDs in the payload are grouped by add or remove actions.

Prerequisites

To use this feature, you must first configure a Webhook Stream integration. This contains the destination URL and authentication details for your external system. For configuration details, see Webhook Streams.

Configure external sync of Rolling Segments

To activate the external sync of your rolling segment, you must configure a destination in your rolling segment configuration:

  1. Go to Data > Audiences > Rolling Segments

  2. Select your rolling segment or create a new one.

  3. Click Add Destinations and provide the following details:

    1. Webhook Stream Integration: From the drop-down, select the Webhook Stream associated with your destination URL.

    2. External Segment ID: Select the segment in your external system that maps to this rolling segment.

      Selecting the external segment ID

      To select an external segment from the drop-down, you must configure the Segment Source Settings in your Webhook Stream integration. For more information on the configuration, see Webhook Stream.

      If the segment source is not enabled, you must type the external segment ID manually.

  4. Save your changes.

Once saved, the sync becomes active. Updates are sent to your configured destination starting with the next hourly cycle.

Rolling Segment Calculation Time Limit

A segment calculation times out if it runs longer than five minutes. When this happens, the sync for that specific hourly cycle fails and an error message is generated. The segment stops syncing and must be manually re-enabled by clicking Enable Sync.