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/unify/linked-profiles/data-graph.md
+17-10Lines changed: 17 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,15 +5,16 @@ beta: true
5
5
---
6
6
7
7
> info "Segment's Data Graph is in private beta"
8
-
> The Data Graph is in private beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available. [Contact Segment](https://segment.com/help/contact/){:target="_blank"} with any feedback or questions.
8
+
> The Data Graph is in private beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
9
9
10
10
With Linked Profiles, you can build a Data Graph that defines relationships between any entity data set in the warehouse and the Segment Profiles you send with Profiles Sync.
11
11
12
12
Make this relational data accessible to marketers and business stakeholders to empower them with the data they need to create targeted and personalized customer engagements.
13
13
14
-
> success ""
14
+
> info ""
15
15
> Segment's Data Graph powers [Linked Events](/docs/unify/linked-profiles/linked-events/) and [Linked Audiences](/docs/engage/audiences/linked-audiences/).
16
16
17
+
17
18
## Prerequisites
18
19
19
20
To use the Data Graph, you'll need the following:
@@ -69,8 +70,6 @@ The Data Graph is a semantic layer that represents a subset of relevant business
69
70
70
71
Use the configuration language spec below to add models to build your Data Graph. The Data Graph currently supports 4 layers of depth, including the Profile entity.
|`profile_folder`| This is the folder or schema location for the profile tables. |
89
-
|`materialization`| Identifies the type of materialization (`dbt`,`segment`,`none`). |
88
+
|`materialization`| Identifies the type of materialization (`none`). |
90
89
91
90
Example:
92
91
@@ -118,12 +117,19 @@ Example:
118
117
```python
119
118
# Define an entity and optionally indicate if the entity will be referenced for Linked Events (event enrichment)
120
119
120
+
data_graph {
121
+
# Entities are nested under the data_graph
121
122
entity "account-entity" {
122
123
name = "account"
123
124
table_ref = "PRODUCTION.CUST.ACCOUNT"
124
125
primary_key = "id"
125
126
enrichment_enabled = true
126
127
}
128
+
129
+
profile {
130
+
# Relationships are nested under the profile
131
+
}
132
+
}
127
133
```
128
134
129
135
### Relate entities
@@ -141,9 +147,11 @@ Use the following relationship, parameters, and examples to help you relate enti
141
147
142
148
143
149
A profile can be related to an entity in two ways:
144
-
1. With an `external_id`: Define the external ID that will be used to join the profile with your entity.
150
+
- With an `external_id`: Define the external ID that will be used to join the profile with your entity.
145
151
-`type`: Identify the external ID type (`email`, `phone`, `user id`). This corresponds to the `external_id_type` column in your `external_id_mapping` table.
146
-
Example:
152
+
-`join_key`: This is the column on the entity table that you are matching to the external identifier.
153
+
154
+
Example:
147
155
148
156
```python
149
157
data_graph {
@@ -160,10 +168,9 @@ data_graph {
160
168
type = "email"
161
169
join_key = "email_id"
162
170
}
171
+
}
163
172
```
164
-
-`join_key`: This is the column on the entity table that you are matching to the external identifier.
165
-
166
-
2. With a `trait`: Define a profile trait that will be used to join the profile with your entity.
173
+
- With a `trait`: Define a profile trait that will be used to join the profile with your entity.
167
174
-`name`: The trait name that corresponds to a column name in your `profile_traits_updates` table.
168
175
-`join_key`: This is the column on the entity table that you are matching to the trait.
Copy file name to clipboardExpand all lines: src/unify/linked-profiles/linked-events.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ plan: unify
5
5
---
6
6
7
7
> info "Linked Events is in private beta"
8
-
> Linked Events is in private beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available. [Contact Segment](https://segment.com/help/contact/){:target="_blank"} with any feedback or questions.
8
+
> Linked Events is in private beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
9
9
10
10
11
11
Use Linked Events to enrich real-time event streams with entities from your data warehouse to your destinations. Insert additional event context for downstream applications for richer data about each event.
@@ -29,7 +29,7 @@ Before getting started with Linked Events, you'll need:
29
29
30
30
1.[BigQuery](/docs/unify/linked-profiles/setup-guides/bigquery-setup/), [Snowflake](/docs/unify/linked-profiles/setup-guides/snowflake-setup/), or [Redshift](/docs/unify/linked-profiles/setup-guides/redshift-setup/) data warehouse credentials with **write** access.
31
31
2. Access to Unify in your workspace.
32
-
3. Access to the Destination you'll be using with Linked Events so that you can validate your data.
32
+
3. Access to the actions-based destination you'll be using with Linked Events so that you can validate your data.
33
33
34
34
> info ""
35
35
> Segment stores and processes all data in the United States.
@@ -53,11 +53,11 @@ To create models and enrich events in destinations, you need to be a `Workspace
53
53
> info ""
54
54
> Linked Events uses Segment's [Reverse ETL](/docs/connections/reverse-etl/) infrastructure for pulling in data from your warehouse.
55
55
56
-
To get started, you'll need to connect a data warehouse. Linked Events supports [BigQuery](/docs/unify/linked-profiles/setup-guides/bigquery/), [Snowflake](/docs/unify/linked-profiles/setup-guides/snowflake/), and [Redshift](/docs/unify/linked-profiles/setup-guides/redshift-setup/).
56
+
To get started, you'll need to connect a data warehouse. Linked Events supports [BigQuery](/docs/unify/linked-profiles/setup-guides/bigquery-setup/), [Snowflake](/docs/unify/linked-profiles/setup-guides/snowflake-setup/), and [Redshift](/docs/unify/linked-profiles/setup-guides/redshift-setup/).
57
57
58
58
1. Navigate to **Unify > Data graph** and click **Add warehouse**.
59
59
2. Select a warehouse to connect from the [supported data warehouses](#supported-data-warehouses).
60
-
3.[Connect your warehouse](#connect-your-warehouse).
60
+
3. Connect your warehouse.
61
61
3. Click **Test Connection** to be sure your warehouse is connected.
62
62
4. After a successful test, click **Save**.
63
63
@@ -80,14 +80,14 @@ The table below shows the data warehouses Linked Events supports. View the Segme
|[Snowflake](docs/unify/linked-profiles/setup-guides/snowflake-setup/)| 1. Configure your snowflake database. <br> 2. Enter your credentials. <br> 3. Test the Connection. <br> 4. Click **Save**. |
83
+
|[Snowflake](/docs/unify/linked-profiles/setup-guides/snowflake-setup/)| 1. Configure your snowflake database. <br> 2. Enter your credentials. <br> 3. Test the Connection. <br> 4. Click **Save**. |
84
84
|[BigQuery](/docs/unify/linked-profiles/setup-guides/bigquery-setup/)| 1. Add your credentials to the database that has tables with the entities you want to enrich your event with. <br> 2. Test your connection. |
85
85
|[Redshift](/docs/unify/linked-profiles/setup-guides/redshift-setup/)| 1. Select the Redshift cluster you want to connect. <br> 2. [Configure](/docs/connections/storage/catalog/redshift/#networking) the correct network and security settings. |
86
86
87
87
88
88
## Step 2: Build your Data Graph
89
89
90
-
The [Data Graph](/unify/linked-profiles/data-graph/) is a semantic layer that represents a subset of relevant business data that you'll use to enrich events in downstream tools. Use the configuration language spec below to add models to build out your Data Graph.
90
+
The [Data Graph](/docs/unify/linked-profiles/data-graph/) is a semantic layer that represents a subset of relevant business data that you'll use to enrich events in downstream tools. Use the configuration language spec below to add models to build out your Data Graph.
91
91
92
92
Each Unify space has one Data Graph. The current version is v0.0.6 but this may change in the future as Segment accepts feedback about the process.
0 commit comments