feat: add custom tracking domain support

README.md

@@ -33,7 +33,7 @@ If you need multiple instances just duplicate the snippet with a different insta
 The Woopra tracker can be customized using the config function. Find below the list of options:
 
 | Option                           | Default                                                                    | Description                                                                                                          |
-|----------------------------------|----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
+| -------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
 | **domain**                       | N/A: required                                                              | **REQUIRED** Project Name in Woopra. Must be explicitly set for tracker to work.                                     |
 | beacons                          | Browser support                                                            | Whether to use `navigator.sendBeacon` instead of `<script>` injection to send actions to Woopra's tracking servers   |
 | click_pause                      | `250`                                                                      | Time in millisecond to pause the browser to ensure that the event is tracked when visitor clicks on an element url.  |
@@ -58,6 +58,7 @@ The Woopra tracker can be customized using the config function. Find below the l
 | ping                             | `false`                                                                    | Ping woopra servers to ensure that the visitor is still on the webpage.                                              |
 | ping_interval                    | `12000`                                                                    | Time interval in milliseconds between each ping. (min: `6000`, max: `60000`)                                         |
 | protocol                         | `https://`                                                                 | The protocol used to contact Woopra's servers. `http://` forces unsecure mode and `//` follows the page's protocol   |
+| tracking_domain                  | N/A                                                                        | Custom tracking domain. When set, all tracking requests are sent to `https://{tracking_domain}/track/`               |
 
 The `config()` function supports key/value singleton argument:
 
@@ -150,7 +151,7 @@ When you track custom events, remember to update your schema on Woopra. That wil
 Below is another example to track when people click on the play button with id="play-button":
 
 ```javascript
-document.getElementById('play-button').onclick = function() {
+document.getElementById('play-button').onclick = function () {
   woopra.track('play', {
     artist: 'Dave Brubeck',
     song: 'Take Five',

dist/wpt.js

@@ -1,5 +1,5 @@
 /*!
- * Copyright (c) 2025 Woopra, Inc.
+ * Copyright (c) 2026 Woopra, Inc.
  *
  * For license information please see https://static.woopra.com/js/w.js.LICENSE.txt
  */
@@ -716,6 +716,7 @@
   var KEY_REGION = 'region';
   var KEY_SAVE_URL_HASH = 'save_url_hash';
   var KEY_THIRD_PARTY = 'third_party';
+  var KEY_TRACKING_DOMAIN = 'tracking_domain';
   var KEY_USE_COOKIES = 'use_cookies';
   var META_CANCELLED = 'cancelled';
   var META_DIRTY = 'dirty';
@@ -2584,17 +2585,24 @@
       }
 
       var protocol = this.getProtocol();
+      var trackingDomain = this.config(KEY_TRACKING_DOMAIN);
+
+      if (path && !Woopra.endsWith(path, '/')) {
+        path += '/';
+      } // Use custom tracking domain if configured
+
+
+      if (trackingDomain) {
+        return protocol + "//" + trackingDomain + "/track/" + path;
+      } // Fall back to region-based endpoints
+
 
       if (this.config(KEY_THIRD_PARTY) && !this.config(KEY_DOMAIN)) {
         throw new Error('Error: `domain` is not set.');
       }
 
       var thirdPartyPath = this.config(KEY_THIRD_PARTY) ? "tp/" + this.config(KEY_DOMAIN) : '';
 
-      if (path && !Woopra.endsWith(path, '/')) {
-        path += '/';
-      }
-
       if (thirdPartyPath && !Woopra.startsWith(path, '/')) {
         thirdPartyPath += '/';
       }

src/constants.js

@@ -121,6 +121,7 @@ export const KEY_PROTOCOL = 'protocol';
 export const KEY_REGION = 'region';
 export const KEY_SAVE_URL_HASH = 'save_url_hash';
 export const KEY_THIRD_PARTY = 'third_party';
+export const KEY_TRACKING_DOMAIN = 'tracking_domain';
 export const KEY_USE_COOKIES = 'use_cookies';
 
 export const META_CANCELLED = 'cancelled';

src/tracker.js

@@ -63,6 +63,7 @@ import {
   KEY_REGION,
   KEY_SAVE_URL_HASH,
   KEY_THIRD_PARTY,
+  KEY_TRACKING_DOMAIN,
   KEY_USE_COOKIES,
   LIFECYCLE_ACTION,
   LIFECYCLE_PAGE,
@@ -321,7 +322,18 @@ export default class Tracker {
    */
   getEndpoint(path = '') {
     const protocol = this.getProtocol();
+    const trackingDomain = this.config(KEY_TRACKING_DOMAIN);
 
+    if (path && !Woopra.endsWith(path, '/')) {
+      path += '/';
+    }
+
+    // Use custom tracking domain if configured
+    if (trackingDomain) {
+      return `${protocol}//${trackingDomain}/track/${path}`;
+    }
+
+    // Fall back to region-based endpoints
     if (this.config(KEY_THIRD_PARTY) && !this.config(KEY_DOMAIN)) {
       throw new Error('Error: `domain` is not set.');
     }
@@ -330,10 +342,6 @@ export default class Tracker {
       ? `tp/${this.config(KEY_DOMAIN)}`
       : '';
 
-    if (path && !Woopra.endsWith(path, '/')) {
-      path += '/';
-    }
-
     if (thirdPartyPath && !Woopra.startsWith(path, '/')) {
       thirdPartyPath += '/';
     }

test/index.js

@@ -762,6 +762,34 @@ describe('Woopra Tracker', function () {
     it('test `getEndpoint` when configured using EU region', function () {
       expect(tracker.getEndpoint()).to.equal('https://www.woopra.com/track/');
     });
+
+    it('test `getEndpoint` when configured with custom tracking_domain', function () {
+      tracker.config('tracking_domain', 'custom.example.com');
+
+      expect(tracker.getEndpoint()).to.equal(
+        'https://custom.example.com/track/'
+      );
+    });
+
+    it('test `getEndpoint` with custom tracking_domain and a path', function () {
+      tracker.config('tracking_domain', 'custom.example.com');
+
+      expect(tracker.getEndpoint('ce')).to.equal(
+        'https://custom.example.com/track/ce/'
+      );
+      expect(tracker.getEndpoint('push/')).to.equal(
+        'https://custom.example.com/track/push/'
+      );
+    });
+
+    it('test `getEndpoint` custom tracking_domain takes priority over region', function () {
+      tracker.config('region', 'kr');
+      tracker.config('tracking_domain', 'custom.example.com');
+
+      expect(tracker.getEndpoint()).to.equal(
+        'https://custom.example.com/track/'
+      );
+    });
   });
 
   describe('Outgoing Link Helpers', function () {