Audience Targeting Conditions

Created: 10.05.2023

Updated: 11.05.2023

Author: Anastasia Nogovitsyna

Targeting relevant content to specific users begins with the establishment of audience targeting conditions. A well-executed audience management strategy is fundamental to ensuring the efficacy of your target efforts.

Audiences are created based on specified conditions. These conditions can be amalgamated to create highly precise user segments.

The available audience parameters can be categorized into three primary categories:

1. Condition: This encompasses a set of prerequisites that a user must satisfy to be included in the audience.

2. Attribution Window: This defines the time period during which the specified conditions must be fulfilled.

3. Retention Period: This determines how long users should remain within the audience after they no longer fulfill the specified conditions.

1. Condition

Audience

Select audiences from a dropdown menu of all audiences generated by any user within the current section.

Available Conditions

• Belongs to

• Does not belong to

Available Values

Audiences existing in the section.

Example*

*Audiences chosen in the screenshot are not default audiences in the platform — they were manually created solely for demonstration purposes.

Browser

Selection of users with a specific browser / browsers.

In case of front-end implementation, this is determined by the script, while in API implementation, it's determined based on the value in context.device.userAgent parameter.

Available Conditions

• Is

• Is not

Available Values

• Chrome

• Firefox

• Safari

• Yandex

• Edge

• Internet Explorer

• Opera

• Android Browser

• Samsung Internet

• MIUI browser

• Other

Example

Traffic Source

Selection of users who arrived to the site from a specific traffic source (Direct, Paid Search, Referral, Search, Social). More about traffic sources.

For front-end implementation, it is determined by the script, while in API implementation, it's determined based on context.page.referrerparameter.

Available Conditions

• Is

• Is not

Available Values

• Direct

• Paid Search

• Referral

• Search

• Social

Example

Device Category

Selection of users accessing the site from a specific type of device (desktop, tablet, smartphone).

For front-end implementation, this is determined by the script, while in API implementation, it's determined based on context.device.userAgent parameter.

Available Conditions

• Is

• Is not

Available Values

• Desktop

• Mobile

• Tablet

Example

Country

Selection of users located in the chosen country.

For front-end implementation, this is determined by the script using the user's IP, while in API implementation, it's determined based on the user's IP passed in context.device.ip parameter.

Available Conditions

• Is

• Is not

Available Values

The value is taken from the reference according to the country code.

We use MaxMind geoIP as a reference for countries, regions, and cities.

Example

Region

Selection of users located in the chosen region.

For front-end implementation, this is determined by the script using the user's IP, while in API implementation, it's determined based on the user's IP passed in context.device.ip parameter.

Available Conditions

• Is

• Is not

The chosen region does not include the regional center

Available Values

The value is taken from the reference according to the region code.

We use MaxMind geoIP as a reference for countries, regions, and cities.

Example

City

Selection of users located in the chosen city.

For front-end implementation, this is determined by the script using the user's IP, while in API implementation, it's determined based on the user's IP passed in context.device.ip parameter.

Available Conditions

• is

• is not

The region's central city is not included when choosing region.

Available Values

The value is taken from the reference according to the region code.

We use MaxMind geoIP as a reference for countries, regions, and cities.

Example

Number of Pageviews

Selection of users who have made the specified number of pageviews on the website.

Works within the scope of an individual user.

Available Conditions

• Exactly

• Is not

• More than

• At least

• Less than

• At most

Available Values

Whole number only.

Example

New User

Checks if the user is a new or returning one.

Available conditions:

• Yes

• No

URL Visit

Selection of users who have visited the specified pages of the website a specified number of times.

Works within the scope of an individual user.

Available Conditions

• Is

• Is not

• Contains

• Does not contain

• Regexp

Available Values

Number of visits:

• Exactly

• Is not

• More than

• At least

• Less than

• At most

Whole number only.

Excluding URL Parameters

When defining a URL, you have the option to choose ”Ignore URL parameters”. By selecting this option, all visitors to the specified page will be included in the audience regardless of any URL parameters present.

URL parameter is a "key-value" pair specified in a link. An equal sign "=" is placed between the key and the value, and an ampersand "&" is placed between different parameters. The question mark "?" is placed before the first pair. Example: `http://example.com?product=1234&utm_source=gravity`.

