Jump to: navigation, search

Visitor Identification

Overview

Genesys Web Engagement allows you to capture visitor activities on your website and to build a complete history of the visitor’s interactions with your contact center.

When a visitor browses your website, the tracking code submits System events to the Web Engagement servers that constitute a visit, such as VisitStarted, PageEntered, SignIn, UserInfo, and so on. The association or relationship between the visit and the visitor is based on the flow derived from System events, in addition to the information retrieved from the Contact Server. In the end, you can access visit history through the Event Resource in the History REST API.

To associate the visitor with the visit, Genesys Web Engagement must "identify" the visitor as one of three possible states:

  • Authenticated — The visitor logged in to the website with a username and password. The username can be an e-mail address, an account name or other similar identifier, depending on your website. When a user is authenticated, Genesys Web Engagement can maintain an association between the visitor and the visit.
  • Recognized — The visitor closed the browser window and did not log out, but cookies are saved. The next time the visitor comes to the website, the website can submit cookie-based user information, which contains the userId.
  • Anonymous — The visitor is anonymous.
Visitor states

Genesys Web Engagement relies on your website to trigger the transitions between visitor states. You can do this by updating the tracking code with the following events in the Monitoring JS API:

  • _gt.push(['sendSignIn', options]) — Send this event when the user is authenticated by the website. This allows the system to identify the user and creates a new "session" with a sessionId that is unique to a visit and will last the duration of the visit. Only Authenticated visitors have an associated sessionId.
  • _gt.push(['sendSignOut', options]) — Send this event when the user logs out of the website.
    Note: The sessionId lasts for the duration of the authenticated user's visit to your website. It is stored in a cookie and sent with every event that occurs between SignIn and SignOut, and is changed automatically after every SignIn event.

Visitor Event Timeline

The figure below shows the timeline for events that take place when a visitor browses your website.

Visitor Event Timeline

All visitors to your website are identified with a visitId, which can be used to associate the visitor to events, such as PageEntered or PageExited, during the span of the visit.

Important
SessionStarted and SessionEnded events are internal and cannot be generated by public API.

Accessing Visitor Information

The History REST API is a RESTful interface for accessing visit and identity information — in the form of a collection of JSON objects — via POST and GET HTTP requests:

  • The visit resource represents the sequence of pages that a given visitor went through.
  • The identity resource contains information about authenticated and recognized visitors.
  • The session resource contains information about the events and pages that a visitor browsed during an authenticated session within a visit.
  • The page resource contains information about browsed pages. If a visitor revisits a page, a new page resource is created.
  • The event resource contains information about System and Business events. For details about how these events are structure, see Events Structure.

Authenticated Visitors

When the visitor is Authenticated on the website, you should use the sendSignIn event so that Genesys Web Engagement can start a new session. When the Backend Server receives this event, it creates a session resource and an identity resource to store the visitor information. The identifying information used to login (for instance, the e-mail address) is available in the SignIn event and is used to:

  • Create the identityId or search the visitor's identity resource.
  • Associate the visitor with a contact in the Genesys solution.
GPE SignIn event.png

The SignOut and UserInfo events are used to manage the collections of additional information. These collections, called contacts and useridentifications, are introduced in the Backend Server database.

  • The contacts collection maintains the association between the identityIds and the sessionId, visitId, and globalVisitId.
  • The useridentifications collection stores all of the System events.

Recognized Visitors

When an Authenticated visitor closes the browser window without signing out and then later revisits your site, you can use the _gt.push(['sendUserInfo', options]) command to tell Genesys Web Engagement that the visitor is now Recognized.

You will need to send the userId in the _gt.push(['sendUserInfo', options]) event. How you track the userId depends on your website. For example, you could create a persistent cookie to store the userId when a visitor logs in to you website. Then when a visitor first browses your site, you could check the cookie and call the _gt.push(['sendUserInfo', options]) event if the cookie contains the userId. There are many possible scenarios - the best implementation is entirely dependent on your website and its workflow.

Important
The visitor's identity cannot be guaranteed in the Recognized state. For instance, another member of the visitor's family could be browsing the website with the same computer.

Anonymous Visitors

If the visitor is not Authenticated or Recognized, no identity is created. The visitor's activity on the website, including events and pages visited, are still associated with the visit.

This page was last edited on July 14, 2016, at 23:37.
Comments or questions about this documentation? Contact us for support!