Campaigns

Deliver banners, emails, and push notifications to your audience segments.

What Are Campaigns?

A campaign is a message delivered to one or more segments. You write the content, choose a delivery channel, select your audience, and the platform handles the rest — scheduling, delivery, and tracking.

Campaigns are part of the Audience system. While segments define who to reach, campaigns define what to send and how to deliver it.

Delivery Channels

Each campaign uses one of three channels. The channel you choose determines how the message is delivered and how it behaves after launch.

Banner — In-App Messages

Banner campaigns display messages directly inside your application. Each banner is assigned to a placement — a named location in the UI such as "top of page," "hero area," or "sidebar." The banner remains visible to users until you cancel it or it reaches its expiration date.

When multiple active banners share the same placement, the system uses weighted random selection to decide which one to display. You assign each banner a weight (from 0 to 100), and banners with higher weights are shown more frequently. This lets you run multiple promotions in the same placement while controlling how often each one appears.

Email — One-Time Blasts

Email campaigns send a one-time message to every user in the target segment(s). Each email includes:

• A subject line
• A plain text body (for email clients that do not render HTML)
• An HTML body (for rich formatting, images, and styled layouts)

The platform delivers emails through its built-in messaging service, which handles provider routing and transport. Once all emails have been dispatched, the campaign is marked as sent and the total delivery count is recorded.

Push Notifications — Mobile Messages

Push campaigns deliver notifications to users' mobile devices. Push notifications support rich content including:

• Title and body text
• An optional image
• A call-to-action button with a label and URL
• Platform-specific options such as sound, badge count, priority, and time-to-live (how long the notification remains deliverable if the device is offline)

Like email, push campaigns are one-time sends. The platform resolves each user's push notification token from their profile and delivers the message through the messaging service.

Campaign Lifecycle

Every campaign moves through a series of statuses as it progresses from creation to delivery:

Scheduling and Timing

Campaigns give you full control over when messages are delivered:

• Send immediately — Launch the campaign right away. The system begins delivering messages as soon as you confirm.
• Schedule for later — Set a specific date and time for delivery. The campaign moves to "Scheduled" status and waits until the appointed time to begin sending.
• Set an expiration date — For time-limited campaigns (especially banners), set an end date so the campaign automatically stops when the promotion period is over. This is useful for seasonal offers, limited-time announcements, and event-based messaging.

Test Sends

Before sending a campaign to your full audience, you can send a test to a single segment. This is the recommended way to verify your campaign before committing to a full delivery.

The typical workflow is:

1. Create a small test segment containing your internal team members or QA group
2. Build your campaign and configure all the content and settings
3. Use the test-send feature to deliver the campaign to your test segment only
4. Review the results — check email rendering, push notification appearance, or banner display
5. Once verified, send the campaign to the full target audience

Banner Placement and Weighting

Banner campaigns require two configuration choices beyond the message content:

• Placement — A string that identifies where in the UI the banner should appear (for example, top, hero, or sidebar). Your development team defines the available placements in the application. Each placement is a slot where one banner can be shown at a time.
• Weight — A number between 0 and 100 that controls how often this banner is shown relative to other active banners in the same placement. Higher weight means higher probability of being displayed.

For example, imagine three banners are active in the hero placement with weights of 60, 30, and 10. The first banner will be shown roughly 60% of the time, the second roughly 30%, and the third roughly 10%. If only one banner is active in a placement, it is shown 100% of the time regardless of its weight.

How Delivery Works

When a campaign is sent, the platform automatically handles the delivery process:

1. The campaign status changes to "Sending"
2. The system works through the target audience in batches, processing thousands of users at a time
3. For each user, the appropriate message is constructed (email with subject and body, push notification with title and image, etc.)
4. Messages are dispatched through the messaging service
5. The delivery count is updated as batches complete, so you can monitor progress
6. When all messages have been sent, the status changes to "Sent" (for email and push) or "Active" (for banners)

Banner campaigns work differently — since banners are displayed in-app rather than sent as messages, the "delivery" step simply activates the banner so it starts appearing in its assigned placement.

Best Practices

• Always test first. Use the test-send feature with an internal team segment before sending to your full audience. Check that email formatting, push notification content, and banner display all look correct.
• Set expiration dates on banners. Unless a banner should run indefinitely, set an end date so it automatically stops displaying when the promotion is over.
• Use descriptive campaign names. Names like "Spring Sale Banner - Homepage Hero" or "Re-engagement Email - Lapsed Users March 2026" make it easy to find and manage campaigns later.
• Coordinate banner weights. When running multiple banners in the same placement, plan your weights intentionally. Make sure the total distribution matches your communication priorities.
• Review segment size before sending. Check the member count on your target segment before launching an email or push campaign. This helps you anticipate the scale of the send and catch any unexpected audience sizes.