# VisitorsByWebsiteId: Crisp Visitors ## Documentation Visitors present on a website right now; the contents change from one moment to the next. - Catalog: `Crisp` - Schema: `Crisp` - Primary Keys: `session_id` - Label: Visitors This is a read-only table function. The Crisp API may not support changing the data or the Invantive UniversalSQL driver for Crisp does not cover it. In the latter case, please use the table NativePlatformScalarRequests to upload data to the Crisp API. ## Parameters of Table Function The following parameters can be used to control the behaviour of the table function `VisitorsByWebsiteId`. A value must be provided at all times for required parameters, but optional parameters in general do not need to have a value and the execution will default to a pre-defined behaviour. Values can be specified by position and by name. In both cases, all parameters not specified will be evaluated using their default values. Value specification by position is done by listing all values from the first to the last needed value. For example: a `select * from table(value1, value2, value3)` on a table with four parameters will use the default value for the fourth parameter and the specified values for the first three. Value specification by name is done by listing all values that require a value. For example with `select * from table(name1 => value1, name3 => value3)` on the same table will use the default values for the second and fourth parameters and the specified values for the first and third. | Name | Data Type | Required | Default Value | Documentation | |---|:---:|:---:|:---:|---| | `website_id` | `varchar2` | ☐ | | The website identifier. Defaults to the website ID of the connection when left out. | | `website_id` | `varchar2` | ☐ | | The website identifier. Defaults to the website ID of the connection when left out. | ## Columns of Table Function The columns of the table function `VisitorsByWebsiteId` are shown below. Each column has an SQL data type. | Name | Data Type | Label | Required | Documentation | |---|:---:|---|:---:|---| | `active` | `char` | | ☐ | Whether the visitor is actively browsing or not. | | `active` | `char` | | ☐ | Whether the visitor is actively browsing or not. | | `avatar` | `varchar2` | | ☐ | Avatar of the visitor. | | `avatar` | `varchar2` | | ☐ | Avatar of the visitor. | | `email` | `varchar2` | | ☐ | Email of the visitor. | | `email` | `varchar2` | | ☐ | Email of the visitor. | | `geolocation_city` | `varchar2` | | ☐ | City name. | | `geolocation_city` | `varchar2` | | ☐ | City name. | | `geolocation_coordinates_latitude` | `decimal` | | ☐ | Latitude coordinate. | | `geolocation_coordinates_latitude` | `decimal` | | ☐ | Latitude coordinate. | | `geolocation_coordinates_longitude` | `decimal` | | ☐ | Longitude coordinate. | | `geolocation_coordinates_longitude` | `decimal` | | ☐ | Longitude coordinate. | | `geolocation_country` | `varchar2` | | ☐ | Country code. | | `geolocation_country` | `varchar2` | | ☐ | Country code. | | `geolocation_region` | `varchar2` | | ☐ | Region code. | | `geolocation_region` | `varchar2` | | ☐ | Region code. | | `inbox_id` | `varchar2` | | ☐ | Inbox identifier of the visitor (if any). | | `inbox_id` | `varchar2` | | ☐ | Inbox identifier of the visitor (if any). | | `initiated` | `char` | | ☐ | Whether the session is initiated or not. | | `initiated` | `char` | | ☐ | Whether the session is initiated or not. | | `last_page_title` | `varchar2` | | ☐ | Title of the last page browsed. | | `last_page_title` | `varchar2` | | ☐ | Title of the last page browsed. | | `last_page_url` | `varchar2` | | ☐ | URL of the last page browsed. | | `last_page_url` | `varchar2` | | ☐ | URL of the last page browsed. | | `nickname` | `varchar2` | | ☐ | Nickname of the visitor. | | `nickname` | `varchar2` | | ☐ | Nickname of the visitor. | | `session_id` | `varchar2` | | ☑ | Session identifier of the visitor. | | `session_id` | `varchar2` | | ☑ | Session identifier of the visitor. | | `timezone` | `int32` | | ☐ | Time zone offset of the visitor in minutes relative to UTC, negated (-120 stands for UTC+02:00). | | `timezone` | `int32` | | ☐ | Time zone offset of the visitor in minutes relative to UTC, negated (-120 stands for UTC+02:00). | | `useragent` | `varchar2` | | ☐ | User agent as advertised by the browser of the visitor. | | `useragent` | `varchar2` | | ☐ | User agent as advertised by the browser of the visitor. |# VisitorsByWebsiteId: Crisp Visitors ## Documentation Visitors present on a website right now; the contents change from one moment to the next. - Catalog: `Crisp` - Schema: `Crisp` - Primary Keys: `session_id` - Label: Visitors This is a read-only table function. The Crisp API may not support changing the data or the Invantive UniversalSQL driver for Crisp does not cover it. In the latter case, please use the table NativePlatformScalarRequests to upload data to the Crisp API. ## Parameters of Table Function The following parameters can be used to control the behaviour of the table function `VisitorsByWebsiteId`. A value must be provided at all times for required parameters, but optional parameters in general do not need to have a value and the execution will default to a pre-defined behaviour. Values can be specified by position and by name. In both cases, all parameters not specified will be evaluated using their default values. Value specification by position is done by listing all values from the first to the last needed value. For example: a `select * from table(value1, value2, value3)` on a table with four parameters will use the default value for the fourth parameter and the specified values for the first three. Value specification by name is done by listing all values that require a value. For example with `select * from table(name1 => value1, name3 => value3)` on the same table will use the default values for the second and fourth parameters and the specified values for the first and third. | Name | Data Type | Required | Default Value | Documentation | |---|:---:|:---:|:---:|---| | `website_id` | `varchar2` | ☐ | | The website identifier. Defaults to the website ID of the connection when left out. | | `website_id` | `varchar2` | ☐ | | The website identifier. Defaults to the website ID of the connection when left out. | ## Columns of Table Function The columns of the table function `VisitorsByWebsiteId` are shown below. Each column has an SQL data type. | Name | Data Type | Label | Required | Documentation | |---|:---:|---|:---:|---| | `active` | `char` | | ☐ | Whether the visitor is actively browsing or not. | | `active` | `char` | | ☐ | Whether the visitor is actively browsing or not. | | `avatar` | `varchar2` | | ☐ | Avatar of the visitor. | | `avatar` | `varchar2` | | ☐ | Avatar of the visitor. | | `email` | `varchar2` | | ☐ | Email of the visitor. | | `email` | `varchar2` | | ☐ | Email of the visitor. | | `geolocation_city` | `varchar2` | | ☐ | City name. | | `geolocation_city` | `varchar2` | | ☐ | City name. | | `geolocation_coordinates_latitude` | `decimal` | | ☐ | Latitude coordinate. | | `geolocation_coordinates_latitude` | `decimal` | | ☐ | Latitude coordinate. | | `geolocation_coordinates_longitude` | `decimal` | | ☐ | Longitude coordinate. | | `geolocation_coordinates_longitude` | `decimal` | | ☐ | Longitude coordinate. | | `geolocation_country` | `varchar2` | | ☐ | Country code. | | `geolocation_country` | `varchar2` | | ☐ | Country code. | | `geolocation_region` | `varchar2` | | ☐ | Region code. | | `geolocation_region` | `varchar2` | | ☐ | Region code. | | `inbox_id` | `varchar2` | | ☐ | Inbox identifier of the visitor (if any). | | `inbox_id` | `varchar2` | | ☐ | Inbox identifier of the visitor (if any). | | `initiated` | `char` | | ☐ | Whether the session is initiated or not. | | `initiated` | `char` | | ☐ | Whether the session is initiated or not. | | `last_page_title` | `varchar2` | | ☐ | Title of the last page browsed. | | `last_page_title` | `varchar2` | | ☐ | Title of the last page browsed. | | `last_page_url` | `varchar2` | | ☐ | URL of the last page browsed. | | `last_page_url` | `varchar2` | | ☐ | URL of the last page browsed. | | `nickname` | `varchar2` | | ☐ | Nickname of the visitor. | | `nickname` | `varchar2` | | ☐ | Nickname of the visitor. | | `session_id` | `varchar2` | | ☑ | Session identifier of the visitor. | | `session_id` | `varchar2` | | ☑ | Session identifier of the visitor. | | `timezone` | `int32` | | ☐ | Time zone offset of the visitor in minutes relative to UTC, negated (-120 stands for UTC+02:00). | | `timezone` | `int32` | | ☐ | Time zone offset of the visitor in minutes relative to UTC, negated (-120 stands for UTC+02:00). | | `useragent` | `varchar2` | | ☐ | User agent as advertised by the browser of the visitor. | | `useragent` | `varchar2` | | ☐ | User agent as advertised by the browser of the visitor. |