Sync your user with Audiens
This document will outline the cookie sync procedure for the Audiens platform.
To map the user with Audiens, the partner will call the endpoint and initiate the sync procedure.
The URL must respect the following format:
The simplest way to implement the Audiens Mapping Service to an html page is to add an img tag with the correct formatted URL
<img src='http(s)://data.audiens.com/v1/cookie/match/?audiens_partner=7&audiens_partner_uuid=23' />
Audiens will match the audiens_partner_uuid with the internal profiled user.
From this point forward the audiens_partner_uuid can be used to send user data.
Whenever is possible the system will always try to deliver the invisible 1x1 pixel to avoid console/network notification.
Amazon S3 is provided together with the access credentials :
Standard format of the data storage URL is:
Is the partner id provided by Audiens during the integration kick-off.
Is the date of files that are provided the split is mandatory as it is used by the system to handle import.
The date component is in the format yyyy/mm/dd
The name of the file that the partner is uploading. The filename can be any format the partner desire. The only restriction is that the extension must be .gz and the file is compressed accordingly.
A non mandatory format proposal: yyyymmddhis.gz example 20170101102059.gz
The content of the file must adhere at the following convention
Is the uuid provided by the partner during the cookie-sync phase, it will be used by the system to relate the segment to the user.
Can be multiple for each line, they represent the segment id of the taxonomy.
7958b37e-955b-4aaa-a5a3-9b94f3b1c9fc,12456;78965;441447;8569;478454 807e16fa-0942-466b-80a0-1bec896bfe44,17456;78895;42347;85149;447544 2825ca84-4910-453f-be08-9906d76622d2,12156;78965;254447;98769;98854 6adb1b44-ea68-47bc-8cc9-dd5b913f64aa,4569856;781254;15677;8748;4854
The file must not exceed the 20MB size limit
The same partner-uuid should be present only one time per data file