Statistics & analytics
Get tracking session slices by attendee id
4 min
{ "tab" "examples", "url" "https //api brella io/api/integration/organizations/{organizationid}/events/{eventid}/attendees/{attendeeid}/tracking session slices", "name" "get tracking session slices by attendee id", "method" "get", "request" { "pathparameters" \[ { "kind" "required", "name" "{organizationid}", "type" "number", "children" \[], "description" "the id of the brella organization you are trying to retrieve data from" }, { "kind" "required", "name" "{eventid}", "type" "number", "children" \[], "description" "the id of the brella event you are trying to retrieve data from" }, { "kind" "required", "name" "{attendeeid}", "type" "number", "children" \[], "description" "the id of the attendee you are trying to retrieve data from" } ], "queryparameters" \[], "headerparameters" \[ { "kind" "required", "name" "brella api access token", "type" "string", "children" \[], "description" "your unique brella api key" }, { "kind" "required", "name" "accept", "type" "string", "children" \[], "description" "application/vnd brella v4+json" }, { "kind" "required", "name" "content type", "type" "string", "children" \[], "description" "application/json" } ], "bodydataparameters" \[], "formdataparameters" \[] }, "results" { "languages" \[ { "id" "psobomoj9uo00ibrqhmgp", "code" "{\n \\"data\\" \[\n {\n \\"id\\" \\"66097\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 15t10 08 03 055z\\",\n \\"end time\\" \\"2023 05 15t10 09 00 993z\\",\n \\"duration seconds\\" 58\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13521\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"65967\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 10t11 49 15 019z\\",\n \\"end time\\" \\"2023 05 10t12 47 33 929z\\",\n \\"duration seconds\\" 3499\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13496\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"65965\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 10t11 06 35 752z\\",\n \\"end time\\" \\"2023 05 10t12 05 32 728z\\",\n \\"duration seconds\\" 3537\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13496\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"65958\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 10t10 38 44 630z\\",\n \\"end time\\" \\"2023 05 10t10 39 55 061z\\",\n \\"duration seconds\\" 70\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13496\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"65956\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 10t10 10 39 732z\\",\n \\"end time\\" \\"2023 05 10t10 36 18 231z\\",\n \\"duration seconds\\" 1538\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13496\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"65955\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 10t09 55 47 422z\\",\n \\"end time\\" \\"2023 05 10t10 16 43 714z\\",\n \\"duration seconds\\" 1256\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13496\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"65954\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 10t09 42 25 811z\\",\n \\"end time\\" \\"2023 05 10t10 12 10 206z\\",\n \\"duration seconds\\" 1784\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13496\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"65885\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 10t08 32 35 024z\\",\n \\"end time\\" \\"2023 05 10t09 31 33 320z\\",\n \\"duration seconds\\" 3538\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13496\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"65877\\",\n \\"type\\" \\"tracking session slice\\",\n \\"attributes\\" {\n \\"tracking type\\" \\"time spent\\",\n \\"click time\\" null,\n \\"start time\\" \\"2023 05 10t04 18 38 073z\\",\n \\"end time\\" \\"2023 05 10t04 19 30 977z\\",\n \\"duration seconds\\" 53\n },\n \\"relationships\\" {\n \\"tracking session\\" {\n \\"data\\" {\n \\"id\\" \\"13494\\",\n \\"type\\" \\"tracking session\\"\n }\n }\n }\n }\n ],\n \\"included\\" \[\n {\n \\"id\\" \\"693\\",\n \\"type\\" \\"trackable\\",\n \\"attributes\\" {\n \\"trackable type\\" \\"event\\",\n \\"name\\" \\"\ boom live \ boom\ unicorn hunt conference\\",\n \\"title\\" null,\n \\"url\\" null,\n \\"body type\\" null\n }\n },\n {\n \\"id\\" \\"13521\\",\n \\"type\\" \\"tracking session\\",\n \\"attributes\\" {\n \\"interaction count\\" 0,\n \\"duration seconds\\" 58\n },\n \\"relationships\\" {\n \\"trackable\\" {\n \\"data\\" {\n \\"id\\" \\"693\\",\n \\"type\\" \\"trackable\\"\n }\n },\n \\"tracking session slices\\" {\n \\"data\\" \[\n {\n \\"id\\" \\"66097\\",\n \\"type\\" \\"tracking session slice\\"\n }\n ]\n }\n }\n },\n {\n \\"id\\" \\"53129\\",\n \\"type\\" \\"trackable\\",\n \\"attributes\\" {\n \\"trackable type\\" \\"sponsor\\",\n \\"name\\" \\"bob, from bob vance refrigeration\\",\n \\"title\\" null,\n \\"url\\" null,\n \\"body type\\" null\n }\n },\n {\n \\"id\\" \\"13496\\",\n \\"type\\" \\"tracking session\\",\n \\"attributes\\" {\n \\"interaction count\\" 3,\n \\"duration seconds\\" 15222\n },\n \\"relationships\\" {\n \\"trackable\\" {\n \\"data\\" {\n \\"id\\" \\"53129\\",\n \\"type\\" \\"trackable\\"\n }\n },\n \\"tracking session slices\\" {\n \\"data\\" \[\n {\n \\"id\\" \\"65967\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65965\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65958\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65956\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65955\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65954\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65885\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65887\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65886\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65884\\",\n \\"type\\" \\"tracking session slice\\"\n }\n ]\n }\n }\n },\n {\n \\"id\\" \\"3187\\",\n \\"type\\" \\"trackable\\",\n \\"attributes\\" {\n \\"trackable type\\" \\"sponsor\\",\n \\"name\\" \\"google cloud platform send us a virtual meeting request!\\",\n \\"title\\" null,\n \\"url\\" null,\n \\"body type\\" null\n }\n },\n {\n \\"id\\" \\"13494\\",\n \\"type\\" \\"tracking session\\",\n \\"attributes\\" {\n \\"interaction count\\" 1,\n \\"duration seconds\\" 53\n },\n \\"relationships\\" {\n \\"trackable\\" {\n \\"data\\" {\n \\"id\\" \\"3187\\",\n \\"type\\" \\"trackable\\"\n }\n },\n \\"tracking session slices\\" {\n \\"data\\" \[\n {\n \\"id\\" \\"65878\\",\n \\"type\\" \\"tracking session slice\\"\n },\n {\n \\"id\\" \\"65877\\",\n \\"type\\" \\"tracking session slice\\"\n }\n ]\n }\n }\n }\n ],\n \\"meta\\" {\n \\"total count\\" 9,\n \\"total pages\\" 1,\n \\"current page\\" 1\n }\n}\n", "language" "200", "customlabel" "" }, { "id" "zacajbwcd8fuhtfgoffqr", "language" "204", "code" "{\n \\"data\\" \[],\n \\"included\\" \[],\n \\"meta\\" {\n \\"total count\\" 0,\n \\"total pages\\" 0,\n \\"current page\\" 1\n }\n}\n", "customlabel" "" } ], "selectedlanguageid" "psobomoj9uo00ibrqhmgp" }, "examples" { "languages" \[ { "id" "58 p6ec5ew 4ak8jmjcmg", "code" "curl location g request get 'https //api brella io/api/integration/organizations/{organizationid}/events/{eventid}/attendees/{attendeeid}/tracking session slices' \\\\\n header 'brella api access token string' \\\\\n header 'accept application/vnd brella v4+json' \\\\\n header 'content type application/json'", "language" "curl", "customlabel" "" } ], "selectedlanguageid" "58 p6ec5ew 4ak8jmjcmg" }, "description" "get all tracking sessions for a specific attendee at the event", "currentnewparameter" { "label" "path parameter", "value" "pathparameters" } } notes filtering data the following url attributes are accepted for filtering tracking type trackable type click time start time end time duration start from start to end from end to note on filtering by tracking type by default, this endpoint returns three types of tracking sessions time spent sponsor streamlink give the value for this param as "time spent" — otherwise, it will also return clicks in media elements in the sponsor booth etc a note about filtering by time (i e using start time , end time , start from , start to , end from , end to ) start time and end time will search for an exact match for sessions that start / end at an exact time these filtering options are not commonly used in automated retrievals, unless you are manually searching for slices from an exact time for automated retrieval, we recommend using the start from , start to , end from , end to attributes by providing these attributes, the endpoint finds records where start time is between start from and start to respectively it finds records where end time is between end from and end to you can also provide an open ended time range, for example by only providing start from but not start to in this case the endpoint selects records where start time is greater than or equal to start from but doesn't limit results by a maximum start time usage example whether an attendee "checks in to" / uses the event app during the event an example use case of tracking whether an attendee “checked in” to brella during an event (presence) let's assume that you have an event that begins on 2023 05 10 and ends on 2023 05 15 you've invited people to brella a week before the event, but, you are only interested in whether they checked in after the event begins (i e on or after 2023 05 10 ) so, your requests would look like the following https //api brella io/api/integration/organizations/{{organizationid}}/events/{{event id}}/attendees/{{attendeeid}}/tracking session slices?tracking type=time spent\&start from= 2023 05 10t00 00 00 000z this would return any session slices that begin after 2023 05 10t00 00 00 000z while you could specify the exact event start time as well, we recommend just leaving it at midnight that day to account for edge cases if the attendee has visited brella after the specified time, the endpoint will return all relevant tracking session slices if the attendee didn't "check in/ visit brella during this time", it will return an empty response so, basically, all you need to do is run this query for your attendees, dynamically replacing the attendee id, and if the response is empty they haven't "checked in", if the response has data, then, that attendee has "checked in"