File-Based Recognition workflow via Amazon S3

S3 File Integration

Overview

Paramount will provide a secure Amazon S3 bucket for clients to upload pseudonymized CRM data. This data will be used to train our models to identify additional high-value customers for advertising campaigns.

File Format Requirements

 

Important: Please ensure your CSV file meets the following specifications. At minimum we should receive either a hashed email or IP address. Please include a header row.

 

Column Header

Description

Required?

EMAIL

SHA-256 hashed email addresses only. No other PII.

Null allowed only if IP available

IP

IP address in IPv4 format

Null allowed only if EMAIL available

TRANSACTION_TIMESTAMP

ISO8601 Compliant Date/time of transaction in UTC: yyyy-MM-dd'T'HH:mm:ss'Z' Example: 2017-02-07T13:25:00Z

 Required

CONVERSION_TYPE

Type of conversion event (e.g., purchase, signup)

Not required

Example CSV Format

EMAIL,IP,TRANSACTION_TIMESTAMP,CONVERSION_TYPE
5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8,192.xxx.x.xxx,2025-12-10T14:30:00Z,purchase
b3a8e0e1f9ab1bfe3a36f231f676f78bb30a519d2b21e6c530c0eee8ebb4a5d0,203.x.xxx.xx,2025-12-10T15:45:00Z,signup
7c222fb2927d828af22f592134e8932480637c0d4f70c0d61c7ad9c9c86fe1b5,198.xx.xxx.xx,2025-12-10T16:20:00Z,purchase

Pre-Campaign Training

S3 Path:

precision-data-[advertiser_name]/

File Name Format:

[advertiser_name]_Conversion_Events_YYYYMMDD.csv

Campaign Files

S3 Path:

precision-data-[advertiser_name]/

File Name Format:

[advertiser_name]_Conversion_Events_YYYYMMDD.csv

Note: YYYYMMDD represents the date of file delivery (rather than date of data event)

Data Volume Requirements

Implementation Checklist

  • Contact your Paramount account manager to receive S3 bucket credentials
  • Prepare your historical conversion data (90 days minimum)
  • Hash all email addresses using SHA-256
  • Format data as CSV with required headers
  • Upload pre-campaign training data to designated S3 bucket
  • Set up automated daily or weekly uploads for campaign period
  • Verify data ingestion in Precision+ dashboard