Skip to content

Commit 59f3845

Browse files
committed
Cleanup from local testing
1 parent 993434b commit 59f3845

File tree

3 files changed

+23
-16
lines changed

3 files changed

+23
-16
lines changed

src/engage/images/conditions.png

5.09 KB
Loading

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

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,16 @@ beta: true
55
---
66

77
> 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.
99
1010
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.
1111

1212
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.
1313

14-
> success ""
14+
> info ""
1515
> Segment's Data Graph powers [Linked Events](/docs/unify/linked-profiles/linked-events/) and [Linked Audiences](/docs/engage/audiences/linked-audiences/).
1616
17+
1718
## Prerequisites
1819

1920
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
6970

7071
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.
7172

72-
> info "Using the Data Graph with Linked Events"
73-
If you're using
7473

7574
### Define entities
7675

@@ -86,7 +85,7 @@ The parameters are:
8685
| Parameters | Definition |
8786
| ----------- | --------------------------------------------------------------------- |
8887
| `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`). |
9089

9190
Example:
9291

@@ -118,12 +117,19 @@ Example:
118117
```python
119118
# Define an entity and optionally indicate if the entity will be referenced for Linked Events (event enrichment)
120119

120+
data_graph {
121+
# Entities are nested under the data_graph
121122
entity "account-entity" {
122123
name = "account"
123124
table_ref = "PRODUCTION.CUST.ACCOUNT"
124125
primary_key = "id"
125126
enrichment_enabled = true
126127
}
128+
129+
profile {
130+
# Relationships are nested under the profile
131+
}
132+
}
127133
```
128134

129135
### Relate entities
@@ -141,9 +147,11 @@ Use the following relationship, parameters, and examples to help you relate enti
141147

142148

143149
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.
145151
- `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:
147155

148156
```python
149157
data_graph {
@@ -160,10 +168,9 @@ data_graph {
160168
type = "email"
161169
join_key = "email_id"
162170
}
171+
}
163172
```
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.
167174
- `name`: The trait name that corresponds to a column name in your `profile_traits_updates` table.
168175
- `join_key`: This is the column on the entity table that you are matching to the trait.
169176

src/unify/linked-profiles/linked-events.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ plan: unify
55
---
66

77
> 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.
99
1010

1111
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:
2929

3030
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.
3131
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.
3333

3434
> info ""
3535
> 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
5353
> info ""
5454
> Linked Events uses Segment's [Reverse ETL](/docs/connections/reverse-etl/) infrastructure for pulling in data from your warehouse.
5555
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/).
5757

5858
1. Navigate to **Unify > Data graph** and click **Add warehouse**.
5959
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.
6161
3. Click **Test Connection** to be sure your warehouse is connected.
6262
4. After a successful test, click **Save**.
6363

@@ -80,14 +80,14 @@ The table below shows the data warehouses Linked Events supports. View the Segme
8080

8181
| Data Warehouse | Steps |
8282
|------------------------|-------------------------|
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**. |
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**. |
8484
| [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. |
8585
| [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. |
8686

8787

8888
## Step 2: Build your Data Graph
8989

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

9292
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.
9393

0 commit comments

Comments
 (0)