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/engage/quickstart.md
+16-15Lines changed: 16 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ redirect_from:
5
5
- "/personas/quickstart"
6
6
---
7
7
8
-
This guide walks you through the set up process for a simple Engage space, which you can use if your Segment implementation is simple. If your implementation is complex, you can use this to demonstrate and test Engage before working on a more complex configuration.
8
+
This guide walks you through the set up process for a simplified Engage space. If your implementation is complex, use this to demonstrate and test Engage before working on a more complex configuration.
9
9
10
10
> success ""
11
11
> The first four steps in this guide also apply to Profiles set up. To learn more, visit the [Profiles Onboarding Guide](/docs/profiles/quickstart).
@@ -14,16 +14,16 @@ This guide walks you through the set up process for a simple Engage space, which
14
14
> info ""
15
15
> Engage requires both [Connections](/docs/connections/) and [Profiles](/docs/profiles/).
16
16
17
-
To configure and use Engage, you need the following:
17
+
The following are prerequisites to configuring and using Engage:
18
18
19
-
1.**A Segment account and Workspace.**
20
-
2.**Events flowing into Connections** from your digital properties where most of your valuable user behavior occurs.
21
-
3.**Profiles identity admin access.** You must have edit access to identity resolution rules.
22
-
4.**Engage Administrator access.** You must be either be a workspace admin, or a workspace user with Engage admin access to set up audiences and computed traits. You can check your permissions by navigating to [Access Management](https://app.segment.com/goto-my-workspace/settings/access-management){:target="_blank"} in your workspace settings. See the [Segment Access Management documentation](/docs/segment-app/iam/) for more details.
19
+
-**A Segment account and Workspace.**
20
+
-**Events flowing into Connections** from your digital properties where most of your valuable user behavior occurs.
21
+
-**Profiles identity admin access.** You must have edit access to identity resolution rules.
22
+
-**Engage Administrator access.** You must be either be a workspace admin, or a workspace user with Engage admin access to set up audiences and computed traits. You can check your permissions by navigating to [Access Management](https://app.segment.com/goto-my-workspace/settings/access-management){:target="_blank"} in your workspace settings. See [Segment Access Management](/docs/segment-app/iam/) for more details.
23
23
24
24
## Step 1: Create a new Developer space
25
25
26
-
When you first start working with Engage, you should start by creating a "Developer" Engage space. This is your experimental and test environment while you learn more about how Engage works.
26
+
When you first start working with Engage, start by creating a "Developer" Engage space. This is your experimental and test environment while you learn more about how Engage works.
27
27
28
28
<!-- TODO: I can't see this in any of the spaces I'm an admin in
29
29
To create a Engage space:
@@ -38,16 +38,17 @@ Invite teammates to your Engage dev space and grant them access to the space. Na
38
38
39
39
## Step 3: Connect production sources
40
40
41
-
1. On the left sidebar click **Profiles**, click **Profiles Settings**, click the **Sources** tab, and then click the blue **+ Add Source** button.
42
-
2. On the screen that appears, choose one or two production sources from your Connections workspace.
43
-
Segment recommends connecting your production website or App source as a great starting point.
44
-
_The flag **Replay data** is enabled by default, **Replay data : Enable this option to replay last month of data into Profiles for every selected source below.** When left enabled, 30 days of historical data will be replayed from the source._
41
+
1. On the left sidebar navigate to **Profiles** > **Profiles Settings** > **Sources** > **+ Add Source**.
42
+
2. Choose one or two production sources from your Connections workspace.
43
+
44
+
Segment recommends connecting your production website or App source as a great starting point.
45
+
_The flag **Replay data** is enabled by default, **Replay data : Enable this option to replay the last month of data into Profiles for every selected source below.** When left enabled, 30 days of historical data will be replayed from the source._
45
46
46
47
To learn more, visit [Connect production sources](/docs/profiles/quickstart/#step-3-connect-production-sources).
47
48
48
49
## Step 4: Check your profile data
49
50
50
-
Once the replay finishes, you can see the data replayed into Engage using the Profile Explorer. Visit the [Profiles Onboarding Guide](/docs/profiles/quickstart/#step-4-check-your-profile-data) for more info.
51
+
After the replay finishes, you can see the data replayed into Engage using the Profile Explorer. Visit the [Profiles Onboarding Guide](/docs/profiles/quickstart/#step-4-check-your-profile-data) for more info.
51
52
52
53
## Step 5: Create an Audience
53
54
@@ -69,12 +70,12 @@ To build your own audience:
69
70
4. Configure the settings for your condition. These vary by type, so explore the different options.
70
71
5. Optionally, add more conditions until you're satisfied that the audience will only contain the users you want to target.
71
72
72
-
Once you build your audience, click **Preview Results** to see the total number of users who meet the audience criteria, for example all users who signed up within the last seven days.
73
+
After you build your audience, click **Preview Results** to see the total number of users who meet the audience criteria, for example all users who signed up within the last seven days.
73
74
74
75
75
76
## Step 6: Connect the Audience to a Destination
76
77
77
-
Once you create your test audience, click **Select Destinations**. Engage guides you through configuration steps to set up a destination for your audience. If you don't already have destinations configured for the Engage space, the you are prompted to select one or more. Finally, enter a name for the audience.
78
+
After you create your test audience, click **Select Destinations**. Engage guides you through configuration steps to set up a destination for your audience. If you don't already have destinations configured for the Engage space, the you are prompted to select one or more. Finally, enter a name for the audience.
78
79
79
80
The larger the audience you're creating, the longer it takes Engage to successfully compute the Audience. The Audience page shows a status that indicates if the audience is still being calculated. When the total number of users appears in the Audience overview, as in the example screenshot below, the audience has successfully finished computing, and Engage then sends the audience to the destination you selected.
80
81
@@ -90,4 +91,4 @@ The UIs for the destination tools you send the audience data to are different, s
90
91
91
92
## Step 8: Create your production space
92
93
93
-
Once you validate that your full audience is arriving in your destination, you're ready to create a Production space. Segment recommends that you repeat the same steps outlined above, focusing on your production use cases and data sources.
94
+
After you validate that your full audience is arriving in your destination, you're ready to create a Production space. Segment recommends that you repeat the same steps outlined above, focusing on your production use cases and data sources.
0 commit comments