Offerwall Integration Guide¶

using IntelliVerseX.Monetization;
using UnityEngine;

public class OfferwallRewardHandler : MonoBehaviour
{
    private void OnEnable()
    {
        IVXOfferwallManager.OnOfferCompleted += HandleOfferCompleted;
        IVXOfferwallManager.OnOfferFailed += HandleOfferFailed;
    }

    private void OnDisable()
    {
        IVXOfferwallManager.OnOfferCompleted -= HandleOfferCompleted;
        IVXOfferwallManager.OnOfferFailed -= HandleOfferFailed;
    }

    private async void HandleOfferCompleted(string offerId, OfferReward reward)
    {
        Debug.Log($"[Offerwall] Offer {offerId} completed: {reward.Amount} {reward.CurrencyId}");

        var result = await IVXWalletManager.Instance.GrantCurrencyAsync(
            reward.CurrencyId,
            reward.Amount
        );

        if (result.Success)
        {
            ShowRewardPopup(reward.Amount, reward.CurrencyId);
        }
    }

    private void HandleOfferFailed(string offerId, string error)
    {
        Debug.LogWarning($"[Offerwall] Offer {offerId} failed: {error}");
    }

    private void ShowRewardPopup(int amount, string currency)
    {
        // Display reward UI to the player
    }
}

using IntelliVerseX.Monetization;
using UnityEngine;
using UnityEngine.UI;

public class OfferwallUI : MonoBehaviour
{
    [SerializeField] private Button _earnCoinsButton;

    private void Start()
    {
        _earnCoinsButton.onClick.AddListener(OnEarnCoinsClicked);
        UpdateButtonState();

        IVXOfferwallManager.OnOfferwallOpened += () => Debug.Log("[Offerwall] Opened");
        IVXOfferwallManager.OnOfferwallClosed += () =>
        {
            Debug.Log("[Offerwall] Closed");
            UpdateButtonState();
        };
    }

    private async void OnEarnCoinsClicked()
    {
        if (!IVXOfferwallManager.Instance.IsAvailable())
        {
            ShowToast("Offers not available right now. Try again later.");
            return;
        }

        await IVXOfferwallManager.Instance.ShowOfferwallAsync();
    }

    private void UpdateButtonState()
    {
        _earnCoinsButton.interactable = IVXOfferwallManager.Instance.IsAvailable();
    }

    private void ShowToast(string message) { /* your toast UI */ }
}

// Hybrid mode is automatic when both are enabled in config
// No additional code required

// To check individual provider availability:
bool hasPubscale = IVXOfferwallManager.Instance.IsProviderAvailable("pubscale");
bool hasXsolla = IVXOfferwallManager.Instance.IsProviderAvailable("xsolla");

var filterConfig = new OfferFilterConfig
{
    EnableAppInstalls = true,
    EnableSurveys = true,
    EnableSignups = true,
    EnableVideoOffers = true,
    EnableSubscriptionOffers = false  // disable high-friction offers
};

IVXOfferwallManager.Instance.SetOfferFilter(filterConfig);

// Weekend 2x bonus
IVXOfferwallManager.Instance.SetBonusMultiplier(2.0f);

// Reset after event
IVXOfferwallManager.Instance.SetBonusMultiplier(1.0f);

// Enabled via IVXOfferwallConfig.EnableFraudProtection = true
// Automatic behaviors:
// - Device fingerprinting
// - Session token rotation
// - Duplicate completion detection

// These events are automatically tracked by the SDK:
// - offerwall_opened: user opened the offerwall
// - offerwall_closed: user closed without completing
// - offer_started: user clicked an offer
// - offer_completed: offer was validated and rewarded
// - offer_failed: offer validation failed

// Custom tracking example:
IVXSatoriClient.TrackEvent("offerwall_revenue", new Dictionary<string, object>
{
    { "provider", reward.Provider },
    { "offer_id", reward.OfferId },
    { "revenue_usd", reward.RevenueUsd },
    { "coins_granted", reward.Amount }
});

// Enable verbose logging for offerwall
IVXOfferwallManager.Instance.SetDebugMode(true);

// Test with mock offers (no real provider calls)
IVXOfferwallManager.Instance.SetTestMode(true);

using IntelliVerseX.Monetization;
using UnityEngine;

public class OfferwallController : MonoBehaviour
{
    [SerializeField] private IVXOfferwallConfig _config;

    private async void Start()
    {
        await IVXOfferwallManager.Instance.InitializeAsync(_config);

        IVXOfferwallManager.OnOfferCompleted += async (offerId, reward) =>
        {
            var result = await IVXWalletManager.Instance.GrantCurrencyAsync(
                reward.CurrencyId, reward.Amount
            );

            if (result.Success)
            {
                Debug.Log($"[Offerwall] Granted {reward.Amount} {reward.CurrencyId}");
            }
        };

        IVXOfferwallManager.OnOfferFailed += (offerId, error) =>
        {
            Debug.LogWarning($"[Offerwall] Failed: {error}");
        };
    }

    public async void ShowOfferwall()
    {
        if (IVXOfferwallManager.Instance.IsAvailable())
        {
            await IVXOfferwallManager.Instance.ShowOfferwallAsync();
        }
    }
}