Skip to content

Commit 02a2bbb

Browse files
committed
organizing sections, rewriting intro
1 parent 49af249 commit 02a2bbb

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

src/connections/spec/alias.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: 'Spec: Alias'
33
---
44

5-
The Alias method is used to merge two unassociated user identities, effectively connecting two sets of user data as one. This is an advanced method used to manage user identities in some of Segment's destinations. Segment usually handles aliasing automatically when you call [Identify](/docs/connections/spec/identify/) on a user, however some tools require an explicit Alias call.
5+
The Alias method is an advanced method used to merge two unassociated user identities, effectively connecting two sets of user data in one profile.
66

77
> info "Alias is an advanced method"
88
> The Alias method allows you to explicitly change the ID of a tracked user. This should only be done when it's required for downstream destination compatibility. See the [Best Practices for Identifying Users](/docs/guides/how-to-guides/best-practices-identify/) docs for more information.
@@ -13,7 +13,7 @@ The Alias method is used to merge two unassociated user identities, effectively
1313
- [Mixpanel](/docs/connections/destinations/catalog/mixpanel#alias)
1414
- [Vero](/docs/connections/destinations/catalog/vero#alias)
1515
16-
TODO: ask if these are the only destinations that use it/if it is REQUIRED for any destination to use this method --->
16+
TODO: do more research on if this is required anywhere anymore. --->
1717

1818
## Syntax
1919

@@ -42,14 +42,15 @@ Here's the payload of a basic Alias call that will associate this user's existin
4242
}
4343
```
4444

45-
If you're instrumenting a website, the Anonymous ID is generated in the browser so you must call Alias from the client-side. If you're using a server-side session ID as the Anonymous ID, then you must Alias from the server-side.
46-
4745
Here's the corresponding JavaScript event that would generate the above payload. If you're using Segment's JavaScript library, Segment automatically passes in the user's `anonymousId` as `previousId` for you:
4846

4947
```js
5048
analytics.alias("507f191e81");
5149
```
5250

51+
If you're instrumenting a website, the Anonymous ID is generated in the browser so you must call Alias from the client-side. If you're using a server-side session ID as the Anonymous ID, then you must Alias from the server-side.
52+
53+
5354
{% include content/syntax-note.md %}
5455

5556
## Examples

0 commit comments

Comments
 (0)