home

Opera Ads Extension

Welcome to the Opera Ads extension wiki!

This extension integrates the Opera Ads SDK for GameMaker projects and supports both Android and iOS through the shared extension interface.

The extension provides support for:

• SDK initialisation
• Privacy configuration (GDPR, US Privacy, COPPA)
• Interstitial ads
• Rewarded ads
• Rewarded interstitial ads
• App open ads
• Banner ads

Notes

• Call opera_ads_init before using any other ad function.
• Most ad loading and showing operations are asynchronous and use callback functions.
• Interstitial, rewarded, rewarded interstitial, and app open callbacks use enum event values.
• Rewarded formats also pass reward data when the user earns a reward.
• Banner ads must be loaded before they can be shown.
• App open ads are enabled once and are then managed automatically by the extension when the app returns to the foreground.

Basic example of usage:

if (opera_ads_init(function(success, error_message)
{
    if (!success)
    {
        show_debug_message("Opera Ads init failed: " + string(error_message));
        return;
    }

    show_debug_message("Opera Ads initialised");

    opera_ads_interstitial_load(function(load_success, load_error)
    {
        if (!load_success)
        {
            show_debug_message("Interstitial load failed: " + string(load_error));
            return;
        }

        if (opera_ads_interstitial_is_ad_valid())
        {
            opera_ads_interstitial_show(function(event, error_message)
            {
                switch (event)
                {
                    case OperaAdsCallbackEventInterstitial.Displayed:
                        show_debug_message("Interstitial displayed");
                    break;

                    case OperaAdsCallbackEventInterstitial.Clicked:
                        show_debug_message("Interstitial clicked");
                    break;

                    case OperaAdsCallbackEventInterstitial.Dismissed:
                        show_debug_message("Interstitial dismissed");
                    break;

                    case OperaAdsCallbackEventInterstitial.Failed:
                        show_debug_message("Interstitial failed: " + string(error_message));
                    break;
                }
            });
        }
    });
}))
{
    show_debug_message("Init request started");
}

Functions

This module offers a collection of functions designed to address specific tasks and provide utilities for various purposes. Explore the available functions to make the most of the functionalities provided by this module.

• opera_ads_init
• opera_ads_set_mute
• opera_ads_set_gdpr
• opera_ads_set_us_privacy
• opera_ads_set_coppa
• opera_ads_get_gdpr
• opera_ads_get_gdpr_applies
• opera_ads_get_us_privacy
• opera_ads_get_coppa
• opera_ads_interstitial_set_placement_id
• opera_ads_interstitial_load
• opera_ads_interstitial_is_ad_valid
• opera_ads_interstitial_show
• opera_ads_interstitial_destroy
• opera_ads_rewarded_set_placement_id
• opera_ads_rewarded_load
• opera_ads_rewarded_is_ad_valid
• opera_ads_rewarded_show
• opera_ads_rewarded_destroy
• opera_ads_rewarded_set_scene
• opera_ads_rewarded_set_reward_ssv_options
• opera_ads_rewarded_interstitial_set_placement_id
• opera_ads_rewarded_interstitial_load
• opera_ads_rewarded_interstitial_is_ad_valid
• opera_ads_rewarded_interstitial_show
• opera_ads_rewarded_interstitial_destroy
• opera_ads_rewarded_interstitial_set_scene
• opera_ads_rewarded_interstitial_set_reward_ssv_options
• opera_ads_app_open_set_placement_id
• opera_ads_app_open_enable
• opera_ads_app_open_disable
• opera_ads_app_open_is_enabled
• opera_ads_banner_set_placement_id
• opera_ads_banner_load
• opera_ads_banner_is_ad_valid
• opera_ads_banner_show
• opera_ads_banner_move
• opera_ads_banner_destroy
• opera_ads_banner_hide
• opera_ads_banner_unhide
• opera_ads_banner_is_visible

Constants

This module includes a set of predefined constants that can be utilized for various purposes. Browse through the available constants to find values relevant to your needs and enhance the efficiency of your code.

