Produkt-Events

Vom Tracking-Skript erfasste Produktaufrufe.

product.viewed

Wird jedes Mal gesendet, wenn der Befehl product des Tracking-Skripts einen Produktaufruf erfasst. Aufrufe kommen von bekannten Kontakten und von anonymen Besuchern. Wird ein anonymer Besucher später identifiziert, zählen seine früheren Aufrufe für den Kontakt, aber in den bereits gesendeten Events bleibt contact_id auf null. Siehe Commerce.

Produktaufrufe stammen aus dem Website-Traffic, daher erhalten Webhooks, die All events empfangen, dieses Event nicht. Abonnieren Sie product.viewed mit seinem Namen.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

Event-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.

typestring

Immer product.viewed.

objectobject

Der Produktaufruf, den das Event beschreibt. Seine Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Produktaufruf-Objekt

objectstring

Immer product_view.

productobject

Das aufgerufene Produkt: id (prd_…, null, wenn das Produkt nicht in Ihrem Katalog ist), external_id (die Produkt-ID in Ihrem Shop), title, url, image_url, price und currency. Die Werte stammen aus Ihrem Katalog, wenn das Produkt darin ist, und sonst aus dem Aufruf product.

contact_idstring | null

Der Kontakt, der das Produkt aufgerufen hat (con_…), oder null für einen anonymen Besucher.

emailstring | null

Die E-Mail-Adresse des Kontakts oder null für einen anonymen Besucher.

anonymous_idstring | null

Die ID, die das Tracking-Skript für den Browser des Besuchers vergibt.

viewed_atstring

Zeitpunkt, zu dem der Besucher das Produkt aufgerufen hat, im Format ISO 8601 in UTC.

sourcestring

Immer js (das Tracking-Skript).

contextobject | null

Was das Skript über den Besuch weiß: page (url, path, title, referrer), campaign (UTM-Werte), locale, timezone, library und user_agent. Dieselben Felder wie bei Events aus dem Tracking-Skript.

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