Contentstack on Contentstack: Omnichannel Personalization | Save your spot!
CS-log-dark.svg

Data & Insights (Lytics) FAQs

Data & Insights (Lytics) is Contentstack’s native audience management and behavioral data platform. It lets you collect real-time user signals, define audience segments, and power personalized experiences using Contentstack Personalize. While it can connect to external Customer Data Platforms like Segment or Salesforce, it acts as the central hub for activating audiences across your digital experience.

You can connect your existing Data & Insights (Lytics) account by enabling the Data Activation Layer (DAL) in your organization’s Admin Settings. During setup, select your linked Data & Insights (Lytics) account from the dropdown. If your account is not listed, contact the support team with your Contentstack organization ID to request a manual connection. Make sure DAL is enabled before submitting the request.

Yes, a single Data & Insights (Lytics) account can collect data across multiple domains. However, when using Data Activation Layer (DAL) within Contentstack, that account can only be connected to one stack. For multi-domain setups, check your api_whitelist_domains configuration in Data & Insights (Lytics). Leave it blank to allow the tag across all domains, or explicitly list each one.

By default, each Contentstack organization can connect up to three Data & Insights (Lytics) accounts. If you need additional accounts for demo or testing purposes, contact the support team with a brief justification. Limits may be increased for special cases such as sales demo environments.

The Data Activation Layer (DAL) is the connection layer between Contentstack and Data & Insights (Lytics). It enables automatic content classification, real-time audience syncing, seamless data flow between platforms, and a unified user experience.

You can add users directly through the DAL configuration, as follows:

  1. Go to Organization Admin in Contentstack.

  2. Click Edit DAL Config.

  3. Scroll to the Add Users section.

  4. Select users from the list (only Admins and Users not already in the account are shown).

  5. Click Update.

Users who are not organization admins may require additional permissions. If they cannot see the Data & Insights (Lytics) option in the navigation:

  1. Ensure they have the correct stack-level permissions.

  2. Try accessing Data & Insights (Lytics) directly using the OAuth link.

  3. Contact the support team if navigation from Audience Insights fails

When a Data & Insights (Lytics) account is connected through Data Activation Layer (DAL), all user management must be done within Contentstack, not directly in Data & Insights (Lytics). This ensures proper integration, permission syncing, and access control.

To install the Real-Time Events tag:

  1. Copy the Data & Insights (Lytics) tag code from your account.

  • For Launch hosting: Enable Real-Time User Event Tracking in your project settings. For detailed steps, please refer to the Event Tracking (Lytics) in Contentstack Launch documentation.

  • For self-hosting: Add the tag to your website’s <head> section.

2. Ensure jstag.optIn() is called to handle cookie consent.

3. Test the installation using the Data & Insights (Lytics) Chrome Extension.

The Launch tag includes additional logic optimized for Single-Page Applications (SPAs), including:

  • Automatic page view tracking on route changes

  • Profile state management for SPAs

  • Enhanced navigation detection

  • Improved user experience polling.

Common issues with Next.js integration include:

  • The tag is not properly initialized for server-side rendering

  • The window object is not available in server environments

  • The standard tag is used instead of the SPA-compatible Launch tag

  • jstag.optIn() is not called correctly for cookie consent.

Contentstack uses Data & Insights (Lytics) APIs to automatically sync audiences to Personalize, so no additional configuration is needed. You no longer need to trigger a special job inData & Insights (Lytics) to enable the sync.

DAL begins processing data immediately after tag installation, with the Stream Stats page updating every 2 minutes.

  • Content classification may take a few hours to several days, depending on content volume and traffic.

  • Audience Insights typically require 2–4 weeks to accumulate meaningful data. Behavioral scoring timelines vary based on user interactions and overall traffic volume.

Yes, you can use the same Data Activation Layer (DAL) configuration across multiple Launch projects within the same organization.

  1. Confirm that the Data & Insights (Lytics)tag is firing on your website.

  2. Use the Data & Insights (Lytics) Chrome Extension to verify profile data.

  3. Check that audiences are being created and synced to Personalize. Monitor the Data & Insights (Lytics) dashboard for incoming data.

  4. Monitor the Data & Insights (Lytics) dashboard for incoming data.

This error typically indicates a domain whitelist or public profile sharing issue.

  1. Go to Account > Settings > Details and ensure Allow access via API is checked. If that setting is already enabled:

  • Check your account’s api_whitelist_domains configuration.

  • If it’s blank, no action is needed.

  • If it includes values, make sure your website domain is added to the list.

  • Clear your browser cache and allow time for changes to propagate.

  • Verify that your tag includes the correct Account ID.

  1. Ensure the Data & Insights (Lytics) tag is properly installed and firing.

  2. Confirm that jstag.optIn() has been called to handle cookie consent.

  3. Verify that scores are enabled under Account > Settings > Lytics API.

  4. Add score fields to the Allowlist fields for public API setting.

  5. Allow 24–48 hours for scores to begin appearing.

This is a known issue with the Data & Insights (Lytics) Chrome Extension. You will need to manually close it on each tab. The development team is aware of this behavior.

Error: Workflow modifies schema for table that has unpublished changes

