@bigz-app/booking-widget 0.2.3 → 0.3.1

package/README.md

@@ -10,7 +10,7 @@ pnpm install @bigz-app/booking-widget
 
 ## Quick Start
 
-Import the widget and provide the necessary configuration. The widget handles the entire booking flow, from event selection to payment.
+Import the widget and provide the necessary configuration. The widget handles the entire booking flow, from event selection to payment, with optional Google Ads conversion tracking.
 
 ```tsx
 import { UniversalBookingWidget } from '@bigz-app/booking-widget';
@@ -100,4 +100,30 @@ The widget can be configured dynamically using URL query parameters. These will
 | `instanceId`     | `eventInstanceId`| `?instanceId=123`     |
 | `categoryId`     | `categoryId`     | `?categoryId=1`       |
 | `eventTypeId`    | `eventTypeId`    | `?eventTypeId=5`      |
-| `eventTypeIds`   | `eventTypeIds`   | `?eventTypeIds=1,3,5` |
+| `eventTypeIds`   | `eventTypeIds`   | `?eventTypeIds=1,3,5` |
+
+## Google Ads Conversion Tracking
+
+The widget supports automatic Google Ads conversion tracking when payments are successful. This feature requires Google Consent Mode to be implemented on your website.
+
+```tsx
+const config = {
+  // ... your existing config
+  googleAds: {
+    tagId: 'AW-XXXXXXX',           // Your Google Ads Tag ID (required)
+    conversionId: 'booking_conversion', // Your conversion label (required)
+    conversionCurrency: 'EUR',     // Optional, defaults to 'EUR'
+    includeValue: true             // Optional, defaults to true
+  }
+};
+```
+
+**Key Features:**
+- ✅ Uses Google Consent Mode for proper consent management
+- ✅ Prevents duplicate gtag initialization 
+- ✅ Includes booking value and transaction ID
+- ✅ Automatic error handling and fallbacks
+
+**Required:** You must implement [Google Consent Mode](https://developers.google.com/tag-platform/security/consent) on your website for tracking to work.
+
+For detailed setup instructions, see [Google Ads Tracking Documentation](./docs/google-ads-tracking.md).