MarinOne's Audience Hub allows you to easily build audiences based on your own customer data -- email addresses, telephone numbers, physical addresses, and more.
Use the Audience Hub to build audiences from your own customer data, including both Google Customer Match Audiences and Facebook Custom Audiences. You can then create, maintain, and manage your audiences across Search and Social from a single location.
If you're currently collecting data in a Customer Relationship Management (CRM) tool, you can feed this data into an audience in order to use differentiated messaging and bidding for different types of customers and prospects.
Note: The Audience Hub feature is currently offered as an FTP-only solution without a dedicated user interface. We plan to add a user interface at a later date, so please stay tuned for updates.
Wondering how you might take advantage of the Audience Hub? Check out the scenarios below for inspiration.
There are a number of benefits to using Google Customer Match Audiences and Facebook Custom Audiences, but among the most significant are the following:
The Audience Hub currently supports Google and Facebook.
The Audience Hub allows you to create Google Customer Match Audiences.
Google Customer Match Audiences are supported on the following ad types:
Google does not currently support Customer Match Audiences on:
Using Google Customer Match Audiences, you can:
The Audience Hub allows you to create Facebook Custom Audiences. There are ten different types of Facebook Custom Audiences that can be managed in Marin Social.
To learn more about Facebook Custom Audiences, check out our dedicated article.
If you're interested in using the Audience Hub in MarinOne, please reach out to a platform representative to learn more.
Creating CRM-based Audiences in MarinOne requires three basic steps.
We'll go into each of these steps in more detail in the following sections.
Use the information below to learn about file formats, naming conventions, accepted column headers, and more.
The file name must be in the following format:
<FileName> can be replaced with whatever name you'd like for the file that is being uploaded. It should not contain spaces or special characters. The only language currently supported is English, though we do plan to support additional languages in the future.
Using the file format of <FileName>.CSV, if a marketer wanted to use the filename "Top100customers," the format would become either Top100customers.CSV or Top100customers.csv.
When uploading your file, keep the following in mind:
From the Hashing tool, use the drop-down to select the operation you'd like to use for your upload. This will perform the following operations:
Only one of the above operations -- Add, Remove, Replace -- can be performed in a given upload.
If no operation value is provided, the default operation will be Add. The operation selected will be appended to the file name once the file has been downloaded from the hashing tool. So, the file name of Top100customers.CSV will become Add_Top100customers.CSV. We'll learn more about other details that will be appended to your file name in the Hashing section of this article.
The first few rows of your file will contain the Audience Metadata. This can include:
At the end of your Audience Metadata, you will need to include an <END> tag to let Marin know when it has finished processing the metadata and can start processing customer data.
Your Audience Metadata might look something like this:
The row with your column headers should come immediately after the <END> tag, without a blank row in between.
Note: Your Audience Metadata will remain unhashed, even after the rest of the file has gone through the hashing process.
Marin currently supports the following customer information:
The first row of customer information will be made up of your column headers and will remain unhashed, even after the remainder of the file has gone through the hashing process.
The following column combinations are accepted in a file:
You can learn more all of the accepted columns and their requirements in the table below. To learn more about the various combinations with which these columns can be used, check out the Valid Column Combinations section of this article.
Please note that after the file has gone through the hashing process, all columns will be displayed. Please leave these added columns in place when uploading your hashed file.
Column Headers | Required/Optional | Values Hashed (Yes/No) | Description & Notes |
---|---|---|---|
Google Account ID |
Required (Google only) |
No |
Google publisher account(s) to which this Audience list is being uploaded. (ex: 123-408-9076, 234-456-123) |
Facebook Account ID
|
Required (for Facebook Audiences)
|
No
|
Facebook publisher account(s) to which this Audience list is being uploaded. (ex: 1234567890123) If you have audience names that are not unique but have different External Account IDs, these will need to be edited prior to uploading your file to ensure that the audience name in the metadata of your file is unique and cannot be inadvertently matched to multiple audiences. If an audience name already exists for an account, then the existing audience should be updated with the <operation> provided in the hashing tool. |
Email, Email1, Email2 |
Required One Email column is required, but additional columns are optional. |
Yes |
You can provide up to 3 email columns for a single user. If a user record has more than one email address on file, use separate columns with the headers Email, Email1, and Email2 |
Phone |
Optional |
Yes |
One phone number per record, should include country code. |
First Name |
Optional |
Yes |
One first name per customer record. This should not include prefixes (e.g. Ms.). Accents are supported. |
Last Name |
Optional |
Yes |
One last name per customer record. This should not include prefixes (e.g. Ms.). Accents are supported. |
Country |
Optional |
No |
Use the ISO two letter country code (e.g. US, GB) |
Zip |
Optional |
No |
Both US and international postal codes are supported. |
Note: The publishers (Google or Facebook) will not find a match for all customer data that is uploaded. As a result, the number of records you upload may not equal the List Size provided by the publisher. List Size is the number of records successfully matched by the publisher. That said, the more information provided in the file (email, phone, etc.), the higher the likelihood that the publisher will find a match for your customer data.
If you're ready to begin creating your Audience Hub file, you can download a sample file at the link below.
Use the matrix below to determine the best column combinations for your data. If a column has an X present, this represents that the data is present in your file.
email1 | email2 | phone | first name | last name | country | zip | Valid or Invalid | |
---|---|---|---|---|---|---|---|---|
X | Valid | |||||||
X | X | Valid | ||||||
X | X | X | Valid | |||||
X | X | X | Valid | |||||
X | X | X | X | Valid | ||||
X | X | X | X | X | X | X | X | Valid |
X | X | Valid | ||||||
X | X | X | Invalid | |||||
X | X | X | X | X | Invalid | |||
X | X | X | X | X | X | Invalid | ||
X | X | X | X | X | X | X | Valid | |
X | X | X | X | X | Valid |
You might find that your your CSV file, when opened in Excel, is displaying numbers in an unusual fashion. You can see an example of this in the screenshot below.
If this is happening, you can simply convert the applicable cells to be displayed in number format.
You may also need to remove excess decimal places.
Your cell values should then display correctly.
Hashing is a process that is used to transform your upload file into a randomized string of characters in order to ensure data privacy. Once the hashed file has been uploaded, it can be used to create audiences based on your customer data, all while ensuring that client information cannot be matched back to a specific customer or user.
This kind of security is important given the sensitivity of your customer data, which can often include client phone numbers, email addresses, home addresses, and more.
Note: Marin uses SHA-256 hashing, which is supported by both Google and Facebook.
Marin takes your data privacy seriously. Marin's Hashing Tool is an html file that you will download locally, which means your secure client data will never leave the comfort of your own computer. It will never pass through Marin's servers, which means we will never store your hashed or unhashed customer data.
To learn more about Data Privacy at Marin, check out the Data Privacy page on our company website.
For concerns on how Google handles customer match data, please visit the Google Ads Help site here (external link). Or for concerns on how Facebook handles customer data, please visit the Facebook Ads Help Center here (external link).
For comparison purposes, let's take a look at both hashed and unhashed data.
Below you can see an example of unhashed data. It has identifiable client names, email addresses, zip codes, and more.
Note: This screenshot uses the External Account ID column header, but for your upload, you will need to use either the headers Google Account ID or Facebook Account ID.
Once hashed, this data might look like the below screenshot. The identifiable client data has been turned into a randomized string of characters in order to ensure the data remains secure. As we saw in the previous section, a few of your columns, such as Google Account ID, Facebook Account ID, and Publisher, will remain unhashed.
When Marin's Hashing tool hashes the file, it will add all supported columns, even if a column is not needed for your upload. Please don't delete these columns prior to uploading your audiences. These columns are required for the file to process, even if all of the cells within that column are left blank. Once a file is hashed, it's ready for upload without any additional changes.
To access Marin's Hashing Tool, follow the instructions below.
Hashing your file is both simple and secure. You can get started simply by following the instructions below.
One your has been hashed and you've downloaded the hashed file, the next step is to upload the hashed version of the file to the FTP.
If you've used an FTP to upload objects to the FTP, this process will be very similar.
The easiest way to connect to the Platform via FTP is to use an FTP program. There are many of these available to download online. One such example is Filezilla, a free, open-source FTP program available for Windows, Mac and Linux.
For more information on Filezilla and help on using the program, please feel free to read their Wiki article here (external link).
To learn more about using the FTP to upload objects to MarinOne, check out our dedicated article.
Once you have an FTP program, open it up and enter the following credentials:
Server: integration.marinsoftware.com
Username: Your Platform username
Password: Your Platform password
Once you have successfully connected to the FTP client, each Marin Client Account you have access to will be listed as a separate folder represented by its Tracker ID. Files should be transferred to the top level folder (not any of the sub-folders within each client folder) and will begin processing in the Activity Log.
To identify your Tracker ID in MarinOne, follow the instructions below.
Note: Your Tracker ID can be located in the Admin section of MarinOne.
When uploading to the FTP, keep the following in mind:
If there were any errors in the file processing, you will see an error status file added to the FTP. If the file was processed successfully, you will see it appear in the MarinOne Activity Log shortly after it has been uploaded.
If the file is successfully parsed, MarinOne will create the Audience object and push this along with any associated user data to the publisher.
Note: For Google Customer Match Audiences, Google requires a match rate of at least 1,000 users in order to build an audience. Marin doesn’t currently alert users when that threshold hasn’t been met, nor does it showcase the total match rate when syncing is complete. We will be introducing these capabilities in a later release.
Similar audiences enable advertisers to target users searching for the same kinds of things as your designated customer match list, for which Google analyzes browsing interests, search queries, and videos watched, on Gmail and YouTube. These will automatically be created if your Customer Match audiences meet the minimum eligibility criteria.
Once your audiences have been uploaded into MarinOne, you can check the status of uploads and edits in the dedicated Audience Activity Log. From here, you can monitor all activity related audience file uploads.
After you've dropped your file to the FTP, you can monitor its status from MarinOne by clicking on the Activity Log button ('bell' icon) in the top right-hand corner.
To monitor audience jobs, click on the Audience Activity tab.
For every file that's uploaded to the FTP, there will be two jobs created:
Once both jobs are completed, you will see the audience created in MarinOne's Audiences tab and in the associated publisher platforms.
Once your Customer Match Audience has been created, it can be managed in MarinOne just like any other audience.
To learn more about managing audiences in MarinOne, check out our dedicated article.