Reteno's ecommerce tracking allows you to understand customer behavior and use this data for analytics and automation.

This guide shows how to track ecommerce activity in your React Native application using specific logging methods from the SDK.

import {
  logEcomEventProductViewed,
  logEcomEventProductCategoryViewed,
  logEcomEventProductAddedToWishlist,
  logEcomEventCartUpdated,
  logEcomEventOrderCreated,
  logEcomEventOrderUpdated,
  logEcomEventOrderDelivered,
  logEcomEventOrderCancelled,
  logEcomEventSearchRequest,
} from "reteno-react-native-sdk";

Supported Events

Function	When to use it
`logEcomEventProductViewed`	User opens a product card
`logEcomEventProductCategoryViewed`	User opens a category or listing page
`logEcomEventProductAddedToWishlist`	User adds a product to wishlist
`logEcomEventCartUpdated`	Cart items changed (add / remove / quantity update)
`logEcomEventOrderCreated`	New order is created
`logEcomEventOrderUpdated`	Order is updated after creation
`logEcomEventOrderDelivered`	Order marked as DELIVERED
`logEcomEventOrderCancelled`	Order marked as CANCELLED
`logEcomEventSearchRequest`	User performs a search query

Usage Pattern

Construct the appropriate payload object.
Pass it to the corresponding log function.
Await the result.

await logEcomEventProductViewed({
  product: {
    productId: "PRODUCT_ID",
    price: 99.99,
    isInStock: true,
    attributes: [
      { name: "color", value: ["red"] },
      { name: "size", value: ["M"] },
    ],
  },
  currencyCode: "USD",
});

Event Reference

Product Viewed

await logEcomEventProductViewed({
  product: {
    productId: "123",
    price: 29.99,
    isInStock: true,
    attributes: [{ name: "color", value: ["blue", "white"] }],
  },
  currencyCode: "EUR",
});

Field	Type	Description
product	`EcomProductView`	Required product object
currencyCode	`string?`	Optional ISO‑4217 code (e.g. USD, EUR)

Product Category Viewed

await logEcomEventProductCategoryViewed({
  category: {
    productCategoryId: "CATEGORY_01",
    attributes: [{ name: "gender", value: ["women"] }],
  },
});

Field	Type	Description
productCategoryId	`string`	Required category identifier
attributes	`EcomAttribute[]?`	Optional metadata fields

Product Added to Wishlist

await logEcomEventProductAddedToWishlist({
  product: {
    productId: "abc",
    price: 59.99,
    isInStock: true,
    attributes: [],
  },
  currencyCode: "UAH",
});

Same structure as Product Viewed.

Cart Updated

await logEcomEventCartUpdated({
  cartId: "CART-123",
  cartItems: [
    {
      productId: "p1",
      quantity: 2,
      price: 25.0,
      discount: 5.0,
    },
    {
      productId: "p2",
      quantity: 1,
      price: 100.0,
    },
  ],
  currencyCode: "USD",
});

Field	Type	Description
cartId	`string`	Shopping cart ID
cartItems	`EcomCartItem[]`	Array of cart item details
currencyCode	`string?`	Optional currency

Order Created / Updated

await logEcomEventOrderCreated({
  order: {
    externalOrderId: "ORDER-999",
    totalCost: 200,
    status: OrderStatus.Initialized,
    cartId: "CART-123",
    externalCustomerId: "user-001",
  },
  currencyCode: "USD",
});

Field	Type	Description
externalOrderId	`string`	Your system's order ID
totalCost	`number`	Total amount charged
status	`OrderStatus`	One of: Initialized, InProgress, Delivered, Cancelled
cartId	`string?`	Related cart ID (optional)
currencyCode	`string?`	ISO‑4217 currency code

Order Delivered / Cancelled

await logEcomEventOrderDelivered({ externalOrderId: "ORDER-999" });

await logEcomEventOrderCancelled({ externalOrderId: "ORDER-999" });

Search Request

await logEcomEventSearchRequest({
  searchQuery: "running shoes",
  isFound: true,
});

Field	Type	Description
searchQuery	`string`	What the user searched for
isFound	`boolean`	Whether results were found

Currency Codes

Always use valid ISO‑4217 currency codes:

USD
EUR
UAH

If no code is provided, your organization's default will be used.