GoogleAdUnitHandlers.cs

using System;
using System.Diagnostics;
using GoogleMobileAds.Api;
 
namespace SCG.SpaceAdMobile
{
    // The second partial part of the GoogleAdUnit 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 GoogleAdUnit<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 virtual void OnAdPaid(AdValue adValue)
        {
            Logger.Log(LogOptions.AdPaidLogText, adValue.Value, adValue.CurrencyCode);
            base.OnAdPaid(adValue);
        }

        protected override void OnAdImpressionRecorded()
        {
            Logger.Log(LogOptions.AdImpressionLogText);
            base.OnAdImpressionRecorded();
        }

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

        protected virtual void OnAdLoadFailed(LoadAdError error)
        {
            ResetLoadingStartTime();
            Logger.LogError(LogOptions.AdLoadFailedText, error);
            base.OnAdLoadFailed(error);
        }

        protected override void OnAdClicked()
        {
            Logger.Log(LogOptions.AdClickedLogText);
            base.OnAdClicked();
        }

        protected override void OnAdShown()
        {
            Logger.Log(LogOptions.AdShownLogText);
            base.OnAdShown();
        }

        protected override void OnAdClosed()
        {
            Logger.Log(LogOptions.AdClosedLogText);
            base.OnAdClosed();
        }

        protected virtual void OnAdContentFailed(AdError error)
        {
            Logger.LogError(LogOptions.AdContentFailedLogText, error);
            base.OnAdContentFailed(error);
        }

        protected virtual void OnUserEarnedReward(AdReward reward)
        {
            Logger.Log(LogOptions.AdRewardEarnedLogText, reward.Name, reward.AmountAsDouble);
            base.OnUserEarnedReward(reward);
        }
    }
}