Onboarding Setup

Initial data parsing setup

Publishers store user data in many different ways, so we need to translate the structure of the CRM data into the digitalAudience tagging system. For this purpose, digitalAudience will need a sample data set from the publisher’s CRM system, a CSV export, to study the content and prepare the translation set for the publisher. If the CRM data uses lookup tables for grouping, the sample set should have a codebook explaining the coding used in the dataset.

Once the translation is ready, a publisher specifies a location - S3, SFTP or FTPS. Then the digitalAudience team sets it up and provides the credentials so that a publisher uploads a full export of their CRM data.

We recommend updating user data regularly to have the new opt-ins included in our database and the opt-outs processed on time. Publishers will use this storage connection to send the updated files to digitalAudience.

It is advisable to upload the hashed versions of email addresses and phone numbers in SHA256 hashing format. However, the publishers can upload plain email addresses and phone numbers. digitalAudience will hash the data and remove the uploaded file from our servers.

Please follow the formatting convention carefully to make sure that the email addresses and phone numbers get connected to the cookies that digitalAudience generates.

Emails

Put the email addresses in one separate column. Make sure that there is only one email address in each row. Lowercase the email address and remove the white spaces. Then, hash it using SHA256 algorithm.

Examples:

[e-mail] > [e-mail] >
A7DF77A9DB89B44110C704B680A24978579A3069B419DB95CBDA84541094ADBA

[e-mail] > [e-mail] >
A7DF77A9DB89B44110C704B680A24978579A3069B419DB95CBDA84541094ADBA

Phone numbers

Put the phone numbers in one separate column. Make sure there is only one phone number in each row. First remove the special characters like plus(+), backslash(/), dash(-), brackets(()), space( ). Reformat the number to conform the 31XXYYYYYYY format, where XX is the carrier code like 20 or 61 and YYYYYYY is the 7-digit phone number. In total it becomes an 11-digit number. Then, hash it using SHA256 algorithm.

Examples:

[phone] > 31614123456 >
5253828BF4B74309F76C1B1B3FC379584D9DC139874764D5D134E6C0FC7235AA

0-10-123 4567 > 31101234567 >
649C4E17CAB8316FA164573FCD76B945793FBAFC8FCF1AD89F9FBCA9B29F51EB

Connecting cookies to CRM data

CRM data is most valuable when the records are connected to a cookie, making the onboarded data available in various digital data marketplaces. The connection is created between the user’s email addresses and the cookies that digitalAudience drops in the user’s browsers. There are two different pixels used to create this connection.

Email pixel

It is injected at the key locations where an email address is available, for example email templates for newsletters. The pixel calls the digitalAudience cookie server for a cookie request and carries over the user’s email address (hashed version, if possible). Place this pixel in every newsletter the users receive, preferably at the beginning of the email.

<img height="1" width="1" style="display:none !important" src="https://target.digitalaudience.io/bakery/bake?publisher=PUBLISHERID_HERE&car=0&email=HASHED_EMAILADDRESS_HERE"/>

This pixel will ensure that the data provided with the email addresses, and the CRM records connected to them, can be carried over to the data marketplaces.

Privacy Clause

digitalAudience requires publishers to include its privacy clause in their privacy statements. The clause is available in English and Dutch. Please see details below.

English

When you enter your email address on our website (to log in, or to sign up for a newsletter, or the like) we may collect personal or other information that we collect from you, such as your email address (in encrypted , pseudonymous form), IP address, or information about your browser or operating system, with our partner digitalAudience BV and its group companies. digitalAudience's privacy policy and opt-out can be found here: https://digitalaudience.io/legal/ digitalAudience uses this information to create an online identifier that allows us to recognize you across your devices. This code does not contain any personally identifiable information about you and will not be used by digitalAudience to identify you again. We place this code in our cookie or use a cookie from digitalAudience and allow it to be used for online and cross-channel advertising. The code may be shared with our advertising partners and other third-party advertising companies worldwide to enable interest-based content or targeted advertising throughout your online experience (e.g. web, email, smart devices, in apps, etc.). These third parties, in turn, may use this code to match demographic or interest-based information that you have shared with them during your interactions. You have the right to express a choice regarding our use of digitalAudience cookies and our sharing of this data with digitalAudience for the above purposes.

