Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cevoid.com/llms.txt

Use this file to discover all available pages before exploring further.

Analytics setup controls which metrics and dimensions Cevoid can calculate. Some reports work from workspace data alone. Other reports need storefront tracking, connected accounts, or product catalogue data.

​
Report requirements

When a report needs more setup or data, Cevoid shows Report requirements in the admin panel. Each requirement has a status:
  • Completed means Cevoid can use that requirement.
  • Not completed means the report needs more setup before the related metric or dimension is complete.
Open the requirement details and follow the instructions shown there. Requirements are report-specific, so a report only shows the setup steps needed for its selected metrics and dimensions.

​
Setup requirements

Common requirements are:
  • Session tracking: Required for user behavior, widget interactions, and conversion analysis.
  • Sales tracking: Required for orders, revenue, and conversion insights.
  • Instagram account: Required for Instagram source and content-type insights.
  • Product brands: Required to break analytics down by product brand.
  • Product collections: Required to break analytics down by product collection.
  • Product categories: Required to break analytics down by product category.
Session and sales tracking are the core setup steps for conversion insights. Other requirements unlock deeper breakdowns for specific reports.

​
Session tracking

Session tracking enables on-site behavior metrics. It tracks storefront sessions and widget interactions, such as widget loads, impressions, post clicks, product tag clicks, reach, and claps. When sales tracking is also enabled, session tracking connects UGC interactions to conversion analysis. Setup steps:
  • Open the report requirement details in Cevoid.
  • Make sure your consent setup allows analytics storage before expecting persistent session IDs.
  • Add the ca_session cookie to your cookie policy if your consent setup requires it.
  • Enable session tracking for production in the requirement instructions.
  • Trigger storefront activity after the setup is live.
Result: Cevoid can connect widget interactions to visitor sessions and use that data in analytics reports.
Session tracking requires visitor consent. If consent is not granted, events can still be sent without a persistent Cevoid session ID.

​
Sales tracking

Sales tracking enables order, revenue, and conversion metrics. It connects completed orders to on-site engagement so reports can compare sessions with UGC interaction against sessions without UGC interaction. Sales tracking is required for conversion analytics, top converting posts, top converting widgets, and revenue-related reports. Shopify setup:
  • Open the report requirement details in Cevoid.
  • Enable the Cevoid checkout web pixel for each Shopify store that should send checkout events.
  • Click Check status after enabling the web pixel to confirm that Cevoid can see checkout tracking.
Non-Shopify setup:
  • Open the report requirement details in Cevoid.
  • Add the checkout script shown in the admin panel to your checkout template.
  • Send a purchase event when an order is completed.
  • Use final order data, not cart or checkout-start data.
  • Click Check status after Cevoid receives new sales data.
Example purchase event shape: 
cevoid.trigger('purchase', {
  orderId: '1',
  orderNumber: '1',
  currency: 'USD',
  amount: 20.0,
  items: [
    {
      id: '2',
      sku: '234'
    }
  ]
})
Only send one conversion event per completed order. Duplicate conversion events can inflate sales and revenue metrics.

​
Instagram account

An Instagram account enables Instagram-specific analytics, such as content collected from tags, mentions, hashtags, and Instagram post type breakdowns. Setup steps:
  • Connect your Instagram account in Cevoid.
  • Confirm that Cevoid can collect the Instagram content you want to analyze.
  • Wait for new or synced content to appear in your workspace.
Result: Reports can include Instagram dimensions such as post type, tag, mention, and hashtag source. Use Instagram for connection details.

​
Product catalogue data

Product catalogue data enables product-related breakdowns. Reports can use product brand, product collection, and product category when those fields exist in your catalogue. Setup steps:
  • Sync or import your product catalogue.
  • Confirm products include the brand, collection, or category fields you want to use.
  • Add product tags to posts when you want product-level UGC performance.
Result: Reports can group or filter analytics by product data. Use Product Feeds and Products & Markets for product setup details.

​
Troubleshoot missing data

If analytics data is missing or incomplete:
  • Check whether the report shows setup requirements.
  • Confirm the date range includes activity after tracking was enabled.
  • Wait for new storefront activity after changing tracking settings.
  • For session metrics, confirm enableSessionTracking is enabled and consent is granted.
  • For sales metrics, confirm purchase events or the Shopify web pixel are sending completed orders.
  • For product breakdowns, confirm product catalogue fields are populated.
  • For Instagram breakdowns, confirm your Instagram account is connected and synced.
The requirement shown in the report points to the data source that the selected metric or dimension needs.

​
Advanced setup

Most teams should follow the instructions in the admin panel. Use the Analytics SDK and developer guides when you want full programmatic control over session tracking, event tracking, consent handling, or conversion tracking.