In this article
Using permutive.identify
to sync user IDs.
Permutive assigns all users a unique ID which is used to track a user across multiple pageviews. If you want to take this a step further and track users across multiple browsers or devices, you can use your own identifier with Permutive. This is particularly useful if your site allows users to log in, as you will likely have your own ID for any user who has logged in.
Note: If a user is not logged in on your site and is browsing on multiple devices, they will be seen as different unique users.
To use your own user IDs with Permutive, a small technical change is needed on site. We provide a JavaScript function permutive.identify
which enables you to pass in your own custom ID.
if (USER_ID_AVAILABLE) {
window.permutive.identify([
{
id: '<USER_ID>',
tag: '<ID_TAG>',
priority: 1
}
])
}
- Include the above if a user ID is available on the page. You should call this function just before
window.permutive.addon(...)
- Please ensure that
USER_ID_AVAILABLE
only returns true if a non-empty user ID is available on the page. - The tag with the highest priority (lowest number) takes precedence. This will always take precedence over Permutive controlled tags
- Simply omit the
if (USER_ID_AVAILABLE) { ... }
code block on pages or environments where a user ID is not available. - Calling the
window.permutive.identify
only when a user logs in is sufficient - You must not use any public IDs (e.g. NO public profile ID, cleartext email addresses or forum IDs)
- Once an ID is mapped to a user, the relationship cannot be reversed. For that reason, please ensure the correct ID is mapped to each user, and if an ID is not available, nothing is mapped.
- Please have a look at our documents here for more information
Add alias Identifiers in the Dashboard
To use your own user IDs with Permutive, a small change is needed in the dashboard.
To add a new identifier, please follow these steps:
- Navigate to the Dashboard > ‘Settings’ > ‘Identifiers’
- Select ‘Add Identifier’, both the red and the green buttons work
- Add the distinct tag for the identifier. Select OK and its done!
To learn more about adding identities in the Permutive Dashboard, please see the page Identity Management Plane (Alias Ingestion)
Comments
0 comments
Article is closed for comments.