Skip to content

tracker.trackAddToCart()

Fires a GA4 add_to_cart event. When conversionLabels.addToCart is configured, also fires a matching Ads conversion.

Signature

tracker.trackAddToCart(input?: BrowserAddToCartInput): Promise<void>;

`BrowserAddToCartInput`

type BrowserAddToCartInput = {
  transactionId?: string;
  value?: number;
  currency?: string;
  items?: TrackbridgeItem[];
  userData?: UserData;
};

Field	Required	Notes
`transactionId`	no	Auto-generated when missing; standard dual-send-disabled warning fires.
`value`	no	Item value, in `currency`.
`currency`	no	ISO 4217.
`items`	no	`TrackbridgeItem[]` — typically a one-element array for the line being added.
`userData`	no	Hashed per enhanced conversions when supplied.

Returns

Promise<void>.

Example

'use client';
import { tracker } from '@/lib/tracker.client';

export function AddToCartButton({ product }: { product: Product }) {
  return (
    <button
      onClick={() => {
        tracker.trackAddToCart({
          value: product.price,
          currency: 'USD',
          items: [
            {
              itemId: product.sku,
              itemName: product.name,
              price: product.price,
              quantity: 1,
            },
          ],
        });
        cart.add(product);
      }}
    >
      Add to cart
    </button>
  );
}

See also