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/getting-started/01-what-is-segment.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
---
2
-
title: How Segment Works
2
+
title: How Segment works
3
3
---
4
4
5
-
In a nutshell, the Segment libraries ([Sources](/docs/connections/sources/catalog/)) generate messages about what's happening in your site or app, and send them to the Segment servers. Segment then translates the content of those messages into different formats for use by other tools (which Segment calls[Destinations](/docs/connections/destinations/)), and sends the translated messages to those tools. The Segment servers also archive a copy of the data, and can [send data to your storage systems](/docs/connections/storage/) (such as databases, warehouses, or bulk-storage buckets).
5
+
In short, the Segment libraries (called [Sources](/docs/connections/sources/catalog/)) generate messages about activity in your site or app, and send them to the Segment servers. Segment then translates the content of those messages into different formats for use by other tools (called[Destinations](/docs/connections/destinations/)), and sends the translated messages to those tools. The Segment servers also archive a copy of the data, and can [send data to your storage systems](/docs/connections/storage/) (such as databases, warehouses, or bulk-storage buckets).
6
6
7
7
8
8
## Overview
@@ -46,14 +46,14 @@ When you collect data using device-based libraries, you can choose between these
46
46
***Cloud-mode** is where the library sends the data directly to the Segment servers which then translate and forward it.
47
47
***Device-mode** is where the library sends the data both directly to the Segment servers, and also to the servers for the destination tool. Device-mode sometimes requires some [additional set-up steps](/docs/connections/sources/mobile_guide/), but can unlock rich device data.
48
48
49
-
Although there are some tradeoffs between the two approaches, neither is better than the other, and Segment recommends that you implement a mix of both. In general, more direct interaction data is available using a device-based library, but server-based collection is more secure, reliable, and can't be blocked by ad blockers.
49
+
Although there are some tradeoffs between the two approaches, neither is better than the other, and we recommend that you implement a mix of both. In general, more direct interaction data is available using a device-based library, but server-based collection is more secure, reliable, and can't be blocked by ad blockers.
50
50
51
51
<!-- Here's a handy flow chart to help with the client-side/server-side decision:
52
52
53
53
TODO: Image removed, didn't work with formatting. need a better version of this flowchart or else to just omit?-->
54
54
55
55
56
-
## The Segment methods
56
+
## Segment methods
57
57
58
58
The Segment libraries generate messages about what happens on your interface, translate those messages into different formats for use by destinations, and transmit the messages to those tools.
59
59
@@ -71,7 +71,7 @@ Segment maintains a catalog of destinations where you can send your data.
71
71
72
72
<!--TODO: big list o' destinations image (programmatically update?) should go here-->
73
73
74
-

74
+

0 commit comments