You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/unified-profiles/connect-a-workspace.md
+15-15Lines changed: 15 additions & 15 deletions
Original file line number
Diff line number
Diff line change
@@ -9,27 +9,27 @@ Your new Segment workspace must be on one of Segment’s [Customer Data Platform
9
9
## Step 1: Set up your Unify space
10
10
11
11
> success ""
12
-
> This section is about setting up a new Segment Unify space to link to Twilio. If you have an existing Segment Unify space you'd like to use,proceed directly to [Connect your Unify space to Twilio](#step-2-connect-your-unify-space-to-twilio).
12
+
> This section is about setting up a new Segment Unify space to link to Twilio. If you have an existing Segment Unify space you'd like to use,proceed directly to [Connect your Unify space to Twilio](#step-2-connect-your-unify-space-to-twilio).
13
13
14
14
Your Unify space acts as a central location for your Profiles, or collated information that you have for each of your customers.
15
15
16
16
Segment recommends connecting a development or sandbox Unify space to Twilio before creating a production Unify space.
17
17
18
18
To create a Segment Unify space:
19
19
20
-
1. In Segment, navigate to Unify and click **Create Space**.
20
+
1. In Segment, navigate to **Unify** and click **Create Space**.
21
21
2. Enter a name for your space, select **Dev space**, then click **Create space**.
22
-
3. Set identity rules for your space by clicking **Set identity rules**.
23
-
4. Navigate to the settings for your Unify space and select API access.
22
+
3.Click **Set identity rules** to set identity rules for your space.
23
+
4. Navigate to the settings of your Unify space and select **API access**.
24
24
5. Copy the Segment Unify Space ID to a safe location, as you'll need this value to connect your Unify space to Twilio.
25
25
6. Click **Generate Token**. Enter a name for your Profile API token, enter the password for your Twilio account, then click **Generate token**.
26
-
7. Copy your Profile API token to a safe location and click the "I have written down this access token" checkbox, then click **Done**.
26
+
7. Copy your Profile API token to a safe location and click the *I have written down this access token* checkbox, then click **Done**.
27
27
28
28
## Step 2: Connect your Unify space to Twilio
29
29
30
30
To connect your Unify space to Twilio, follow the [Set up your Segment space](https://www.twilio.com/docs/unified-profiles/segment-space){:target="_blank"} instructions in the Unified Profiles documentation.
31
31
32
-
By connecting your Unify space to Twilio, you will create a Unified Profiles Service and can now use Unified Profiles in Flex and Studio.
32
+
By connecting your Unify space to Twilio, you can create a Unified Profiles Service and can use Unified Profiles in Flex and Studio.
33
33
34
34
Before leaving Segment, note the following information about your Segment workspace and Unify space:
35
35
@@ -51,7 +51,7 @@ After you've connected your Unify space to Twilio, you can connect additional da
51
51
> This section is about setting up sources and destinations to link to your Unify space. If you have an existing Segment Unify space with these connections that you'd like to use, proceed directly to [Optional: Create computed traits and Predictions](#optional-create-computed-traits-and-predictions).
52
52
53
53
### Connect a cloud app or library source
54
-
54
+
To connect a cloud app or library source:
55
55
1. From the [catalog page in your workspace](https://app.segment.com/goto-my-workspace/sources/), select your preferred business tool and click **Add Source**.
56
56
2. Enter a name for your source, fill in any additional settings, and click **Add Source**.
57
57
@@ -65,7 +65,7 @@ To extract customer data from your warehouse, you must:
65
65
2.[**Add a Segment Profiles destination**](#add-a-segment-profiles-destination): When you connect a Segment Profiles destination to your Reverse ETL source, you can send your warehouse data back to Segment to create and update [Profiles](/docs/profiles/) that can then be accessed through the [Profile API](/docs/profiles/profile-api/) and activated within [Unified Profiles](https://www.twilio.com/docs/unified-profiles){:target="_blank"}.
66
66
67
67
#### Add a Reverse ETL source
68
-
68
+
To add a Reverse ETL source:
69
69
1. In the [Reverse ETL section of the Sources catalog](https://app.segment.com/goto-my-workspace/sources/catalog?category=Reverse%20ETL), select your preferred data warehouse and click **Add Source**.
70
70
2. Give your source a name and enter the credentials for a user with read and write access to your database.
71
71
3. Click **Test Connection**. If Segment can successfully connect to your warehouse, click **Add Source**.
@@ -77,12 +77,12 @@ To extract customer data from your warehouse, you must:
77
77
78
78
#### Add a Segment Profiles destination
79
79
80
-
Create a Segment Profiles destination to add a mapping to your Reverse ETL source.
80
+
Create a Segment Profiles destination to add a mapping to your Reverse ETL source. To add a Segment Profiles destination:
81
81
82
82
1. From the [catalog page in your workspace](https://app.segment.com/goto-my-workspace/destinations/catalog/actions-segment-profiles), select the Segment Profiles destination and click **Add destination**.
83
-
2. On the Choose Data Source page, select your data source you set up in the previous steps and click **Next**.
83
+
2. On the **Choose Data Source** page, select your data source you set up in the previous steps and click **Next**.
84
84
3. Enter a name for your destination and click **Create destination**.
85
-
4. On the Mappings tab, click **Add Mapping**.
85
+
4. On the **Mappings** tab, click **Add Mapping**.
86
86
5. Search for the model you created when you added your Reverse ETL source, select **Send Identify** and click **Create Mapping**.
87
87
6. You're redirected to the Edit Mapping page. Under the Select mappings section, map event fields from your data source to the pre-filled values that Segment expects to receive. Add additional traits by entering your properties and event names in the Traits section. Clicking into an event field lets you search your destination's record fields.
88
88
**(Optional)**: To test your mapping, click the **Test Mapping** button.
@@ -113,12 +113,12 @@ To create a computed trait:
113
113
2. Click **Create computed trait**.
114
114
3. Select the type of event you'd like to create and click **Next**.
115
115
4. Select an event to be the base of your computed trait.
116
-
5. Add conditions and an optionally, an event property.
116
+
5. Add conditions and optionally, an event property.
117
117
-**Conditions**: These restrict the messages considered when calculating the final value of a computed trait. For more information, see the [Conditions](/docs/unify/traits/computed-traits/#conditions) documentation.
118
118
-**Event properties**: These refine the computed traits to include only the specified properties.
119
119
6. Verify that your trait contains at least one member by clicking the **Preview Trait** button.
120
120
7. When you've verified that your trait contains at least one member, click **Next**.
121
-
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
121
+
8. On the **Select Destinations** page, don't add a destination. Instead, click **Next**.
122
122
9. Enter a name for your trait and click **Create Trait**.
123
123
124
124
#### Computed Traits for Flex
@@ -187,7 +187,7 @@ Create a Last trait based on the "Flex - Engagement Completed" event and add the
187
187
-**Event property**: sentiment
188
188
-**Value**: Text
189
189
190
-
If you have the [Twilio Engage addon](https://segment.com/pricing/customer-data-platform/){:target="_blank"}, you can use [Audiences](docs/engage/audiences/) to build a cohort of Profiles that all share a computed trait.
190
+
If you have the [Twilio Engage add-on](https://segment.com/pricing/customer-data-platform/){:target="_blank"}, you can use [Audiences](docs/engage/audiences/) to build a cohort of Profiles that all share a computed trait.
191
191
192
192
For example, you could personalize the marketing your customers receive by creating an Audience of the Profiles that have a frequent inbound channel computed trait of `email` and sending those customers a promotion over email for your newest product.
193
193
@@ -208,7 +208,7 @@ You can use the following tools to debug issues you may encounter while configur
208
208
209
209
### Source debugger
210
210
211
-
The Source debugger is a real-time tool that helps you confirm that API calls made from your website, mobile app, or servers arrive at your Segment source, so you can troubleshoot your Segment connections. With the debugger, you can check that calls are sent in the expected format without having to wait for any data processing.
211
+
The Source debugger is a real-time tool that helps you confirm that API calls made from your website, mobile app, or servers arrive at your Segment source, so you can troubleshoot your Segment connections. With the debugger, you can check that calls send in the expected format without having to wait for any data processing.
212
212
213
213
For more information about the Source debugger, see the [Source debugger](/docs/connections/sources/debugger) documentation.
0 commit comments