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:
Condition: This encompasses a set of prerequisites that a user must satisfy to be included in the audience.
Attribution Window: This defines the time period during which the specified conditions must be fulfilled.
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
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.
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
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 containsutm_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:
In the Condition section, select the Country parameter and set the condition to is United States.
Select the operand AND.
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:
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).
Select the operand AND.
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.
Selection of users who arrived to the site from a specific traffic source (Direct, Paid Search, Referral, Search, Social). .
