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

This guide shows how to track e-commerce 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.