URL parameters

Adding tracking parameters

For the purpose of tracking, you can add the following parameters to the URL:

Parameter	Description
referrer	Name of the partner
campaign	ID of the campaign from the marketing tool Can be empty
param1	The platform where our campaign is located (website / mobile / display, etc.)
param2	The page where our campaign is located (homePage, matchPage, etc.)
param3	The type of integration (banner / iframe / API)

By setting these parameters properly, we can share conversion data with you.

Incorporating them into the URL, it would resemble this:

https://app.socios.com/partner/[PARTNER_ID]?partnerWebAppId=[PARTNER_ID]&referrer=paris_saint_germain&campaign=FB_psg_20456&param1=website&param2=homePage&param3=banner

Separating each parameter to make it more readable:

https://app.socios.com/partner/[PARTNER_ID]?partnerWebAppId=[PARTNER_ID]
&referrer=paris_saint_germain
&campaign=FB_psg_20456
&param1=website
&param2=homePage
&param3=banner

Theparam1,param2 andparam3 parameters can be tailored to a partner's usage, hence the generic names. They have an impact on the charts that we create internally, which we can share with you.

Incorporating login/registration information as parameters

To facilitate a better user experience, you can auto-fill the login/registration form by supplying user information: country code, phone number, etc.

This requires a base64-encoded JSON value, which you can provide through the userInfo parameter. This encoded value may include the following JSON:

{
    "countryCode": "+33",
    "phoneNumber": "0623456789",
    "email": "[e-mail]",
    "username": "username",
    "country": "France",
    "dob": "1970-01-01"
}

Incorporating the above base64-encoded JSON within the URL, it would resemble this:

https://app.socios.com/partner/[PARTNER_ID]?partnerWebAppId=[PARTNER_ID]&userInfo=ew0KICAgICJjb3VudHJ5Q29kZSI6ICIrMzMiLA0KICAgICJwaG9uZU51bWJlciI6ICIwNjIzNDU2Nzg5IiwNCiAgICAiZW1haWwiOiAiZXhhbXBsZUBtYWlsLmNvbSIsDQogICAgInVzZXJuYW1lIjogInVzZXJuYW1lIiwNCiAgICAiY291bnRyeSI6ICJGcmFuY2UiLA0KICAgICJkb2IiOiAiMTk5OS0wMS0wMSINCn0%3D

Retrieve user session (to avoid multiple logins)

In order to simplify user flow and more especially the login, you can add login_redirect=true parameter. Having this parameter will check if the user has an active session on Socios.com and avoid to ask him to log in again.

https://app.socios.com/partner/[PARTNER_ID]?partnerWebAppId=[PARTNER_ID]&login_redirect=true