Targeting by URL Parameters

It is possible to only target by a URL parameter by choosing, e.g. URL Visit contains utm_source=gravity and unchecking the ”Ignore URL parameters” checkbox.

Example

Products Added To Cart

Selection of users who have added a specified number of products to the cart. Gravity Field can only consider those cart additions for which Add To Cart events have been triggered.

Works within the scope of an individual user.

There is an option to choose a specific product property from a dropdown menu, and available properties are drawn from the product feed (e.g. category, product color, size, availability for order, etc.).

To modify the list of available fields, you need to contact the personalization manager or customer support.

Available Conditions

• any product

• with property

• without property

Available Values

Number of cart additions:

• exactly

• is not

• more than

• at least

• less than

• at most

Whole number only.

Example

Product Viewed

Selection of users who have viewed a specified number of products that meet the specified conditions.

Works within the scope of an individual user.

You have the option to choose a specific product property from a dropdown menu, and available properties are selected from the product feed (e.g. category, product color, size, availability for order, etc.).

To modify the list of available fields, you need to contact the personalization manager or customer support.

Available Conditions

• any product

• with property

• without property

Available Values

Amount of product views:

• exactly

• is not

• more than

• at least

• less than

• at most

Whole number only.

Example

Product Purchased

Selection of users who have purchased a specified number of products that meet the specified conditions.

Works within the scope of an individual user.

You have the option to choose a specific product property from a dropdown menu, and available properties are selected from the product feed (e.g., category, product color, size, availability for order, etc.).

To modify the list of open fields, you need to contact the personalization manager or customer support.

General Conditions

• any product

• with property

• without property

Available Values

Amount of purchases:

• exactly

• is not

• more than

• at least

• less than

• at most

Whole number only.

Example

Event Trigger

Selection of users who have triggered the specified number of selected events.

Works within the scope of an individual user.

You have the option to choose a specific event from a dropdown menu, and available events are selected from the overall list of events sent to the section.

Available Values

Amount of events:

• exactly

• is not

• more than

• at least

• less than

• at most

Whole number only.

Example

Event Trigger by Property

Selection of users who have triggered the specified number of selected events with a chosen property value.

Works within the scope of an individual user.

You have the option to choose a specific event from a dropdown menu, and available events are selected from the overall list of events sent to the account. You can specify any properties and values, but the users will not be added to the audience if property and value do not match those sent in the events.

Available Conditions

• is

• is not

• more than

• at least

• less than

• at most

• is not

• contains

• does not contain

Available Values

Amount of events:

• exactly

• is not

• more than

• at least

• less than

• at most

Whole number only.

Example

2. Attribution window

The attribution window defines the time period during which the specified conditions in the audience settings must be fulfilled for a user to be added to the audience

Available Values

• current session

• one day

• one week

• two weeks

• one month

• three months

• one year

Example

3. Retention period

The retention period specifies how long users should remain within the audience after they no longer fulfill the specified conditions set in the audience.

Available values

Values are indicated in days (whole number).

Example

Audience examples

Using Country and City conditions

Example: To create an audience that includes users from all over the US except New York:

1. In the Condition section, select the Country parameter and set the condition to is United States.

2. Select the operand AND.

3. In the Condition section, select the City parameter and set the condition to is not New York (the dropdown list will suggest available options as you type).

Using is not condition

Example: To create an audience that excludes users from both Washington and New York:

1. In the Condition section, select the City parameter and set the condition to is not Washington (the dropdown list will suggest available options as you type).

2. Select the operand AND.

3. In the Condition section, select the City parameter and set the condition to is not New York.

Please note that in this example, only the `AND` operand will solve the task. When using the `OR` operand, a user will be included in the targeting if they are not located in at least one city from the set "Washington, New York." This condition will match all users since a user can only be in one city.

Excluding Secondary Audience

Example: creating an audience of users who abandoned their cart on the website (or in the app).

This audience should include users who added items to their cart but did not complete the purchase. It's important to exclude those users who are still in the process of making a purchase. To achieve this, you need to create a secondary audience of users who added items to their cart during the current session or within a day (in the example, this audience is "Cart additions (1 day)"), and then exclude this audience from the main audience you are creating.