Campaigns: Overview and Essential Concepts

A campaign is a mechanism used to display offers or third-party ads within your application. It serves as a core element of the Magify SDK, allowing you to dynamically engage users based on specific in-app events or conditions.

Campaign Processing: The Core of the SDK

Campaign processing is a fundamental feature of the Magify SDK. For it to function properly, you must configure and initialize the Magify Service to support advanced features such as subscriptions, purchases, and dynamic configuration.

Key points about campaign processing:

1. Campaigns are tied to predefined in-app events.
2. When an event triggers, the SDK processes any associated campaigns using asynchronous methods.
3. Campaign execution time depends on its complexity, ranging from instantaneous to several minutes for more advanced configurations.

For more details on how campaigns and the SDK work together, refer to the Campaigns section.

Defining a Campaign

A campaign acts as a handler for application events, triggering specific actions such as showing ads, delivering rewards, or tailoring user interactions.

Example Workflow:

• Event: session_start (The start of a new user session in the game)
• Campaign Action: Display an In-app Campaign with predefined parameters and creative, allowing the user to purchase the offer and receive a reward.

Campaigns are event-driven. When an event occurs, the SDK determines if a relevant campaign is available. If no campaign matches the event, the process ends immediately. If a campaign exists, its logic is executed, with the duration varying depending on the campaign’s complexity.

Steps to Set Up a Campaign

General Process:

1. Access Configuration > Remote Config > Campaign in the admin panel.
2. Click Create New to initialize a campaign.
3. Define the following settings:
   • Name: Provide a descriptive name for the campaign.
   • Application: Select the app where the campaign will run.
   • Type: Specify the type of campaign (e.g., rewarded ad, interstitial ad, in-app purchase, or other campaign types). The available settings will depend on the selected type.
   • Description: Optionally, provide additional information about the campaign or include a link to the task related to its creation.
   • Priority: Assign a priority level to the campaign. Higher priorities ensure the campaign is prioritized if multiple campaigns are eligible for the same event.
   • Status: Set the campaign status (e.g., active or paused). Read more about this statuses in the Campaign Statuses article.
   • User Conditions: Configure conditions for targeting users, such as:
     • Subscription status.
     • In-App Status
     • Paying Status
     • Read more about this statuses in the Filters and Payment Statuses article.
   • Segmentation: Select the user segment that determines the campaign’s audience.
   • Placement or Event: Specify the placement or in-app event that triggers the campaign, along with any required numbering.
   • Additional fields for configuring a campaign will appear after selecting the campaign type. Each campaign type has its own unique settings and configuration fields.

Key Components of Campaigns

A campaign consists of several essential components, each contributing to its functionality within your application. Campaigns can include configuration data, creative elements, and products. The specific components and their configuration depend on the campaign's goals and type. Below is an overview of these key components, along with links to related articles for further details.

1. Campaign Data

Campaigns are built on a foundation of configuration data, which defines their type, triggering conditions, and behavior. This data serves as the structural backbone, ensuring the campaign functions as intended.

2. Creatives

Creatives are the visual assets or interfaces displayed to users during the campaign. These may include:

• Images configured in the admin panel.
• Custom popups defined within your application.
• Dynamic assets, such as downloadable bundles.

Each creative type serves different purposes, from presenting offers to delivering user experiences.

For more details, see the Creatives article.

3. Products

Products represent the rewards or items delivered to users upon completing a campaign. They are the core incentive for user interaction and can include:

• In-app items (e.g., coins, hints).
• Subscriptions.
• Bonuses or rewards.
• External or internal links with rewards.

Products are configured and managed through the admin panel and linked to campaigns based on the desired outcome.

For more details, see the Product ID article.

Customization Based on Campaign Type

Each campaign type (e.g., Interstitial, Rewarded Video, or In-App Purchase) uses a tailored combination of these components. The flexibility in defining these elements allows campaigns to align closely with your business goals and user engagement strategies.

For a detailed understanding of campaign types, refer to the campaign type sections below.

Campaign Types

1. Banner Campaign Displays banner ads within the application.
2. Bonus Campaign: Provides users with free rewards or bonuses.
3. Bonus LTO Campaign: Offers limited-time bonuses to encourage engagement.
4. Cross-Promo Campaign: Promotes other applications within your portfolio.
5. Cross-Promo LTO Campaign: Highlights cross-promotions for a limited time.
6. Empty Campaign: Placeholder campaigns with no specific action or creative.
7. External Campaign: Redirects users to external links, such as websites or app stores.
8. External LTO Campaign: Limited-time offers tied to external links.
9. In-App Campaign: Promotes in-app purchases with predefined rewards.
10. In-App LTO Campaign: Limited-time offers for in-app purchases.
11. Interstitial Campaign: Shows full-screen ads between app interactions or levels.
12. Mixed Campaign: Combines elements of multiple campaign types.
13. Mixed LTO Campaign: Offers a limited-time combination of various campaign types.
14. Rate And Review Campaign: Encourages users to rate and review your application.
15. Rewarded Video Campaign: Displays videos that reward users upon completion.
16. Rewarded Video LTO Campaign: Offers limited-time rewarded video ads.
17. Subscription Campaign: Promotes subscription-based services.
18. Subscription LTO Campaign: Highlights limited-time subscription offers.

A/B Test Campaign Types

All the listed campaign types also have A/B test variations, meaning they can participate in A/B testing scenarios. For example, if a regular subscription campaign has the type Subscription Campaign, its A/B test variation is designated as Subscription A/B Test Campaign.

1. Banner A/B Test Campaign
2. Bonus A/B Test Campaign
3. Bonus LTO A/B Test Campaign
4. Cross-Promo A/B Test Campaign
5. Cross-Promo LTO A/B Test Campaign
6. External A/B Test Campaign
7. External LTO A/B Test Campaign
8. In-App A/B Test Campaign
9. In-App LTO A/B Test Campaign
10. Interstitial A/B Test Campaign
11. Mixed A/B Test Campaign
12. Mixed LTO A/B Test Campaign
13. Rate And Review A/B Test Campaign
14. Rewarded Video LTO A/B Test Campaign
15. Rewarded Video A/B Test Campaign
16. Subscription A/B Test Campaign
17. Subscription LTO A/B Test Campaign

For more details, see A/B Test article.