Data Parameters

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

ParameterDescriptionExamples / Notes
TimeDate+Time or timestamp of the event in UTC. Can be in seconds or milliseconds.2016-01-06 20:34:25 UTCOR
1453133038
IPFull 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 HintsEither 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.