Skip to content

Commit 546f299

Browse files
authored
Update data-graph.md
1 parent a5014cb commit 546f299

File tree

1 file changed

+8
-28
lines changed

1 file changed

+8
-28
lines changed

src/unify/data-graph/data-graph.md

Lines changed: 8 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -7,24 +7,16 @@ redirect_from:
77
- '/unify/linked-profiles/data-graph'
88
---
99

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.
1511

1612
> info ""
1713
> Data Graph currently only supports workspaces in the United States.
1814
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-
2115
The Data Graph powers:
2216

2317
- [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.
2418
- [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.
2519

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-
2820
> warning ""
2921
> Don't send any personal health information with the Data Graph.
3022
@@ -33,43 +25,31 @@ To help you get started with the Data Graph, [view this short setup demo](https:
3325
To use the Data Graph, you'll need the following:
3426

3527
- 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.
3729
- Workspace Owner or Unify Read-only/Admin and Entities Admin permissions.
3830

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
4332

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:
4534

4635
- [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.
4736
- [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.
4837

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.
5239

5340
## Step 2: Connect your warehouse to the Data Graph
5441

5542
To connect your warehouse to the Data Graph:
5643

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.
5945
2. Click **Connect warehouse**.
6046
3. Select your warehouse type.
61-
**Note:** Linked Audiences only supports Snowflake.
6247
4. Enter your warehouse credentials.
6348
5. Test your connection, then click **Save**.
6449

6550
## Step 3: Build your Data Graph
6651

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.
7353

7454
### Define entities
7555

@@ -165,7 +145,7 @@ Next, relate Profiles to Entities to model relationships between your Profiles a
165145
A profile can be related to an entity in two ways:
166146

167147
**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.
169149
- `join_key`: This is the column on the entity table that you are matching to the external identifier.
170150

171151
Example:

0 commit comments

Comments
 (0)