Step 1: Getting Click ID
Capturing the Click ID (ps_xid)
When a visitor redirects through a partner's link, the may notice two query parameters appended to destination URL: ps_xid
and ps_partner_key
- The value of
ps_xid
is a unique identifier that PartnerStack uses as a reference to the click event through the Partner's link. - The value of
ps_partner_key
is the base64 encoded partner key, which is the unique identifier of the Partner.
When a visitor converts to a user you'll need to attribute the user to the partner who referred them. To do this you need to associate the ps_xid
of the click event with the visitor/user customer_key
who clicked the link and send both ps_xid
and customer_key
to PartnerStack with the conversion event (more on this in "Tracking Conversions" below).
Fetching query parameters
To fetch the ps_xid
value from the browser refer to this excellent documentation from the Mozilla Developer Documentation on search parameters.
Mozilla recommends using the URLSearchParams interface to retrieve the value of query parameters in the browser. You can read more on this interface in the Mozilla URLSearchParams documentation.
Example Implementation
The following code illustrates how you may use the URLSearchParams interface to grab the Click ID from the search params.
// get the search string part of the URL
const searchString = document.location.search;
// create a new URLSearchParams instance
const urlSearchParams = new URLSearchParams(searchString);
// get the ClickID from the search params
const partnerStackClickID = urlSearchParams.get('ps_xid');
After fetching the data, you can store it to the user's session. The exact storage method will depend on your application and use case for tracking.
A common solution would be to store the clickID to a cookie on the user's browser. Be sure that the expiration of this cookie at least matches the duration that the click is valid for attribution. PartnerStack's default is a 90-day, last-click attribution.
If you already have session data tracking technology in place that can hold this Click ID, then we recommend using that existing infrastructure.
Updated 11 months ago