Data Feed shows, almost in real time, activity collected from your websites and apps. Use it to check that your Contentsquare Experience platform setup is working, inspect the details of an interaction, identify whether it matches an existing event, and create an event from a real interaction
This article supports both first-time setup checks and ongoing event validation.
How Data Feed works
Data Feed is a live list of activity collected from websites and apps set up as Data Sources.
A Data Source represents a website or app from which Contentsquare collects activity. Data Feed displays the interactions collected from these Data Sources, including the event type, target, timestamp, and properties.
An interaction is an action collected from your website or app, such as a page view, button click, or form submission. An event is a definition that matches one or more interactions based on criteria such as the event type, target, properties, or page context.
When you select an interaction, you can see whether it matches an existing event:
- If it matches an existing event, the event name appears in panel.
- If it doesn’t match an existing event, the following message appears: “No events have been created with criteria that match this interaction.”
Data Feed includes controls to pause, resume, clear, and filter the activity shown. Use these controls while testing to find and inspect the interaction you performed.
Best practices
- Start with one deliberate action. Perform one action at a time so you can identify the correct interaction.
- Keep Data Feed running while you test. Pause it after the interaction appears so you can inspect the correct row.
- Use two tabs for website testing. Keep Data Feed open in one tab and your website open in another tab in the same browser profile.
- Use My data only as a convenience filter. Always check the interaction details before creating or validating an event.
- Don’t use personal data to identify activity. Don’t assume that a login email is collected as an identity or send personal data just to create a filter.
- Decide the event scope before creating it. If the same element appears on several page types, decide whether the event should match it everywhere or only in a specific context.
- Test representative page types. If an event should match across several page types, test the interaction on each relevant page type.
- Run a positive and negative test. Confirm that the intended action matches and that a similar action doesn’t match accidentally.
Before you start
Make sure that:
- You can access the relevant Contentsquare Experience platform environment.
- The website or app you want to test is set up as a Data Source.
- Data collection is implemented and active.
- You can perform the action you want to test.
- You complete any prerequisites for the action, such as selecting a store or signing in.
- The website’s normal consent process is complete, if applicable.
Data Feed only shows activity that your website or app sends to Contentsquare. If the implementation or collection isn’t active, this guide won’t generate activity.
Validate an interaction with Data Feed
Use this workflow to check that activity is reaching Contentsquare and to inspect a specific interaction.
Test a website interaction
For a website test, use two tabs in the same browser profile:
- Tab A: Contentsquare Experience Platform with Data Feed open.
- Tab B: Your website in a regular browser tab.
Step 1: Open Data Feed
In Tab A:
- Select Records in the main menu.
- Select Data Feed.
- Select the Data Source you want to test.
Use the Data Source selector in the top-left navigation to choose what Data Feed displays:
- Select All Data Sources to view activity from all websites and apps available in your environment.
- Select a specific Data Source to view activity from one website or app.
For focused testing, select the specific Data Source that contains the website or app you’re testing.
Check the feed control:
- If it shows Resume, Data Feed is paused. Select resume to start it
- If it shows Pause, Data Feed is already running.
- If you want to narrow the activity shown, select My data only.
Step 2: Perform an action on your website
Open your website in Tab B and complete any prerequisites for the action you want to test.
Perform one deliberate action, such as:
- Clicking a button.
- Viewing a page.
- Selecting an option.
- Submitting a form
- Adding an item to a cart.
Return to Data Feed in Tab A and wait a few seconds for the interaction to appear.
Step 3: Pause and inspect the interaction
When you see the interaction, select Pause, then select the interaction row to open the event details panel.
Compare the details with the action you performed:
- Timestamp: Check that it matches the time of your action.
- Page URL: Check that it’s the page where you performed the action.
- Target: Check that it identifies the element you interacted with.
- Event type: Check that it describes the action you performed.
- Properties: Check that the values match the context of your action.
My data only helps narrow the list to activity from your browser or device, but it may still include activity from other people. Confirm that the interaction is yours by checking its timestamp, page URL, target, and properties.
If you still can’t identify the interaction, use another available filter based on a test identifier that you know Contentsquare collects.
Test a mobile app interaction
For a mobile app test, use a test device running an app with the Contentsquare mobile implementation enabled.
- Open Data Feed and make sure the Data feed is running.
- Select the relevant Data Source.
- Perform one deliberate action on the test device.
- Wait for the interaction to appear in Data Feed.
- Pause the Data feed.
- Select the interaction row to open the event details panel.
- Check the timestamp, target, event type, and properties to confirm that the interaction is the one you performed.
For mobile testing, don’t rely on My data only to identify the app user or test device. Use the available filters to narrow the results to your test device, then confirm the interaction by checking its timestamp, target, event type, and properties.
For both website and mobile testing, once you have identified and inspected the interaction, continue to check whether it matches an existing event.
Check whether an event already exists
Use the event details panel to check whether the interaction already matches an event:
- If an event name appears, the interaction matches an existing event.
- If you see “No events have been created with criteria that match this interaction,” the interaction is collected, but no existing event matches it.
- If an event already matches the interaction, review the existing event before creating another one.
- If no event matches and you want to define one, select Create on the interaction row.
Create an event from Data Feed
To create an event from an interaction:
- Select Create on the event row.
- Review the:
- Data Source
- Event type
- Target
- Properties
- Criteria
- Give the event a clear business name, then select Save.
- Select Save.
For detailed guidance on defining and managing events, see the Events article.
Test the event
After saving the event, resume the Data Feed and perform two tests:
- Positive test: Perform the action that should match the event.
- Negative test: Perform a similar action that shouldn’t match.
The negative action may still appear as raw activity. It shouldn’t match the event.
Use an event in analysis
Data Feed and charts serve different purposes:
- Data Feed shows recent raw activity and helps you inspect individual interactions.
- Charts query event definitions over a selected period.
An interaction can appear in Data Feed before the corresponding event data is available in charts.
To check that an event is available for analysis:
- Create or select the event in Data Feed.
- Allow time for the event data to be processed.
- Use the event in a chart.
- Rerun the chart query.
- Check the event definition, date range, Data Source, and any test-traffic exclusions.
If the action appears in Data Feed but doesn’t appear in the chart, this doesn’t necessarily mean that data collection failed. Data Feed shows recent activity, while charts query processed data over a selected period.
FAQs
Why can't I see any activity in the Data feed?
Check that:
- Data Feed is open and running.
- The correct website/app is selected as a Data Source.
- Implementation, collection, and consent are active.
- Prerequisites were met before performing the action.
- The action was performed after opening Data Feed.
- Active filters aren't hiding activity (isolated mobile test devices if applicable).
If necessary, remove only the analysis filters you added and repeat the test.
Why do I see an interaction that is not mine?
For website testing, select My data only, then check the timestamp, page URL, target, event type, and properties in the event details panel.
For mobile testing, use the available filters to isolate activity from the test device. Don’t rely on My data only to identify the app user or device.
If needed, use another filter based on a test identifier that you know Contentsquare collects. Don’t use personal data just to create a filter.
Why does an interaction appear in the Data Feed but not in a chart?
Allow time for processing, rerun the query, and check the event definition, date range, Data Source, and test-traffic exclusions.