@walkeros/web-destination-d8a

d8a web destination for walkerOS. It sends walkerOS events to the d8a web tracker using the GA4 gtag-style d8a() API.

Source Code • NPM Package

Installation

npm install @walkeros/web-destination-d8a

Usage

import { startFlow } from '@walkeros/collector';
import { destinationD8a } from '@walkeros/web-destination-d8a';

await startFlow({
  destinations: {
    d8a: {
      code: destinationD8a,
      config: {
        settings: {
          property_id: '80e1d6d0-560d-419f-ac2a-fe9281e93386',
          server_container_url:
            'https://global.t.d8a.tech/80e1d6d0-560d-419f-ac2a-fe9281e93386/d/c',
        },
      },
    },
  },
});

Configuration

| Name | Type | Required | Description | | ---------------------- | ------------------- | -------- | ------------------------------------------- | | property_id | string | Yes | d8a property ID | | server_container_url | string | Yes | d8a collector URL for the property | | send_page_view | boolean | No | Set false to disable automatic page views | | debug_mode | boolean | No | Enable d8a debug mode | | dataLayerName | string | No | Queue name, defaults to d8aLayer | | globalName | string | No | Global function name, defaults to d8a | | snakeCase | boolean | No | Convert walkerOS event names to snake_case | | como | boolean \| object | No | Consent mode mapping, defaults to true |

The destination follows d8a behavior for page views: automatic page views are preserved by default and disabled only when send_page_view: false is configured.

Event Mapping

By default, walkerOS event names are converted to snake_case and sent with the configured property ID as send_to.

mapping: {
  order: {
    complete: {
      name: 'purchase',
      data: {
        map: {
          transaction_id: 'data.id',
          value: 'data.total',
          currency: { key: 'data.currency', value: 'EUR' },
        },
      },
    },
  },
}

This produces:

d8a('event', 'purchase', {
  transaction_id: '0rd3r1d',
  value: 555,
  currency: 'EUR',
  send_to: '80e1d6d0-560d-419f-ac2a-fe9281e93386',
});

Consent Mode

The destination supports d8a's gtag-compatible consent mode. By default, the mapping is:

| walkerOS consent key | d8a consent fields | | -------------------- | -------------------------------------------------- | | marketing | ad_storage, ad_user_data, ad_personalization | | functional | analytics_storage |

Disable consent mode with:

settings: {
  como: false,
}

Or provide a custom mapping:

settings: {
  como: {
    analytics: 'analytics_storage',
    marketing: ['ad_storage', 'ad_personalization'],
  },
}

Related

• d8a web tracker docs
• Destination interface

License

MIT