Segment Connector

Segment is a customer data platform (CDP) that specializes in event collection and data activation. The platform collects data from websites, mobile apps, servers, and cloud applications and pushes that data to downstream destinations.

The Segment connector enables you to sync Segment audience data with Dynamic Yield instantly. Once synced, you can aim Dynamic Yield campaigns at users in particular Segment audiences.

Install the Segment extension

1. In the Experience OS store, go to Segment and click Learn More.
2. On the Segment page, click Install.
   
   
3. Go to Audience Hub › Extensions.
4. Select Active from the status dropdown.
5. In the Connection Settings: Select the identifier type for this integration. You have two options:
   • Select from the list the main identifier type (CUID) you defined for your Dynamic Yield section. It must be the same identifier type you use in Segment. This is the same CUID you use in Identification events (such as Login, Signup, Identify User, Newsletter Subscription).
   • Select other to use a custom identifier you defined in Segment. In Dynamic Yield, this must be defined as a secondary identifier in your section, and it must be used in your identification events as a secondary identifier as well.
   Learn more about CUID and secondary identifiers.
6. Click Save. Keep this tab open, as you'll need to copy the identifier, section ID, and connection key to your Segment console.

Configure the Dynamic Yield destination

This is a one-time setup in Segment Connections. After you complete this configuration, you'll select audiences to sync with Dynamic Yield.

1. In Connections › Catalog, search for Dynamic Yield.
   
2. On the Dynamic Yield Audiences page, click Add destination.
   
3. Select the relevant space, and then click Confirm Source.
   
4. Enter the information from Dynamic Yield (see Step 6 of the previous section): Identifier, section ID, and connection key. Click Save.
5. Go to Mappings. Click New Mapping and then click Sync Audience.
6. Go to Engage › Audiences and select the audience you want to sync with Dynamic Yield.
7. On the audience page, click Add Destination, and search the Dynamic Yield destination.

You can now view the synced audiences in Experience OS.

Create audiences based on Segment data

1. In the Experience OS Audience Hub, go to Audience Explore. 
2. Select Segment Audiences from the dropdown list.
3. Configure audience conditions based on data from Segment.
   

Troubleshooting

• Make sure the identifier type and values are identical in both the Dynamic Yield integration settings for the Segment connector and the destination configuration in Segment.
• Make sure that the identifier type you use in your identification events (Login, Signup, Identify) is the same identifier used in the integration.
• Verify that the users in the Segment audiences indeed visited the site. If you're not sure, we recommend that you create an audience with all users who visited the site, sync it, and see if users appear in the Audience Explorer.
• Note that Audience Explorer doesn't include real-time data, only defined past timeframes.
• If an audience from Segment is unsynced: 
  • Segment isn’t able to send us this webhook. This means that this audience is still available on Experience OS, but the data is the "old" data we collected until the audience unsynced. 
  • If you sync it again, Segment sends us updated information about users who joined or left this audience. 
• If the destination is deleted, Segment is unable to send us this information. This means that the audience data remains on Experience OS until it's manually removed. 
• If you've just now implemented the identifier in your identification events: For users who were never identified on the site, connecting them to their Segment identity can take up to 24 hours.