• OperaAdsCallbackEventInterstitial
• OperaAdsCallbackEventRewarded
• OperaAdsCallbackEventRewardedInterstitial
• OperaAdsCallbackEventAppOpen
• OperaAdsCallbackEventBanner
• OperaAdsBannerPosition

---

Back To Top

opera_ads_init

This function initialises the Opera Ads SDK. This should be called before using any other function in the extension. The function returns immediately and the provided callback is called asynchronously when initialisation succeeds or fails.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_init(callback)

Argument	Type	Description
callback	Function	The callback function to call upon completion.

Returns:

Boolean

Triggers:

Callback

Key	Type	Description
success	Boolean	Whether SDK initialisation succeeded.
error_message	String	Error message when initialization fails. This argument may be omitted on success.

Example:

opera_ads_init(function(success, error_message)
{
    if (!success)
    {
        show_debug_message("Init failed: " + string(error_message));
        return;
    }

    show_debug_message("Opera Ads ready");
});

---

Back To Top

opera_ads_set_mute

This function enables or disables ad audio. This affects SDK audio playback after the SDK has been initialised.

Syntax:

opera_ads_set_mute(mute)

Argument	Type	Description
mute	Boolean	Whether to mute ad audio.

Returns:

Boolean

Example:

opera_ads_set_mute(true);

---

Back To Top

opera_ads_set_gdpr

This function sets the GDPR consent string and whether GDPR applies to the current user. This information should ideally be configured before calling opera_ads_init.

Syntax:

opera_ads_set_gdpr(consent_string, applies)

Argument	Type	Description
consent_string	String	IAB TCF consent string.
applies	Boolean	Whether GDPR applies to the current user.

Returns:

N/A

Example:

opera_ads_set_gdpr("CPXxRfAPXxRfAAHABBENBRCgAAAAAAAAAAYgAAAAAAAA", true);

---

Back To Top

opera_ads_set_us_privacy

This function sets the US privacy string used by the SDK. This should typically be set before initialisation when applicable.

Syntax:

opera_ads_set_us_privacy(us_privacy)

Argument	Type	Description
us_privacy	String	US privacy consent string.

Returns:

N/A

Example:

opera_ads_set_us_privacy("1YYY");

---

Back To Top

opera_ads_set_coppa

This function enables or disables COPPA treatment for the current user.

Syntax:

opera_ads_set_coppa(coppa)

Argument	Type	Description
coppa	Boolean	Whether to enable COPPA or not.

Returns:

N/A

Example:

opera_ads_set_coppa(true);

---

Back To Top

opera_ads_get_gdpr

This function returns the currently stored GDPR consent string.

Syntax:

opera_ads_get_gdpr()

Returns:

String

Example:

var consent = opera_ads_get_gdpr();
show_debug_message("GDPR consent: " + consent);

---

Back To Top

opera_ads_get_gdpr_applies

This function returns whether GDPR currently applies for the stored privacy state.

Syntax:

opera_ads_get_gdpr_applies()

Returns:

Boolean

Example:

if (opera_ads_get_gdpr_applies())
{
    show_debug_message("GDPR applies");
}

---

Back To Top

opera_ads_get_us_privacy

This function returns the currently stored US privacy string.

Syntax:

opera_ads_get_us_privacy()

Returns:

String

Example:

show_debug_message(opera_ads_get_us_privacy());

---

Back To Top

opera_ads_get_coppa

This function returns whether COPPA treatment is currently enabled.

Syntax:

opera_ads_get_coppa()

Returns:

Boolean

Example:

if (opera_ads_get_coppa())
{
    show_debug_message("COPPA is enabled");
}

---

Back To Top

opera_ads_interstitial_set_placement_id

This function sets a custom placement ID for interstitial ads. This overrides the default placement ID configured in the extension options. Must be called before loading the ad.

Syntax:

opera_ads_interstitial_set_placement_id(placement_id)

Argument	Type	Description
placement_id	String	The custom placement ID to use for interstitial ads.

Returns:

N/A

Example:

