With this integration, Piano Audience segments (and users - for S2S) can be exported to Supership.
Setting the tag
-
Client side
Preresequisites
-
The ID of a persisted query created in Piano Audience (see Persisted Query Tutorial ). This query must select segments for specified Audience user IDs.
-
<account_id> (section ID) and <sid> values registreted in Scale Out server and a valid Scale Out user.
-
A tag in your inventory pages. This script loads all segment IDs for the current user from Piano Audience (using a persisted query). Convert them to the Scale Out format and send to the Scale Out server.
Tag with a JS script to export a user's segments to the Scale Out server
cX.callQueue.push(['getUserSegmentIds', {
persistedQueryId: <persisted_query_id>,
callback: function(segments) {
if (segments.length > 0){
var imgUrl;
if (location.protocol === 'https:'){ imgUrl = 'http://ssl.socdm.com/aux/extsync'; }
else{ imgUrl = 'http://tg.socdm.com/aux/extsync'; }
var aid = <account_id>;
var sid = <sid>;
imgUrl = imgUrl + '?aid=' + aid + '&sid=' + sid;
for(i = 0; i<segments.length && i<10; i++){
if (i == 0){ imgUrl = imgUrl + '&attr_raw=' + segments[i] + '=1'; }
else{ imgUrl = imgUrl + '|' + segments[i] + '=1'; }
}
new Image().src = imgUrl;
}
}
}]);
-
Server side
Add this code to your tag. This script allows you to synchronize ScaleOut user IDs with Piano Audience user IDs. After you enable the membership checkbox in the Connectivity tab the user-segment mapping will be sent to ScaleOut's SFTP every day.
cX.callQueue.push(['sync','scaleout']);
Configuring Piano Audience
-
Create a Supership configuration
With your site group selected, from the Piano Audience home page, go to the Connectivity tab → the Configurations tab →the Supershipicon 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 to simplify managing numerous integrations.
Username, Password, and Section ID: enter your username, password, and account (section) ID at Scale Out here.
Type of synchronization: Client-side integration will send segments only, while server-side integration will also send members of those segments.
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 Supership; 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. Multiple selection is supported.
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) almost immediately.
By default, if segments export is enabled, then all site group segments are exported. The same applies to membership export.
