Articles in this section

Passing Filter Options via URL

Mark Heideman
  • Updated
Follow

Summary

In this article you'll learn how to specify filter options via URL parameters to apply to pages in Blue Triangle. This includes time periods and look-back periods, page names, devices and more. Here's how we'll go through it:

How to Pre-Filter the Data in Blue Triangle with URL Parameters

Add an "&" and the name of the respective URL parameters as listed below.
Example:
...?r=real-user-monitoring/performance-detail&sid=567&daysData=5&pageName[]=homepage&trafficSegment[]=eCommerce
Unless stated otherwise, any of the filters you want to use must match EXACTLY how
they appear in the filters. If you see a space in the filter option name, there must also be a space in the URL param. If it is capitalized, it must be capitalized in the URL param as well.
The params with square brackets "[]" mean you can configure more than one at one time.
Example: 
&pageName[]=oneValue&pageName[]=anotherValue

Available Filter Options Reference

The filters that are currently available are as follows:

startDate/endDate
  • The start and end dates for a specific time period
  • Must be in YYYY-MM-DD format
  • Start date cannot be past the end date and the end date cannot be past the current date

startEpochTime/endEpochTime

  • Used to specify a specific start and end epoch time period
  • Must be in epoch milliseconds
daysData
  • a lookback period
  • accepts whole numbers between 1 and 365
  • lookback cannot exceed a year and cannot be less than a day
botTraffic
  • Allows the user to toggle Blue Triangle’s bot filtering.
  • Accepts ‘include-bots’, ’exclude-bots’, OR ‘bots-only’
visitorType[]
  • Differentiates between new and returning users
  • Accepts ‘new’ and/or ‘retuning’ as parameters
device[]
  • Allows the user to choose common devices
  • Accepts ‘mobile’, ‘dekstop’, and/or ‘tablet’ as params
browser[]
  • Allows the user to choose common browsers
  • Accepts ‘Edge’, ‘Safari’, ‘Firefox’, and/or ‘Chrome’ as params
operatingSystem[]
  • Allows user to choose common operating systems
  • Accepts ‘linux’, ‘windows’, ‘android’, ‘ios’, and/or ‘macintosh’ as params
pageName[]
  • Allows user to choose the site’s page name(s)
  • User can type in the page name(s) of their choosing
pageGroup[]
  • Allows user to choose the site’s page group(s)
  • Users can select the page groups of their choosing
trafficSegment[]
  • Allows users to select traffic segments
  • Users can select the traffic segments of their choosing
isp[]
  • Allows users to select internet service providers
  • Users can select the isps of their choosing
datacenter[]
  • Allows users to select datacenter locations
  • Users can type in whichever locations they have configured
abSegment[]
  • Allows users to select a/b testing sements
  • Users can type in whichever segments they have configured
campaignName[]
  • Users can type in configured campaign names
  • Users can type in the names of them
campaignMedium[]
  • Users can choose configured campaign mediums
  • Users can type in the names of them
campaignSource[]
  • Users can choose configured campaign sources
  • Users can type in the names of them
campaign[]
  • Works the same as campaignName[]
  • Exclusive to customer Journey

Only Available for the Real User Performance Detail Page

CSID

  • Filter on a specific Customer Session ID
  • Must be an exact match

GUID

  • Filter on a specific BTT GUID (Graphical User Interface ID)
  • Must be an exact match

sessionID

  • Filter on a specific BTT Session ID
  • Must be an exact match

url

  • Filter by URL
  • Substring search can be done using asterisks as wildcards, or exact match otherwise
  • Must be Base64 encoded

userAgent

  • User Agent String for the page view
  • Substring search can be done using asterisk as wildcards, or exact match otherwise

customVar1, customVar2, ..., customVar5

  • Filter on a specific Custom Variable value using the Display Name*
  • Must be an exact match

*Display name can be found in the Custom Variable page found in Settings & Administration 

Examples

Example #1: Standard example

https://portal.bluetriangle.com/btportal/web/index.php?r=real-user-monitoring/performance-detail&sid=567&daysData=5&pageName[]=homepage&trafficSegment[]=eCommerce
Example #2: Passing base64 params
You can also set the filtering parameters all together as one URL param. To do this, get together your param string using the options listed in the reference above, then base64 encode it. Now, simply add &params= at the end of the page's URL in Blue Triangle, followed by the base64 encoded string. *Note this is not available with the options specific to the Real User Performance Detail page.
https://portal.bluetriangle.com/btportal/web/index.php?r=real-user-monitoring%2Fperformance-detail&sid=567&params=JmRheXNEYXRhPTQ
Example #3: CSID (exact match)
https://portal.bluetriangletech.com/btportal/web/index.php?r=real-user-monitoring%2Fperformance-detail&sid=567&startDate=2019-12-25&endDate=2020-01-01&CSID=123456
Example #4: URL (substring search)
This example searches for anything with "/category" in the URL. The base64 decoded version of this is "*%2Fcategory*." The asterisks indicate wildcards meaning "anything before" and "anything after" the given substring. If no asterisks are provided, however, an exact match will be done.
https://portal.bluetriangletech.com/btportal/web/index.php?r=real-user-monitoring%2Fperformance-detail&sid=567&startDate=2019-12-25&endDate=2020-01-01&url=KiUyRmNhdGVnb3J5Kg==

Session Lookup - Performance Detail

There is now a screen dedicated to viewing session performance details and you can reach it at https://portal.bluetriangletech.com/btportal/web/index.php?r=real-user-monitoring/session-lookup-performance-detail.

Using the same URL parameters defined above in the Only Available on the Real User Performance Detail Page section, you can use this new page to focus in on the session details. 

Example:

https://portal.bluetriangletech.com/btportal/web/index.php?r=real-user-monitoring/session-lookup-performance-detail&sid=567&url=aHR0cHM6Ly9idXkuU3BvcnRzLmNvbS8=
Note: The "sid" parameter in these examples is specific to a demo site. You'll need to change this to your site.

Related articles

Comments

0 comments

Please sign in to leave a comment.