Samba TV requires specific parameters to be present in your event logs in order to ensure high-quality deduplication.
We can accept multiple UID columns and their corresponding UID Type columns within the same file.
Required parameters
Please note that we can accept multiple UID columns and multiple corresponding UID Type columns
Parameter | Description | Examples / Notes |
---|---|---|
Time | Date+Time or timestamp of the event in UTC. Can be in seconds or milliseconds. | 2016-01-06 20:34:25 UTC OR1453133038 |
IP | Full IP address of the user. A hashed IP is also acceptable. IPs must not be truncated or randomized. | 192.168.0.1 |
UID[] | User ID (UID). If multiple UID types may appear in the same event, provide each UID in its own column. | Common identifiers: CTV: AAID, AFAI, IDFA, LGAID, RIDA, Mobile: AAID, GAID, IDFA, IFA, MAID Email Addresses: MD5, SHA1, SHA256 Cookie: Third-Party Cookie, First-Party Cookie (see note below) Hardware ID: did, didmd5, didsha1, dpid, dpidmd5, dpidsha1 |
UserAgent / Client Hints | Either the full User Agent string or modern User-Agent Client Hints headers. UA-CH is recommended for Chrome and other browsers that restrict User Agent strings. | UA string: "Mozilla/5.0 … Safari/537.36" UA-CH fields: Sec-CH-UA: "Chromium";v="118" Sec-CH-UA-Platform: "Windows" Sec-CH-UA-Mobile: ?0 |
First-party cookies: The domain (not full URL) from which the cookie was set must be included.
ID types
- Separate Columns: Each UID type should be placed in its own column whenever possible.
- Fallback Option: If UIDs cannot be split into separate columns, include an accompanying column specifying the UID type.
- Clear Designation: Properly labeling UID types is critical for matching, as different identifiers may belong to the same profile.