# Události produktů

> Zobrazení produktů zaznamenaná sledovacím skriptem.



## product.viewed

> Odesílá se, když měřicí skript zaznamená zobrazení produktu, od kontaktu nebo od anonymního návštěvníka. Alfaverze: otevřená jen týmu Emailitu.

# product.viewed

Odesílá se pokaždé, když příkaz `product` [měřicího skriptu](/cs/docs/commerce/connect-your-shop/#record-shop-activity) zaznamená zobrazení produktu. Zobrazení pocházejí od známých kontaktů i od anonymních návštěvníků. Když se anonymní návštěvník později identifikuje, jeho dřívější zobrazení se započítají kontaktu, ale už odeslané události si ponechají `contact_id` nastavené na `null`. Viz [E-commerce](/cs/docs/commerce/#events).

> **E-commerce je v alfaverzi:** Dokud E-commerce testujeme, je otevřené jen týmu Emailitu. Viz [Kdo může E-commerce používat](/cs/docs/commerce/#who-can-use-commerce).

Zobrazení produktů pocházejí z návštěvnosti webu, takže webhooky, které přijímají **All events**, tuto událost nedostanou. Událost `product.viewed` odebírejte podle názvu.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/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"
      }
    }
  }
}
```

## Pole

- `event_id` (string): ID události (`evt_…`). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint [Načtení události](/cs/docs/api-reference/events/get/).

- `type` (string): Vždy `product.viewed`.

- `object` (object): Zobrazení produktu, kterého se událost týká. Jeho pole jsou uvedena níže.

- `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`.

### Objekt zobrazení produktu

- `object` (string): Vždy `product_view`.

- `product` (object): Zobrazený produkt: `id` (`prd_…`, nebo `null`, pokud produkt není ve vašem katalogu), `external_id` (ID produktu ve vašem obchodě), `title`, `url`, `image_url`, `price` a `currency`. Hodnoty pocházejí z vašeho [katalogu](/cs/docs/api-reference/products/get/), pokud v něm produkt je, jinak z volání `product`.

- `contact_id` (string | null): Kontakt, který si produkt zobrazil (`con_…`), nebo `null` u anonymního návštěvníka.

- `email` (string | null): E-mailová adresa kontaktu, nebo `null` u anonymního návštěvníka.

- `anonymous_id` (string | null): ID, které měřicí skript přidělil prohlížeči návštěvníka.

- `viewed_at` (string): Kdy si návštěvník produkt zobrazil, ve formátu ISO 8601 v UTC.

- `source` (string): Vždy `js` (měřicí skript).

- `context` (object | null): Co skript ví o návštěvě: `page` (`url`, `path`, `title`, `referrer`), `campaign` (hodnoty UTM), `locale`, `timezone`, `library` a `user_agent`. Stejná pole jako u [událostí z měřicího skriptu](/cs/docs/events/tracking-script/#what-the-script-sends).

---
Zdroj: https://emailit.com/cs/docs/webhooks/events/product/product-viewed/