Jump to: navigation, search

Identity Resource

The identity resource contains visitor information and is created when the Backend Server receives the SignIn event. The Browser Tier generates this event when the visitor signs in (or is authenticated with the company web portal). The identification information submitted by the visitor is used to create the identity ID (for instance, the e-mail address or an account name). Additionally, it creates a new session with a unique session ID across the visit, which becomes the new active session for the current visit. At this point, the identification scope of the visitor is Authenticated. If the visitor signs out, the Backend Server receives the SignOut event and the identification scope becomes Recognized. For further information on events, see Event Resource.

Resource Details

Field Type Mandatory Description
identityId string yes The unique ID of the given identity. The visitor provides the identityId information when registering on the website; for instance, it can be the e-mail address.
name string no User name.
location string no User location.
entityInCS string no Entity in the Contact Server.
visitScope Authenticated,

Recognized

yes Specify the visit's identification scope in relation to the visitor. If the visitor is authenticated, you can retrieve session information. If the visitor signs out, the visit scope changes to recognized.
eventIds string[] no Array of event IDs<ref name="guid">GUID (Globally Unique Identifier)</ref> associated with this identity.
events event[] no Array of the event resources associated with this identity.
pageIds string[] no Array of page IDs<ref name="guid"/> associated with this identity.
pages page[] no Array of the page resources associated with this identity.
sessionIds string[] no Array of session IDs<ref name="guid"/> associated with this identity.
sessions session[] no Array of the session resources associated with this identity.
visitIds string[] no Array of visit IDs<ref name="guid"/> associated with this identity.
visits visit[] no Array of the visit resources associated with this identity.

<references />

Related Requests

Examples

Retrieving Identities

The following request retrieves all the identities available.

Request

GET http://198.51.100.12:9081/backend/data/identities

Response

HTTP/1.1 200 OK
Date: Wed, 12 Dec 2012 15:17:09 GMT
Content-Type: application/json; charset=UTF-8
Date: Wed, 12 Dec 2012 15:17:09 GMT
Accept-Ranges: bytes
Server: Restlet-Framework/2.1.0
Content-Length: 477
[{"eventIds":null,"events":null,"pageIds":null,"pages":null,
"sessionIds":null,"sessions":null,"identityId":"pat.thompsom@genesyslab.com",
"name":null,"location":null,"entityInCS":null,"visitScope":"Authenticated",
"visitIds":null,"visits":null},
{"eventIds":null,"events":null,"pageIds":null,"pages":null,
"sessionIds":null,"sessions":null,"identityId":"user@genesyslab.com",
"name":null,"location":null,"entityInCS":null,"visitScope":"Authenticated",
"visitIds":null,"visits":null}]

Retrieving Identities with page IDs

The following request retrieves all the identities available, including the associated page IDs.

Request

GET /backend/data/identities?include_pages=true

Response

HTTP/1.1 200 OK
Date: Wed, 12 Dec 2012 15:28:13 GMT
Content-Type: application/json; charset=UTF-8
Date: Wed, 12 Dec 2012 15:28:13 GMT
Accept-Ranges: bytes
Server: Restlet-Framework/2.1.0
Content-Length: 627
[{"eventIds":null,"events":null,
"pageIds":["11ff6de0-446e-11e2-bfd2-00505625a04f"],
"pages":null,"sessionIds":null,"sessions":null,"
identityId":"pat.thompsom@genesyslab.com",
"name":null,"location":null,"entityInCS":null,
"visitScope":"Authenticated","visitIds":null,
"visits":null},
{"eventIds":null,"events":null,
"pageIds":["45f0eda1-3fa4-11e2-aee5-00505625a04f","c489cac0-3fa3-11e2-aee5-00505625a04f",
"06afd7f0-3fa4-11e2-aee50505625a04f"],"pages":null,"sessionIds":null,
"sessions":null,"identityId":"user@genesyslab.com",
"name":null,"location":null,"entityInCS":null,"visitScope":"Authenticated",
"visitIds":null,"visits":null}]
This page was last edited on July 11, 2014, at 19:52.
Comments or questions about this documentation? Contact us for support!