FreakOut integration
  • 3 Minutes To Read

FreakOut integration


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

product_freakout

Integration goal

Freakout is a digital marketing technology company that created the first Demand Side Platform (DSP) in Japan. Freakout platform enables marketers and advertisers to buy real-time impressions across the leading display Ad Exchanges and Supply Side Platforms (SSPs).

This integration provides the ability to use DMP segments in FreakOut DSP.

Parties

Customer, Piano 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 Piano Tag

Standard TAG Collapse source

<!-- Piano 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>
<!-- Piano script end -->

Modified TAG Collapse source

<!-- Piano 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>
<!-- Piano script end -->
  1. Customer contacts Piano account manager or support and requests access to FreakOut DSP connectivity tab.
  2. Piano 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 Piano DMP UI

If you want to create new file export connection navigate to DMP -> Connectivity -> Configuration->FreakOut.
Press the “Configure” button to create a new configuration of connection:
Снимок экрана 2020-03-19 в 13.40.58

After that you have to make settings in all sections below:
Снимок экрана 2020-03-13 в 13.08.52

“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).

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

“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.
Снимок экрана 2020-03-18 в 11.20.25

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 using special selector:
Снимок экрана 2020-03-19 в 14.03.56

After you make a choice and add segments press the “Create”/”Save” button in the top right corner of the form.

Only memberships of selected segments will be exported into the FreakOut sftp directory.

“Activate”

The last step is to activate the connection. If Turn connection is “off”, memberships won’t be exported by schedule.
Снимок экрана 2020-03-18 в 10.47.31

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:
Снимок экрана 2020-03-19 в 15.18.05

Was This Article Helpful?