Advertisement

Preparation

Remember, you need to configure and initialize the Magify Service to work with purchases and subscriptions.

Overview

Magify SDK allows you to control the display of ads to the user and collect information about the views of the ads.

Also the Magify SDK allows you to use preloading of ads, which is described below.

How to use advertising

The easiest (but not the best) way to work with ads through our SDK is to use MagifyService.Advertiser.

All the API describes below.

Example:

_logger.Log("Show RewardVideo and wait for result");
var mediatorResult = await _advertiser.ShowRewardedVideoAsync(
    placement: "placement",
    clickedCallback: impression =>
    {
        _logger.Log($"Rewarded video clicked: {nameof(impression)}={JsonConvert.SerializeObject(impression)}");
    }
);

switch (mediatorResult.State)
{
    case AdShowState.Showed:
        _logger.Log("RewardVideo successfully showed");
    case AdShowState.Closed:
        _logger.Log("RewardVideo was closed");
    default:
        _logger.Log($"Failed to show RewardVideo. FailType={mediatorResult.State}. Error: {mediatorResult.Error}");
}

However, in this way of working, you need to perform many additional operations for the SDK to correctly handle shown ads and collect analytics. Therefore, it is usually better to realize the showing of ad through a campaigns system. In this case, we have already implemented a lot of logic to simplify your experience.

Ads preloading

Our sdk introduces the ability to preload ads so that at the moment of requesting there will not be any delays associated with the need to download.

To activate this functionality you need to use AdPreloadEnable. Then the sdk will use the mediator to check for the presence of cached ads to initiate the download in its absence.

Keep in mind that different ad mediators have their own ad caching policy, and you may encounter a situation where the ad mediator will invalidate preloaded ads after some time. We try to handle such situations, but we cannot guarantee that the ads will always be present.

This logic applies only to interstitial and reward ads.

For this logic to work correctly you need full implementation of the IMinimalAdsMediator interface.

Custom ad mediator

If you need to use ad mediator that's not provided out of the box you can implement IMinimalAdsMediator (IAdsMediator in advanced integration) interface. This interface returns IAdsImpression in many places, using this interface we track ad analytics by passing data about the ads shown/viewed, so your mediator in case of displaying ads should also return data packed in IAdsImpression. You can safely rely on MaxMediator or LevelPlayMediator when implementing each method.