Full list of URL query parameters that Browser SDK 2.0 automatically uses?

System

The amplitude docs include this note:

Starting from v2.8.0 the SDK supports getting the device ID from the URL paramter ampDeviceId. The SDK configuration, for example, init('API_KEY', { deviceId: 'custom-device-id' }) still takes precedence over the URL parameter. Previous versions of the SDK supported the deviceId URL parameter, this option is still supported for backward compatibility but ampDeviceIdwill take precedence if both are set. You don't need to change your code if upgrade to versions higher than v2.8.0 but it is recommended.

But then later on, there is also mention of the “ampSessionId” while I’m pretty sure the older version was just “sessionId”. Is there a full list somewhere of all the URL parameters that the SDK will attempt to automatically use, along with information about priority (for example I’m assuming ampSessionId would override sessionId) and support/deprecation information?

For example, we do still use `sessionId` in some cases, and I’d like to confirm whether that’s still valid or if we need to switch to the `ampSessionId`.

System

Hi Robby,

Thank you for reaching out! I understand you're looking for a comprehensive list of URL query parameters that the Browser SDK 2.0 automatically uses, along with details on priority and support/deprecation—specifically regarding the transition from `sessionId` to `ampSessionId`.

The Browser SDK 2.0 automatically tracks several URL query parameters for attribution and session management. `ampSessionId` is the newer parameter introduced for session tracking. It takes precedence over the older `sessionId` parameter if both are present in the URL. `sessionId` is still supported for backward compatibility but is overridden by `ampSessionId` if both are set.

`ampDeviceId` is introduced in SDK version 2.8.0, this parameter is used to set the device ID. It takes precedence over the older `deviceId` parameter. `deviceId` is still supported for backward compatibility but overridden by `ampDeviceId` if both are present.

The SDK captures the five standard UTM parameters: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, and `utm_content` and these parameters are case-sensitive and are used for marketing attribution. The SDK also tracks various click IDs, such as `gclid` (Google), `fbclid` (Facebook), `ttclid` (TikTok), and others along with `referrer` and `referring_domain` that are captured to track the source of traffic.

For session and device parameters, the newer `ampSessionId` and `ampDeviceId` take precedence over their older counterparts (`sessionId` and `deviceId`). While the older parameters are still supported for backward compatibility, it is recommended to transition to the newer parameters (`ampSessionId` and `ampDeviceId`) to ensure consistency with the latest SDK updates.

Let me know if you have any questions!

Best,

Jarren

P.S. Checkout upcoming events and user meetups on our events page.