URL parameters
Adding tracking parameters
For the purpose of tracking, you can add the following parameters to the URL:
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¶m1=website¶m2=homePage¶m3=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
¶m1=website
¶m2=homePage
¶m3=banner
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": "[email protected]",
"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
Last updated