Sarge
Docs
Event reference

Track the events that prove what happened.

Use stable, lowercase, dot-separated names. Properties should be JSON-serializable and should keep the same shape every time an event fires.

Ecommerce events

page.view

Initial page load and SPA route changes.

pathtitle 
window.sarge("track", "page.view", {
  path: window.location.pathname,
  title: document.title
});

product.viewed

Product detail view, quick view, or product card inspection.

product_id 
window.sarge("track", "product.viewed", {
  product_id: "field-flask",
  product_name: "Field Flask",
  price: 42,
  currency: "USD"
});

cart.added

A product is successfully added to cart.

product_idprice 
window.sarge("track", "cart.added", {
  product_id: "field-flask",
  product_name: "Field Flask",
  price: 42,
  currency: "USD",
  cart_size: 1
});

checkout.started

The customer starts checkout.

valuecurrency 
window.sarge("track", "checkout.started", {
  value: 84,
  currency: "USD",
  cart_size: 2
});

purchase.completed

Payment succeeds and an order is created.

order_idvaluecurrency 
window.sarge("track", "purchase.completed", {
  order_id: "order_123",
  value: 84,
  currency: "USD",
  item_count: 2,
  products: ["field-flask", "map-wax"]
});

Watchdog events

These are emitted automatically when Sarge observes common third-party marketing APIs after the pixel loads.

meta.pixel.fire

Observed from `fbq(...)`

{
  vendor: "meta",
  command: "track",
  event_name: "Purchase",
  payload: { value: 84, currency: "USD" }
}

google.tag.fire

Observed from `gtag(...)`

{
  vendor: "google",
  command: "event",
  event_name: "purchase",
  payload: { transaction_id: "order_123", value: 84 }
}

data_layer.push

Observed from `dataLayer.push(...)`

{
  vendor: "google",
  payload: {
    event: "purchase",
    ecommerce: { value: 84, currency: "USD" }
  }
}