Versions Compared

Key

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

...

eventCallback - Optional. Function to be executed after the event is sent.

 

Parameter Name

Type

Description

Max Data Length

Example

e

string

Event name. Mandatory.

50 chars

"Pageview", "Search", "Search Result Click", "External Click", "Search Result Preview", "Duration", "Custom Event"

eid

string

Event ID.

10 chars

 "E7878CEF2A"

rid

string

Related Event Id (ID of previous 'Pageview' event).

10 chars

 "02E0D73FBF"

sid

string

Session Id. Should be same for all events within same browser session.

10 chars

 "39E186A874"

a.username

string

Full user account name.

256 chars

 "i:0#.f|membership|username@company.onmicrosoft.com"

u

string

Full URL path where the event occurred on or derived from:
1. If URL has more than 1 query parameter, limit them to one
2. If it's a document - then it should be the document URL

1000 chars

"https://company.sharepoint.com/Home/Home.aspx?id=1"

qsstringQueryString of URL2000 chars"?id=1&q=2#s=1"

ct

DateTime

Client time.

 

 "2019-04-22 16:59:57"

ctoffset

string

Client time offset.

6 chars

“+03:00”

servertimeDateTimeServer time.  "2019-04-22 07:59:57"
servertimeoffsetstringServer time offset.6 chars"-06:00"

data.timeonpage

int

Time spent on page (after page is closed or URL is changed) in milliseconds

32-bit integer

65030
data.loadtimeint

Only for "Pageview" event:

Time it takes for the page to load in milliseconds

32-bit integer0

ua

string

User Agent

450 chars

"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36"

spint

Only for "Search Result Click" event:
Position of search result on search result page

32-bit integer5
srint

Only for "Search" and "Search Result Click" events:

Total amount of search results on search results page

32-bit integer6
ststring

Only for "Search" and "Search Result Click" and "Search Result Preview" events:

Search term

255 chars"documents"
metadata A list of parameters and their values. 255 chars for key and value 
Code Sample

In this example, when a user clicks on the DOWNLOAD button on the home page, a popup window is opened with the download form:


Download Button


Download Form

...

Info
iconfalse
(function (CardioLogAgent) {
  if (CardioLogAgent.API) {
    return;
  }

  var WAIT_FOR_SEC = 10;
  var WAIT_CHECK_INTERVAL_MSEC = 500;

  function createSendEventProxy() {
    var proxy = {
      calls: [],

      fn: function (data, callback) {
        proxy.calls.push({ data: data, callback: callback });
      }
    };

    return proxy;
  }

  var sendEventProxy = createSendEventProxy();
  var totalAttemptsCount = Math.ceil(WAIT_FOR_SEC * 1000 / WAIT_CHECK_INTERVAL_MSEC);

  function waitForSendEventInit(attemptNumber) {
    if (attemptNumber >= totalAttemptsCount) {
      return;
    }

    window.setTimeout(function () {
      if (CardioLogAgent.API.sendEvent === sendEventProxy.fn) {
        waitForSendEventInit(attemptNumber + 1);
      } else {
        var call;
        while ((call = sendEventProxy.calls.shift())) {
          CardioLogAgent.API.sendEvent(call.data, call.callback);
        }
      }
    }, WAIT_CHECK_INTERVAL_MSEC);
  }

  CardioLogAgent.API = { sendEvent: sendEventProxy.fn };
  waitForSendEventInit(0);
})(window.CardioLogAgent || (window.CardioLogAgent = {}));


Monitoring Internal Traffic Sources

Referrer Parameter

To monitor SharePoint content that is accessed via external locationsapplications, you can use add the referrer parameter  parameter to the URL whenever you publish a link to a SharePoint page and you wish to track the source of the referring application or page.

This is most commonly used in email or social networks such as Teams or Viva Engage (Yammer)

For example, if you have included an internal SharePoint page link in a promotional an email, add the referrer parameter to the URL to track the users who visited your site via this link. Define a unique referrer value that will be displayed in reports, such as referrer=email_promotion_Dec_20202023 in order to display the link accordingly:

Code Block
https://intlock.sharepoint.com/sites/blogs/ceo_blog.aspx?referrer=email_promotion_Dec_2020

To see how many visitors arrived at your page through your email campaign, filter the Usage Overview report by the QueryString field which stores all URL parameters.

2023

UTM Parameters

To track and analyze the performance of internal campaigns and understand which marketing efforts are driving traffic to your SharePoint site, you can use UTM parameters.

You can add any of the following UTM parameters to the end of a URL: 

  1. utm_source: This parameter identifies the source of your traffic. It typically indicates where the link was placed, such as a specific website, newsletter, or social media platform.

  2. utm_medium: This parameter specifies the medium through which the traffic is coming, such as email, social, or search.

  3. utm_campaign: Campaigns are specific promotions or marketing initiatives that you want to track separately. This parameter allows you to identify the campaign associated with the URL.

  4. utm_term: This parameter is used primarily for paid or promoted search campaigns, allowing you to specify the keywords associated with your campaign. It's less commonly used in other marketing channels.

  5. utm_content: This parameter is used to differentiate between different pieces of content within the same campaign or source. For example, you can use it to track different versions of a banner or a link within an email.

For example, if you are sending out a monthly newsletter via email promoting a product launch event that was published in your SharePoint News section, add the following UTM parameters to the news article URL:

Code Block
https://intlock.sharepoint.com/sites/news/product_launch.aspx?utm_source=newsletter&utm_medium=email&utm_campaign=product_launch_dec_2023

By adding these UTM parameters to your URL, you can track the effectiveness of your campaigns with greater granularity. When someone clicks on a URL containing UTM parameters and visits your site, the data is captured in CardioLog Analytics SaaS allowing you to analyze and measure the performance of each campaign, source, and medium separately. This information is valuable for optimizing your marketing strategies and understanding which channels are generating the most traffic and engagement.

How to see this data in the reports?

To find out how many visitors reached your SharePoint page from a specific referring application or internal campaign, select the relevant page under the Page URL filter in the out-of-the-box Navigation Overview report, and view the results in the Internal Traffic Sources table visual.

Image Added
Navigation Overview 

 

You can also filter any other report page by the referrer parameter or UTM parameters.

The referrer parameter and the UTM parameters' values are available in the CardioLog Analytics SaaS dataset in Power BI in the following tables:

  • SharePoint Usage table which stores all URL parameters in one string in the QueryString field.
  • SharePoint Usage | Url Parameters table which stores all URL Parameters in key-value pairs, in the Key and Value fields.

To access the CardioLog Analytics SaaS dataset, edit your report and locate the relevant tables and fields under the Data section.

Image Added
Edit Mode