Filters And Payment Statuses

User Statuses: Overview and Description

The campaign configuration interface provides three filters for segmenting users: Subscription Status, In-App Status, and Paying Status. These filters help determine which users will see the campaign based on their activity and purchasing behavior.

1. Subscription Status

The Subscription Status filter classifies users based on their subscription activity. Available options include:

Free Users: The user has never had an active subscription (paid or trial) or has canceled it.
Trial: The user currently has an active trial subscription.
Paid: The user currently has an active paid subscription.
Trial or Paid: The user has any active subscription, whether trial or paid.
All Users: Includes all users, regardless of their subscription activity.
Trial Cancelled: The trial subscription was canceled, and the user did not transition to a paid subscription.
Paid Cancelled: The user canceled their paid subscription.
Never Subscribed: The user has never subscribed, including trial periods.

2. In-App Status

The In-App Status filter targets users based on their activity with in-app purchases:

All Users: All users, regardless of their in-app purchasing activity.
Free Users: Users who have never made in-app purchases (items or subscriptions).
Paying Users: Users who have made at least one in-app purchase.

3. Paying Status

The Paying Status filter focuses on users' overall purchasing behavior, including subscriptions and in-app purchases:

All Users: All users, regardless of their purchasing activity.
Free: Users who have made no purchases (including subscriptions or in-app items).
Paying: Users who have made at least one purchase.

Configuring Paying Status in Campaigns

When using the Paying Status filter in a campaign, special considerations apply. If the Paying Status is set to any value other than all_users (e.g., free or paying), the Subscription Status and In-App Status must be set to all_users for the campaign to work correctly.

Key Rules:

General Notes For All Statuses

Filter Combination: You can combine multiple filters for more precise campaign targeting.
Filter Priority: If multiple filters are applied, the campaign will be shown only to users who meet all selected criteria.
Default Settings: By default, each filter is set to All Users, covering the entire audience.
Independent Filters: In-App Status and Subscription Status are separate filters. A user’s subscription activity does not influence their in-app purchase status and vice versa.
Dynamic Subscription Tracking: The application must track and communicate subscription changes (e.g., transitioning from trial to paid or cancellation) to the SDK to ensure accurate targeting.

Filters: Overview and Description

Filters allow campaigns to be delivered to users based on specific product purchases. For example:

Deliver Campaign A to users who purchased product_A_id for $3.99.
Exclude users who have not purchased product_A_id.

By combining product-specific filters, groups, and include/exclude logic, campaigns can be tailored to meet your exact needs.

Filter Configuration Fields

Exclude or Include Filters

Group Configuration

Filters can group multiple product IDs:

Include Group If Any Purchased: Deliver campaigns to users who purchased any product within the group.
Include Group If All Purchased: Deliver campaigns to users who purchased all products in the group.
Exclude Group If Any Purchased: Exclude users who purchased any product within the group.
Exclude Group If All Purchased: Exclude users who purchased all products in the group.

Steps to Create Groups:

Create a group and add the desired product IDs.
Select the group in the appropriate filter field (e.g., Include group if any purchased).
Editing the group will dynamically update the context for all campaigns using the group.

For more advanced configurations, refer to the related article: Native Elements Group (add link).

Example: Filter Logic in Action

Include Group If Any Purchased: A user who purchased any product in the group qualifies for the campaign.
Exclude Group If Any Purchased: A user who purchased any product in the group is excluded from the campaign.
Combine Include and Exclude: Campaign logic can include and exclude specific users simultaneously.

SDK Dynamic Behavior

Campaign filters are processed dynamically, ensuring real-time targeting based on user activity. Unlike segmentation, filters are evaluated client-side, allowing immediate application without requiring a config refresh.

Key Points:

Campaigns dynamically adapt to user actions, such as purchasing a product.
No need to restart the application to apply new filters.

Filter Use Cases for Campaigns

Below are detailed scenarios illustrating how filters operate under different configurations. This includes examples with various combinations of product inclusions and exclusions. The results demonstrate whether the campaign is shown or not based on the filters settings.

In-App Status: Paying Users

