Implementation for Sponsored Ads

OnlineSales.ai sets certain parameters in the ad URL which are required for correct attribution. It is very important to send all the URL parameters back to OnlineSales.ai and hence registering a click with correct param values is required

How to Implement

The response of Fetching Sponsored Ads api includes a unique key which is uclid which is used to track the ad clicks. Once the fetched products are rendered on the app and when the user clicks on the app, partner needs to make the following api all with uclid

Endpoint

GET https://t.o-s.io/aclick

Following is the list of all possible query parameters to be passed to above endpoint:

Parameter	Description	Mandatory
device_id	The unique identifier for the user currently performing the action. Use GAID or IDFA in case of Android or iOS respectively.	Yes
cli_ubid	Client's generated user id. If sent, this takes precedence over device_id Once generated for a user - should be the same for all the api calls.	Yes, if device_id is not set
client_id	Identifier for your account. The value will be shared at the time of integration and will be fixed for all API calls.	Yes
uclid	The unique value obtained from the ad server's api response.	Yes