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/connections/spec/common.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -139,7 +139,7 @@ Context is a dictionary of extra information that provides useful context about
139
139
|`active`| Boolean | Whether a user is active. <br><br> This is usually used to flag an `.identify()` call to just update the traits but not "last seen." |
140
140
|`app`| Object | dictionary of information about the current application, containing `name`, `version`, and `build`. <br><br> This is collected automatically from the mobile libraries when possible. |
141
141
|`campaign`| Object | Dictionary of information about the campaign that resulted in the API call, containing `name`, `source`, `medium`, `term`, `content`, and any other custom UTM parameter. <br><br> This maps directly to the common UTM campaign parameters. |
142
-
|`device`| Object | Dictionary of information about the device, containing `id`, `advertisingId`, `manufacturer`, `model`, `name`, `type`, and `version`. |
142
+
|`device`| Object | Dictionary of information about the device, containing `id`, `advertisingId`, `manufacturer`, `model`, `name`, `type`, and `version`. <br><br> **Note:**`model` for iOS may not exactly correspond to an iPhone model number. For example, an `iPhone 15 Pro Max` has a model number of `iPhone16,2`. These values are set by iOS. |
143
143
|`ip`| String | Current user's IP address. |
144
144
|`library`| Object | Dictionary of information about the library making the requests to the API, containing `name` and `version`. |
145
145
|`locale`| String | Locale string for the current user, for example `en-US`. |
@@ -258,7 +258,7 @@ Every API call has four timestamps, `originalTimestamp`, `timestamp`, `sentAt`,
|`originalTimestamp`| Time on the client device when call was invoked <br> **OR** <br> The `timestamp` value manually passed in through server-side libraries. | Used by Segment to calculate `timestamp`. <br><br> **Note:**`originalTimestamp` is not useful for analysis since it's not always trustworthy as it can be easily adjusted and affected by clock skew. |
261
-
|`sentAt`| Time on client device when call was sent. <br> **OR** <br> `sentAt` value manually passed in. | Used by Segment to calculate `timestamp`. <br><br> **Note:**`sentAt` is not useful for analysis since it's not always trustworthy as it can be easily adjusted and affected by clock skew. |
261
+
|`sentAt`| Time on client device when call was sent. <br> **OR** <br> `sentAt` value manually passed in. | Used by Segment to calculate `timestamp`. <br><br> **Note:**`sentAt` is not useful for analysis since it's not always by clock skew. |
262
262
|`receivedAt`| Time on Segment server clock when call was received | Used by Segment to calculate `timestamp`, and used as sort key in Warehouses. <br><br> **Note:** For max query speed, `receivedAt` is the recommended timestamp for analysis when chronology does not matter as chronology is not ensured. |
263
263
|`timestamp`| Calculated by Segment to correct client-device clock skew using the following formula:<br> `receivedAt` - (`sentAt` - `originalTimestamp`) | Used by Segment to send to downstream destinations, and used for historical replays. <br><br>**Note:** Recommended timestamp for analysis when chronology does matter. |
0 commit comments