Manage Game Promotions | Besitos Knowledge Base

Increase user engagement with limited-time promotions that offer extra rewards on select game offers. Create one-time or recurring promotions, choose which rewards receive a boost, and schedule them to run automatically.

Promotions can be configured and run in your iFrame or sent via the Games, Games User Data, or Games International APIs.

Before you start

Before creating a promotion, decide how you want it to work.

Reward duration: Should users receive extra rewards only during the promotion, or for the lifetime of the offer after they start it?
Eligible goal types: Should extra rewards apply to timeline (linear), turbo, bonus goals, or all goal types?
Schedule: Will the promotion run once, recur weekly or monthly, or repeat annually (such as Black Friday)?
Announcement: Do you want to promote the event in advance or surprise users when it begins?

Planning these details ahead of time will speed up the setup process.

Promotions can also be created and published by a Besitos Admin. You'll be given notice of these promotions in advance, and they'll be labeled Besitos in the Admin column of the Promotions list. You'll have limited actions available for promotions created by a Besitos Admin.

Create a promotion

Manage promotions from the Promotions page in the Besitos Admin Portal.

You can have only one active promotion at a time. Promotions that overlap with an existing active promotion can't be activated.

Creating a promotion consists of five steps:

Set promotion details and rules.
Design the banner.
Set promotion dates.
Set announcement dates (optional).
Publish the promotion.

1. Set promotion details and rules

Click Promotions on the sidebar.
Click Create Promotion.
Enter an internal promotion title.
If your app is available in multiple countries, select the countries where the promotion will run.
Select the game offers to include. If you don't select any offers, the promotion applies to all game offers.
Choose how long you want promotional rewards to remain available:
- Promotion window only: Extra rewards end when the promotion ends.
- Until the offer expires: Users who start the offer during the promotion continue earning extra rewards.
Enter the reward multiplier (for example, 2 or 3 times the standard reward).
Select which goal types to include in the promotion:
- Timeline: Standard sequential goals.
- Turbo: Time-sensitive goals that require an in-app purchase.
- Bonus: Non-sequential tasks that may require an in-app purchase.
Enable the countdown timer to help users know when the promotion ends.

2. Design the banner

Customize the promotion banner that appears to users.

Enter the primary banner text (for example, Boost Your Rewards by 100%).
Enter the secondary banner text (for example, "Earn 2x rewards this weekend!").
Select an emoji to display before the banner text.
Choose a banner color.

Banner colors are also used to highlight eligible offer cards and display the reward multiplier tag (for example, 2x rewards).

Default: Uses your configured iFrame color or the Default Promotion Color in Theme settings.
Custom - Choose a custom banner color.

The preview on the right side of the page is for demonstration purposes only—it shows sample offers and may not match your configured theme or branding.

3. Set promotion dates

Promotions can run once or on a recurring schedule.

To create a one-time promotion:

Select the event duration: single-day or multi-day.
Select the promotion start and end date.

To create a recurring promotion, complete the steps above, then:

Enable recurring events.
Choose a recurrence frequency:
- Weekly
- Monthly
- Yearly
Select a promotion start date and end date (for monthly or yearly events).
For a weekly event, choose whether the promotion lasts a single day or multiple days.

Multiple promotions cannot run simultaneously. If you attempt to schedule a promotion that overlaps with another created by your team or a Besitos Admin, you will receive an error message.

4. Set announcement dates (optional)

To build anticipation, you can display an announcement banner before the promotion begins.

The announcement uses the same banner design configured in Step 2. Simply enter the announcement copy and choose when it should appear. The announcement automatically ends when the promotion begins.

Select when the announcement should become visible.
Enter the primary announcement text (for example, Extra rewards coming soon!).
Enter the secondary announcement text (for example, Earn 2x rewards on July 4.).

5. Publish the promotion

Publishing a promotion does not make it immediately visible. The promotion and announcement appear automatically on their scheduled dates.

Before the promotion becomes visible to users, you can edit any promotion settings. After it becomes visible, only the promotion title and banner design can be modified.

If you're not ready to launch the promotion, click Save as Draft.

When you're ready:

Click Schedule & Publish.
Review the promotion details.
Click Confirm & Publish.

Receiving promotion information via API

When a promotion applies to an offer, the API provides two types of promotion-related information:

Promotion details: Information about the promotion itself, such as its name, reward multiplier, status dates, eligible goal types, and banner settings.
Boosted rewards: The updated reward amounts that reflect the promotion, along with the original amounts when available.

Promotion information can appear at the promotion, offer, goal, and conversion levels, depending on the endpoint.

In the Games, Games User Data, and Games International API:

Promotion segment: The promotions[] array contains promotion details, including the promotion name, reward multiplier, status, dates, reward duration, eligible goal types, banner content, and countdown settings.
Offer segment: The promotion_ids field identifies the promotions that apply to an offer. The amount reflects the boosted reward, while original_amount shows the reward before the promotion when available.
Goal segment: Goal objects identify the goal type and indicate when a goal has been boosted. The amount reflects the boosted reward, while original_amount shows the pre-promotion reward when applicable.

In the Conversion Data API and postback response:

Conversion Data API: When a conversion earns a promotional reward, the response includes the promotion name and multiplier. The reward and payout reflect the boosted amounts.
Postback: Standard postback also includes the promotion name and multiplier when a promotion applies. The reward, payout, and reward_local_currency fields already reflect the boosted amounts.

See the Games, Games User Data, Games International API, Conversion Data API, and Postback Data documentation for sample responses and attribute details.

Managing promotions in the admin portal

After you schedule a promotion, it appears in the Promotions list, where you can view, edit, activate, deactivate, or delete it based on its status.

You will not be able to edit, activate, deactivate, or delete promotions created and managed by Besitos Admins. Refer to the Admin column in the Promotions list to see who created the promotion: Besitos or Partner.

Action	Promotion Status	Description
View	Active, Completed, Disabled, Draft, or Scheduled	Opens the promotion details in a locked (uneditable) state.
Edit	Draft or Scheduled	Scheduled: All settings are editable. Active: Only the promotion title and banner design are editable.
Activate	Disabled	Activates a promotion that was previously disabled.
Deactivate	Active or Scheduled	This ends the promotion, making it unavailable to new users or game offers. Users who have already started can continue earning promotional rewards. The status changes to Disabled.
Delete	Draft or Scheduled	Deletes the promotion record.