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/data-graph/data-graph.md
+8-28Lines changed: 8 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,24 +7,16 @@ redirect_from:
7
7
- '/unify/linked-profiles/data-graph'
8
8
---
9
9
10
-
<!-- New stuff here -->
11
-
12
-
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](/docs/unify/profiles-sync/overview/). 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
-
14
-
Using the Data Graph, you can reflect your business in your data model. The Data Graph enables businesses to map and understand the relationships between different datasets about their customers (accounts, subscriptions, households, products), and tie rich entity context back to the profile.
10
+
The Data Graph is a semantic layer unifying all of your customer datasets. With the Data Graph, you can define relationships between any entity data set in the warehouse and the Segment Profiles you send with Profiles Sync. The Data Graph enables businesses to map and understand the relationships between different datasets about their customers (accounts, subscriptions, households, products, etc.), and tie rich entity context back to the profile. The Data Graph allows you to make this relational data accessible to marketers and business stakeholders to empower them with all the data they need to create targeted and personalized customer engagements.
15
11
16
12
> info ""
17
13
> Data Graph currently only supports workspaces in the United States.
18
14
19
-
Using Data Graph, you only need to define the relationships between data sets one time to make data accessible to marketers and business stakeholders to build targeted and personalized customer engagements.
20
-
21
15
The Data Graph powers:
22
16
23
17
-[Linked Audiences](/docs/engage/audiences/linked-audiences/): enables marketers to build targeting logic based on data points available in the data graph in a self-service way. Start by building a [Data Graph](/docs/unify/data-graph/data-graph/) that defines relationships between any data set in the warehouse and the Segment Profiles you send with Profiles Sync. From there, use Linked Audiences to unlock a world of new hyper-personalized campaigns.
24
18
-[Linked Events](/docs/unify/data-graph/linked-events/): enables data teams to enrich event streams, in real time, with any data set coming from a data warehouse or data lake, and send those enriched events to any Destination. Start by building a [Data Graph](/docs/unify/data-graph/data-graph/) with the data models you want to use, and then use set up the enrichment in Destinations or Functions.
25
19
26
-
To help you get started with the Data Graph, [view this short setup demo](https://drive.google.com/file/d/1oZNvs0raYaxK6tds3OEF0Ri3NGVCoXys/view?pli=1){:target="_blank"}.
27
-
28
20
> warning ""
29
21
> Don't send any personal health information with the Data Graph.
30
22
@@ -33,43 +25,31 @@ To help you get started with the Data Graph, [view this short setup demo](https:
33
25
To use the Data Graph, you'll need the following:
34
26
35
27
- A supported data warehouse.
36
-
-(If setting up Linked Audiences)[Profiles Sync](/docs/unify/profiles-sync/) set up with ready-to-use [data models and tables](/docs/unify/profiles-sync/tables/) in your warehouse.
28
+
- If using Linked Audiences,[Profiles Sync](/docs/unify/profiles-sync/)will need to be set up with ready-to-use [data models and tables](/docs/unify/profiles-sync/tables/) in your warehouse. Profiles Sync is not required for Linked Events.
37
29
- Workspace Owner or Unify Read-only/Admin and Entities Admin permissions.
38
30
39
-
> info ""
40
-
> Profiles Sync is not required for Linked Events.
41
-
42
-
## Step 1: Set up required permissions in your data warehouse
31
+
## Step 1: Set up Data Graph permissions in your data warehouse
43
32
44
-
To get started, set up the required permissions:
33
+
While Linked Audiences uses [Segment's Reverse ETL](/docs/connections/reverse-etl/) infrastructure to pull data from your warehouse, additional permissions are still required for Linked Audiences and Linked Events. To get started, set up the required permissions:
45
34
46
35
-[Snowflake](/docs/unify/data-graph/setup-guides/snowflake-setup/) and [Databricks](/docs/unify/data-graph/setup-guides/databricks-setup/) are supported by both Linked Events and Linked Audiences.
47
36
-[Redshift](/docs/unify/data-graph/setup-guides/redshift-setup/) and [BigQuery](/docs/unify/data-graph/setup-guides/BigQuery-setup/) are currently supported for Linked Events.
48
37
49
-
Linked Audiences uses [Segment's Reverse ETL](/docs/connections/reverse-etl/) infrastructure to pull data from your warehouse.
50
-
51
-
To track what data has been sent to Segment on previous syncs, Segment stores delta/diffs in tables within a single schema called `_segment_reverse_etl` in your data warehouse. You can choose which database/project in your warehouse this data lives in.
38
+
To track what data has been sent to Segment on previous syncs, Segment stores diffs in tables within a single schema called `_segment_reverse_etl` in your data warehouse. You can choose which database or project in your warehouse this data lives in.
52
39
53
40
## Step 2: Connect your warehouse to the Data Graph
54
41
55
42
To connect your warehouse to the Data Graph:
56
43
57
-
1. Navigate to **Unify > Data Graph**.
58
-
This should be a Unify space with Profiles Sync already set up.
44
+
1. Navigate to **Unify > Data Graph**. This should be a Unify space with Profiles Sync already set up.
59
45
2. Click **Connect warehouse**.
60
46
3. Select your warehouse type.
61
-
**Note:** Linked Audiences only supports Snowflake.
62
47
4. Enter your warehouse credentials.
63
48
5. Test your connection, then click **Save**.
64
49
65
50
## Step 3: Build your Data Graph
66
51
67
-
The Data Graph is a semantic layer that represents a subset of relevant business data that you'll use for audience targeting and personalization in downstream tools. Use the configuration language spec below to add models to build your Data Graph. The Data Graph currently supports 6 layers of depth, including the Profile entity. Warehouse schemas are case sensitive, so you'll need to reflect the schema, table, and column names based on how you case them in the warehouse.
68
-
69
-
To leverage the Data Graph auto-complete feature, begin typing or use the following keyboard shortcuts to autocomplete the profile_folder and table_ref properties.
70
-
71
-
- Mac: Ctrl + Space
72
-
- Windows: Alt + Esc
52
+
The Data Graph is a semantic layer that represents a subset of relevant business data that marketers and business stakeholders can use for audience targeting and personalization in downstream tools. Use the configuration language spec below to build your Data Graph. The Data Graph currently supports 6 layers of depth, including the Profile entity.
73
53
74
54
### Define entities
75
55
@@ -165,7 +145,7 @@ Next, relate Profiles to Entities to model relationships between your Profiles a
165
145
A profile can be related to an entity in two ways:
166
146
167
147
**1. With an `external_id`**: Define the external ID that will be used to join the profile with your entity.
168
-
-`type`: Identify the external ID type (`email`, `phone`, `user_id`). This corresponds to the `external_id_type` column in your `external_id_mapping` table.
148
+
-`type`: Identify the external ID type (`email`, `phone`, `user id`). This corresponds to the `external_id_type` column in your `external_id_mapping` table.
169
149
-`join_key`: This is the column on the entity table that you are matching to the external identifier.
0 commit comments