This page explains how to control when Campaigns display in your application. By default, no SDK code is required — campaigns display automatically.

⚠️ The minimum SDK version required to use this feature is 5.1.0

Controlling campaign display

By default, campaigns are displayed immediately — allowCampaigns is true, so a trigger-based campaign shows on its own with no extra code.

If your app has a launch routine that must complete before a screen can be shown (splash screen, onboarding, login, ad interstitial…), you can temporarily prevent campaigns from displaying, then re-enable them once you are ready. Any campaign triggered meanwhile is then displayed:

// Prevent campaigns from displaying (e.g. during onboarding)
Purchasely.allowCampaigns(false)

// Re-enable once ready — any queued campaign displays immediately
Purchasely.allowCampaigns(true)

// Prevent campaigns from displaying (e.g. during onboarding)
Purchasely.allowCampaigns = false

// Re-enable once ready — any queued campaign displays immediately
Purchasely.allowCampaigns = true

Purchasely.allowCampaigns(false);
// later, once your app is ready
Purchasely.allowCampaigns(true);

Purchasely.allowCampaigns(false);
// later, once your app is ready
Purchasely.allowCampaigns(true);

Purchasely.allowCampaigns(false);
// later, once your app is ready
Purchasely.allowCampaigns(true);

_purchasely.SetAllowCampaigns(false);
// later, once your app is ready
_purchasely.SetAllowCampaigns(true);

📘

Important notices

• allowCampaigns controls campaigns independently from deeplinks (allowDeeplink) — gating one does not affect the other.
• If you have implemented the UI Handler to manage the display yourself, you must keep the presentation object returned and not fetch it again — otherwise campaign context will be lost.

Placement-based campaigns

Campaigns associated with Placements do not require any additional SDK implementation. They are displayed automatically when the Placement is called in your app, using the same code you already use to fetch and present a Placement.

In other words, if your app already calls Placements, Placement-based campaigns will work out of the box with no code change.

Summary