@aranova/tracking-react 0.6.0 → 0.7.0

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.