"Improve Digital" stands for the European Programmatic Advertising Platform for Publishers, Content Providers and Broadcasters. The integration enables using Piano Audience created segments on the partner's side.
Setting the CookieSync tag
The Cookie sync tag should be placed on the needed websites' pages. Some time (a month or two) is required for matching users between Piano and Improve Digital, so it's a good practice to put the tag in advance. Make sure that the tag is placed on alive websites because it is traffic that defines the speed of the matching process.
Integration with a Improve Digital account should be configured, needed segments should be selected for transfer. Make sure that all the needed segments are active and selected for full usage, but not for reporting only.
-
Synchronous tag
One of the following tags should be placed on websites with high traffic.
<div class="code-toolbar" data-puniqid="dc3316eedb43fb7">
<div class="toolbar" data-puniqid="2b9287e069cf7e0">
<pre><script type="text/javascript" src="//cdn.cxense.com/cx.js"></script>
<script type="text/javascript">
cX.sync({'partner': 'imdigital', 'customerId': '<customerId>'});
</script>
-
Asynchronous tag
<script type="text/javascript">
// Async load of cx.js
(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');
var cX = cX || {}; cX.callQueue = cX.callQueue || [];
cX.sync({'partner': 'imdigital', 'customerId': '<customerId>'});
</script>
Configuring Piano Audience
-
Create an Improve Digital configuration
With your site group selected, from the Piano Audience home page, go to the Connectivity tab → the Configurations tab →the Improve Digital icon and click the Configure button.
-
Configure the connection
In the New Connection menu, you want to set:
-
Project name: to be shown in Piano Audience only, intended to simplify managing numerous integrations.
-
Publisher name, Client ID, and Password (Client secret) for the corresponding Improve Digital account (if you don't know it, please contact your account manager).
When everything is set, click the Test connection button. A request to the specified account on the partner’s side will be sent, and, if everything works correctly, you'll get a corresponding notification. The Create button in the upper right corner will be activated. Click it. Create will turn to the Save button you can use any time during further configuration.
-
Configure segments
Successful test connection enables the Configure segments form where:
-
All segments means that all active full usage segments will be sent to FreeWheel; any newly created active full usage segment will be added automatically.
-
All segments (including Reporting only) includes Reporting only segments.
-
Manually selected segments allows both to send some part of active segments and to check if a needed segment is active now. If a needed segment is inactive, you can activate it on the Segments tab. To select a segment, click its name.
Set the parameter.
-
Export segments
You can click Export now in the Configure segments section for almost immediate export of selected segments without waiting for the next scheduled data transfer. The other option is configuring scheduled data transfer in the Activate section below. There, you can either set up a daily data transfer by turning connection on, or hold the created configuration without activation yet and set the connection to "off".
When ready, click Create or Save (if editing) in the top right corner of the page.
Monitoring and update
Configured connections can be viewed and edited in the Connections tab. They are also available under the Match rate reporting tab.
Data is normally exported once a day. The Export now button allows to export segments (not membership data) immediately.