opera_ads_interstitial_set_placement_id("your_custom_interstitial_id");

---

Back To Top

opera_ads_interstitial_load

This function loads an interstitial ad asynchronously.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_interstitial_load(callback)

Argument	Type	Description
callback	Function	The function to be called upon completion.

Returns:

N/A

Triggers:

Callback

Key	Type	Description
success	Boolean	Whether the interstitial ad loaded successfully.
error_message	String	Error message when loading fails. This argument may be omitted on success.

Example:

opera_ads_interstitial_load(function(success, error_message)
{
    if (!success)
    {
        show_debug_message("Interstitial load failed: " + string(error_message));
        return;
    }

    show_debug_message("Interstitial loaded");
});

---

Back To Top

opera_ads_interstitial_is_ad_valid

This function returns whether a loaded interstitial ad is currently available and still valid for showing.

Syntax:

opera_ads_interstitial_is_ad_valid()

Returns:

Boolean

Example:

if (opera_ads_interstitial_is_ad_valid())
{
    show_debug_message("Interstitial is ready");
}

---

Back To Top

opera_ads_interstitial_show

This function shows the currently loaded interstitial ad. The callback receives event updates during the ad lifecycle.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_interstitial_show(callback)

Argument	Type	Description
callback	Function	The function to be called upon completion.

Returns:

N/A

Triggers:

Callback

Key	Type	Description
event	OperaAdsCallbackEventInterstitial	Event describing the interstitial lifecycle state.
error_message	String	Error message when the event is OperaAdsCallbackEventInterstitial.Failed. This argument may be omitted for other events.

Example:

if (opera_ads_interstitial_is_ad_valid())
{
    opera_ads_interstitial_show(function(event, error_message)
    {
        switch (event)
        {
            case OperaAdsCallbackEventInterstitial.Displayed:
                show_debug_message("Interstitial displayed");
            break;

            case OperaAdsCallbackEventInterstitial.Clicked:
                show_debug_message("Interstitial clicked");
            break;

            case OperaAdsCallbackEventInterstitial.Dismissed:
                show_debug_message("Interstitial dismissed");
            break;

            case OperaAdsCallbackEventInterstitial.Failed:
                show_debug_message("Interstitial failed: " + string(error_message));
            break;
        }
    });
}

---

Back To Top

opera_ads_interstitial_destroy

This function destroys the currently loaded interstitial ad and clears its internal reference.

Syntax:

opera_ads_interstitial_destroy()

Returns:

Boolean

Example:

opera_ads_interstitial_destroy();

---

Back To Top

opera_ads_rewarded_set_placement_id

This function sets a custom placement ID for rewarded ads. This overrides the default placement ID configured in the extension options. Must be called before loading the ad.

Syntax:

opera_ads_rewarded_set_placement_id(placement_id)

Argument	Type	Description
placement_id	String	The custom placement ID to use for rewarded ads.

Returns:

N/A

Example:

opera_ads_rewarded_set_placement_id("your_custom_rewarded_id");

---

Back To Top

opera_ads_rewarded_load

This function loads a rewarded ad asynchronously.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_rewarded_load(callback)

Argument	Type	Description
callback	Function	The function to be called upon completion.

Returns:

N/A

Triggers:

Callback

Key	Type	Description
success	Boolean	Whether the rewarded ad loaded successfully.
error_message	String	Error message when loading fails. This argument may be omitted on success.

Example:

opera_ads_rewarded_load(function(success, error_message)
{
    if (!success)
    {
        show_debug_message("Rewarded load failed: " + string(error_message));
        return;
    }

    show_debug_message("Rewarded loaded");
});

---

Back To Top

opera_ads_rewarded_is_ad_valid

This function returns whether a loaded rewarded ad is currently available and still valid for showing.

Syntax:

opera_ads_rewarded_is_ad_valid()

Returns:

Boolean

Example:

if (opera_ads_rewarded_is_ad_valid())
{
    show_debug_message("Rewarded ad ready");
}

---

Back To Top

opera_ads_rewarded_show

