Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • UserName - Optional. The user associated with the event. If not passed, the method will use the current user credentials.
  • SessionID - Required. The A unique browser session ID associated with the event.
  • Event Type - Required. The event type ID number
  • URL - Required. The URL of the page where the event occurred.
  • UserAgent - Optional. The user details including browser type and OS version.
  • ClientIP - Optional. The user IP address.
  • Param1 - Optional. Used to store additional information about the event, typically for custom event types. This string is limited to 1000 characters. Built-in events reserve this string for the system. For example, in a "Visit" event it stores the referrer information; in a "Search" event it stores the search term.
  • Param2 - Optional. Used to store additional information about the event, typically for custom event types. This string is limited to 50 characters. Built-in events reserve this string for the system. For example, in a "Search" event it is used to store the number of results.

...

You can create custom event types and build custom reports using the CardioLog SDK. The custom event types can be used in the SendEvent function, for both Client-Side and Server-Side APIs. For example, if your website is a sales site and you wish to track each product sold, and then you can create a report on the number of items sold, and create a custom event type in CardioLog named "Items-Sold."

...

4. Create a custom report to display the number of items sold using the CardioLog SDK.

Anchor
#rest api
#rest api
The REST API

In order to track visitor actions for custom browsers and non-browser apps, developers must send usage event objects to the CardioLogAgent web application through HTTP POST requests in JSON format. The JSON string must be embedded in the request body. The POST response is provided in JSON format as well.

...

CardioLog Analytics usage event objects have the following properties:

  • u - Decoded URL of the page the event is related to. For example, the URL of a "View" event will be the current page; the URL of a search result will be the clicked link.
  • X - Holds the following event dependent information:
    • Search event - The search term
    • View event:
      • If __Referrer parameter was passed to this page, __Referrervalue 
      • If there is a Referrer cookie, sends the ReferrerReason cookie value 
      • If this is the first page the user views in this session, sends "First In Session" and appends the data from __Referreragent
    • Duration event - Time on page in seconds
  • Y - Holds the following information:
    • In Search event - Number of total results
    • In Visit event - If there is a Referrer cookie, sends its content
    • In Duration event - Last visit event ID
  • Z - In Search event - First result on page (number of results)
  • RI - Last event ID
  • et - Event type code (eg., Goal event is 20, Leave event is 1, etc.)
  • events - The event can have sub events sent with it. Typically, this is used when a search event is sent or with saved events.

In addition to event objects, the request body may include includes the following properties:

  • browserType - The user-agent information.
  • sessionid - Required. A unique browser session ID associated with the event. The unique session ID associated with the events. Any string format accepted.
  • un - User name. Any username associated with the events. Any string format accepted. If not passed, the current user credentials will be used.

The JSON Request Format

The full JSON request format is as follows:

{
    "events": {
      "event": [
        {
          "u": "http://www.intlock.com/pages/home.aspx",
          "X": "|referral|blog.intlock.com|/about/||",
          "et": 0,
          "RI": 564940
        },
        {
          "X": "1",
          "Y": "7",
          "et": 23,
          "RI": 0
        }
      ]
    },
    "browserType": "Apple-iPhone5C2/1001.525",
    "sessionid": "861529144.325047542",
    "un": "INTLOCK\\tomj"
}

...