Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The

...

 Reasoning

...

 settings define what kind of feedback your user receives in the result list of your

...

recommendation phase.

...

 This page gives you an overview of all the available settings, shows

...

you the difference between positive and negative reasoning texts and provides with you with a list of

...

convenient reason variables for the ability to customize your result lists even more. 


Table of Contents:

Table of Contents



Info
title

...

If the product has a feature, it is marked with a positive text (pro reason). If it has not the desired property, it is marked with a negative (con reason) or unknown text (unknown reason).

Both positive and negative & unknown reason texts can be enabled or disabled for every Question separately. Therefore the toggle buttons on the right-hand side of the texts have to be activated. A deactivation results in not showing any positive/negative reasons for the corresponding Question in the product recommendation result list.

Image Removed

Question vs. Answer Option Setting

This page shows you the difference between the Question (left) and the Answer Option (right) settings.


Question Detail View


The image below shows you the Detail View for a question within the Concept Board:

Image Added


Tip

With the aid of the reasoning section you are able to configure individual reason texts for each Question.

...

 The reason texts are shown in the recommendation.


Answer Option Detail View


The image below shows you the Detail View for an answer option within the Concept Board:

Image Added

Tip

For more complex topics, a specific reason text might be helpful; e.g. for plural nouns, lists of several values, when very content-specific explanations are not possible or there are flaws in grammar. For this purpose, there are Reason Texts for answer options. This is only possible if, "The user can select one answer" is selected in the Question Settings.

  • An Option reason text overrides the text from the Question.
  • Unknown reasons are not 'Answer Option' specific.
  • The texts are only accessible and editable if the corresponding positive/negative reason toggle button is activated in the Question detail view.
  • If the Question allows multi-select answers, a specific Answer Option reason text cannot be used anymore. In this case, the Question reason text is always used.


Reason Texts
Anchor
ReasonTexts
ReasonTexts

...


For the Question you can activate the positive text, and you can activate the negative / unknown text separately. (see Reasoning Use case below).

Variable Texts

Description

Positive Text

...

The positive text is used to signal that a product has a certain feature or property.

For example let's assume that the customer wants to have a bike with carbon breaks and some of the recommended bikes have these breaks. Then the product recommendation card contains a positive feedback about this feature. As a default the text "Supported: carbon breaks" is displayed. This text is OK but of course very generic. That is why you are able to individualize this text to match the topic or environment of the displayed information. So the text could be: "The bike has carbon breaks".

Now we have a specific text for this topic but we also have the problem that this text does not match with aluminium or steel breaks. Therefore you can use Reason Variables. With the aid of these variables you can match different answers. So if you enter the text "The bike has $uservalue" the contained variable will be replaced by the text of the Answer Option label which the user has selected.

Possible results:

  1. User selects carbon breaks      → "The bike has carbon breaks"
  2. User selects steels breaks        → "The bike has steel breaks"
  3. User selects aluminium breaks → "The bike has aluminium breaks"
  4. etc. ...

Negative Text

...

The negative text is used to signal that a product

...

does have not a certain feature or property.

So let's adapt the example above and assume that a bike does not have the wished carbon breaks. In this case you can enter the text "Unfortunately this bike does not have $uservalue" which results into the product reason text "Unfortunately this bike does not have carbon breaks".

...

Unknown Text

The difference between the negative text and unknown text is that this text signals that the product does not contain any information about

...

the feature or property

...

.

...


Reason Templates

...


The reason templates can help

...

to find a

...

suitable reasoning text. By clicking on 'Use a template,' you can select the most suitable reasoning texts out of a list of template examples.

...

These examples

...

illustrate how the reason variables can be used.

...

Once confirm is clicked, the selected template text replaces the text in the

...

reason text input field.

(info) Note: Each reason type has a different set of template texts.

...

Image Added

Reason Variables
Anchor
ReasonVariables
ReasonVariables


Reason Variables can be used to enrich your reason texts with dynamic values, depending on the product data and/or the user input. Reason Variables can simply be

...

added into your texts using the notation shown in the list below.

...

...

 to understand the different use cases for each reason variable. (see Reasoning Use case below)

Variable List
Anchor
VariableList
VariableList

Variable


Description

Conditions

User Selection

Product Value

Example Template

Example

$matching