This function shows the currently loaded rewarded ad. The callback receives lifecycle events, and when the ad rewards the user it also receives reward data.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_rewarded_show(callback)

Argument	Type	Description
callback	Function	The function to be called upon completion.

Returns:

N/A

Triggers:

Callback

Key	Type	Description
event	OperaAdsCallbackEventRewarded	Event describing the rewarded ad lifecycle state.
reward_type	String	Reward type string when the event is OperaAdsCallbackEventRewarded.Rewarded. Omitted for other events.
reward_amount	Real	Reward amount when the event is OperaAdsCallbackEventRewarded.Rewarded. Omitted for other events.
error_message	String	Error message when the event is OperaAdsCallbackEventRewarded.Failed. Omitted for other events.

Example:

if (opera_ads_rewarded_is_ad_valid())
{
    opera_ads_rewarded_show(function(event, reward_type, reward_amount, error_message)
    {
        switch (event)
        {
            case OperaAdsCallbackEventRewarded.Displayed:
                show_debug_message("Rewarded displayed");
            break;

            case OperaAdsCallbackEventRewarded.Clicked:
                show_debug_message("Rewarded clicked");
            break;

            case OperaAdsCallbackEventRewarded.Dismissed:
                show_debug_message("Rewarded dismissed");
            break;

            case OperaAdsCallbackEventRewarded.Rewarded:
                show_debug_message("Reward granted: " + string(reward_type) + " / " + string(reward_amount));
            break;

            case OperaAdsCallbackEventRewarded.Failed:
                show_debug_message("Rewarded failed: " + string(error_message));
            break;
        }
    });
}

---

Back To Top

opera_ads_rewarded_destroy

This function destroys the currently loaded rewarded ad and clears its internal reference.

Syntax:

opera_ads_rewarded_destroy()

Returns:

Boolean

Example:

opera_ads_rewarded_destroy();

---

Back To Top

opera_ads_rewarded_set_scene

This function sets the scene ID for rewarded ads. This is used for analytics and reporting purposes. Android only.

Syntax:

opera_ads_rewarded_set_scene(scene_id)

Argument	Type	Description
scene_id	String	The scene identifier to associate with rewarded ads.

Returns:

N/A

Example:

opera_ads_rewarded_set_scene("level_complete");

---

Back To Top

opera_ads_rewarded_set_reward_ssv_options

This function sets server-side verification (SSV) options for rewarded ads. This enables server-to-server reward validation. Android only.

Syntax:

opera_ads_rewarded_set_reward_ssv_options(user_id, custom_data)

Argument	Type	Description
user_id	String	User identifier for server-side verification.
custom_data	String	Custom data to be passed with the verification request.

Returns:

N/A

Example:

opera_ads_rewarded_set_reward_ssv_options("user_12345", "extra_data");

---

Back To Top

opera_ads_rewarded_interstitial_set_placement_id

This function sets a custom placement ID for rewarded interstitial ads. This overrides the default placement ID configured in the extension options. Must be called before loading the ad.

Syntax:

opera_ads_rewarded_interstitial_set_placement_id(placement_id)

Argument	Type	Description
placement_id	String	The custom placement ID to use for rewarded interstitial ads.

Returns:

N/A

Example:

opera_ads_rewarded_interstitial_set_placement_id("your_custom_rewarded_interstitial_id");

---

Back To Top

opera_ads_rewarded_interstitial_load

This function loads a rewarded interstitial ad asynchronously.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_rewarded_interstitial_load(callback)

Argument	Type	Description
callback	Function	The function to be called upon completion.

Returns:

N/A

Triggers:

Callback

Key	Type	Description
success	Boolean	Whether the rewarded interstitial ad loaded successfully.
error_message	String	Error message when loading fails. This argument may be omitted on success.

Example:

opera_ads_rewarded_interstitial_load(function(success, error_message)
{
    if (!success)
    {
        show_debug_message("Rewarded interstitial load failed: " + string(error_message));
        return;
    }

    show_debug_message("Rewarded interstitial loaded");
});

---

Back To Top

