Shopping Portal
Shopping Portal Authentication
11min
overview before we get started, it's important to understand what a tracking code(tc) is and why it is used when a user activates offers from the shopping portal, we need a way to identify the user to affiliate when they activate cash back through your extension, in order to attribute them properly when the sale completes its lifecycle this is done at wildfire by attaching a tc query parameter at the end of your affiliate url once the sale completes its lifecycle, you can retrieve the value within the tc parameter by going in to the admin tool, and posting the data to your callback url example of a vanity url with a tc parameter https //wild link/lovepop/aiul ai?tc=ee5f1a61 a2f1 4cde be78 293fa339e592 example of an offline vanity url with a tc parameter https //wild link/e?d=0\&c=0\&tc=2d4109a6 c5f6 4028 a206 c26b1379ea82\&url=https //example com authentication details for this method we will leverage your existing authentication system the extension will send the user to the partner's login page with a uri included as a query parameter example of login url https //www example com/login?uri=shoppingportal site com/auth html after the user is successfully authenticated the partner will redirect to the provided uri and include the user's uuid as a query parameter example of redirect url shoppingportal site com/auth html?uuid=uuidhere at this step the portal will store the uuid and include it as the tracking code on all affiliate link activations when passing a uuid ensure that each uuid is unique to a single user, does not change, and is a valid uuid each individual user should only have one uuid oauth for an oauth implementation you can use this same flow, but instead send us the relevant tokens as query parameters to the uri we will then need documentation for how to integrate with your oauth system authentication for app only partners for partners that operate exclusively within a mobile app and do not support web based logins, authentication should be handled within the app before opening the shopping portal authenticating users via app launch the portal with a user id since the user is already authenticated in the partner’s app, open the portal url with the user’s unique identifier (uuid) appended as a query parameter shoppingportal site com/auth html?uuid=uuidhere user tracking the portal will store the uuid and use it as a tracking code for all affiliate link activations this ensures that purchases made through the portal are correctly attributed to the authenticated user handling web links when only app based logins are supported if the app based partner also has a website that links to the shopping portal but does not support web based logins, follow this process redirect to the app for authentication when a user attempts to log in, redirect them to the app using an app deep link (e g , app\ //) instead of a web based login flow (https //) return to the browser with user id once the user is authenticated in the app, redirect them back to the browser with the uuid appended to the url shoppingportal site com/auth html?uuid=uuidhere maintaining authentication across tabs the shopping portal will store the uuid in local storage this allows the new tab to be logged in automatically if the user refreshes the original tab, it will also reflect a logged in state user tracking the portal will store the uuid and use it as a tracking code for all affiliate link activations this ensures that purchases made through the portal are correctly attributed to the authenticated user