Querystring API
Detailed technical description of the RudderStack's Querystring API.
RudderStack's Querystring API lets you trigger the track and identify calls using the query parameters within the URL.
Query parameters
The query parameters are listed in the following table:
| Parameter | Action |
|---|---|
ajs_uid | Triggers a rudderanalytics.identify() call with userId having the parameter value. |
ajs_aid | Triggers a rudderanalytics.setAnonymousId() call with anonymousId having the parameter value. |
ajs_event | Triggers a rudderanalytics.track() call with event name as the parameter value. |
ajs_prop_<property> | If ajs_event is passed as a query string, the value of this parameter populates the properties of the corresponding event in the track call. |
ajs_trait_<trait> | If ajs_uid is provided as a query sting, the value of this parameter will populate the traits of the identify call made. |
Use-case
For the following URL containing the querystring parameters:
http://hostname.com/?ajs_uid=12345&ajs_event=test%20event&ajs_aid=abcde&ajs_prop_testProp=prop1&ajs_trait_name=Firstname+LastnameThe following API calls will be triggered:
rudderanalytics.setAnonymousId("abcde");rudderanalytics.identify("12345", { name: "Firstname Lastname" });rudderanalytics.track("test event", { testProp: "prop1" });Contact us
For more information on any of the sections covered in this guide, you can contact us or start a conversation in our Slack community.
If you come across any issues while using this SDK, feel free to submit them on our GitHub issues page.