Dutch

Wanneer u uw e-mailadres op onze website invoert (om in te loggen, of om u aan te melden voor een nieuwsbrief, of iets dergelijks) kunnen wij persoonlijke of andere informatie die wij van u verzamelen, zoals uw e-mailadres (in versleutelde, pseudonieme vorm), IP- adres, of informatie over uw browser of besturingssysteem, delen met onze partner digitalAudience BV en haar groepsmaatschappijen. Het privacybeleid en de opt-out van digitalAudience vindt u hier: https://digitalaudience.io/legal/ digitalAudience gebruikt deze informatie om een online- identificatiecode aan te maken waarmee wij u op uw apparaten kunnen herkennen. Deze code bevat geen identificeerbare persoonsgegevens van u en zal door digitalAudience niet worden gebruikt om u opnieuw te identificeren. Wij plaatsen deze code in onze cookie of gebruiken een cookie van digitalAudience en staan toe dat deze gebruikt wordt voor online en cross- channel reclame. De code kan worden gedeeld met onze reclamepartners en andere externe advertentiebedrijven wereldwijd om op interesses gebaseerde inhoud of gerichte reclame mogelijk te maken binnen uw gehele online ervaring (bijv. web, e-mail, slimme apparaten, in apps, enz.). Deze derde partijen kunnen op hun beurt deze code gebruiken om demografische of op interesses gebaseerde informatie die u tijdens uw interacties met hen hebt gedeeld, aan elkaar te koppelen. U hebt het recht om een keuze kenbaar te maken met betrekking tot ons gebruik van digitalAudience- cookies en het door ons delen van deze gegevens met digitalAudience voor de bovengenoemde doeleinden

Publishers need to make sure that digitalAudience (Vendor ID 133) is listed in the Vendors list in the CMP. This is required for the website script to function.

Website script

digitalAudience offers a website script designed to help publishers, on the one hand, make their traffic interoperable and, on the other hand, create segments and increase segment volumes in the data marketplaces.

Below are the instructions on how and where to place the script on all website pages.

The contents of the script may vary, depending on the publisher's use case. For example, they do not use a data management platform or need categorization or email addresses.

Add the following script to the end of the <body>, close to the closing of the body tag </body>;

<script language='javascript'> 
try{
	var __s = document.createElement('script');
	__s.src = "https://target.digitalaudience.io/bakery/scripts/da.js";
	__s.addEventListener ("load", 
		function(){ 
			__da.bake({
				partner:'PARTNER', 
				parcid:'PARTNERID', 
				publisher:'PUBLISHERID', 
				category:'category1' OR [category1,category2,category3], 
				email:'HASHED_EMAILADDRESS_HERE',
				syncs:[vendorid1,vendorid2] OR [],
				consent:[vendorid1,vendorid2],
				dpixel:'DPIXELID'
				}); 
			__s.remove();
		}, false); 
	document.body.appendChild(__s);
} catch (error) {
  console.error(error);
}
</script>

Parameter	Description
partner	Data Management Platform (DMP) identifier provided by digitalAudience when applicable
parcid	User identifier provided by the DMP
publisher	Publisher's identifier provided by digitalAudience
category	If categorization is applied to the site structure and the category is available in the data layer, a single selected category (id) or an array [a,b,c] can be passed along
email	Hashed email address when available, for instance on a login page
syncs	List of IAB vendor ids to allow syncing process [ref]. Pass an empty array if no vendor should be allowed.
consent	IAB vendor id to allow syncing process for the CDP/DMP [ref]
dpixel	Pixel id to generate dashboard data for this website

Privacy Clause

In case the publisher hasn't implemented a CMP yet, digitalAudience requires publishers to include its privacy clause into their cookie banners. The clause is available in English and Dutch. Please see details below.

English

We use digitalAudience techniques to collect statistics and insights about the use of our website and services. More information about digitalAudience and the techniques used can be found here.

Dutch

Wij maken gebruik van technieken van digitalAudience om statistieken en inzichten te verzamelen over het gebruik van onze website en dienstverlening. Meer informatie over digitalAudience en de gebruikte technieken kunt u hier vinden.