opera_ads_rewarded_interstitial_is_ad_valid

This function returns whether a loaded rewarded interstitial ad is currently available and still valid for showing.

Syntax:

opera_ads_rewarded_interstitial_is_ad_valid()

Returns:

Boolean

Example:

if (opera_ads_rewarded_interstitial_is_ad_valid())
{
    show_debug_message("Rewarded interstitial ready");
}

---

Back To Top

opera_ads_rewarded_interstitial_show

This function shows the currently loaded rewarded interstitial ad. The callback receives lifecycle events, and when the ad rewards the user it also receives reward data.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_rewarded_interstitial_show(callback)

Argument	Type	Description
callback	Function	The function to be called upon completion.

Returns:

N/A

Triggers:

Callback

Key	Type	Description
event	OperaAdsCallbackEventRewardedInterstitial	Event describing the rewarded interstitial lifecycle state.
reward_type	String	Reward type string when the event is OperaAdsCallbackEventRewardedInterstitial.Rewarded. Omitted for other events.
reward_amount	Real	Reward amount when the event is OperaAdsCallbackEventRewardedInterstitial.Rewarded. Omitted for other events.
error_message	String	Error message when the event is OperaAdsCallbackEventRewardedInterstitial.Failed. Omitted for other events.

Example:

if (opera_ads_rewarded_interstitial_is_ad_valid())
{
    opera_ads_rewarded_interstitial_show(function(event, reward_type, reward_amount, error_message)
    {
        switch (event)
        {
            case OperaAdsCallbackEventRewardedInterstitial.Displayed:
                show_debug_message("Rewarded interstitial displayed");
            break;

            case OperaAdsCallbackEventRewardedInterstitial.Clicked:
                show_debug_message("Rewarded interstitial clicked");
            break;

            case OperaAdsCallbackEventRewardedInterstitial.Dismissed:
                show_debug_message("Rewarded interstitial dismissed");
            break;

            case OperaAdsCallbackEventRewardedInterstitial.Rewarded:
                show_debug_message("Reward granted: " + string(reward_type) + " / " + string(reward_amount));
            break;

            case OperaAdsCallbackEventRewardedInterstitial.Failed:
                show_debug_message("Rewarded interstitial failed: " + string(error_message));
            break;
        }
    });
}

---

Back To Top

opera_ads_rewarded_interstitial_destroy

This function destroys the currently loaded rewarded interstitial ad and clears its internal reference.

Syntax:

opera_ads_rewarded_interstitial_destroy()

Returns:

Boolean

Example:

opera_ads_rewarded_interstitial_destroy();

---

Back To Top

opera_ads_rewarded_interstitial_set_scene

This function sets the scene ID for rewarded interstitial ads. This is used for analytics and reporting purposes. Android only.

Syntax:

opera_ads_rewarded_interstitial_set_scene(scene_id)

Argument	Type	Description
scene_id	String	The scene identifier to associate with rewarded interstitial ads.

Returns:

N/A

Example:

opera_ads_rewarded_interstitial_set_scene("bonus_round");

---

Back To Top

opera_ads_rewarded_interstitial_set_reward_ssv_options

This function sets server-side verification (SSV) options for rewarded interstitial ads. This enables server-to-server reward validation. Android only.

Syntax:

opera_ads_rewarded_interstitial_set_reward_ssv_options(user_id, custom_data)

Argument	Type	Description
user_id	String	User identifier for server-side verification.
custom_data	String	Custom data to be passed with the verification request.

Returns:

N/A

Example:

opera_ads_rewarded_interstitial_set_reward_ssv_options("user_12345", "extra_data");

---

Back To Top

opera_ads_app_open_set_placement_id

This function sets a custom placement ID for app open ads. This overrides the default placement ID configured in the extension options. Must be called before enabling app open ads.

Syntax:

opera_ads_app_open_set_placement_id(placement_id)

Argument	Type	Description
placement_id	String	The custom placement ID to use for app open ads.

Returns:

N/A

Example:

opera_ads_app_open_set_placement_id("your_custom_app_open_id");

