Dokumentace FoodRetailor Help

Sběr a zpracování událostí

Sbírání eventu, které odesílá systémový client

Seznam události

Zákaznická interakce s produktem

Názvy události a jejich datové typy

Události sledující zákaznické chování vůči produktu.


Sledované chování:

Událost

EventName

Data

Zákazník viděl produkt

CustomerSeenProduct

CustomerGeneralProductData

Zákazník koupil produkt

CustomerHasBoughtProduct

CustomerHasBoughtProductData

Zákazník přidal produkt do nákupního seznamu

CustomerAddedProductToShoppingList

CustomerGeneralProductData

Zákazník přidal produkt do nákupního koše

CustomerAddedProductToBasket

CustomerGeneralProductData

Zákazníkovi byl doporučen produkt

CustomerHasBeenRecommendedProduct

CustomerGeneralProductData

Model události

Hodnota

Popis

type

SystemCustomerProductEvent

source

Odkuď událost pochází (mobilní aplikace, emailing, web,...).

name

Název eventu. Např. pokud byl uživateli doporučen produkt name bude "CustomerHasBeenRecommendedProduct"

customerId

Od jakého zákazníka je daná událost.

marketId

Jaké pobočky se událost týká?

dateTime

Kdy došlo k události?

data

Data k události (pole datových typů)

Příklad použití

SystemCustomerProductEvent( source = "Emailing", name = "CustomerHasBeenRecommendedProduct", customerId = "2018092", marketId = "4001", dateTime = "2025-04-10T16:41:11Z", data = [ ... ], type = "SystemCustomerProductEvent" )

Seznam datových modelů

CustomerGeneralProductData

Defaultní datový model pro události.

Hodnota

Popis

type

CustomerGeneralProductData

productId

Vanr produktu

origin

Místo, kde došlo k události.

originId

Identifikátor originu.

position

Pozice produktu.

price

Cena produktu v době události.

price

Původní cena produktu.

priceType

Typ ceny produktu v době události.

  • 0 - bez slevy

  • 1 - sleva

  • 2 - cena Můj Globus

  • 3 - cena Můj Globus v kombinaci se slevou

strategy

Jaká strategie byla použitá pro doporučení.

  • emailing - defaultní strategie pro emailing.

Příklad použití
CustomerGeneralProductData( productId = "12345", origin = "SmartEmailing", price = 12.34, position = 1, priceType = "1", originId = "123", originalPrice = 15.00, strategy = "emailing", type = "CustomerGeneralProductData" )
Datový model pro CustomerHasBoughtProduct událost.

Datový model pro událost uživatel nakoupil produkt.

Hodnota

Popis

type

CustomerHasBoughtProduct

productId

Vanr produktu

price

Cena za kterou zákazník produkt koupil

priceType

Typ ceny

quantity

Kolik jednotek zákazník nakoupil.

Příklad použití
CustomerHasBoughtProductData( productId = "8172", price = 7.34, priceType = "1", quantity = 2.0, type = "CustomerHasBoughtProduct" )

API specifikace

/event/collect

Collecting events of predefined types

Request parameters

[ { "type": "example", "source": "example", "name": "CustomerSeenProduct", "marketId": "example", "dateTime": "example", "data": [ { "type": "example", "productId": "example", "origin": "example", "price": 16.0, "position": 96, "originId": "example", "originalPrice": 16.0, "priceType": "example", "strategy": "example" } ], "version": 96 } ]

Responses

15 April 2025