Value types in analyses and filters

This article is a continuation of the Event and attribute operators article.

Once you define a logical operator in an analysis or a filter, you must define a value that will be used with the operator to check if the selected attribute or parameter meets the condition.

Filter in a segmentation
The screen presents a value in a condition in a segmentation

You can select the following value types:

How to change a value type
Changing value type

Value types

Array


If you want to analyze a parameter or an attribute in the filter or an analysis that is an array, you must use the Array operator. Then the field that appears next to the operator accepts the value of an array.

The area marked on the screen is a field that accepts elements of an array
The area marked on the screen is a field that accepts elements of an array
  • If the array contains different data types (numbers, objects, arrays) it must be converted into a string and analyzed as a string.
  • If you want to analyze occurrences of more than one string, you can do it in the following way:
    Analyze occurrences of strings in events
    Analyzing occurrences of two strings in an event

Example

The example below presents the condition in a metric that calculates the occurrences of an array that contains the potato, steak value in the products parameter in a groceries.bag event.

Analyze occurrences of strings in events
Analyzing occurrences of two strings in an event

Dynamic key


A dynamic key is a condition whose value can be changed when the analysis is requested.
You can use a dynamic key to create a dashboard entirely dedicated for the analysis of a given aspect, for example, an item, a customer, a campaign, a brand, a product model, and so on.

The marked area on the screen presents the dynamic key value selected in a metric condition
The marked area on the screen presents the dynamic key value selected in a metric condition

How to create a dynamic key?

While preparing any analysis (except for aggregates, expressions, and dashboards):

  1. Select an event.
  2. Select an event parameter.
  3. After selecting the operator, next to the operator, click the string icon icon until you get two fields: Dynamic key and Value.
    How to change a value type
    Changing value type
  4. In the Dynamic key field, enter a name of the dynamic key. The dynamic key will take the values sent through the event parameter you selected is step 2. For example, in Figure 7, the dynamic key will take the values sent through the uri parameter of the page.visit event.
    You can use any name, for example, ID of the item, Item manufacturer (recommended understandable, unique, and self-explanatory names).
    Follow these dynamic key name rules:
    • Don’t use spaces, diacritic characters and special characters.
    • You can use the same name as event parameters and attributes.
    • Names are case-sensitive. Don’t use spaces before or after dynamic key names.
    • There are some predefined dynamic keys which you can use to your advantage.
  5. In the Value field, you can enter any value.
  6. Click Save.
    Results: When you create a dashboard and add this analysis, the Dynamic key button appears on the editing panel. Then, you can specify the value of the dynamic key.

Example

The example below presents the condition of a metric that calculates the number of times a product was purchased. In this example, the id dynamic key is created and it will take the values sent through the $sku parameter of the product.buy event. At this stage, the value of the dynamic key is not important in this analysis, that is why in this example a . will be used as the value. The result for this metric will be 0 but the metric will be added to the analytical dashboard (figure 9) in which the value of the dynamic key (the SKU of the item) will be defined and produce results.

The metric conditions
The metric condition

This metric is added to a dashboard. In the Dynamic key field, you can enter a SKU and the dashboard will show metrics result for events in which the $sku parameter was the same as the SKU you entered.

The dashboard that contains metrics
The dashboard that contains the metrics that use a dynamic key

Number


The numerical value is expected when you select the number operator and/or the event parameter or attribute is sent to Synerise in the form of a number.

The metric conditions
The marked area presents the numerical type selected

Example

The example below presents the condition of a metric that calculates the number of transactions above a specific value. In this example, the More than logical operator is used (the Number type operator) to narrow down the analysis to transactions where the monetary value was more than 100.
Currency is a separate parameter. This example shows events with $totalAmount over 100 regardless of the currency.

The metric conditions
The metric condition

Parameter


As the value of the condition, you can indicate the value of another element created in Synerise.

The marked area on the screen presents the parameter value selected in an aggregate condition
The marked area on the screen presents the parameter value selected in an aggregate condition

The following list presents the types of elements you can use to compare with the values of event parameters and profile attributes:

  • For event parameters:
    • Tags,
    • Attributes,
    • Specials (Timestamp),
    • Segmentations,
    • Aggregates,
    • Expressions (event expressions for the event selected in the analysis/filter and all profile attribute expressions)
      Tip: To check whether an expression is an attribute or event expression, go to Analytics > Expressions, find the expression on the list and go into its details. If the Expression for option is set to Attribute, it’s an attribute expression. Otherwise, it’s an event expression.
  • For profile attributes:

How to select a parameter value

  1. After selecting an operator, next to the operator, click the string icon icon until you get the Choose value button.
    How to change a value type
    Changing value type
  2. Click Choose value.
  3. On the dropdown list, you can:
    • Use the search box to find an element
    • Select one of the following tabs: Tags, Attributes, Specials, Segmentations, Aggregates, Expressions. On the list, find the element you’re looking for.

Example

The example below presents an aggregate that returns the list of last 100 IDs of transactions from the last 30 days which contain the products visited which were displayed in a defined recommendation campaign. The condition of the aggregate uses an aggregate that returns the SKUs of the clicked items within a particular recommendation campaign.

Note: This example is a part of the Calculating items purchased within a campaign use case.
  1. Create an aggregate that returns the last visited recommendations in the defined time range.
  2. Create a new aggregate:
    1. Set the size of returned results to 100.
    2. Select the Consider only unique occurrence of the event parameter.
    3. Select the Bought product event.
    4. As the event parameter, select $orderId.
    5. After the $orderId parameter, add $sku parameter that occurs in the results of the aggregate from step 1.
      Configuration of the aggregate
      The list of products clicked in the recommendation

String


This type of value allows you to enter a string of characters. It accepts special characters and spaces. Some features across the Synerise application allow usage of Jinjava/inserts in filters/analyses to retrieve a value out of another analyses like an aggregate, attribute, catalog, voucher pool, AI recommendations

Filter in a segmentation
The screen presents a value in a condition in a segmentation

How to select a string value

After you select an operator, it’s the default parameter/attribute value.

Example

The screen below presents the condition of a metric: it calculates the first occurrences of the newsletter.open event (an event which is generated when a profile opens an email) in a mobile channel. The is that the source parameter of the event must include the string mobile.

Filter in a segmentation
The area marked on the screen presents a value in a condition in a segmentation
😕

We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

😉

Awesome!

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

Close modal icon Placeholder alt for modal to satisfy link checker