Creating & Managing Promotions

This guide covers how to create promotions, configure agents, and manage AI-powered pricing optimization.

Key Concepts

Before getting started, here are the two core concepts in Monetai:

• Promotion: Represents a single promotion purchase page in your app. For example, if your app has an onboarding promotion and a churn-prevention promotion, you would create two separate promotions in Monetai.
• Agent: The AI-powered unit that optimizes pricing within a promotion. Each agent operates on a specific platform (iOS or Android) and can have its own targeting rules and priority. When a user visits a promotion page, they are assigned to one of the active agents based on targeting rules. If no agent's rules match the user, no offer is served. A single promotion can have multiple agents to target different user segments.

Onboarding Promotion
├── Agent A (iOS, Target: country = JP, Priority: 1st)
├── Agent B (iOS, No target = Global, Priority: 2nd)
├── Agent C (Android, Target: app_version ≥ 2.0, Priority: 1st)
└── Agent D (Android, No target = Global, Priority: 2nd)

Churn-Prevention Promotion
├── Agent E (iOS, Global)
└── Agent F (Android, Global)

Creating a Promotion

1. Open the Dashboard
   Log in to the Monetai Dashboard and navigate to the Promotions page.

2. Set Promotion Name & Platforms
   Enter a name for your promotion and select the platforms you want to support (iOS, Android, or both).

3. Configure Products & Discount Pricing
   For each platform, add the subscription products you want to include in the promotion. For each product, set up to 3 discount price options linked to your app store products.

4. Start or Save
   Choose to start agents immediately, or save the promotion and start agents later from the promotion detail page.

Agent Targeting

By default, an agent created with a promotion has no targeting rules and applies to all users on its platform (Global agent). You can create additional agents with specific targeting conditions to serve different user segments.

When to Split Agents

The key question is: does your app behave differently depending on user segments?

• No need to split: If all users experience the same app and pricing structure, a single Global agent per platform is sufficient.
• Split recommended: If your app differs significantly by certain criteria, splitting agents helps each one optimize pricing more effectively for its segment.

Examples of when splitting is beneficial:

• Your app offers different content or subscription plans by country (e.g., Korea vs. other regions).
• A major app version update changed the purchase flow, and old/new versions coexist.

If the app experience is identical for all users, adding more agents won't improve optimization — a single Global agent is the best choice.

Available Targeting Conditions

Field	Type	Description
Country	String	Target users by country code (e.g., US, KR, JP)
App Version	Semver	Target users by app version (e.g., ≥ 2.0.0)

Targeting Operators

Depending on the field type, you can use different operators:

• String fields: is one of, is not one of, contains one of, contains none of
• Semver fields: =, ≠, >, ≥, <, ≤

Combining Conditions

• Conditions within a target group are combined with AND logic (all must match).
• Multiple target groups are combined with OR logic (any group can match).

Example: Target users in Japan OR users in Korea with app version ≥ 2.0:

• Target Group 1: country is one of [JP]
• Target Group 2: country is one of [KR] AND app_version ≥ 2.0

Multiple Agents & Priority

You can create multiple agents for the same platform within a promotion. When a user requests an offer, Monetai evaluates agents in priority order (highest first) and assigns the user to the first matching agent.

How Priority Works

1. Agents are sorted by priority (highest priority = evaluated first).
2. Each agent's targeting rules are checked against the user's properties.
3. The first agent whose rules match is selected.
4. If an agent has no targeting rules, it matches all users (acts as a catch-all).

Recommended Setup

Create targeted agents with higher priority and a Global agent (no targeting rules) with the lowest priority as a fallback. This ensures every user is covered.

Managing Priority

You can reorder agent priorities from the promotion settings page using drag-and-drop. The agent at the top of the list has the highest priority.

Starting & Pausing Agents

• Start an Agent: Click the start button on the agent detail to begin pricing optimization. The agent starts serving offers immediately.
• Pause an Agent: Click the pause button to temporarily stop an agent. Paused agents do not serve offers to users.
• Resume an Agent: Restart a paused agent at any time. The agent will resume serving offers.

Each agent can be started and paused independently, giving you full control over which agents are active at any time.

Monitoring Performance

Once your agents are running, you can monitor performance in real-time on the promotion detail page.

How Impact is Measured

To accurately measure the revenue impact of AI pricing optimization, Monetai automatically divides users into separate groups:

Group	Description
AI Optimized	Users who receive AI-optimized discount pricing
Baseline	Users who receive the default discount rate you set for the promotion (used to measure impact)

By comparing revenue between these two groups, you can see exactly how much additional revenue the AI optimization is generating.

Key Metrics

1. ARPU (Average Revenue Per User)

ARPU is the average revenue generated per user within each group. It is the most important metric for evaluating the effectiveness of AI pricing optimization.

Why ARPU matters: raw revenue totals can be misleading because group sizes may differ. ARPU normalizes this by dividing revenue by the number of users, giving you a fair comparison regardless of group size. When the AI Optimized group's ARPU is higher than the Baseline group's, it means the AI optimization is generating more revenue per user.

2. Cumulative Revenue

The total accumulated revenue for each group over time. Use this to see the overall revenue trend and understand the scale of revenue being generated.

3. Additional Revenue

The extra revenue generated by AI optimization, calculated as the difference between the AI Optimized group and the Baseline group. This is the direct monetary impact that Monetai's pricing optimization is creating for your app.

Filtering by Agent

Use the agent filter tabs at the top of the promotion detail page to:

• View aggregated performance across all agents (select "All").
• View individual agent performance by selecting a specific agent tab.

What's Included in the Calculations?

To accurately measure the impact of promotions on new purchases, Monetai's revenue calculation includes:

• Free trial starts
• Paid subscription conversions
• Refunds

To prevent skewing results, revenue from subscription renewals is excluded.

Test Devices

The Test Devices feature allows you to manually assign specific users to groups or discount products, so you can preview exactly what they will see in the app before going live.

How to Use

1. Open the promotion settings and navigate to the Test Devices tab.
2. Select the agent you want to test.

The test device panel has two tabs:

Prediction Tab (shown by default)
Assign users to a specific discount product to preview the exact offer they will see.

• Each discount product (e.g., 40% discount, 50% discount) is listed with a User ID input field.
• Enter a User ID and press Enter to register.
• Adding a user to a discount product automatically adds them to the AI Optimization group as well.
• A user can only be assigned to one discount product at a time within the same agent.

AI Optimization Tab
Manually assign users to either the Baseline or AI Optimization group.

• Baseline (No optimization): The user receives the default discount rate you set for the promotion.
• AI Optimization: The user receives AI-optimized discount pricing.

Users can only belong to one group at a time — adding a user to one group automatically removes them from the other. Removing a user from the AI Optimization group also removes them from any discount product assignments.

Note

• Changes take effect immediately upon saving.
• Restart the app on the test device for accurate results.

Support
If you have any questions or encounter issues while managing your promotions, feel free to contact us at support@monetai.io.