Eventi dei prodotti

Visualizzazioni di prodotto registrate dallo script di tracciamento.

product.viewed

Inviato ogni volta che il comando product dello script di tracciamento registra una visualizzazione di prodotto. Le visualizzazioni arrivano sia dai contatti noti sia dai visitatori anonimi. Quando un visitatore anonimo viene identificato in seguito, le sue visualizzazioni precedenti contano per il contatto, ma gli eventi già inviati mantengono contact_id impostato su null. Vedi E-commerce.

Le visualizzazioni di prodotto derivano dal traffico del sito, quindi i webhook che ricevono All events non ricevono questo evento. Sottoscrivi product.viewed per nome.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre product.viewed.

objectobject

La visualizzazione di prodotto descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto visualizzazione di prodotto

objectstring

Sempre product_view.

productobject

Il prodotto visualizzato: id (prd_…, null quando il prodotto non è nel catalogo), external_id (l’ID del prodotto nel tuo negozio), title, url, image_url, price e currency. I valori vengono dal catalogo quando il prodotto è presente, altrimenti dalla chiamata product.

contact_idstring | null

Il contatto che ha visualizzato il prodotto (con_…), oppure null per un visitatore anonimo.

emailstring | null

L’indirizzo email del contatto, oppure null per un visitatore anonimo.

anonymous_idstring | null

L’ID che lo script di tracciamento assegna al browser del visitatore.

viewed_atstring

Quando il visitatore ha visualizzato il prodotto, in ISO 8601 UTC.

sourcestring

Sempre js (lo script di tracciamento).

contextobject | null

Ciò che lo script sa della visita: page (url, path, title, referrer), campaign (valori UTM), locale, timezone, library e user_agent. Gli stessi campi degli eventi dello script di tracciamento.

JSON

{
  "event_id": "evt_3xbB2QmL7cVn0Rk8sWd4TfY1uHa",
  "type": "product.viewed",
  "object": {
    "object": "product_view",
    "product": {
      "id": "prd_3Rx6aB1cD2eF3gH4iJ5kL6mN7oP",
      "external_id": "8123456789",
      "title": "Trail running shoe",
      "url": "https://shop.example.com/products/trail-running-shoe",
      "image_url": "https://shop.example.com/images/trail-running-shoe.jpg",
      "price": 89,
      "currency": "USD"
    },
    "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs",
    "email": "ada@example.com",
    "anonymous_id": "anon_5f0c9e2b7d1a4c8e9b3f6a2d1c0e7b4a",
    "viewed_at": "2026-10-19T09:12:40.512Z",
    "source": "js",
    "context": {
      "page": {
        "url": "https://shop.example.com/products/trail-running-shoe",
        "path": "/products/trail-running-shoe",
        "title": "Trail running shoe"
      },
      "campaign": { "source": "emailit", "medium": "email", "name": "Autumn sale" },
      "timezone": "Europe/Prague"
    }
  },
  "data": {
    "object": {
      "object": "product_view",
      "product": {
        "id": "prd_3Rx6aB1cD2eF3gH4iJ5kL6mN7oP",
        "external_id": "8123456789",
        "title": "Trail running shoe",
        "url": "https://shop.example.com/products/trail-running-shoe",
        "image_url": "https://shop.example.com/images/trail-running-shoe.jpg",
        "price": 89,
        "currency": "USD"
      },
      "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs",
      "email": "ada@example.com",
      "anonymous_id": "anon_5f0c9e2b7d1a4c8e9b3f6a2d1c0e7b4a",
      "viewed_at": "2026-10-19T09:12:40.512Z",
      "source": "js",
      "context": {
        "page": {
          "url": "https://shop.example.com/products/trail-running-shoe",
          "path": "/products/trail-running-shoe",
          "title": "Trail running shoe"
        },
        "campaign": { "source": "emailit", "medium": "email", "name": "Autumn sale" },
        "timezone": "Europe/Prague"
      }
    }
  }
}