README.md

Matomo

homepage: matomo.org
docs: developer.matomo.org
import: import { Angulartics2Matomo } from 'angulartics2/matomo';

Setup

Add the standard matomo track code inside your index.html head tag:

<!-- Matomo -->
<script type="text/javascript">
  var _paq = _paq || [];
  /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
  // _paq.push(['trackPageView']); // DELETE THIS LINE
  _paq.push(['enableLinkTracking']);
  (function() {
    var u="//matomo.YOUR-DOMAIN.com/";
    _paq.push(['setTrackerUrl', u+'matomo.php']);
    _paq.push(['setSiteId', '11']);
    var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
    g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
  })();
</script>
<!-- End Matomo Code -->

Make sure "trackPageView" line is commented or deleted. It is not needed as page tracking will be trigger by the angular module on route change.

Replace YOUR-DOMAIN with your matomo domain (//DOMAIN.innocraft.cloud if you are using the innocraft cloud service).

Pass the Matomo provider to angulartics in app.module:

import { Angulartics2Module } from 'angulartics2';
import { Angulartics2Matomo } from 'angulartics2/matomo';
@NgModule({
  imports: [
    Angulartics2Module.forRoot(),
    ...

Inject angulartics into your root component (usually appComponent)

import { Angulartics2Matomo } from 'angulartics2/matomo';
export class AppComponent {
  // inject Angulartics2Matomo in root component and initialize it
  constructor(private angulartics2Matomo: Angulartics2Matomo) {
    angulartics2Matomo.startTracking();
  }
}

Tracking Custom Variables

angulartics2.setUserProperties.next({index: 1, name: 'John', value: 123, scope: 'visit'});

Note: To track multiple custom variables, call setUserProperties multiple times

Tracking Custom Dimensions

angulartics2.setUserProperties.next({
    dimension1: 'v1.2.3',
    dimension2: 'german',
    dimension43: 'green',
});

Note: Custom Variables and Custom Dimensions cannot be tracked in the same call, and requires separate setUserProperties calls

To track full URLs if there is a hash (#), make sure to enable settings=>websites=>settings=>page url fragments tracking in the Matomo dashboard.

Once set up, Angulartics usage is the same regardless of provider