Skip to main content
Contentsquare detects visitors who struggle on your site, for example by clicking rapidly on the same element. Without a connection to Kameleoon, you can’t include those visitors in your experiments or personalizations. Contentsquare Live Signals fills a Kameleoon custom data point with each signal that triggers during a visit, so you can build segments from signals and break down experiment results by them.

​
How Contentsquare Live Signals fits into your workflow

  • Set up the custom data: Create the ContentsquareLiveSignals custom data, which Contentsquare fills when a signal triggers, and add the signal names to it.
  • Review the available signals: See the signals that Contentsquare provides by default and what each one detects.
  • Use the signals: Target visitors with signals in a segment, or break down results by signals on the Results page.

​
Before you begin

  • Contentsquare integration: Connect Kameleoon to Contentsquare as described in Kameleoon’s Contentsquare article.
  • Live Signal names: The names of the Live Signals in your Contentsquare account, which you enter in the custom data script.

​
Set up the Contentsquare Live Signals custom data

Contentsquare sets this custom data when a Live Signal triggers. The custom data is a list of strings with the Visit scope, so it holds the signals that triggered during each visit. You must create the custom data in Kameleoon before you can target or break down by signals.

​
Create the ContentsquareLiveSignals custom data

Create a custom data point that Contentsquare fills with the signals that trigger during a visit.
  1. Click Settings > Custom Data, and then click New custom data.
  2. Enter ContentsquareLiveSignals as the name.
  3. Set the Retrieval method to Kameleoon Activation API.
  4. Set Type to List, Format to String, and Scope to Visit.
The New custom data pop-in in Kameleoon, with ContentsquareLiveSignals as the name and Kameleoon Activation API as the retrieval method.
Click Next to open the options for the custom data, where you add the signal names.

​
Add the signal names to the custom data

Add the signal names so the segment builder lists each Contentsquare Live Signal. Contentsquare lets users rename Live Signals, so the names in the script must match the names in your Contentsquare account.
  1. Click Next to open the options.
  2. Turn on Save the values for the targeting condition associated with the custom data point. A code field appears.
  3. Paste the following script into the code field.
  1. If you renamed a signal in Contentsquare, change its value and label to the new name. For example, if you renamed js_error_signal to JavaScript errors, change its line to {value:'JavaScript errors', label:'JavaScript errors'},.
  2. Click Create.
The ContentsquareLiveSignals custom data appears in your list of custom data.

​
Available Contentsquare signals

Contentsquare provides nine signals by default. In the descriptions below, X, Y, and Z stand for the values that Contentsquare configures for each signal.

​
Friction signals

  • js_error_signal: A click causes a JavaScript error within X seconds.
  • consecutive_click_signal: The visitor clicks the same element X times in a row within Y seconds.
  • rage_click_signal: The visitor clicks rapidly X times within Y milliseconds.
  • repetitive_hovering_signal: The visitor hovers over the same element X times within Y seconds.
  • repeated_scrolling_signal: The visitor scrolls to X% of the page, back up to Y%, Z times.
  • mouse_shakes_signal: The visitor accelerates the mouse left and right, or up and down, within X milliseconds.

​
Fraud signals

  • excessive_pastes_fraud_signal: The visitor pastes into the same field X times in one session. Three thresholds apply: Low, Medium, and High.
  • excessive_reloads_fraud_signal: The visitor reloads the page X times in one session. Three thresholds apply: Low, Medium, and High.

​
Ad block signal

  • adblocker_signal: Contentsquare detects an ad blocker within X seconds.

​
Use Contentsquare Live Signals in Kameleoon

After you set up the custom data, you can use the signals in two places. As a targeting condition in the Segment Builder, a signal limits a segment to visitors who triggered it. As a breakdown on the Results page, a signal splits an experiment’s results by the signals that visitors triggered.

​
Target visitors who triggered a signal

Build a segment that matches visitors who triggered one or more Contentsquare Live Signals during their visit.
  1. Click Settings > Segments, and then click New segment.
  2. In the Custom data tab of the Conditions column, select ContentsquareLiveSignals.
  3. Choose the condition for list values, and select the signals you want to target.
  4. Choose whether to include or exclude the visitors who match the condition.
The segment appears in the Segments list. Selecting one or more signals enables targeting in personalizations and experiments. To learn more about segments, see create a segment.

​
Break down results by signal

Break down an experiment’s results by the Contentsquare Live Signals that visitors triggered.
  1. Open the Results page of the experiment.
  2. Click the sideways chevrons on the right side of the page to open the settings sidebar, and then select the Audience tab.
  3. Click the chevron to expand the Breakdown audience menu, and then click +Add breakdown.
  4. Select ContentsquareLiveSignals, and then specify its criteria. Use the search bar to find the breakdown.
  5. Click Apply.
You can apply only one audience breakdown at a time. Custom data breakdowns behave differently depending on the type and scope of the custom data. For more information, see Results page settings.