TrustData
Getting started

Core concepts

Understand TrustData's account structure and key concepts.

TrustData uses a hierarchical structure: Organizations contain Properties, and Properties contain Attribution IDs (data streams).

Account structure

Organization (your company or client)
    │
    └── Property (a logical user base)
            │
            ├── Attribution ID (website stream)
            ├── Attribution ID (another website stream)
            └── Attribution ID (app stream)

Organization

An Organization is the top-level container in TrustData.

  • Represents a company, brand, or client
  • Contains one or more properties
  • Has its own users, billing, and permissions
  • Role-based access control (RBAC) manages who can view or edit

Typical setups:

  • Small business: One organization for your company
  • Agency: One organization per client

Property

A Property represents a logical user base—a set of users you want to analyze together.

  • Belongs to one organization
  • Contains one or more attribution IDs (data streams)
  • Has its own data sources (ad platform connections)
  • Data is isolated between properties

When to use one property:

  • Single website or app
  • Small business with one domain

When to use multiple attribution IDs under one property:

  • Same business with web + mobile app (same user base)
  • Regional sites that share users (e.g., brand.com, brand.co.uk)
  • Staging and production environments for the same site

Attribution ID

An Attribution ID identifies a specific data stream—a source of event data like a website or app.

  • Each website or app gets its own attribution ID
  • Used in the tracking SDK to identify where events come from
  • Multiple attribution IDs can roll up into one property

Example:

Organization: Acme Corp
    │
    └── Property: Acme Store (all Acme users)
            │
            ├── Attribution ID: acme-web (acme.com)
            ├── Attribution ID: acme-uk (acme.co.uk)
            └── Attribution ID: acme-app (iOS/Android)

For small businesses, you'll typically have one organization, one property, and one attribution ID.

Visitor identity

TrustData assigns identifiers to track visitors across sessions:

IdentifierScopePurpose
Visitor IDPersistent (local storage)Tracks the same visitor across sessions
Session IDSingle sessionGroups events within one visit
User IDAuthenticated (optional)Links to your user database

When a visitor returns, TrustData recognizes them via the visitor ID and connects their full journey.

Click ID capture

When a user clicks an ad, the ad platform appends a click ID to the URL:

PlatformParameter
Google Adsgclid
Meta Adsfbclid
TikTok Adsttclid
Microsoft Adsmsclkid

TrustData automatically captures these click IDs and stores them with the visitor. When a conversion occurs, TrustData matches it back to the original click for attribution.

Smart Links are trackable URLs you create in TrustData to measure clicks from any surface — ads, emails, QR codes, influencer posts, SMS campaigns.

Unlike standard UTM links, Smart Links:

  • Are hosted on your own domain (e.g., go.example.com/summer-sale)
  • Support mobile deep linking (open the app directly if installed)
  • Track clicks server-side, independent of browser or ad blockers
  • Work without a JavaScript SDK on the destination page

Smart Links belong to a property and are managed under SettingsSmart Links.

Data sources

A Data Source is a connection to an external platform:

TypeExamplesData Synced
AdvertisingGoogle Ads, Meta Ads, TikTok AdsCampaigns, spend, clicks, impressions
E-commerceShopifyOrders, revenue, products
CustomWebhooks, APIAny structured data

Data sources belong to a property and sync automatically on a daily schedule.

Events

Events are user interactions tracked by the SDK:

// Pageview (automatic)
// Tracked automatically when sendPageView: true

// Custom event
trustdata.push(['event', 'add_to_cart', {
  id: 'SKU123',
  value: 49.99
}]);

// Conversion event
trustdata.push(['event', 'purchase', {
  order_id: 'ORD-456',
  value: 149.99,
  currency: 'USD'
}]);

Events are stored in ClickHouse and associated with the attribution ID they came from.

Attribution models

TrustData uses Data-Driven attribution by default:

Unlike simple models (last-click, first-click), Data-Driven attribution:

  1. Consider all touchpoints in the customer journey
  2. Assign fair credit based on each channel's contribution
  3. Use game theory to calculate marginal value

Example: Customer sees a Meta ad, then clicks a Google ad, then converts:

ModelMeta CreditGoogle Credit
Last-click0%100%
First-click100%0%
Linear50%50%
Data-Driven35%65%

Data-Driven attribution accounts for the incremental value each touchpoint adds.

For measuring true causal lift independent of platform claims, incrementality testing (geo holdouts) is on the roadmap.

Attribution window

The attribution window defines how far back to look for touchpoints:

WindowUse Case
7 daysImpulse purchases, low-cost items
30 daysStandard e-commerce (default)
90 daysHigh-consideration purchases, B2B

Configure this per property in SettingsAttribution.

TrustData tracks a 4-level consent model:

LevelPurpose
AnalyticsBasic analytics and performance measurement
AdvertisingAd targeting and conversion tracking
PreferencesPersonalization and saved settings
Sale of DataThird-party data sharing (CCPA)

You can see consent acceptance rates for each level in the dashboard.