Tracking pixel - Videowise

VideowiseSDK.trackingPixel is an async function that sends order data to Videowise analytics after a successful checkout. Call it once per completed order, after order confirmation. It is a plain async function and does not need to be rendered inside VideowiseSDK.Provider. On the web, the equivalent is the order tracking pixel. When a stored live shopping session ID (lsId) is present, the SDK automatically attaches a mobile_app referral (vw_source_id = lsId, vw_user_identifier = uid). That order is attributed to MOBILE APP in live-show analytics, not ON SITE. referral is not a trackingPixel parameter and is not merchant-configurable. Live Shopping add-to-cart is sent to /tracking/cart/pixel with the same referral. It returns Promise<Response | null>. The resolved value is null when the SDK has no stored user identifier, when a required parameter is missing, or when the request throws.

Parameters

trackingPixel(params) takes a single object with the following properties:

Property	Type	Required	Description
`shop`	`string`	Yes	Store domain (e.g. `storename.myshopify.com`)
`orderId`	`number`	Yes	Numeric order ID
`orderTotal`	`number`	Yes	Total order amount
`orderCurrency`	`string`	Yes	ISO currency code (e.g. `USD`)
`orderItems`	`OrderItem[]`	Yes	Array of purchased items (see below)

`orderItems` element (`OrderItem`)

Property	Type	Description
`id`	`string`	Line item ID
`quantity`	`number`	Quantity purchased
`title`	`string \| null`	Line item title
`variant`	`object`	Variant details (see below)
`finalLinePrice`	`object`	Final line price (see below)

variant object

Property	Type	Description
`id`	`string`	Variant ID
`image.src`	`string \| null`	Variant image URL
`price.amount`	`number`	Variant unit price
`price.currencyCode`	`string`	Variant price currency code
`product.id`	`string`	Product ID
`product.title`	`string \| null`	Product title
`product.vendor`	`string \| null`	Product vendor
`product.type`	`string \| null`	Product type
`product.untranslatedTitle`	`string \| null`	Untranslated product title
`product.url`	`string`	Product URL
`sku`	`string \| null`	Variant SKU
`title`	`string`	Variant title
`untranslatedTitle`	`string`	Untranslated variant title

finalLinePrice object

Property	Type	Description
`amount`	`number`	Final line price amount
`currencyCode`	`string`	Final line price currency

Example

import VideowiseSDK from "@vidystar/videowise-react-native-sdk";

await VideowiseSDK.trackingPixel({
  shop: "storename.myshopify.com",
  orderId: 12345,
  orderTotal: 99.99,
  orderCurrency: "USD",
  orderItems: [
    {
      id: "item-1",
      quantity: 1,
      title: "Product Name",
      variant: {
        id: "variant-1",
        image: { src: "https://..." },
        price: { amount: 99.99, currencyCode: "USD" },
        product: {
          id: "prod-1",
          title: "Product Name",
          vendor: "Vendor",
          type: "Type",
          untranslatedTitle: "Product Name",
          url: "https://...",
        },
        sku: "SKU-123",
        title: "Variant",
        untranslatedTitle: "Variant",
      },
      finalLinePrice: { amount: 99.99, currencyCode: "USD" },
    },
  ],
});

​Parameters

​orderItems element (OrderItem)

​Example

​Related

Parameters

`orderItems` element (`OrderItem`)

Example

Related