feat: capture page title and canonical URL in page view events

Add optional pageTitle and canonicalUrl fields to captured page-view
records so they surface in the page_events attribute sent to
selectPlacements.

- pageTitle is read from document.title
- canonicalUrl is read from <link rel="canonical"> and sanitized
  through the same helper as pageUrl (query string stripped, hash
  fragment retained)

Both fields are omitted when unavailable, matching the existing
activeTimeOnSite handling.

Author: alexs-mparticle

src/Rokt-Kit.ts

@@ -65,6 +65,8 @@ interface PageEvent {
   pageUrl: string;
   sourceMessageId: string;
   timestamp: number;
+  pageTitle?: string;
+  canonicalUrl?: string;
   activeTimeOnSite?: number;
   // Derived at transmission not at capture based
   // on the next page view's activeTimeOnSite,
@@ -508,6 +510,19 @@ function sanitizeUrl(href: string): string {
   }
 }
 
+// Reads the page's canonical URL from <link rel="canonical">, resolving it
+// against the document base and sanitizing it through the same helper as
+// pageUrl (query string stripped, hash fragment retained).
+// Returns undefined when no canonical link is present or its href is empty.
+function readCanonicalUrl(): string | undefined {
+  const link = document.querySelector<HTMLLinkElement>('link[rel="canonical"]');
+  const href = link?.href;
+  if (!href) {
+    return undefined;
+  }
+  return sanitizeUrl(href);
+}
+
 function generateIntegrationName(customIntegrationName?: string): string {
   const coreSdkVersion = mp().getVersion();
   const kitVersion = process.env.PACKAGE_VERSION;
@@ -917,6 +932,16 @@ class RoktKit implements KitInterface {
         timestamp: event.Timestamp,
       };
 
+      const pageTitle = document.title;
+      if (pageTitle) {
+        pageView.pageTitle = pageTitle;
+      }
+
+      const canonicalUrl = readCanonicalUrl();
+      if (canonicalUrl) {
+        pageView.canonicalUrl = canonicalUrl;
+      }
+
       if (Number.isFinite(event.ActiveTimeOnSite)) {
         pageView.activeTimeOnSite = event.ActiveTimeOnSite;
       }
@@ -970,6 +995,14 @@ class RoktKit implements KitInterface {
         timestamp: pageView.timestamp,
       };
 
+      if (pageView.pageTitle !== undefined) {
+        pageEvent.pageTitle = pageView.pageTitle;
+      }
+
+      if (pageView.canonicalUrl !== undefined) {
+        pageEvent.canonicalUrl = pageView.canonicalUrl;
+      }
+
       const activeTimeOnSite = pageView.activeTimeOnSite;
       const hasActiveTime = activeTimeOnSite !== undefined && Number.isFinite(activeTimeOnSite);
       if (hasActiveTime) {

test/src/tests.spec.ts

@@ -5687,6 +5687,81 @@ describe('Rokt Forwarder', () => {
         ]);
       });
 
+      it('captures the page title and canonical URL when present', async () => {
+        document.title = 'Home Page Title';
+        const canonical = document.createElement('link');
+        canonical.setAttribute('rel', 'canonical');
+        canonical.setAttribute('href', 'https://example.com/canonical?tracking=abc#section');
+        document.head.appendChild(canonical);
+
+        try {
+          await (window as any).mParticle.forwarder.init(
+            {
+              accountId: '123456',
+            },
+            reportService.cb,
+            true,
+            null,
+            {},
+          );
+
+          await waitForCondition(() => (window as any).mParticle.Rokt.attachKitCalled);
+
+          (window as any).mParticle.forwarder.process({
+            EventName: 'Home Page',
+            EventCategory: EventType.Unknown,
+            EventDataType: MessageType.PageView,
+            SourceMessageId: 'source-message-id-title',
+            Timestamp: 1712345678000,
+          });
+
+          expect(readStoredPageViews()).toEqual([
+            {
+              pageUrl: window.location.href,
+              sourceMessageId: 'source-message-id-title',
+              timestamp: 1712345678000,
+              pageTitle: 'Home Page Title',
+              // Sanitized via the same helper as pageUrl: query string is stripped,
+              // the hash fragment is retained.
+              canonicalUrl: 'https://example.com/canonical#section',
+            },
+          ]);
+        } finally {
+          document.title = '';
+          document.head.removeChild(canonical);
+        }
+      });
+
+      it('omits pageTitle and canonicalUrl when neither is available', async () => {
+        await (window as any).mParticle.forwarder.init(
+          {
+            accountId: '123456',
+          },
+          reportService.cb,
+          true,
+          null,
+          {},
+        );
+
+        await waitForCondition(() => (window as any).mParticle.Rokt.attachKitCalled);
+
+        (window as any).mParticle.forwarder.process({
+          EventName: 'Home Page',
+          EventCategory: EventType.Unknown,
+          EventDataType: MessageType.PageView,
+          SourceMessageId: 'source-message-id-bare',
+          Timestamp: 1712345678000,
+        });
+
+        expect(readStoredPageViews()).toEqual([
+          {
+            pageUrl: window.location.href,
+            sourceMessageId: 'source-message-id-bare',
+            timestamp: 1712345678000,
+          },
+        ]);
+      });
+
       it('omits activeTimeOnSite when the source value is non-finite', async () => {
         await (window as any).mParticle.forwarder.init(
           {
@@ -5989,6 +6064,46 @@ describe('Rokt Forwarder', () => {
         ]);
       });
 
+      it('carries pageTitle and canonicalUrl through selectPlacements when stored', async () => {
+        window.localStorage.setItem(
+          'mpPageViews',
+          JSON.stringify([
+            {
+              pageUrl: 'https://example.com/a',
+              sourceMessageId: 'source-message-id-a',
+              timestamp: 1712345678000,
+              pageTitle: 'Page A',
+              canonicalUrl: 'https://example.com/canonical-a',
+            },
+          ]),
+        );
+
+        await (window as any).mParticle.forwarder.init(
+          {
+            accountId: '123456',
+          },
+          reportService.cb,
+          true,
+          null,
+          {},
+        );
+
+        await waitForCondition(() => (window as any).mParticle.Rokt.attachKitCalled);
+
+        await (window as any).mParticle.forwarder.selectPlacements({ attributes: {} });
+
+        const forwardedAttributes = (window as any).mParticle.Rokt.selectPlacementsOptions.attributes;
+        expect(JSON.parse(forwardedAttributes.page_events)).toEqual([
+          {
+            pageUrl: 'https://example.com/a',
+            sourceMessageId: 'source-message-id-a',
+            timestamp: 1712345678000,
+            pageTitle: 'Page A',
+            canonicalUrl: 'https://example.com/canonical-a',
+          },
+        ]);
+      });
+
       it('does not add a page_events attribute when no page views are stored', async () => {
         await (window as any).mParticle.forwarder.init(
           {