Visitor Profile API objects | Visitor Profile API |Tealium Docs

Visitor fields

Visitors are returned as JSON objects that contain the following fields:

Object Name	Type	Description
`live`	Boolean	Set to `true` if the visitor is currently in a live session.
`visitor`	object	The visitor object with sub-objects for each of the attribute data types: Visitor IDs: `secondary_ids : { }` Numbers/Array of Numbers: `"metrics" : { }` `"metric_lists" : { }` Strings/Array of Strings/Set of Strings: `"properties" : { }` `"property_lists" : { }` `"property_sets" : { }` `"audiences" : { }` Booleans/Array of Booleans: `"flags" : { }` `"flag_lists" : { }` Dates: `"dates" : { }` Badges: `"badges" : { }` Tallies: `"metric_sets" : { }` Timeline: `"sequences" : { }` Funnel: `"funnels" : { }`

Example response

{"live": false,
    "visitor": {
        "metrics": {
            "Weeks since first visit": 0.14,
            "Total referred visits": 11,
            "Lifetime visit count": 12,
            "Average visit duration in minutes": 0.36,
            "Lifetime event count": 35,
            "Total time spent on site in minutes": 4.27,
            "Total direct visits": 1
        },
        "dates": {
            "Last visit": 1521217490000,
            "last_visit_start_ts": 1521217490000,
            "First visit": 1521134626000
        },
        "properties": {
            "Lifetime browser versions used (favorite)": "Chrome",
            "Lifetime browser types used (favorite)": "Chrome",
            "profile": "main",
            "Lifetime devices used (favorite)": "Mac desktop",
            "Lifetime platforms used (favorite)": "browser",
            "Last event URL": "http://www.tealium.com/",
            "account": "tealium",
            "Lifetime operating systems used (favorite)": "Mac OS X"
        },
        "flags": {
            "Returning visitor": true
        },
        "funnels": {
            "fake_funnel": {
                "completed": true,
                "fake_title": {
                    "timestamp": 1655303842639,
                    "snapshot": {
                        "fake_string": "fake_string",
                        "Average visits per week": 1.0
                    }
                }
            },
            "pii_funnel": {
                "completed": true,
                "step2": {
                    "timestamp": 1655303842639,
                    "snapshot": {
                        "pii_string": "Example string",
                        "First visit": 1655303836000,
                        "Last event URL": "http://172.16.3.15:8000/datacloudtest.html"
                    }
                },
                "step1": {
                    "timestamp": 1655303842639,
                    "snapshot": {
                        "pii_string": "Example string"
                    }
                }
            }
        },
        "sequences": {
            "fake_timeline": [
                {
                    "timestamp": 1655303842639,
                    "snapshot": {}
                },
                {
                    "timestamp": 1655303842642,
                    "snapshot": {}
                },
                {
                    "timestamp": 1655303842652,
                    "snapshot": {}
                },
                {
                    "timestamp": 1655303842654,
                    "snapshot": {}
                },
                {
                    "timestamp": 1655303842665,
                    "snapshot": {}
                }
            ]
        },
        "audiences": [
            "fake_visitors"
        ],
        "badges": ["Unbadged"],
        "metric_sets": {
            "Lifetime operating systems used": {
                "Mac OS X": 12
            },
            "Lifetime devices used": {
                "Mac desktop": 12
            },
            "Lifetime browser versions used": {
                "Chrome": 12
            },
            "Lifetime browser types used": {
                "Chrome": 12
            },
            "Lifetime platforms used": {
                "browser": 12
            }
        }
    }
}