---

Back To Top

opera_ads_app_open_enable

This function enables app open ads. After being enabled, the extension manages app open loading and showing automatically when the application returns to the foreground.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_app_open_enable(callback)

Argument	Type	Description
callback	Function	The function to be called upon completion.

Returns:

N/A

Triggers:

Callback

Key	Type	Description
event	OperaAdsCallbackEventAppOpen	Event describing app open load or display state.
error_message	String	Error message when the event is OperaAdsCallbackEventAppOpen.LoadFailed or OperaAdsCallbackEventAppOpen.Failed. Omitted for other events.

Example:

opera_ads_app_open_enable(function(event, error_message)
{
    switch (event)
    {
        case OperaAdsCallbackEventAppOpen.Loaded:
            show_debug_message("App open loaded");
        break;

        case OperaAdsCallbackEventAppOpen.Displayed:
            show_debug_message("App open displayed");
        break;

        case OperaAdsCallbackEventAppOpen.Dismissed:
            show_debug_message("App open dismissed");
        break;

        case OperaAdsCallbackEventAppOpen.LoadFailed:
        case OperaAdsCallbackEventAppOpen.Failed:
            show_debug_message("App open error: " + string(error_message));
        break;
    }
});

---

Back To Top

opera_ads_app_open_disable

This function disables app open ads and clears any currently managed app open ad instance.

Syntax:

opera_ads_app_open_disable()

Returns:

Boolean

Example:

opera_ads_app_open_disable();

---

Back To Top

opera_ads_app_open_is_enabled

This function returns whether app open ads are currently enabled.

Syntax:

opera_ads_app_open_is_enabled()

Returns:

Boolean

Example:

if (opera_ads_app_open_is_enabled())
{
    show_debug_message("App open ads enabled");
}

---

Back To Top

opera_ads_banner_set_placement_id

This function sets a custom placement ID for banner ads. This overrides the default placement ID configured in the extension options. Must be called before loading the banner.

Syntax:

opera_ads_banner_set_placement_id(placement_id)

Argument	Type	Description
placement_id	String	The custom placement ID to use for banner ads.

Returns:

N/A

Example:

opera_ads_banner_set_placement_id("your_custom_banner_id");

---

Back To Top

opera_ads_banner_load

This function loads a banner ad asynchronously.

This function operates asynchronously, which means that it does not immediately return the requested result. Instead, upon completion of the task, it will trigger the Callback.

Syntax:

opera_ads_banner_load(callback)

Argument	Type	Description
callback	Function	The function to be called upon completion.

Returns:

N/A

Triggers:

Callback

Key	Type	Description
event	OperaAdsCallbackEventBanner	Event describing banner load or interaction state.
error_message	String	Error message when the event is OperaAdsCallbackEventBanner.LoadFailed. Omitted for other events.

Example:

opera_ads_banner_load(function(event, error_message)
{
    switch (event)
    {
        case OperaAdsCallbackEventBanner.Loaded:
            show_debug_message("Banner loaded");
        break;

        case OperaAdsCallbackEventBanner.Impression:
            show_debug_message("Banner impression");
        break;

        case OperaAdsCallbackEventBanner.Clicked:
            show_debug_message("Banner clicked");
        break;

        case OperaAdsCallbackEventBanner.LoadFailed:
            show_debug_message("Banner load failed: " + string(error_message));
        break;
    }
});

---

Back To Top

opera_ads_banner_is_ad_valid

This function returns whether a banner ad is currently loaded and still valid.

Syntax:

opera_ads_banner_is_ad_valid()

Returns:

Boolean

Example:

if (opera_ads_banner_is_ad_valid())
{
    show_debug_message("Banner is valid");
}

---

Back To Top

opera_ads_banner_show

This function shows the loaded banner ad at the given screen position. If the banner has already been attached, its position is updated and it is made visible.

Syntax:

opera_ads_banner_show(position)

Argument	Type	Description
position	OperaAdsBannerPosition	Desired banner position on screen.

Returns:

Boolean

Example:

