Skip to content

Commit 68953bf

Browse files
authored
Add explanation for Device ID coalesce
Added explanation for the `coalesce` function in the Device ID field, to clear up customer confusion.
1 parent de1c75c commit 68953bf

File tree

1 file changed

+4
-0
lines changed
  • src/connections/destinations/catalog/actions-amplitude

1 file changed

+4
-0
lines changed

src/connections/destinations/catalog/actions-amplitude/index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,10 @@ Session tracking is only available when using Segment's new libraries: [Analytic
4545
Once you have a mapping, you can follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
4646

4747

48+
### Mappings for Device ID
49+
The Amplitude destination requires that each event includes either a Device ID or a User ID. If a User ID is not present, a Device ID will be used, and vice versa. By default, Segment maps the Segment property `context.device.id` to the Amplitude property `Device ID`. If `context.device.id` is not available, Segment will map the property `anonymousId` to the Amplitude `Device ID`. This is indicated by the following text in the Device ID field: `coalesce(` `context.device.id` `anonymousId` `)`. In future, you will be able to specify the default property and additional fallback properties should the higher-priority fallback(s) not be available.
50+
51+
4852
### Enable session tracking for Analytics.js 2.0
4953

5054
The session tracking is automatically enabled on Javascript sources.

0 commit comments

Comments
 (0)