Web tracking

From Genesys Documentation
Jump to: navigation, search
This topic is part of the manual Altocloud Administrator's Guide for version Current of Altocloud.

Configure how Altocloud tracks your visitors as they move through your website.

Configure web tracking

  1. Click Admin.
  2. Under Altocloud, click Web Tracking.
  3. Specify the allowed domains.
    Initially, configure only the allowed domains. Then use Live Now to verify that Altocloud is tracking events. After basic tracking works, configure the rest of the web tracking settings.
  4. Specify any excluded IP addresses.
  5. Specify the short ID length.
  6. Specify any URL query parameters that Altocloud should ignore.
  7. Indicate whether Altocloud should keep URL fragments.
  8. Specify any site search settings.
  9. Click Save.

Allowed domains

Identify the website domains that you want to accept web traffic from.

  • Include only domain and sub-domains labels. Do not include additional /paths after the domain.
  • Altocloud validates your domain entries and displays an error message if any are incorrect.
  • NEW: This list of allowed domains should match the list of allowed domains for the widget.
  1. Under Allowed Domains, click Add first domain.
  2. Type the domain you want to track.
  3. To add another domain, click Add more.

Exclude IP addresses


You can designate IP addresses for which Altocloud should not generate web events. For example, you might not want to track visits from internal users.

  • This feature works in addition to whatever blocking your corporate IT department does to block external traffic from competitors, robo-spammers, and so on.
  • You can add up to 10 IP filters.
  • If you are not sure of what IP addresses to exclude, check with your network administrator and watch incoming traffic on your website logs.
  • IP filtering works only when Altocloud processes web beacons. Therefore, you cannot use this setting to block Altocloud's tracking of custom events.

To block an IP address:

  1. Click Add IP address.
  2. In the Enter an IP filter box, type either a single IP address or use CIDR notation to specify a range of IP addresses.
    • Altocloud supports both IPv4 and IPv6 protocols. For IPv6, Altocloud supports both the shorthand and expanded version.
    • IP examples
  3. In the adjacent box, type a recognizable name for the IP address.
  4. Click the check mark.
To see the implied CIDR range of the IP address you entered, hover over it.

IP examples

Valid IP addresses (IPv4)

Valid IPv4 CIDR input follows the format: <A valid IPv4 address>/<A number from 0-32>.

Good examples Bad examples
  • (the max for IPv4 is /32)
  • (cannot be a negative number)
  • (must be a whole number)
  • (no special characters allowed)
  • (only 1 slash allowed)

Valid IP addresses (IPv6)

Valid IPv6 CIDR input follows the format: <A valid IPv6 address>/<A number from 0-128>.

Good examples Bad examples
  •  ::1/32
  •  ::1/64
  •  ::1/128
  •  ::1/129 (the max for IPv6 is /128)
  •  ::1/-1 (cannot be a negative number)
  •  ::1/.10 (must be a whole number)
  •  ::1/& (no special characters allowed)
  •  ::1/128/64 (only 1 slash allowed)

Short ID length

Altocloud assigns each visit a unique number that is based on a lengthy, automatically generated ID. In the Short ID field, indicate the number of digits that Altocloud should use for each visit ID.

You should choose a short ID length that is long enough to be unique among all visitors that are currently active on your website. The more traffic your site gets, the longer your short ID should be. For example: if you always have less than 10,000 visitors at any time, a short ID length of 4 will suffice. If you could have more than 100,000 visitors at any one time, then you should choose a short ID length of 6.

If you find that you need a longer short ID, you can increase the length at any time. Your changes will take effect immediately.

Exclude URL query parameters

Specify any URL Query Parameters we should ignore. URL query parameters appear near the end of URLs. They can lead to overly-specific tracking data. They can also potentially expose personally identifiable information, which violates GDPR.

Keep URL fragments

You can configure whether Altocloud should use URL fragments to identify web pages.

URL fragments appear after a URL. For example, in "altocloud.com#pagename", #pagename is a URL fragment.

While URL fragments can identify specific webpages, they can also potentially expose personally identifiable information, which violates GDPR. They can also result in an excess amount of tracking data.

Unless you want to track the URL fragments, do not enable this option.

Site search settings

Each time a user searches your site, the URL for your webpage changes. Since Altocloud tracks URL changes, the information about each user's specific searches can appear as part of the customer's journey data. You can see this by going to Live Now and looking under Searches performed. Your agents have a similar view in their agent UI.

To set this up, in the Site search settings box type the URL parameter for search terms on your website. For example, suppose that when a customer searches for "Sale," the string, “?term=Sale#search” is appended to the end of your URL. In this case, type term in the Site search settings box.
If you do not know your URL parameter for search terms, try searching for something on your website. Then note what appears when the URL changes.