opera_ads_banner_show(OperaAdsBannerPosition.BottomCenter);

---

Back To Top

opera_ads_banner_move

This function moves the currently attached banner ad to a new screen position without reloading it.

Syntax:

opera_ads_banner_move(position)

Argument	Type	Description
position	OperaAdsBannerPosition	Desired banner position on screen.

Returns:

Boolean

Example:

opera_ads_banner_move(OperaAdsBannerPosition.TopCenter);

---

Back To Top

opera_ads_banner_destroy

This function destroys the current banner ad, removes it from the view hierarchy, and clears its loaded state.

Syntax:

opera_ads_banner_destroy()

Returns:

Boolean

Example:

opera_ads_banner_destroy();

---

Back To Top

opera_ads_banner_hide

This function hides the currently attached banner ad without destroying it.

Syntax:

opera_ads_banner_hide()

Returns:

Boolean

Example:

opera_ads_banner_hide();

---

Back To Top

opera_ads_banner_unhide

This function makes a previously hidden banner visible again. If the banner became invalid while hidden, it may need to be loaded again.

Syntax:

opera_ads_banner_unhide()

Returns:

Boolean

Example:

opera_ads_banner_unhide();

---

Back To Top

opera_ads_banner_is_visible

This function returns whether the banner is currently attached and visible on screen.

Syntax:

opera_ads_banner_is_visible()

Returns:

Boolean

Example:

if (opera_ads_banner_is_visible())
{
    show_debug_message("Banner visible");
}

---

Back To Top

OperaAdsCallbackEventInterstitial

These constants are referenced by the following functions:

• opera_ads_interstitial_show

Member	Description
Clicked	The interstitial ad was clicked.
Displayed	The interstitial ad was displayed.
Dismissed	The interstitial ad was closed by the user.
Failed	The interstitial ad failed to show.

---

Back To Top

OperaAdsCallbackEventRewarded

These constants are referenced by the following functions:

• opera_ads_rewarded_show

Member	Description
Clicked	The rewarded ad was clicked.
Displayed	The rewarded ad was displayed.
Dismissed	The rewarded ad was closed by the user.
Failed	The rewarded ad failed to show.
Rewarded	The user earned the configured reward.

---

Back To Top

OperaAdsCallbackEventRewardedInterstitial

These constants are referenced by the following functions:

• opera_ads_rewarded_interstitial_show

Member	Description
Clicked	The rewarded interstitial ad was clicked.
Displayed	The rewarded interstitial ad was displayed.
Dismissed	The rewarded interstitial ad was closed by the user.
Failed	The rewarded interstitial ad failed to show.
Rewarded	The user earned the configured reward.

---

Back To Top

OperaAdsCallbackEventAppOpen

These constants are referenced by the following functions:

• opera_ads_app_open_enable

Member	Description
Loaded	An app open ad loaded successfully.
LoadFailed	An app open ad failed to load.
Clicked	The app open ad was clicked.
Displayed	The app open ad was displayed.
Dismissed	The app open ad was closed by the user.
Failed	The app open ad failed to show.

---

Back To Top

OperaAdsCallbackEventBanner

These constants are referenced by the following functions:

• opera_ads_banner_load

Member	Description
Loaded	The banner ad loaded successfully.
LoadFailed	The banner ad failed to load.
Impression	The banner recorded an impression.
Clicked	The banner ad was clicked.

---

Back To Top

OperaAdsBannerPosition

These constants are referenced by the following functions:

• opera_ads_banner_show
• opera_ads_banner_move

Member	Description
TopLeft	Positions the banner at the top-left corner.
TopCenter	Positions the banner at the top-center of the screen.
TopRight	Positions the banner at the top-right corner.
MiddleLeft	Positions the banner at the middle-left side.
MiddleCenter	Positions the banner at the center of the screen.
MiddleRight	Positions the banner at the middle-right side.
BottomLeft	Positions the banner at the bottom-left corner.
BottomCenter	Positions the banner at the bottom-center of the screen.
BottomRight	Positions the banner at the bottom-right corner.

---