Filter Configuration	User Purchase Status	Campaign Outcome
Include if all purchased: `product_A_id` Exclude if all purchased: `product_B_id`	No product IDs purchased.	Campaign does not show.
Include if all purchased: `product_A_id` Exclude if all purchased: `product_B_id`	Purchased `product_A_id`	Campaign shows.
Include if all purchased: `product_A_id` Exclude if all purchased: `product_B_1`	Purchased `product_A_id` and `product_B_1`	Campaign does not show.
Include if all purchased: `product_A_id` Exclude if all purchased: `product_B_id`, `product_C_id`	Purchased `product_A_id` and `product_C_id`.	Campaign shows.
Include if all purchased: `product_A_id` Exclude if all purchased: `product_B_id`, `product_C_id`	Purchased `product_A_id`,`product_B_id`, and`product_C_id`	Campaign does not show.
Include if all purchased: `product_A_id`, `product_B_id` Exclude if all purchased: `product_C_id`	Purchased `product_A_id`	Campaign does not show.
Include if all purchased: `product_A_id`, `product_B_id` Exclude if all purchased: `product_C_id`	Purchased `product_A_id`, `product_B_id`	Campaign shows.
Include if all purchased: `product_A_id`, `product_B_id` Exclude if all purchased: `product_C_id`	Purchased `product_A_id`, `product_B_id`, and `product_C_id`	Campaign does not show.
Include if all purchased: Nothing is specified. Exclude if all purchased: `product_A_id`	Purchased `product_B_id`	Campaign shows.
Include if any purchased: `product_A_id` Exclude if any purchased: `product_B_id`	Purchased `product_A_id`	Campaign shows.
Include if any purchased: `product_A_id` Exclude if any purchased: `product_B_id`	Purchased `product_A_id` , `product_B_id`	Campaign does not show.
Include if any purchased: `product_A_id` Exclude if any purchased: `product_B_id`, `product_C_id`	Purchased `product_A_id` , `product_C_id`	Campaign does not show.
Include if any purchased: `product_A_id`, `product_C_id` Exclude if any purchased: `product_B_id`	Purchased `product_A_id`	Campaign shows.
Include if any purchased: `product_A_id`, `product_C_id` Exclude if any purchased: Nothing is specified.	Purchased `product_A_id`, `product_C_id`, `product_D_id`, and`product_E_id`	Campaign shows.
Include if any purchased: Nothing is specified. Exclude if any purchased: `product_A_id`	Purchased`product_D_id`	Campaign shows.
Include if all purchased: `product_A_id`,`product_C_id` Exclude if any purchased: `product_B_id`,`product_D_id`	Purchased`product_A_id`,`product_C_id`	Campaign shows.
Include if all purchased: `product_A_id`,`product_C_id` Exclude if any purchased: `product_B_id`,`product_D_id`	Purchased`product_A_id`,`product_C_id`, and `product_B_id`	Campaign does not show.
Include if any purchased: `product_A_id`,`product_C_id` Exclude if all purchased: `product_B_id`,`product_D_id`	Purchased`product_A_id`	Campaign does not show.
Include if any purchased: `product_A_id`,`product_C_id` Exclude if all purchased: `product_B_id`,`product_D_id`	Purchased`product_A_id`, `product_B_id`	Campaign shows.
Include if any purchased: `product_A_id`,`product_C_id` Exclude if all purchased: `product_B_id`,`product_D_id`	Purchased`product_A_id`, `product_B_id`, and`product_D_id`	Campaign does not show.
Include if all purchased: `product_A_id` Exclude if all purchased: `product_B_id` Include if any purchased: `product_C_id` Exclude if any purchased: `product_D_id`	Purchased`product_A_id`	Campaign does not show.
Include if all purchased: `product_A_id` Exclude if all purchased: `product_B_id` Include if any purchased: `product_C_id` Exclude if any purchased: `product_D_id`	Purchased`product_A_id` and `product_C_id`	Campaign shows.
Include if all purchased: `product_A_id` Exclude if all purchased: `product_B_id` Include if any purchased: `product_C_id` Exclude if any purchased: `product_D_id`	Purchased`product_A_id`, `product_C_id`, and `product_D_id`	Campaign does not show.

In-App Status: All Users

Filter Configuration	User Purchase Status	Campaign Outcome
Include if all purchased: Nothing is specified. Exclude if all purchased: `product_A_id`	Nothing Purchased.	Campaign shows.
Include if any purchased: Nothing is specified. Exclude if any purchased: `product_A_id`	Nothing Purchased.	Campaign shows.

Filter Configuration

User Purchase Status

Campaign Outcome

Include if all purchased: Nothing is specified.

Exclude if all purchased: product_A_id

Nothing Purchased.

Campaign shows.

Include if any purchased: Nothing is specified.

Exclude if any purchased: product_A_id

Nothing Purchased.

Campaign shows.

Campaign Inclusion in Configurations

Campaigns are included in the configuration based on the user's segment, while filtering by status and campaign filters occurs directly on the client side. As a result, all campaigns matching the user's segmentation are delivered in the configuration, but the specific campaign displayed to the user is determined client-side.

Example: For global audiences, there are three campaigns:

Free users: Excludes the "No Ads" product group.
Paying users: Excludes the "No Ads" product group.
Paying users: Includes the "No Ads" product group.

A user from the United States receives all three campaigns in their configuration. Upon receiving the config for the first time, the user is in the free status and only sees the campaign for free users. Campaigns for paying users are excluded based on their in-app status.

If the user purchases the "No Ads" product, they immediately see the campaign for paying users with the "No Ads" inclusion, while other campaigns are excluded due to their status. Campaign updates occur instantly since the campaigns are already present in the configuration.

Important Note: If segmentation is based on user attributes such as free/paying status or purchases (defined in the segment rather than campaign filters or statuses), additional time may be required for campaigns to appear. This happens because information about purchases must reach the server to update the configuration and deliver relevant campaigns.

Example Scenario:

In-App status, Subscription Status, Paying Status: All Users
Campaign filters: None
Segmentation: Users with ≥2 purchases

The campaign will only become available after the second purchase is processed by the server. This update may occur immediately or with a delay of up to 5 minutes, as the segment condition (≥2 purchases) wasn't met at the time of the initial configuration. Until then, the user will receive campaigns applicable to their campaign status, not their segment condition.