To resolve this:

  1. Use a Data & Insights (Lytics) Auth token to publish schema changes via the API.

  2. Alternatively, publish changes manually in the Data & Insights (Lytics) UI before creating jobs.

  3. Wait until all changes are fully published before proceeding.

Data & Insights (Lytics) supports a wide range of integrations across advertising, marketing automation, analytics, data storage, and more. For a complete list, visit the Data & Insights (Lytics) Integrations Directory.

  1. Use the Recently Visited URLs field type.

  2. Set up URL pattern matching in the audience rules.

  3. Configure time-based conditions (for example, “visited in the last 10 days”).

  4. Test audience membership using the Data & Insights (Lytics) Chrome Extension.

Data & Insights (Lytics) Flows are visual workflows used to activate data across systems within Data & Insights. To learn more, explore the Data & Insights (Lytics) Practitioner path on Contentstack Academy.

  1. Data & Insights (Lytics) respects cookie consent using the jstag.optIn() method.

  2. No data is collected without explicit user consent.

  3. Users can clear their data by removing browser cookies.

  4. Data & Insights (Lytics) supports integration with most Consent Management Platforms (CMPs).

  • User behavioral data and content interactions

  • Audience membership information

  • Personalization attributes

  • All data is stored securely using enterprise-grade security measures

Yes, if users log in and you pass their Account ID or email to Data & Insights (Lytics), personalization can be based on their authenticated identity rather than browser cookies.

Use the Segment Create API endpoint: https://docs.lytics.com/reference/segment-create

Yes, Data & Insights (Lytics) provides APIs for fetching audience data. Refer to the Data & Insights (Lytics) API documentation for available endpoints and authentication requirements.

Use the Collect endpoint:

https://api.lytics.io/collect/json/{stream}

You can send custom user attributes, events, and content metadata to this endpoint.

Auth tokens are automatically created when you set up Data Activation Layer (DAL). You can find them in your Data & Insights (Lytics) account under Security > Authorizations.

  • Installing the Real-Time Events tag is free.

  • Basic data collection and insights are included with Contentstack CMS.

  • Billing typically begins when you launch active personalization campaigns.

  • Contact your account manager for specific pricing details.

  1. Contentstack Academy: Complete the Lytics Practitioner Certification path.

  2. Official Documentation: Data & Insights (Lytics) Docs

  3. Contentstack End-to-end Guide: Data & Insights (Lytics) + Contentstack

  4. Community Support: Join the #support-data-and-insights Slack channel.

  1. A five-course certification path on Contentstack Academy

  2. 40+ training videos covering all aspects of Data & Insights (Lytics)

  3. Hands-on labs and practical exercises

  4. Regular webinars and live demo sessions.

  1. Immediate help: Post in the #support-data-and-insights Slack channel.

  2. Technical issues: Submit a ticket through the official Contentstack Support system.

  3. Security reviews: Email [email protected].

  4. General IT support: Email [email protected].

This error typically occurs with the content classification API. Contact Data & Insights (Lytics) Support with your use case details and API token to resolve the issue.

This message appears because audience sync jobs run on an hourly schedule. You cannot trigger the job immediately, but it will process automatically based on its timing

This means you have reached the maximum number of Data Activation Layer (DAL) instances allowed for your account. Contact the support team to request an account limit increase, especially for demo or testing needs.

This usually means score sharing is not enabled. Go to Account > Settings > Lytics API, enable score sharing, and add the required score fields to your public API allowlist.

All Contentstack-provisioned Data & Insights (Lytics) accounts require login through the Contentstack App Switcher. Direct login on the Data & Insights (Lytics ) website is not supported for Contentstack-managed accounts.

You cannot reset a password for a Contentstack-provisioned Lytics account because authentication is handled through Contentstack's OAuth connection. To access your account, simply sign in to Contentstack and open Data & Insights (Lytics) from the App Switcher.

Contentstack is the source of truth for all user management, roles, and permissions. User roles in Data & Insights (Lytics) are automatically mapped from your Contentstack organization. All role or permission updates must be made within Contentstack, for example, through Organization Admin or by contacting an Organization Owner or Admin. You cannot add users, remove users, or change roles directly within the Data & Insights (Lytics) UI.

Data & Insights (Lytics) roles are automatically mapped from your Contentstack organization roles. Because authentication is handled through Contentstack’s OAuth connection, all role assignments must be managed in Contentstack, not within the Data & Insights (Lytics) interface.

Roles for Data & Insights (Lytics) accounts provisioned through Contentstack cannot be changed within the Data & Insights (Lytics) interface. To update permissions or change a user’s role, you must contact an Organization Owner or Admin in Contentstack, as all role management is handled at the Contentstack organization level.

Data & Insights (Lytics) access levels are determined by your Contentstack organization role. The table below outlines the permissions granted for each role.

Contentstack Role

Lytics Access Level

Description

Owner

Admin

Full access to audiences, event data, and integration settings.

Admin

Editor

Can manage audiences and events, and analyze data, cannot modify integration configurations.

Member (non-admin)

Audience Manager

Access to content classification, collections, and topics.

Member (non-admin)

Data Manager

Access to schemas, queries, users, and PII fields.

Guest / Collaborator

Restricted

No, Data & Insights (Lytics) access unless explicitly granted.