FreakOut integration
  • 3 minutes to read

FreakOut integration


Username/Password
Please contact your Cxense representative to access the links

product_freakout

Integration goal

Use DMP segments in FreakOut DSP.

Parties

Customer, Cxense Onboarding, FreakOut

Steps

  1. Customer must put cookie sync tag on his site.

Q: Why?
A: Because FreakOut integration is server2server integration. It means that membership data are uploaded to FreakOut by schedule (not runtime as in case tag based integration). And as far as FreakOut expects to see their userIds in membership data we must store mapping on our side.

Q: How?
A: Just make small modification of standard Cxense Tag

Standard TAG Collapse source

<!-- Cxense script begin -->
<script type="text/javascript">
    var cX = cX || {}; cX.callQueue = cX.callQueue || [];
    cX.callQueue.push(['setSiteId', '<SITE_ID>']);
    cX.callQueue.push(['sendPageViewEvent']);
</script>
 
<script type="text/javascript">
    (function(d,s,e,t){e=d.createElement(s);e.type='text/java'+s;e.async='async';
    e.src='http'+('https:'===location.protocol?'s://s':'://')+'cdn.cxense.com/cx.js';
    t=d.getElementsByTagName(s)[0];t.parentNode.insertBefore(e,t);})(document,'script');
</script>
<!-- Cxense script end -->

Modified TAG Collapse source

<!-- Cxense script begin -->
<script type="text/javascript">
    var cX = cX || {}; cX.callQueue = cX.callQueue || [];
    cX.callQueue.push(['setSiteId', '<SITE_ID>']);
    cX.callQueue.push(['sendPageViewEvent']);
     <!-- Added cookie sync -->
    cX.callQueue.push(['sync','frk']);
</script>
 
<script type="text/javascript">
    (function(d,s,e,t){e=d.createElement(s);e.type='text/java'+s;e.async='async';
    e.src='http'+('https:'===location.protocol?'s://s':'://')+'cdn.cxense.com/cx.js';
    t=d.getElementsByTagName(s)[0];t.parentNode.insertBefore(e,t);})(document,'script');
</script>
<!-- Cxense script end -->
  1. Customer contacts Cxense account manager or support and requests access to FreakOut DSP connectivity tab.
  2. Cxense account manager or support whitelists user or customer.
  3. Customer by dmp.cxense.com->Connectivity->FreakOut DSP schedules segments to be exported.
  4. Customer notifies FreakOut about folder name on FreakOut SFTP server (it will be customerId).
  5. FreakOut tunes processing of data from Customers's folder.
  6. FreakOut notifies Customer about readiness.
  7. Customer is able to use segments.

Configurations in Cxense DMP UI

Creating configuration

If you want to create new file export connection navigate to DMP -> Connectivity -> Configuration->FreakOut
Снимок экрана 2019-09-23 в 15.28.18

Press the “Configure” button to create a new configuration of connection:
Снимок экрана 2019-09-24 в 11.39.32

After that you have to make settings in all steps below:
Снимок экрана 2019-09-24 в 11.57.18

Step 1 “Configure connection”

Give the name of your export project just for your convenience - fill the “Project Name” - it will simplify the further work with the list of all the existing connections and Match Rate reporting (e.g. if you have several connections with one 3rd party system, such a name can help to differentiate it).
Снимок экрана 2019-09-24 в 12.06.35

You should save all settings just push the “Create”/“Save” button in the top right corner of the page.

Step 2 “Configure Segments”

There are two options: all segments or only selected segments you want to connect.
If you choose the option “All segments” all new segments always will be added automatically to connection.
Снимок экрана 2019-09-24 в 12.09.03

If you choose option “Manually selected Segments” you should add all new segments manually every time for every new segment. It will be possible to do it in the same way as you are doing it now - just edit the existing connection and change the list of segments.
After choosing “Manually selected Segments” select available segments:
Снимок экрана 2019-09-24 в 12.11.51

Use “Add”/”Add all” buttons to shift segments from Available segments list to Selected segments list. The search bar above the Available segments list can help you to find segments easily.
After you make a choice and add segments from the left side to right press the “Create”/”Save” button in the top right corner of the page.
Only memberships of selected segments will be exported into the FreakOut sftp directory.

Step 3 “Activate”

The last step is to activate the connection. If Turn connection will be “off”, memberships won’t be exported by schedule.
Снимок экрана 2019-09-24 в 12.03.35

Monitoring and update

Now you can see your connection on the list of existing connections (DMP->Connectivity ->Connections) and Match Rate report (DMP->Connectivity -> Match Rate Reporting).
In order to change settings (name of the project, list of segments or status of connection) please find the needed connection on the list of existing connections (DNP->Connectivity ->Connections) and choose the needed option in the context menu:
Снимок экрана 2019-09-24 в 11.58.50

Was this article helpful?