Displays all user-selected Answer Options of the associated Question, for which the given product fulfills the requirements defined by the data bindings.

Non 

HDMI, DVI, VGA

HDMI, VGA

supports $matching

supports HDMI, VGA

$nonmatching

Displays all user-selected Answer Options of the associated Question, for which the given

...

product does not

...

 fulfill the requirements defined by the data bindings.

Only for negative Reasons

HDMI, DVI, VGA

HDMI, VGA

no support for $nonmatching

no support for DVI

$remaining

Displays all Answer Options not selected by the user of the associated Question for which the given

...

product does not fulfill the requirements defined by the data bindings.

Useful, if the product value contains multiple values

HDMI, DVI

HDMI, DVI, VGA

supports $matching (also provides: $remaining) 

supports HDMI, DVI (also provides: VGA)

$unit

Displays the unit or currency of a numeric value configured for the associated

...

question. You can set this

...

unit Stepping Configuration - Unit.

For questions with numerical options 

100

99

$value $unit

99 €

$userRangeMin / $userRangeMax

Define a range, selected by the user.

For questions with numerical options with a range selection.

Please set the Answer Option Type:

Continuous numeric

Activate: Range selectable

250 / 600

500

The SSD storage capacity of the laptop is in the defined range of $userRangeMin to $userRangeMax giga byte

The SSD storage capacity of the laptop is in the defined range of 250 to 600 gigabyte

$uservalue

Displays all user-selected Answer Options of the associated Question.

...

$value

Non

HDMI, DVI

HDMI, DVI, VGA

supports $uservalue

supports HDMI, DVI

$value

...

Displays all Answer Options that are fulfilled by the product.

Non

HDMI, DVI, VGA

HDMI, VGA

supports $value

supports HDMI, VGA

$valueRelevantFirst

Displays all Answer Options that are fulfilled by the product. Answer Options requested by a user will be shown first in the list.

Non

HDMI, DVI, VGA

HDMI, VGA

supports $valueRelevantFirst

supports HDMI, VGA, DVI


Applicable use cases for Reason Variables
Anchor
ApplicableVariableLists
ApplicableVariableLists



Expand
titleShow possibilities for Variable using Answer Option Type: Text


Variable

Question

Answer

positive

negative

unknown

positive

negative

$matching

(tick)

(error)

(error)

(tick)

(error)

$nonmatching

(error)

(tick)

(error)

(error)

(error)

$remaining

(error)

(error)

(error)

(error)

(error)

$unit

(error)

(error)

(error)

(error)

(error)

$userRangeMin

...

/ $userRangeMax

(error)

(error)

(error)

(error)

(error)

$uservalue

(tick)

(tick)

(tick)

(tick)

(tick)

$value

(tick)

(tick)

(error)

(tick)

(tick)

$valueRelevantFirst

(tick)

(tick)*

(error)

(tick)

(tick)

...

$attribute

...

*

...

$displayValue

...



Expand
titleShow possibilities for Variable using Answer Option Type: Continuous Numeric


Variable

Question

Answer

positive

negative

unknown

positive

negative

$matching

(error)

(error)

(error)

(error)

(error)

$nonmatching

(error)

(error)

(error)

(error)

(error)

$remaining

(error)

(error)

(error)

(error)

(error)

$unit

(question)

(question)

(question)

(question)

(question)

$userRangeMin

(error)

(error)

(error)

(error)

(error)

$userRangeMax

(error)

(error)

(error)

(error)

(error)

$uservalue

(tick)

(tick)

(tick)

(tick)

(tick)

$value

(tick)

(tick)

(error)

(tick)

(tick)

$valueRelevantFirst

(error)

(error)

(error)

(error)

(error)

...

$attribute

...

$displayValue

...

...



Expand
titleShow possibilities for Variable using Answer Option Type: Continuous Numeric + Range selectable


Variable

Question

Answer

positive

negative

unknown

positive

negative

$matching

(error)

(error)

(error)

Status
titlen.a.

Status
titlen.a.

$nonmatching

(error)

(error)

(error)

Status
titlen.a.

Status
titlen.a.

$remaining

(error)

(error)

(error)

Status
titlen.a.

Status
titlen.a.

$unit

(question)

(question)

(question)

Status
titlen.a.

Status
titlen.a.

$userRangeMin

(tick)

