Analytics SDK
Choose the right Cevoid analytics integration path for your storefront.
Use this page first when you are deciding how to implement Cevoid analytics on a storefront. If you already know the exact SDK method or event payload you need, skip to Installation, SDK API, or Event types.
Choose your path
Using Cevoid galleries or cards
Gallery and card widgets already initialize Cevoid UGC tracking and emit browser events automatically.
Listen to Cevoid browser events on
windowand forward them into your existing analytics setup.Use
trackEvent()when you render Cevoid interactions yourself and need to send widget-style events manually.Shopify uses the checkout web pixel path. Non-Shopify storefronts use the manual sales-tracking path.
Keep the Cevoid session ID across page loads when consent allows it.
See when
ca_sessionis created, when it is not, and how denied consent affects events.
Quick answers
I embedded a Cevoid gallery or card. Do I need to call trackEvent()?
Usually you do not need trackEvent() for them. Cevoid galleries and cards initialize the UGC SDK internally and send the core widget, post, product, and gallery events automatically.
I want those gallery events in GA4 or GTM.
Use Forward browser events to GA. The SDK emits browser CustomEvents like cevoid:post.click by default, so you usually listen for them instead of duplicating the tracking calls.
I am rendering Cevoid interactions in my own storefront code.
Use Manual event tracking and send the supported Cevoid event names yourself.
I want to track completed purchases.
Use Track sales. Shopify storefronts use the checkout web pixel path only; non-Shopify storefronts use the manual trackSale() path.
I need Cevoid session IDs on events.
Use Session tracking and Consent. Every event carries a session ID for the current page runtime. Session tracking is optional and only keeps that session_id across page loads, in the ca_session cookie, when consent resolves to granted.