Shopify Web Pixel API — Tracking Moderno

// extensions/tracker/src/index.ts
// Web Pixel app — roda em sandbox isolado
import { register } from '@shopify/web-pixels-extension'

register(({ analytics, browser, settings }) => {
  const collectorUrl = settings.collector_url
  const apiKey = settings.api_key

  // Fila local com batching
  const queue: any[] = []
  let timer: any = null

  const flush = () => {
    if (queue.length === 0) return
    const batch = queue.splice(0)
    browser.sendBeacon(collectorUrl, JSON.stringify({ apiKey, events: batch }))
    timer = null
  }

  const enqueue = (event: any) => {
    queue.push({
      event_id: crypto.randomUUID(),
      timestamp: event.timestamp,
      name: event.name,
      data: event.data,
    })
    if (queue.length >= 10) flush()
    else if (!timer) timer = setTimeout(flush, 3000)
  }

  // Eventos de produto
  analytics.subscribe('product_viewed', enqueue)
  analytics.subscribe('product_added_to_cart', enqueue)
  analytics.subscribe('collection_viewed', enqueue)

  // Eventos de checkout (CRÍTICOS — flush imediato)
  analytics.subscribe('checkout_started', e => { enqueue(e); flush() })
  analytics.subscribe('checkout_completed', e => { enqueue(e); flush() })

  // Custom event opcional
  analytics.subscribe('custom_event', enqueue)
})

// extensions/tracker/shopify.extension.toml
// type = "web_pixel_extension"
// name = "Custom Tracker"
// settings = [
//   { key = "collector_url", type = "url" },
//   { key = "api_key", type = "string" }
// ]