(tick)

(tick)

Status
titlen.a.

Status
titlen.a.

$userRangeMax

(tick)

(tick)

(tick)

Status
titlen.a.

Status
titlen.a.

$uservalue

(tick)

(tick)

(tick)

Status
titlen.a.

Status
titlen.a.

$value

(tick)

(tick)

(error)

Status
titlen.a.

Status
titlen.a.

$valueRelevantFirst

(error)

(error)

(error)

...

Status
titlen.a.

...

$attribute

...

Status
titlen.a.

...

...

titlen.a.

...

$displayValue

...

Status
titlen.a.

...

Status
titlen.a.



Expand
titleShow possibilities for Variable using Answer Option Type: Ordered


Variable

Question

Answer

positive

negative

unknown

positive

negative

$matching




Status
titlen.a.

Status
titlen.a.

$nonmatching




Status
titlen.a.

Status
titlen.a.

$remaining




Status
titlen.a.

Status
titlen.a.

$unit




Status
titlen.a.

Status
titlen.a.

$userRangeMin




Status
titlen.a.

Status
titlen.a.

$userRangeMax




Status
titlen.a.

Status
titlen.a.

$uservalue




Status
titlen.a.

Status
titlen.a.

$value




Status
titlen.a.

Status
titlen.a.

$valueRelevantFirst




Status
titlen.a.

Status
titlen.a.




Question Use case 

...

Anchor

...

UsecaseReasoning

...

titlen.a.

...

Status
titlen.a.

...

$displayValue

...

Status
titlen.a.

...

Status
titlen.a.

Answer Option Specific Reasoning

While the general Reason Texts provide you an simple and quick way to explain to your user why a requested product feature may or may not be fulfilled, it can be somehow tricky to create more specific reason texts. Using for example plural nouns, lists of several values or very content specific explanations is not possible or only with flaws in the grammar.

To avoid these issues and enable you with more flexibility, you can use the Answer Option Specific Reasoning. You can access the Answer Option Specific Reasoning via the Detail View in every Answer Option, but Positive and Negative Texts may only be activated when your Question is set to "The user can select one answer".

Possible specific texts:

  • Carbon is the material of the breaks
  • One battery is contained 
  • Two batteries are contained

Image Removed

The specific texts can be enabled by activating the toggle button of the text "Option specific positive reason" respectively "Option specific negative reason". A deactivated toggle button results in using the defined text from the Question.

Hints

...

UsecaseReasoning

These use cases for the settings for the Question help you to understand the presented settings.


Answer Option Use case 
Anchor
UsecaseReasoning
UsecaseReasoning

These use cases for the settings for the Answer Option help you to understand the presented settings.


Reason Texts 
Anchor
UsecaseReasonTextsQuestion
UsecaseReasonTextsQuestion


Positive Text

For example, let's assume that the customer wants to have a bike with carbon brakes and some recommended bikes have these brakes. Then the product recommendation card contains a positive feedback about this feature. As default, the text "Supported: carbon brakes" is displayed. This text is OK but of course very generic. That is why you are able to individualize this text to match the topic or environment of the displayed information. So the text could be: "This bike has carbon brakes."

Negative Text

So let's adapt the example above and assume that a bike does not have the desired carbon brakes. In this case, you can enter the text "Unfortunately, this bike does not have $uservalue" which results into the product reason text "Unfortunately, this bike does not have carbon brakes."

Unknown Text

A possible text could be "There is no information about the brake type."


Reason Variables 
Anchor
UsecaseReasonVariablesQuestion
UsecaseReasonVariablesQuestion


For example, now we have a specific text for this topic, but we also have the problem that this text does not match with aluminum or steel brakes. With the aid of these variables you can match different answers. So if you enter the text "The bike has $uservalue" the contained variable will be replaced by the text of the Answer Option label which the user has selected.

Possible results:

  1. User selects carbon brakes       → "The bike has carbon brakes"
  2. User selects steels brakes         → "The bike has steel brakes"
  3. User selects aluminum brakes"The bike has aluminum brakes"
  4. Etc. ...

Reason Variables 
Anchor
UsecaseReasonVariablesAnswer
UsecaseReasonVariablesAnswer


Possible specific texts:
  • Carbon is the material of the brakes

  • One battery is contained 
  • Two batteries are contained

...