@aranova/tracking-react 0.6.1 → 0.7.1

package/README.md

@@ -52,6 +52,32 @@ createRoot(document.getElementById('root')!).render(
 );
 ```
 
+### Multiple gtag IDs
+
+To install multiple Google Ads tags simultaneously (for example a production MCC and a test MCC for verifying conversion actions before they touch the live account), pass `gtagIds` instead of `gtagId`. Every entry fires `gtag('config', ...)` on every page — gtag natively supports multiple configured tags.
+
+```tsx
+<TrackingProvider
+  gtagIds={{
+    production: 'AW-111111111',  // real client account
+    test: 'AW-222222222',         // test MCC for development
+  }}
+>
+  <App />
+</TrackingProvider>
+```
+
+The labels are arbitrary and surface in the Aranova dashboard's SDK versions table. You can also stamp events with a deployment environment so the dashboard can filter out test traffic:
+
+```ts
+createTracking({
+  apiKey: import.meta.env.VITE_ARANOVA_TRACKING_API_KEY,
+  endpoint: import.meta.env.VITE_ARANOVA_TRACKING_ENDPOINT,
+  environment: import.meta.env.MODE,  // 'production' | 'development'
+  triggers: { /* ... */ },
+});
+```
+
 ## Manual Events
 
 Manual events must be registered under `triggers.manual` before `trackEvent()` accepts them.

package/dist/index.d.mts

@@ -11,20 +11,6 @@ import { z } from 'zod';
  */
 declare function ConsentBanner(): react_jsx_runtime.JSX.Element | null;
 
-interface GoogleAdsTrackingProps {
-    /**
-     * Google Ads tag id, for example `AW-123456789`.
-     */
-    gtagId: string;
-}
-/**
- * Client component that loads Google Ads gtag and restores stored consent.
- *
- * Render once near the application root when the client site runs paid Google
- * Ads. The component renders nothing.
- */
-declare function GoogleAdsTracking({ gtagId }: GoogleAdsTrackingProps): null;
-
 /**
  * Visitor consent state stored by the SDK.
  *
@@ -62,6 +48,23 @@ interface TrackingParams {
  * whether a site uses the Next, React, or script-tag integration.
  */
 type TrackingInstallSurface = 'next' | 'react' | 'script';
+/**
+ * Deployment environment label for event tagging.
+ *
+ * Used to stamp tracking events with the deployment context so the dashboard
+ * can distinguish production traffic from dev test traffic. The backend
+ * enforces this via a Postgres enum, so values are strictly one of
+ * `'production'` or `'development'`.
+ */
+type TrackingEnvironment = 'production' | 'development';
+/**
+ * Labelled map of Google Ads tag IDs.
+ *
+ * ALL entries are loaded simultaneously via `gtag('config', ...)` — the keys
+ * are human-readable labels (e.g. `production`, `test`) and the values are
+ * Google Ads tag IDs (e.g. `AW-123456789`).
+ */
+type GtagEnvironmentMap = Record<string, string>;
 /**
  * Runtime context attached to tracking sessions and events.
  */
@@ -78,6 +81,16 @@ interface TrackingClientContext {
     page_title: string | null;
     /** Browser document referrer at client creation time. */
     referrer: string | null;
+    /**
+     * Deployment environment label, e.g. `'production'`, `'development'`.
+     *
+     * Always set — defaults to `'production'` when the consumer doesn't
+     * pass `environment` to the factory. Sending `null` would fail the
+     * backend's strict enum validation.
+     */
+    environment: TrackingEnvironment;
+    /** All active gtag IDs loaded on this page, keyed by label. */
+    active_gtag_ids: Record<string, string> | null;
 }
 /**
  * Session payload sent to `POST /tracking/events`.
@@ -127,6 +140,13 @@ interface TrackingInitConfig {
     endpoint?: string;
     /** Optional Google Ads tag id, for example `AW-123456789`. */
     gtagId?: string;
+    /**
+     * Labelled map of Google Ads tag IDs. ALL are loaded simultaneously.
+     * When provided, `gtagId` is ignored.
+     */
+    gtagIds?: GtagEnvironmentMap;
+    /** Deployment environment label reported in session context. */
+    environment?: TrackingEnvironment;
     /** Whether to capture attribution params from `window.location`. Defaults to true. */
     autoCaptureTrackingParams?: boolean;
     /** Whether the browser script should inject the default consent banner. */
@@ -174,6 +194,8 @@ interface TrackingContextInput {
     referrer?: string | null;
     sdkVersion?: string | null;
     siteOrigin?: string | null;
+    environment?: TrackingEnvironment;
+    activeGtagIds?: Record<string, string> | null;
 }
 interface TrackingEventInput {
     eventType: string;
@@ -275,6 +297,7 @@ declare const sdkHeartbeatMetadataSchema: z.ZodObject<{
         manual: string[];
     }>;
     trigger_config: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+    configured_gtag_ids: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, "strict", z.ZodTypeAny, {
     sdk_version: string;
     package_name: string | null;
@@ -284,6 +307,7 @@ declare const sdkHeartbeatMetadataSchema: z.ZodObject<{
         manual: string[];
     };
     trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
+    configured_gtag_ids?: Record<string, string> | null | undefined;
 }, {
     sdk_version: string;
     package_name: string | null;
@@ -293,6 +317,7 @@ declare const sdkHeartbeatMetadataSchema: z.ZodObject<{
         manual: string[];
     };
     trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
+    configured_gtag_ids?: Record<string, string> | null | undefined;
 }>;
 type SdkHeartbeatMetadata = z.infer<typeof sdkHeartbeatMetadataSchema>;
 /**
@@ -1028,6 +1053,7 @@ declare const EVENT_REGISTRY: {
                 manual: string[];
             }>;
             trigger_config: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+            configured_gtag_ids: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
         }, "strict", z.ZodTypeAny, {
             sdk_version: string;
             package_name: string | null;
@@ -1037,6 +1063,7 @@ declare const EVENT_REGISTRY: {
                 manual: string[];
             };
             trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
+            configured_gtag_ids?: Record<string, string> | null | undefined;
         }, {
             sdk_version: string;
             package_name: string | null;
@@ -1046,6 +1073,7 @@ declare const EVENT_REGISTRY: {
                 manual: string[];
             };
             trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
+            configured_gtag_ids?: Record<string, string> | null | undefined;
         }>;
         readonly configSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
     };
@@ -1370,6 +1398,27 @@ interface TypedTrackingClient<TRegistry extends TriggerRegistryConfig> {
     getVisitorId(): string;
 }
 
+/**
+ * Props for the Google Ads tracking component.
+ *
+ * Accepts either a single `gtagId` (legacy) or a labelled `gtagIds` map
+ * where ALL entries are loaded simultaneously via `gtag('config', ...)`.
+ */
+type GoogleAdsTrackingProps = {
+    gtagId: string;
+    gtagIds?: undefined;
+} | {
+    gtagId?: undefined;
+    gtagIds: GtagEnvironmentMap;
+};
+/**
+ * Client component that loads Google Ads gtag and restores stored consent.
+ *
+ * Render once near the application root when the client site runs paid Google
+ * Ads. The component renders nothing.
+ */
+declare function GoogleAdsTracking(props: GoogleAdsTrackingProps): null;
+
 /**
  * Read the captured Google Ads click id from first-party cookies.
  *
@@ -1408,6 +1457,14 @@ interface CreateTrackingOptions<TRegistry extends TriggerRegistryConfig> {
      * `automatic.page_view` is required — every tracking install needs it.
      */
     triggers: TRegistry;
+    /**
+     * Deployment environment label reported in session context.
+     *
+     * Does not affect which gtag IDs are loaded — all configured IDs are
+     * loaded simultaneously. This value is purely for event tagging so the
+     * dashboard can filter by environment.
+     */
+    environment?: TrackingEnvironment;
     /**
      * When true, the typed client validates every `trackEvent()` metadata
      * payload through the Zod schema before forwarding. Errors are thrown
@@ -1419,9 +1476,14 @@ interface TrackingProviderProps {
     /**
      * Optional Google Ads tag id, for example `AW-123456789`.
      *
-     * If omitted, no gtag script is loaded by the provider.
+     * If omitted and `gtagIds` is also omitted, no gtag script is loaded.
      */
     gtagId?: string;
+    /**
+     * Labelled map of Google Ads tag IDs. ALL are loaded simultaneously.
+     * When provided, `gtagId` is ignored.
+     */
+    gtagIds?: GtagEnvironmentMap;
     /**
      * Application tree that should have access to the scoped tracking client.
      */

package/dist/index.d.ts

@@ -11,20 +11,6 @@ import { z } from 'zod';
  */
 declare function ConsentBanner(): react_jsx_runtime.JSX.Element | null;
 
-interface GoogleAdsTrackingProps {
-    /**
-     * Google Ads tag id, for example `AW-123456789`.
-     */
-    gtagId: string;
-}
-/**
- * Client component that loads Google Ads gtag and restores stored consent.
- *
- * Render once near the application root when the client site runs paid Google
- * Ads. The component renders nothing.
- */
-declare function GoogleAdsTracking({ gtagId }: GoogleAdsTrackingProps): null;
-
 /**
  * Visitor consent state stored by the SDK.
  *
@@ -62,6 +48,23 @@ interface TrackingParams {
  * whether a site uses the Next, React, or script-tag integration.
  */
 type TrackingInstallSurface = 'next' | 'react' | 'script';
+/**
+ * Deployment environment label for event tagging.
+ *
+ * Used to stamp tracking events with the deployment context so the dashboard
+ * can distinguish production traffic from dev test traffic. The backend
+ * enforces this via a Postgres enum, so values are strictly one of
+ * `'production'` or `'development'`.
+ */
+type TrackingEnvironment = 'production' | 'development';
+/**
+ * Labelled map of Google Ads tag IDs.
+ *
+ * ALL entries are loaded simultaneously via `gtag('config', ...)` — the keys
+ * are human-readable labels (e.g. `production`, `test`) and the values are
+ * Google Ads tag IDs (e.g. `AW-123456789`).
+ */
+type GtagEnvironmentMap = Record<string, string>;
 /**
  * Runtime context attached to tracking sessions and events.
  */
@@ -78,6 +81,16 @@ interface TrackingClientContext {
     page_title: string | null;
     /** Browser document referrer at client creation time. */
     referrer: string | null;
+    /**
+     * Deployment environment label, e.g. `'production'`, `'development'`.
+     *
+     * Always set — defaults to `'production'` when the consumer doesn't
+     * pass `environment` to the factory. Sending `null` would fail the
+     * backend's strict enum validation.
+     */
+    environment: TrackingEnvironment;
+    /** All active gtag IDs loaded on this page, keyed by label. */
+    active_gtag_ids: Record<string, string> | null;
 }
 /**
  * Session payload sent to `POST /tracking/events`.
@@ -127,6 +140,13 @@ interface TrackingInitConfig {
     endpoint?: string;
     /** Optional Google Ads tag id, for example `AW-123456789`. */
     gtagId?: string;
+    /**
+     * Labelled map of Google Ads tag IDs. ALL are loaded simultaneously.
+     * When provided, `gtagId` is ignored.
+     */
+    gtagIds?: GtagEnvironmentMap;
+    /** Deployment environment label reported in session context. */
+    environment?: TrackingEnvironment;
     /** Whether to capture attribution params from `window.location`. Defaults to true. */
     autoCaptureTrackingParams?: boolean;
     /** Whether the browser script should inject the default consent banner. */
@@ -174,6 +194,8 @@ interface TrackingContextInput {
     referrer?: string | null;
     sdkVersion?: string | null;
     siteOrigin?: string | null;
+    environment?: TrackingEnvironment;
+    activeGtagIds?: Record<string, string> | null;
 }
 interface TrackingEventInput {
     eventType: string;
@@ -275,6 +297,7 @@ declare const sdkHeartbeatMetadataSchema: z.ZodObject<{
         manual: string[];
     }>;
     trigger_config: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+    configured_gtag_ids: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, "strict", z.ZodTypeAny, {
     sdk_version: string;
     package_name: string | null;
@@ -284,6 +307,7 @@ declare const sdkHeartbeatMetadataSchema: z.ZodObject<{
         manual: string[];
     };
     trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
+    configured_gtag_ids?: Record<string, string> | null | undefined;
 }, {
     sdk_version: string;
     package_name: string | null;
@@ -293,6 +317,7 @@ declare const sdkHeartbeatMetadataSchema: z.ZodObject<{
         manual: string[];
     };
     trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
+    configured_gtag_ids?: Record<string, string> | null | undefined;
 }>;
 type SdkHeartbeatMetadata = z.infer<typeof sdkHeartbeatMetadataSchema>;
 /**
@@ -1028,6 +1053,7 @@ declare const EVENT_REGISTRY: {
                 manual: string[];
             }>;
             trigger_config: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+            configured_gtag_ids: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
         }, "strict", z.ZodTypeAny, {
             sdk_version: string;
             package_name: string | null;
@@ -1037,6 +1063,7 @@ declare const EVENT_REGISTRY: {
                 manual: string[];
             };
             trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
+            configured_gtag_ids?: Record<string, string> | null | undefined;
         }, {
             sdk_version: string;
             package_name: string | null;
@@ -1046,6 +1073,7 @@ declare const EVENT_REGISTRY: {
                 manual: string[];
             };
             trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
+            configured_gtag_ids?: Record<string, string> | null | undefined;
         }>;
         readonly configSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
     };
@@ -1370,6 +1398,27 @@ interface TypedTrackingClient<TRegistry extends TriggerRegistryConfig> {
     getVisitorId(): string;
 }
 
+/**
+ * Props for the Google Ads tracking component.
+ *
+ * Accepts either a single `gtagId` (legacy) or a labelled `gtagIds` map
+ * where ALL entries are loaded simultaneously via `gtag('config', ...)`.
+ */
+type GoogleAdsTrackingProps = {
+    gtagId: string;
+    gtagIds?: undefined;
+} | {
+    gtagId?: undefined;
+    gtagIds: GtagEnvironmentMap;
+};
+/**
+ * Client component that loads Google Ads gtag and restores stored consent.
+ *
+ * Render once near the application root when the client site runs paid Google
+ * Ads. The component renders nothing.
+ */
+declare function GoogleAdsTracking(props: GoogleAdsTrackingProps): null;
+
 /**
  * Read the captured Google Ads click id from first-party cookies.
  *
@@ -1408,6 +1457,14 @@ interface CreateTrackingOptions<TRegistry extends TriggerRegistryConfig> {
      * `automatic.page_view` is required — every tracking install needs it.
      */
     triggers: TRegistry;
+    /**
+     * Deployment environment label reported in session context.
+     *
+     * Does not affect which gtag IDs are loaded — all configured IDs are
+     * loaded simultaneously. This value is purely for event tagging so the
+     * dashboard can filter by environment.
+     */
+    environment?: TrackingEnvironment;
     /**
      * When true, the typed client validates every `trackEvent()` metadata
      * payload through the Zod schema before forwarding. Errors are thrown
@@ -1419,9 +1476,14 @@ interface TrackingProviderProps {
     /**
      * Optional Google Ads tag id, for example `AW-123456789`.
      *
-     * If omitted, no gtag script is loaded by the provider.
+     * If omitted and `gtagIds` is also omitted, no gtag script is loaded.
      */
     gtagId?: string;
+    /**
+     * Labelled map of Google Ads tag IDs. ALL are loaded simultaneously.
+     * When provided, `gtagId` is ignored.
+     */
+    gtagIds?: GtagEnvironmentMap;
     /**
      * Application tree that should have access to the scoped tracking client.
      */

package/dist/index.js

@@ -81,7 +81,9 @@ function createTrackingClientContext(surface, input = {}) {
     package_name: input.packageName ?? null,
     site_origin: input.siteOrigin ?? (typeof window === "undefined" ? null : window.location.origin),
     page_title: input.pageTitle ?? (typeof document === "undefined" ? null : document.title || null),
-    referrer: input.referrer ?? (typeof document === "undefined" ? null : document.referrer || null)
+    referrer: input.referrer ?? (typeof document === "undefined" ? null : document.referrer || null),
+    environment: input.environment ?? "production",
+    active_gtag_ids: input.activeGtagIds ?? null
   };
 }
 function createTrackingSessionUpsertPayload(trackingParams, input, context) {
@@ -118,6 +120,10 @@ var TRACKING_SCRIPT_ATTRIBUTE = "data-aranova-tracking";
 function getScriptMarker(id) {
   return `aranova-${id}`;
 }
+var GTAG_ID_PATTERN = /^[A-Z]{1,3}-[A-Za-z0-9_-]+$/;
+function isValidGtagId(id) {
+  return GTAG_ID_PATTERN.test(id);
+}
 function ensureGtagFunction() {
   window.dataLayer = window.dataLayer || [];
   if (typeof window.gtag === "function")
@@ -158,11 +164,28 @@ function initializeGtag(gtagId) {
 function bootstrapGoogleAdsTracking(gtagId) {
   if (typeof window === "undefined" || typeof document === "undefined")
     return;
+  if (!isValidGtagId(gtagId))
+    return;
   applyDefaultConsentState();
   loadGtagScript(gtagId);
   initializeGtag(gtagId);
   restoreStoredConsent();
 }
+function bootstrapMultipleGtags(gtagIds) {
+  if (typeof window === "undefined" || typeof document === "undefined")
+    return;
+  const ids = Object.values(gtagIds).filter(isValidGtagId);
+  if (ids.length === 0)
+    return;
+  applyDefaultConsentState();
+  loadGtagScript(ids[0]);
+  const gtag = ensureGtagFunction();
+  gtag("js", /* @__PURE__ */ new Date());
+  for (const id of ids) {
+    gtag("config", id);
+  }
+  restoreStoredConsent();
+}
 
 // ../tracking-core/src/tracking.ts
 var TRACKING_COOKIE_MAX_AGE_SECONDS = 7776e3;
@@ -437,7 +460,7 @@ function serializeValue(value) {
   }
   return value;
 }
-function buildHeartbeatMetadata(surface, sdkVersion, packageName, triggers) {
+function buildHeartbeatMetadata(surface, sdkVersion, packageName, triggers, gtagIds = null) {
   const automaticNames = triggers ? Object.keys(triggers.automatic) : [];
   const manualNames = triggers?.manual ? Object.keys(triggers.manual) : [];
   let triggerConfig = null;
@@ -470,7 +493,8 @@ function buildHeartbeatMetadata(surface, sdkVersion, packageName, triggers) {
       automatic: automaticNames,
       manual: manualNames
     },
-    trigger_config: triggerConfig
+    trigger_config: triggerConfig,
+    configured_gtag_ids: gtagIds
   };
 }
 
@@ -479,14 +503,16 @@ var DEFAULT_FLUSH_INTERVAL_MS = 2e3;
 var DEFAULT_MAX_QUEUE_SIZE = 10;
 var HARD_MAX_BATCH = 50;
 var API_KEY_HEADER = "X-Aranova-Api-Key";
-function buildContext(surface, sdkVersion, packageName) {
+function buildContext(surface, sdkVersion, packageName, environment, activeGtagIds) {
   return {
     surface,
     sdk_version: sdkVersion,
     package_name: packageName,
     site_origin: typeof window === "undefined" ? null : window.location.origin,
     page_title: typeof document === "undefined" ? null : document.title || null,
-    referrer: typeof document === "undefined" ? null : document.referrer || null
+    referrer: typeof document === "undefined" ? null : document.referrer || null,
+    environment,
+    active_gtag_ids: activeGtagIds
   };
 }
 function readTrackingParams() {
@@ -546,6 +572,8 @@ function createTrackingClient(config) {
   const maxQueueSize = Math.min(config.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE, HARD_MAX_BATCH);
   const sdkVersion = config.sdkVersion ?? null;
   const packageName = config.packageName ?? null;
+  const environment = config.environment ?? "production";
+  const activeGtagIds = config.activeGtagIds ?? null;
   const endpointBase = config.endpoint.replace(/\/$/, "");
   const eventsUrl = `${endpointBase}/events`;
   let queue = [];
@@ -562,7 +590,8 @@ function createTrackingClient(config) {
       config.surface,
       sdkVersion,
       packageName,
-      config.triggers ?? null
+      config.triggers ?? null,
+      activeGtagIds
     );
     queue.push({
       event_type: "sdk_heartbeat",
@@ -581,7 +610,7 @@ function createTrackingClient(config) {
     }
     sessionId = rotated.id;
     const params = readTrackingParams();
-    const context = buildContext(config.surface, sdkVersion, packageName);
+    const context = buildContext(config.surface, sdkVersion, packageName, environment, activeGtagIds);
     return {
       session_id: sessionId,
       visitor_id: visitorId,
@@ -703,7 +732,8 @@ var sdkHeartbeatMetadataSchema = import_zod3.z.object({
   package_name: import_zod3.z.string().nullable(),
   surface: import_zod3.z.enum(["next", "react", "script"]),
   triggers: sdkHeartbeatTriggersSchema,
-  trigger_config: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown())).nullable().optional()
+  trigger_config: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown())).nullable().optional(),
+  configured_gtag_ids: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.string()).nullable().optional()
 }).strict();
 var sdkHeartbeatConfigSchema = import_zod3.z.object({}).strict();
 
@@ -1293,10 +1323,19 @@ function ConsentBanner() {
 
 // src/GoogleAdsTracking.tsx
 var import_react2 = require("react");
-function GoogleAdsTracking({ gtagId }) {
+function GoogleAdsTracking(props) {
+  const { gtagId, gtagIds } = props;
+  const gtagIdsKey = (0, import_react2.useMemo)(
+    () => gtagIds ? JSON.stringify(gtagIds) : "",
+    [gtagIds]
+  );
   (0, import_react2.useEffect)(() => {
-    bootstrapGoogleAdsTracking(gtagId);
-  }, [gtagId]);
+    if (gtagIds && Object.keys(gtagIds).length > 0) {
+      bootstrapMultipleGtags(gtagIds);
+    } else if (gtagId) {
+      bootstrapGoogleAdsTracking(gtagId);
+    }
+  }, [gtagId, gtagIdsKey]);
   return null;
 }
 
@@ -1336,7 +1375,7 @@ function useConsentState() {
 var import_react4 = require("react");
 
 // package.json
-var version = "0.6.1";
+var version = "0.7.1";
 
 // src/factory.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
@@ -1349,7 +1388,7 @@ var NOOP_CLIENT = {
   getVisitorId: () => ""
 };
 function createTracking(options) {
-  const { apiKey, endpoint, triggers, debug } = options;
+  const { apiKey, endpoint, triggers, environment, debug } = options;
   if (!apiKey || !endpoint) {
     if (apiKey || endpoint) {
       console.warn(
@@ -1363,7 +1402,8 @@ function createTracking(options) {
     };
   }
   const TrackingContext = (0, import_react4.createContext)(null);
-  function TrackingProvider({ gtagId, children }) {
+  function TrackingProvider({ gtagId, gtagIds, children }) {
+    const resolvedGtagIds = gtagIds ?? (gtagId ? { default: gtagId } : void 0);
     const client = (0, import_react4.useMemo)(
       () => createTypedClient(
         getOrCreateTrackingClient({
@@ -1373,6 +1413,8 @@ function createTracking(options) {
           packageName: "@aranova/tracking-react",
           sdkVersion: version,
           triggers,
+          environment,
+          activeGtagIds: resolvedGtagIds,
           debug
         }),
         triggers,
@@ -1380,10 +1422,14 @@ function createTracking(options) {
       ),
       []
     );
+    const gtagIdsKey = (0, import_react4.useMemo)(() => gtagIds ? JSON.stringify(gtagIds) : "", [gtagIds]);
     (0, import_react4.useEffect)(() => {
-      if (!gtagId) return;
-      bootstrapGoogleAdsTracking(gtagId);
-    }, [gtagId]);
+      if (gtagIds && Object.keys(gtagIds).length > 0) {
+        bootstrapMultipleGtags(gtagIds);
+      } else if (gtagId) {
+        bootstrapGoogleAdsTracking(gtagId);
+      }
+    }, [gtagId, gtagIdsKey]);
     (0, import_react4.useEffect)(() => {
       const detachers = [];
       const rawClient = getOrCreateTrackingClient({
@@ -1392,6 +1438,8 @@ function createTracking(options) {
         surface: "react",
         packageName: "@aranova/tracking-react",
         triggers,
+        environment,
+        activeGtagIds: resolvedGtagIds,
         debug
       });
       detachers.push(attachAutoPageView(rawClient));