How to Track SharePoint Online websites with Angelfish
Angelfish creates reports by processing web server log files. But if you're a SharePoint Online customer, you aren't able to access the underlying IIS logs.
The solution is simple:
- add the AGF tracking code snippet to your SharePoint site
- configure angelfish.js to send the tracking request to another domain
- process those logs with Angelfish
The angelfish.js file can be configured to send the tracking gif to another domain via the “Hostname for Tracking Requests” parameter:
When a visitor accesses your SharePoint Online site, the tracking request will be sent to the web server you specify as the “Hostname for Tracking Requests”. Simply process the web logs from this server with Angelfish, and voila: web analytics reports for SharePoint Online.
New to Angelfish?
Angelfish is secure, on-premise web analytics software. Learn more here:
Here's how to setup Angelfish to track SharePoint Online:
1) Create / Procure / Commandeer a web server (let's call it an "AGF server")
This web server will serve up the AGF tracking code and collect the AGF tracking requests. A subdomain of an existing domain is fine, e.g. agf.yourdomain.com
The default log format is fine, regardless of the web server used.
2) Put angelfish.js and agf.gif in the root directory of the AGF Server
AGF code is used by the Angelfish tracking method, explained here:
AGF code installation instructions are here:
Be sure to use the Custom Tracking Code Generator so you can set the “Hostname for Tracking Requests”:
3) Add AGF code to your SharePoint site
Microsoft's Web Analytics Integration app makes it easy to add AGF code to your SharePoint Online instance:
Simply add the AGF code snippet to the Web Analytics Integration app – the snippet needs to reference angelfish.js from the AGF Server created in step 1.
4) Install Angelfish and Create a Profile
It's not necessary to install the Angelfish application directly on the AGF Server. Angelfish can be installed anywhere as long as it's able to access the log files from the AGF Server.
If you haven't already watched the “Create a Profile” video, it can be viewed here:
We have a short list of recommendations for new SharePoint profiles - they can be seen here:
5) Process Data and View the Reports
Click the Process Data button in the Run/Data Management tab to start processing data. Once processing is complete, click the Profile Name in the All Profiles screen, or the “View Report” button in the Profile Config.
If you don't see any data in the reports, please verify the Datasource is configured correctly (i.e. the Location field matches log files, not just a directory), then delete data and reprocess.
If you need help, please open a support ticket so our technical team can assist.