Using the Analytics.js Querystring API
Analytics.js can trigger Track and Identify events based on the URL query string. You can use this when tracking email click-throughs, social media clicks, and digital advertising.
Here are the query parameters to use:
| Parameter | Description | Triggers |
|---|---|---|
ajs_uid |
The userId to pass to an identify call. | This triggers an identify call. |
ajs_event |
The event name to pass to a track call. | This triggers a track call. |
ajs_aid |
The anonymousId to set for the user. | This triggers an analytics.user().anonymousId() call. |
ajs_prop_<property> |
A property to pass to the track call | This won’t implicitly trigger an event and is dependent on you also passing ajs_event - this property be included in the resulting track call |
ajs_trait_<trait> |
A trait to pass to the identify call | This won’t implicitly trigger any call and is dependent on you also passing ajs_uid - this trait is included in the resulting identify call |
For example, this URL:
http://segment.com/?ajs_uid=123456789abcd&ajs_event=Clicked%20Email&ajs_aid=abc123&ajs_prop_emailCampaign=First+Touch&ajs_trait_name=Karl+Jr.
would create the following events on the page.
analytics.identify('123456789abcd', { name: 'Karl Jr.' });
analytics.track('Clicked Email', { 'emailCampaign': 'First Touch' });
analytics.user().anonymousId('abc123');
Each trigger parameter is optional. You can pass up to one of each trigger parameter as shown in the example above.
This page was last modified: 18 Sep 2020
Need support?
Questions? Problems? Need more info? Contact us, and we can help!
Was this page helpful?
Get started with Segment
Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.