# Eventi dei prodotti

> Visualizzazioni di prodotto registrate dallo script di tracciamento.



## product.viewed

> Inviato quando lo script di tracciamento registra una visualizzazione di prodotto, da un contatto o da un visitatore anonimo. Alpha: aperto solo al team di Emailit.

# product.viewed

Inviato ogni volta che il comando `product` dello [script di tracciamento](/it/docs/commerce/connect-your-shop/#record-shop-activity) 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](/it/docs/commerce/#events).

> **L’e-commerce è in alpha:** L’e-commerce è aperto solo al team di Emailit mentre lo testiamo. Vedi [Chi può usare l’e-commerce](/it/docs/commerce/#who-can-use-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](/it/docs/webhooks/webhook-requests/).

```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"
      }
    }
  }
}
```

## Campi

- `event_id` (string): 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](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `product.viewed`.

- `object` (object): La visualizzazione di prodotto descritta dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto visualizzazione di prodotto

- `object` (string): Sempre `product_view`.

- `product` (object): 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](/it/docs/api-reference/products/get/) quando il prodotto è presente, altrimenti dalla chiamata `product`.

- `contact_id` (string | null): Il contatto che ha visualizzato il prodotto (`con_…`), oppure `null` per un visitatore anonimo.

- `email` (string | null): L’indirizzo email del contatto, oppure `null` per un visitatore anonimo.

- `anonymous_id` (string | null): L’ID che lo script di tracciamento assegna al browser del visitatore.

- `viewed_at` (string): Quando il visitatore ha visualizzato il prodotto, in ISO 8601 UTC.

- `source` (string): Sempre `js` (lo script di tracciamento).

- `context` (object | 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](/it/docs/events/tracking-script/#what-the-script-sends).

---
Fonte: https://emailit.com/it/docs/webhooks/events/product/product-viewed/