Události produktů

Zobrazení produktů zaznamenaná sledovacím skriptem.

product.viewed

Odesílá se pokaždé, když příkaz product měřicího skriptu 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.

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ů.

Pole

event_idstring

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.

typestring

Vždy product.viewed.

objectobject

Zobrazení produktu, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt zobrazení produktu

objectstring

Vždy product_view.

productobject

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, pokud v něm produkt je, jinak z volání product.

contact_idstring | null

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

emailstring | null

E-mailová adresa kontaktu, nebo null u anonymního návštěvníka.

anonymous_idstring | null

ID, které měřicí skript přidělil prohlížeči návštěvníka.

viewed_atstring

Kdy si návštěvník produkt zobrazil, ve formátu ISO 8601 v UTC.

sourcestring

Vždy js (měřicí skript).

contextobject | 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.

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