Skip to content

Commit 44aca80

Browse files
authored
Merge pull request #4593 from segmentio/profiles-sync-updates
Update Profiles Sync headers
2 parents fd4b286 + 91956d3 commit 44aca80

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

src/unify/profiles-sync/tables.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Using a practical example of how Segment connects and then merges anonymous prof
99

1010
## Case study: anonymous site visits lead to profile merge
1111

12-
To help illustrate the possible entries and values populated into Profiles Sync tables, consider the following scenario.
12+
To help illustrate the possible entries and values populated into Profiles Sync tables, view the event tabs below and consider the following scenario.
1313

1414
Suppose the following four events lead to the creation of two separate profiles:
1515

@@ -79,7 +79,7 @@ Profiles Sync tracks and provides information about these events through a set o
7979

8080
Using the events from the profile merge case study, Segment would land the following tables as part of Profiles Sync.
8181

82-
### The `id_graph_updates` table
82+
### The id_graph_updates table
8383

8484
The `id_graph_updates` table maps between the following:
8585

@@ -109,7 +109,7 @@ Segment shows the complete history of every profile. If, later, `profile_1` merg
109109

110110
If you’ll use Profiles Sync to build models, refer to the `id_graph` model, which can help you put together a complete view of a customer.
111111

112-
### The `external_id_mapping_updates` table
112+
### The external_id_mapping_updates table
113113

114114
This table maps Segment-generated identifiers, like `segment_id`, to external identifiers that your users provide.
115115

@@ -127,7 +127,7 @@ The anonymous site visits sample used earlier would generate the following event
127127

128128
In this table, Segment shows three observed identifiers. For each of the three identifiers, Segment outputs the Segment ID initially associated with the identifier.
129129

130-
### `identifies`, `page`, `screens`, and track tables
130+
### The identifies, page, screens, and track tables
131131

132132
These tables show the instrumented events themselves. Entries in these tables reflect payloads that you instrument according to the Segment spec.
133133

@@ -189,11 +189,11 @@ Follow the steps below to change your schema name:
189189
> To get started with your table materializations, try Segment's [open-source dbt models](https://github.com/segmentio/profiles-sync-dbt){:target="_blank"}, or materialize views with your own tools.
190190
191191
> warning ""
192-
> Please note that dbt models are in beta and need modifications to run efficiently on BigQuery, Synapse, and Postgres warehouses. Segment is actively working on this feature.
192+
> Please note that dbt models are in beta and need modifications to run efficiently on BigQuery, Synapse, and Postgres warehouses. Segment is actively working on this feature.
193193
194194
Every customer profile (or `canonical_segment_id`) will be represented in each of the following tables.
195195

196-
### `id_graph` table
196+
### The id_graph table
197197

198198
This table represents the current state of your identity graph, showing only where a `segment_id` is now understood to point.
199199

@@ -204,9 +204,10 @@ The most recent entry for each `segment_id` from `id_graph_updates` reflects thi
204204
| `profile_1` | `profile_1` | 2022-05-02 14:01:00 |
205205
| `profile_2` | `profile_1` | 2022-06-22 10:48:00 |
206206

207+
207208
Segment drops most diagnostic information from this table, since it’s designed for reference use. In this case, you’d learn that any data references to `profile_2` or `profile_1` now map to the same customer, `profile_1`.
208209

209-
### `external_id_mapping` table
210+
### The external_id_mapping table
210211

211212
Use this table to view the full, current-state mapping between each external identifier you’ve observed and its corresponding, fully-merged `canonical_segment_id`.
212213

@@ -219,7 +220,7 @@ In the case study example, you’d see the following:
219220
| `profile_1` | `anonymous_id` | `b50e18a5-1b8d-451c` | `2022-06-22 10:48:00` |
220221

221222

222-
### `profile_traits` table
223+
### The profile_traits table
223224

224225
Use the `profile_traits` table for a singular view of your customer. With this table, you can view all custom traits, computed traits, SQL traits, audiences, and journeys associated with a profile in a single row.
225226

0 commit comments

Comments
 (0)