@leancodepl/gtag/README.md

Google Tag Manager integration utilities for web analytics

# @leancodepl/gtag

Type-safe Google Tag Manager data layer integration.

## Installation

```bash
npm install @leancodepl/gtag
# or
yarn add @leancodepl/gtag
```

## API

### `mkgtag()`

Creates a type-safe Google Tag Manager data layer push function.

**Returns:** Function that accepts data layer arguments and pushes to GTM

## Usage Examples

### Basic Event Tracking

```typescript
import { mkgtag } from '@leancodepl/gtag';

const gtag = mkgtag<{ event: 'page_view'; page_title: string }>();

gtag({
  event: 'page_view',
  page_title: 'Home Page',
});
```

### Custom Events with Callbacks

```typescript
import { mkgtag } from '@leancodepl/gtag';

interface CustomEvent {
  event: 'button_click';
  element_id: string;
}

const gtag = mkgtag<CustomEvent>();

gtag({
  event: 'button_click',
  element_id: 'signup-button',
  eventCallback: (containerId) => {
    console.log('Event sent to container:', containerId);
  },
  eventTimeout: 2000,
});
```