Product & Technical Documentation
Product & Technical Documentation
Breadcrumbs

Data Activation

Teavaro provides profile and event level data activation.

Profile and event data can be sent as individual extracts or combined.

Profile data is usually a full extract, whereas event data would consist of the events for a selected period, for example 24h.

For data extracts we support CSV and JSONL format.

Other forms of activation include:

  1. Fetching data via GraphQL API.

  2. Receiving a selected events data stream.

  3. Sending selected fields to API, for example identifiers, consents, and attributes.


For more information, please contact helpdesk@teavaro.com.

Profile Data

Consists of the following:

Data source

Field description

Example

profiles

(core data)

owner
source
is_test
category
change_date
creation_date
JSON
"profiles": {
    "owner": "demo",
    "source": "brand-demo-com-info-ident",
    "is_test": false,
    "category": "visitor",
    "change_date": "2026-03-11T19:02:45.815+00:00",
    "creation_date": "2026-03-11T19:02:45.815+00:00"
},

identifiers

Identifiers include:

  • umid

  • customer ids (as available)

Each identifier is described with:

name
type
value
last_seen
JSON
"identifiers": [
    {
        "name": "umid",
        "type": "UMID",
        "value": "1932d2bd-3d3c-4422-b2d2-bd3d3cf42296",
        "last_seen": "2026-03-11T19:02:45.815+00:00"
    },
    {
        "name": "customer-id",
        "type": "GUID",
        "value": "12345678910",
        "last_seen": "2026-03-11T19:02:45.815+00:00"
    }
],

device_identifiers

Device identifiers include:

  • IDFA

  • GAID

  • ID sync ids

  • gclid,

  • etc.


Each device identifier is described with:

name
type
value
last_seen
JSON
"device_identifiers": [
    {
        "name": "gaid",
        "type": "DEVICEID",
        "value": "fa511497-331a-4a73-b372-a8544c76f3d9",
        "last_seen": "2026-03-11T19:02:45.815+00:00"
    },
    {
        "name": "ttdId",
        "type": "COOKIE",
        "value": "2f2c2b23-73a2-4602-a830-2b7e10c7a2a3",
        "last_seen": "2026-03-11T19:02:45.815+00:00"
    },
    {
        "name": "gclid",
        "type": "DEVICEID",
        "value": "Cj0KCQjwqPLOBhCiARIsAKRMPZpae7DOz1sg...",
        "last_seen": "2026-03-11T19:02:45.815+00:00"
    }
]

consents

Consents captured from consent management providers like for example OneTrust, using the consent string and mapping it to a more descriptive list of purposes with name and value.
JSON
"consents": [
  {
    "source": "brand-demo-com-info-ident",
    "purposes": [
      {
        "name": "analytics",
        "value": true
      },
      {
        "name": "functional",
        "value": true
      },
      {
        "name": "marketing",
        "value": true
      }
    ]
  },
  {
    "source": "publisher-demo-com-info-ident",
    "purposes": [
      {
        "name": "analytics",
        "value": false
      },
      {
        "name": "functional",
        "value": false
      },
      {
        "name": "marketing",
        "value": false
      }
    ]
  }
]

attributes

Attributes consist of aggregated events collections, for example page and product views, campaign engagements, ecommerce events; audience segments created through the audience builder, and onboarded attributes, for example socio-demographic, and next best action recommendations.


Each device identifier is described with:

field_name
type
value
JSON
"attributes": [
    {
        "type": "multiple",
        "value": [
            {
                "ls": "2026-04-11T15:59:58.144Z",
                "frequency": 1,
                "utm_medium": "email",
                "utm_source": "email",
                "utm_campaign": "demo-12345"
            }
        ],
        "field_name": "campaign"
    },
    {
        "type": "multiple",
        "value": [
            {
                "ls": "2026-04-11T16:00:19.399Z",
                "isp_city": "Absecon",
                "isp_name": "Comcast Cable Communications LLC",
                "isp_type": "ISP",
                "frequency": 4,
                "isp_region": "New Jersey",
                "isp_country": "US",
                "isp_latitude": "39.42845153808594",
                "isp_longitude": "-74.49571228027344"
            }
        ],
        "field_name": "ip2loc"
    },
    {
        "type": "multiple",
        "value": [
            {
                "ls": "2026-04-11T16:00:19.399Z",
                "device_os": "macOS",
                "frequency": 4,
                "device_type": "PC",
                "device_browser_name": "Chrome",
                "device_browser_type": "BR"
            }
        ],
        "field_name": "user_agent"
    }
],

Event Data

Consists of the following:

Field name

Description

Example

timestamp

ISO 8601 / RFC 3339 timestamp in UTC

2026-04-10T20:08:35.370Z

transaction_id

A unique id (UUID) per request.

019d8bce-65cf-78e9-956b-9778191f91c8

umid

Unified marketing id (UUID)

aeda2ced-59ff-485b-9a2c-ed59ff185b0b

device

User-agent derived information
JSON
{
  "Os": "Windows",
  "Class": "PC",
  "UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...",
  "BrowserType": "BR",
  "BrowserFamily": "Chrome",
  "BrowserVersion": "147.0.0.0"
}

location

IP address derived information
JSON
{
  "City": "Frankfurt am Main",
  "Region": "Hessen",
  "Latitude": 50.11088180541992,
  "Longitude": 8.68199634552002,
  "CountryCode": "DE"
}

isp

IP address derived information
JSON
{
  "Name": "A100 ROW GmbH",
  "UsageType": "DCH",
  "DomainName": "amazon.com"
}

pipeline_name

The pipeline name

brand-demo-com-info-ident

domain

The domain of the request.

funnelconnect.brand-demo.com

cv

Custom variable data incoming with request payload.

This is analytics, campaign and other tracking data for example obtained from data layer(s), query string parameters and any other local storage.
JSON
{
  "analytics": {
    "page": {
      "url": "https://www.brand-demo.com/?utm_source=demo",
      "name": "www.brand-demo.com",
      "action": "navigation",
      "timestamp": 1776167308742
    },
    "query_params": {
      "utm_source": [
        "demo"
      ],
      "utm_medium": [
        "demo"
      ]
    }
  }
}

destination

For ClickIdentTrack calls, the destination or landing page URL.

https://publisher-demo.media/?utm_source=demo1&utm_medium=demo2&etc