feat: add setPageViewId and getPageViewId to tracker api

Note: those methods should probably not be called in a single-page app!

projects/ngx-matomo-client/core/tracker/matomo-tracker.service.spec.ts

@@ -222,6 +222,20 @@ describe('MatomoTracker', () => {
 
   it('should reset user id', expectSimpleMethod('resetUserId', []));
 
+  it('should set page view id', expectSimpleMethod('setPageViewId', ['my-id']));
+
+  it('should get page view id', done => {
+    expectGetter(
+      'getPageViewId',
+      {
+        getPageViewId(): string {
+          return 'fake-id';
+        },
+      },
+      'fake-id',
+    ).then(done);
+  });
+
   it(
     'should set custom variable',
     expectSimpleMethod('setCustomVariable', [1, 'name', 'value', 'page']),

projects/ngx-matomo-client/core/tracker/matomo-tracker.service.ts

@@ -82,6 +82,8 @@ export interface MatomoInstance {
 
   getUserId(): string;
 
+  getPageViewId(): string;
+
   getCustomVariable(index: number, scope: string): string;
 
   getCustomDimension(customDimensionId: number): string;
@@ -748,6 +750,24 @@ export abstract class MatomoTracker {
     this.push(['resetUserId']);
   }
 
+  /**
+   * Override PageView id for every use of logPageView() <b>THIS SHOULD PROBABLY NOT BE CALLED IN A SINGLE-PAGE APP!</b>
+   *
+   * Do not use this if you call trackPageView() multiple times during tracking (e.g. when tracking a single page application)
+   *
+   * @param pageView
+   */
+  setPageViewId(pageView: string): void {
+    this.push(['setPageViewId', pageView]);
+  }
+
+  /**
+   * Returns the PageView id. If not set manually using setPageViewId, this method will return the dynamic PageView id, used in the last tracked page view, or undefined if no page view was tracked yet
+   */
+  getPageViewId(): Promise<string> {
+    return this.get('getPageViewId');
+  }
+
   /**
    * Set a custom variable.
    *