YandexAdUnitHandlers.cs

using System;
using System.Diagnostics;
using YandexMobileAds.Base;
 
namespace SCG.SpaceAdMobile
{
    // The second partial part of the YandexAdUnit class focuses on handling various advertisement events,
    // particularly logging and responding to key lifecycle events such as ad load failures and ad clicks.
    // This part of the class includes methods that are invoked in response to specific ad events,
    // allowing for comprehensive logging and additional processing through base class methods.
    // Each handler method is designed to capture detailed information about the event,
    // such as failure reasons or simple acknowledgment of user interaction, and log this information
    // for debugging, analytics, and operational insights. These methods ensure that any significant
    // event in the ad lifecycle is not only noted but also acted upon, following the principle of
    // observability and responsiveness in ad management.
    public abstract partial class YandexAdUnit<TAd>
    {
        public DateTime? LoadTime { get; protected set; }
 
        private long? loadingStartTimestamp;

        public long? LoadingTimeMs { get; protected set; }

        protected void SetLoadingStartTime() => loadingStartTimestamp = Stopwatch.GetTimestamp();

        protected void ResetLoadingStartTime() => loadingStartTimestamp = null;

        private void SetLoadingTime()
        {
            LoadingTimeMs = loadingStartTimestamp is { } startTimestamp
                ? (long)((Stopwatch.GetTimestamp() - startTimestamp) * 1000d / Stopwatch.Frequency)
                : null;
            loadingStartTimestamp = null;
        }

        protected override void OnAdPaid(object adValue) => throw new NotSupportedException();

        protected virtual void OnAdImpression(object sender, ImpressionData e)
        {
            Logger.Log(LogOptions.AdImpressionLogText, e?.rawData ?? string.Empty);
            base.OnAdImpressionRecorded();
        }

        protected override void OnAdLoaded()
        {
            LoadTime = DateTime.Now;
            SetLoadingTime();
            PrepareAdObject();
            Logger.Log(LogOptions.AdLoadedLogText);
            base.OnAdLoaded();
        }

        protected virtual void OnAdLoadFailed(object sender, AdFailedToLoadEventArgs args)
        {
            ResetLoadingStartTime();
            Logger.LogError(LogOptions.AdLoadFailedText, args.Message, args.AdUnitId);
            base.OnAdLoadFailed(args.Message);
        }
 
#if !LEGACY_YANDEX_MOBILE_ADS
        protected void OnAdLoadFailed(object sender, AdFailureEventArgs e)
            => OnAdLoadFailed(sender, new AdLoadingException(e.Message, GetId()));

        protected virtual void OnAdLoadFailed(object sender, AdLoadingException args)
        {
            ResetLoadingStartTime();
            Logger.LogError(LogOptions.AdLoadFailedText, args.Message, args.AdUnitId);
            base.OnAdLoadFailed(args.Message);
        }
#endif

        protected virtual void OnAdClicked(object sender, EventArgs e)
        {
            Logger.Log(LogOptions.AdClickedLogText);
            base.OnAdClicked();
        }

        protected virtual void OnAdShown(object sender, EventArgs e)
        {
            Logger.Log(LogOptions.AdShownLogText);
            base.OnAdShown();
        }

        protected virtual void OnAdClosed(object sender, EventArgs e)
        {
            Logger.Log(LogOptions.AdClosedLogText);
            base.OnAdClosed();
        }

        protected virtual void OnAdContentFailed(object sender, AdFailureEventArgs e)
        {
            Logger.LogError(LogOptions.AdContentFailedLogText, e.Message);
            base.OnAdContentFailed(e.Message);
        }

        protected virtual void OnUserEarnedReward(object sender, AdRewardBase reward)
        {
            Logger.Log(LogOptions.AdRewardEarnedLogText, reward.Name, reward.Amount);
            base.OnUserEarnedReward(reward);
        }
    }
}