1231 lines
		
	
	
		
			52 KiB
		
	
	
	
		
			C#
		
	
	
	
		
		
			
		
	
	
			1231 lines
		
	
	
		
			52 KiB
		
	
	
	
		
			C#
		
	
	
	
|  | using System; | ||
|  | using System.Collections; | ||
|  | using System.Collections.Generic; | ||
|  | using System.Runtime.InteropServices; | ||
|  | using AOT; | ||
|  | using UnityEngine; | ||
|  | using AppLovinMax.ThirdParty.MiniJson; | ||
|  | 
 | ||
|  | /// <summary> | ||
|  | /// iOS AppLovin MAX Unity Plugin implementation | ||
|  | /// </summary> | ||
|  | public class MaxSdkiOS : MaxSdkBase | ||
|  | { | ||
|  |     private delegate void ALUnityBackgroundCallback(string args); | ||
|  | 
 | ||
|  |     static MaxSdkiOS() | ||
|  |     { | ||
|  |         InitializeEventExecutor(); | ||
|  | 
 | ||
|  | #if UNITY_IOS | ||
|  |         _MaxSetBackgroundCallback(BackgroundCallback); | ||
|  | #endif | ||
|  |     } | ||
|  | 
 | ||
|  | #if UNITY_IOS | ||
|  | 
 | ||
|  |     #region Initialization | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetBackgroundCallback(ALUnityBackgroundCallback backgroundCallback); | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxInitializeSdk(string serializedAdUnitIds, string serializedMetaData); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Initialize the default instance of AppLovin SDK. | ||
|  |     /// | ||
|  |     /// Please make sure that application's Android manifest or Info.plist includes the AppLovin SDK key. | ||
|  |     /// <param name="adUnitIds"> | ||
|  |     /// OPTIONAL: Set the MAX ad unit ids to be used for this instance of the SDK. 3rd-party SDKs will be initialized with the credentials configured for these ad unit ids. | ||
|  |     /// This should only be used if you have different sets of ad unit ids / credentials for the same package name.</param> | ||
|  |     /// </summary> | ||
|  |     public static void InitializeSdk(string[] adUnitIds = null) | ||
|  |     { | ||
|  |         var serializedAdUnitIds = (adUnitIds != null) ? string.Join(",", adUnitIds) : ""; | ||
|  |         _MaxInitializeSdk(serializedAdUnitIds, GenerateMetaData()); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsInitialized(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Check if the SDK has been initialized. | ||
|  |     /// </summary> | ||
|  |     /// <returns>True if SDK has been initialized</returns> | ||
|  |     public static bool IsInitialized() | ||
|  |     { | ||
|  |         return _MaxIsInitialized(); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region User Info | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetUserId(string userId); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set an identifier for the current user. This identifier will be tied to SDK events and our optional S2S postbacks. | ||
|  |     ///  | ||
|  |     /// If you're using reward validation, you can optionally set an identifier to be included with currency validation postbacks. | ||
|  |     /// For example, a username or email. We'll include this in the postback when we ping your currency endpoint from our server. | ||
|  |     /// </summary> | ||
|  |     ///  | ||
|  |     /// <param name="userId">The user identifier to be set. Must not be null.</param> | ||
|  |     public static void SetUserId(string userId) | ||
|  |     { | ||
|  |         _MaxSetUserId(userId); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxSetSegmentCollection(string segmentCollectionsJson); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set the <see cref="MaxSegmentCollection"/>. | ||
|  |     /// </summary> | ||
|  |     /// <param name="segmentCollection"> The segment collection to be set. Must not be {@code null}</param> | ||
|  |     public static void SetSegmentCollection(MaxSegmentCollection segmentCollection) | ||
|  |     { | ||
|  |         _MaxSetSegmentCollection(JsonUtility.ToJson(segmentCollection)); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region MAX | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern string _MaxGetAvailableMediatedNetworks(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Returns the list of available mediation networks. | ||
|  |     ///  | ||
|  |     /// Please call this method after the SDK has initialized. | ||
|  |     /// </summary> | ||
|  |     public static List<MaxSdkBase.MediatedNetworkInfo> GetAvailableMediatedNetworks() | ||
|  |     { | ||
|  |         var serializedNetworks = _MaxGetAvailableMediatedNetworks(); | ||
|  |         return MaxSdkUtils.PropsStringsToList<MaxSdkBase.MediatedNetworkInfo>(serializedNetworks); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxShowMediationDebugger(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Present the mediation debugger UI. | ||
|  |     /// This debugger tool provides the status of your integration for each third-party ad network. | ||
|  |     /// | ||
|  |     /// Please call this method after the SDK has initialized. | ||
|  |     /// </summary> | ||
|  |     public static void ShowMediationDebugger() | ||
|  |     { | ||
|  |         _MaxShowMediationDebugger(); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxShowCreativeDebugger(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Present the creative debugger UI. | ||
|  |     /// This debugger tool provides information for recently displayed ads. | ||
|  |     /// | ||
|  |     /// Please call this method after the SDK has initialized. | ||
|  |     /// </summary> | ||
|  |     public static void ShowCreativeDebugger() | ||
|  |     { | ||
|  |         _MaxShowCreativeDebugger(); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern string _MaxGetAdValue(string adUnitIdentifier, string key); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Returns the arbitrary ad value for a given ad unit identifier with key. Returns null if no ad is loaded. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier for which to get the ad value for. Must not be null.</param> | ||
|  |     /// <param name="key">Ad value key. Must not be null.</param> | ||
|  |     /// <returns>Arbitrary ad value for a given key, or null if no ad is loaded.</returns> | ||
|  |     public static string GetAdValue(string adUnitIdentifier, string key) | ||
|  |     { | ||
|  |         var value = _MaxGetAdValue(adUnitIdentifier, key); | ||
|  | 
 | ||
|  |         if (string.IsNullOrEmpty(value)) return null; | ||
|  | 
 | ||
|  |         return value; | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region Privacy | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Get the SDK configuration for this user. | ||
|  |     /// | ||
|  |     /// Note: This method should be called only after SDK has been initialized. | ||
|  |     /// </summary> | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern string _MaxGetSdkConfiguration(); | ||
|  | 
 | ||
|  |     public static SdkConfiguration GetSdkConfiguration() | ||
|  |     { | ||
|  |         var sdkConfigurationStr = _MaxGetSdkConfiguration(); | ||
|  |         var sdkConfigurationDict = Json.Deserialize(sdkConfigurationStr) as Dictionary<string, object>; | ||
|  |         return SdkConfiguration.Create(sdkConfigurationDict); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetHasUserConsent(bool hasUserConsent); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set whether or not user has provided consent for information sharing with AppLovin and other providers. | ||
|  |     /// </summary> | ||
|  |     /// <param name="hasUserConsent"><c>true</c> if the user has provided consent for information sharing with AppLovin. <c>false</c> by default.</param> | ||
|  |     public static void SetHasUserConsent(bool hasUserConsent) | ||
|  |     { | ||
|  |         _MaxSetHasUserConsent(hasUserConsent); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxHasUserConsent(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Check if user has provided consent for information sharing with AppLovin and other providers. | ||
|  |     /// </summary> | ||
|  |     /// <returns><c>true</c> if user has provided consent for information sharing. <c>false</c> if the user declined to share information or the consent value has not been set <see cref="IsUserConsentSet">.</returns> | ||
|  |     public static bool HasUserConsent() | ||
|  |     { | ||
|  |         return _MaxHasUserConsent(); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsUserConsentSet(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Check if user has set consent for information sharing. | ||
|  |     /// </summary> | ||
|  |     /// <returns><c>true</c> if user has set a value of consent for information sharing.</returns> | ||
|  |     public static bool IsUserConsentSet() | ||
|  |     { | ||
|  |         return _MaxIsUserConsentSet(); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetDoNotSell(bool doNotSell); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set whether or not user has opted out of the sale of their personal information. | ||
|  |     /// </summary> | ||
|  |     /// <param name="doNotSell"><c>true</c> if the user has opted out of the sale of their personal information.</param> | ||
|  |     public static void SetDoNotSell(bool doNotSell) | ||
|  |     { | ||
|  |         _MaxSetDoNotSell(doNotSell); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsDoNotSell(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Check if the user has opted out of the sale of their personal information. | ||
|  |     /// </summary> | ||
|  |     /// <returns><c>true</c> if the user has opted out of the sale of their personal information. <c>false</c> if the user opted in to the sell of their personal information or the value has not been set <see cref="IsDoNotSellSet">.</returns> | ||
|  |     public static bool IsDoNotSell() | ||
|  |     { | ||
|  |         return _MaxIsDoNotSell(); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsDoNotSellSet(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Check if the user has set the option to sell their personal information | ||
|  |     /// </summary> | ||
|  |     /// <returns><c>true</c> if user has chosen an option to sell their personal information.</returns> | ||
|  |     public static bool IsDoNotSellSet() | ||
|  |     { | ||
|  |         return _MaxIsDoNotSellSet(); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region Banners | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxCreateBanner(string adUnitIdentifier, string bannerPosition, bool isAdaptive); | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxCreateBannerXY(string adUnitIdentifier, float x, float y, bool isAdaptive); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Create a new banner. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to create. Must not be null.</param> | ||
|  |     /// <param name="configuration">The configuration for the banner</param> | ||
|  |     public static void CreateBanner(string adUnitIdentifier, AdViewConfiguration configuration) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "create banner"); | ||
|  |         if (configuration.UseCoordinates) | ||
|  |         { | ||
|  |             _MaxCreateBannerXY(adUnitIdentifier, configuration.XCoordinate, configuration.YCoordinate, configuration.IsAdaptive); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             _MaxCreateBanner(adUnitIdentifier, configuration.Position.ToSnakeCaseString(), configuration.IsAdaptive); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxLoadBanner(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Load a new banner ad. | ||
|  |     /// NOTE: The <see cref="CreateBanner()"/> method loads the first banner ad and initiates an automated banner refresh process. | ||
|  |     /// You only need to call this method if you pause banner refresh. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to load. Must not be null.</param> | ||
|  |     public static void LoadBanner(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "load banner"); | ||
|  |         _MaxLoadBanner(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetBannerPlacement(string adUnitIdentifier, string placement); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set the banner placement for an ad unit identifier to tie the future ad events to. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to set the placement for. Must not be null.</param> | ||
|  |     /// <param name="placement">Placement to set</param> | ||
|  |     public static void SetBannerPlacement(string adUnitIdentifier, string placement) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set banner placement"); | ||
|  |         _MaxSetBannerPlacement(adUnitIdentifier, placement); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxStartBannerAutoRefresh(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Starts or resumes auto-refreshing of the banner for the given ad unit identifier. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner for which to start auto-refresh. Must not be null.</param> | ||
|  |     public static void StartBannerAutoRefresh(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "start banner auto-refresh"); | ||
|  |         _MaxStartBannerAutoRefresh(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxStopBannerAutoRefresh(string adUnitIdentifeir); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Pauses auto-refreshing of the banner for the given ad unit identifier. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner for which to stop auto-refresh. Must not be null.</param> | ||
|  |     public static void StopBannerAutoRefresh(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "stop banner auto-refresh"); | ||
|  |         _MaxStopBannerAutoRefresh(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxUpdateBannerPosition(string adUnitIdentifier, string bannerPosition); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Updates the position of the banner to the new position provided. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">The ad unit identifier of the banner for which to update the position. Must not be null.</param> | ||
|  |     /// <param name="bannerPosition">A new position for the banner. Must not be null.</param> | ||
|  |     public static void UpdateBannerPosition(string adUnitIdentifier, AdViewPosition bannerPosition) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "update banner position"); | ||
|  |         _MaxUpdateBannerPosition(adUnitIdentifier, bannerPosition.ToSnakeCaseString()); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxUpdateBannerPositionXY(string adUnitIdentifier, float x, float y); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Updates the position of the banner to the new coordinates provided. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">The ad unit identifier of the banner for which to update the position. Must not be null.</param> | ||
|  |     /// <param name="x">The X coordinate (horizontal position) of the banner relative to the top left corner of the screen.</param> | ||
|  |     /// <param name="y">The Y coordinate (vertical position) of the banner relative to the top left corner of the screen.</param> | ||
|  |     /// <seealso cref="GetBannerLayout"> | ||
|  |     /// The banner is placed within the safe area of the screen. You can use this to get the absolute position of the banner on screen. | ||
|  |     /// </seealso> | ||
|  |     public static void UpdateBannerPosition(string adUnitIdentifier, float x, float y) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "update banner position"); | ||
|  |         _MaxUpdateBannerPositionXY(adUnitIdentifier, x, y); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetBannerWidth(string adUnitIdentifier, float width); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Overrides the width of the banner in points. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">The ad unit identifier of the banner for which to override the width for. Must not be null.</param> | ||
|  |     /// <param name="width">The desired width of the banner in points</param> | ||
|  |     public static void SetBannerWidth(string adUnitIdentifier, float width) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set banner width"); | ||
|  |         _MaxSetBannerWidth(adUnitIdentifier, width); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxShowBanner(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Show banner at a position determined by the 'CreateBanner' call. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to show. Must not be null.</param> | ||
|  |     public static void ShowBanner(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "show banner"); | ||
|  |         _MaxShowBanner(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxDestroyBanner(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Remove banner from the ad view and destroy it. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to destroy. Must not be null.</param> | ||
|  |     public static void DestroyBanner(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "destroy banner"); | ||
|  |         _MaxDestroyBanner(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxHideBanner(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Hide banner. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to hide. Must not be null.</param> | ||
|  |     public static void HideBanner(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "hide banner"); | ||
|  |         _MaxHideBanner(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetBannerBackgroundColor(string adUnitIdentifier, string hexColorCodeString); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set non-transparent background color for banners to be fully functional. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to set background color for. Must not be null.</param> | ||
|  |     /// <param name="color">A background color to set for the ad</param> | ||
|  |     public static void SetBannerBackgroundColor(string adUnitIdentifier, Color color) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set background color"); | ||
|  |         _MaxSetBannerBackgroundColor(adUnitIdentifier, MaxSdkUtils.ParseColor(color)); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetBannerExtraParameter(string adUnitIdentifier, string key, string value); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set an extra parameter for the banner ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to set the extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the extra parameter.</param> | ||
|  |     public static void SetBannerExtraParameter(string adUnitIdentifier, string key, string value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set banner extra parameter"); | ||
|  |         _MaxSetBannerExtraParameter(adUnitIdentifier, key, value); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetBannerLocalExtraParameter(string adUnitIdentifier, string key, IntPtr value); | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetBannerLocalExtraParameterJSON(string adUnitIdentifier, string key, string json); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set a local extra parameter for the banner ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner to set the local extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the local extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the local extra parameter. Accepts the following types: <see cref="IntPtr"/>, <c>null</c>, <c>IList</c>, <c>IDictionary</c>, <c>string</c>, primitive types</param> | ||
|  |     public static void SetBannerLocalExtraParameter(string adUnitIdentifier, string key, object value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set banner local extra parameter"); | ||
|  | 
 | ||
|  |         if (value == null || value is IntPtr) | ||
|  |         { | ||
|  |             var intPtrValue = value == null ? IntPtr.Zero : (IntPtr) value; | ||
|  |             _MaxSetBannerLocalExtraParameter(adUnitIdentifier, key, intPtrValue); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             _MaxSetBannerLocalExtraParameterJSON(adUnitIdentifier, key, SerializeLocalExtraParameterValue(value)); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetBannerCustomData(string adUnitIdentifier, string customData); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// The custom data to tie the showing banner ad to, for ILRD and rewarded postbacks via the <c>{CUSTOM_DATA}</c> macro. Maximum size is 8KB. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Banner ad unit identifier of the banner to set the custom data for. Must not be null.</param> | ||
|  |     /// <param name="customData">The custom data to be set.</param> | ||
|  |     public static void SetBannerCustomData(string adUnitIdentifier, string customData) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set banner custom data"); | ||
|  |         _MaxSetBannerCustomData(adUnitIdentifier, customData); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern string _MaxGetBannerLayout(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// The banner position on the screen. When setting the banner position via <see cref="CreateBanner(string, float, float)"/> or <see cref="UpdateBannerPosition(string, float, float)"/>, | ||
|  |     /// the banner is placed within the safe area of the screen. This returns the absolute position of the banner on screen. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the banner for which to get the position on screen. Must not be null.</param> | ||
|  |     /// <returns>A <see cref="Rect"/> representing the banner position on screen.</returns> | ||
|  |     public static Rect GetBannerLayout(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "get banner layout"); | ||
|  |         var positionRect = _MaxGetBannerLayout(adUnitIdentifier); | ||
|  |         return GetRectFromString(positionRect); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region MRECs | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxCreateMRec(string adUnitIdentifier, string mrecPosition); | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxCreateMRecXY(string adUnitIdentifier, float x, float y); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Create a new MREC. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC to create. Must not be null.</param> | ||
|  |     /// <param name="configuration">The configuration for the MREC.</param> | ||
|  |     public static void CreateMRec(string adUnitIdentifier, AdViewConfiguration configuration) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "create MREC"); | ||
|  |         if (configuration.UseCoordinates) | ||
|  |         { | ||
|  |             _MaxCreateMRecXY(adUnitIdentifier, configuration.XCoordinate, configuration.YCoordinate); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             _MaxCreateMRec(adUnitIdentifier, configuration.Position.ToSnakeCaseString()); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxLoadMRec(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Load a new MREC ad. | ||
|  |     /// NOTE: The <see cref="CreateMRec()"/> method loads the first MREC ad and initiates an automated MREC refresh process. | ||
|  |     /// You only need to call this method if you pause MREC refresh. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC to load. Must not be null.</param> | ||
|  |     public static void LoadMRec(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "load MREC"); | ||
|  |         _MaxLoadMRec(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetMRecPlacement(string adUnitIdentifier, string placement); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set the MREC placement for an ad unit identifier to tie the future ad events to. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC to set the placement for. Must not be null.</param> | ||
|  |     /// <param name="placement">Placement to set</param> | ||
|  |     public static void SetMRecPlacement(string adUnitIdentifier, string placement) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set MREC placement"); | ||
|  |         _MaxSetMRecPlacement(adUnitIdentifier, placement); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxStartMRecAutoRefresh(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Starts or resumes auto-refreshing of the MREC for the given ad unit identifier. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC for which to start auto-refresh. Must not be null.</param> | ||
|  |     public static void StartMRecAutoRefresh(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "start MREC auto-refresh"); | ||
|  |         _MaxStartMRecAutoRefresh(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxStopMRecAutoRefresh(string adUnitIdentifeir); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Pauses auto-refreshing of the MREC for the given ad unit identifier. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC for which to stop auto-refresh. Must not be null.</param> | ||
|  |     public static void StopMRecAutoRefresh(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "stop MREC auto-refresh"); | ||
|  |         _MaxStopMRecAutoRefresh(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxUpdateMRecPosition(string adUnitIdentifier, string mrecPosition); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Updates the position of the MREC to the new position provided. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">The ad unit identifier of the MREC for which to update the position. Must not be null.</param> | ||
|  |     /// <param name="mrecPosition">A new position for the MREC. Must not be null.</param> | ||
|  |     public static void UpdateMRecPosition(string adUnitIdentifier, AdViewPosition mrecPosition) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "update MREC position"); | ||
|  |         _MaxUpdateMRecPosition(adUnitIdentifier, mrecPosition.ToSnakeCaseString()); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxUpdateMRecPositionXY(string adUnitIdentifier, float x, float y); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Updates the position of the MREC to the new coordinates provided. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">The ad unit identifier of the MREC for which to update the position. Must not be null.</param> | ||
|  |     /// <param name="x">The X coordinate (horizontal position) of the MREC relative to the top left corner of the screen.</param> | ||
|  |     /// <param name="y">The Y coordinate (vertical position) of the MREC relative to the top left corner of the screen.</param> | ||
|  |     /// <seealso cref="GetMRecLayout"> | ||
|  |     /// The MREC is placed within the safe area of the screen. You can use this to get the absolute position Rect of the MREC on screen. | ||
|  |     /// </seealso> | ||
|  |     public static void UpdateMRecPosition(string adUnitIdentifier, float x, float y) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "update MREC position"); | ||
|  |         _MaxUpdateMRecPositionXY(adUnitIdentifier, x, y); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxShowMRec(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Show MREC at a position determined by the 'CreateMRec' call. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC to show. Must not be null.</param> | ||
|  |     public static void ShowMRec(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "show MREC"); | ||
|  |         _MaxShowMRec(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxDestroyMRec(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Remove MREC from the ad view and destroy it. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC to destroy. Must not be null.</param> | ||
|  |     public static void DestroyMRec(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "destroy MREC"); | ||
|  |         _MaxDestroyMRec(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxHideMRec(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Hide MREC. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC to hide. Must not be null.</param> | ||
|  |     public static void HideMRec(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "hide MREC"); | ||
|  |         _MaxHideMRec(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetMRecExtraParameter(string adUnitIdentifier, string key, string value); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set an extra parameter for the MREC ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC to set the extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the extra parameter.</param> | ||
|  |     public static void SetMRecExtraParameter(string adUnitIdentifier, string key, string value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set MREC extra parameter"); | ||
|  |         _MaxSetMRecExtraParameter(adUnitIdentifier, key, value); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetMRecLocalExtraParameter(string adUnitIdentifier, string key, IntPtr value); | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetMRecLocalExtraParameterJSON(string adUnitIdentifier, string key, string json); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set a local extra parameter for the MREC ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC to set the local extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the local extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the local extra parameter. Accepts the following types: <see cref="IntPtr"/>, <c>null</c>, <c>IList</c>, <c>IDictionary</c>, <c>string</c>, primitive types</param> | ||
|  |     public static void SetMRecLocalExtraParameter(string adUnitIdentifier, string key, object value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set MREC local extra parameter"); | ||
|  | 
 | ||
|  |         if (value == null || value is IntPtr) | ||
|  |         { | ||
|  |             var intPtrValue = value == null ? IntPtr.Zero : (IntPtr) value; | ||
|  |             _MaxSetMRecLocalExtraParameter(adUnitIdentifier, key, intPtrValue); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             _MaxSetMRecLocalExtraParameterJSON(adUnitIdentifier, key, SerializeLocalExtraParameterValue(value)); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetMRecCustomData(string adUnitIdentifier, string value); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// The custom data to tie the showing MREC ad to, for ILRD and rewarded postbacks via the <c>{CUSTOM_DATA}</c> macro. Maximum size is 8KB. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">MREC Ad unit identifier of the banner to set the custom data for. Must not be null.</param> | ||
|  |     /// <param name="customData">The custom data to be set.</param> | ||
|  |     public static void SetMRecCustomData(string adUnitIdentifier, string customData) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set MREC custom data"); | ||
|  |         _MaxSetMRecCustomData(adUnitIdentifier, customData); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern string _MaxGetMRecLayout(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// The MREC position on the screen. When setting the banner position via <see cref="CreateMRec(string, float, float)"/> or <see cref="UpdateMRecPosition(string, float, float)"/>, | ||
|  |     /// the banner is placed within the safe area of the screen. This returns the absolute position of the MREC on screen. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the MREC for which to get the position on screen. Must not be null.</param> | ||
|  |     /// <returns>A <see cref="Rect"/> representing the banner position on screen.</returns> | ||
|  |     public static Rect GetMRecLayout(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "get MREC layout"); | ||
|  |         var positionRect = _MaxGetMRecLayout(adUnitIdentifier); | ||
|  |         return GetRectFromString(positionRect); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region Interstitials | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxLoadInterstitial(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Start loading an interstitial. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the interstitial to load. Must not be null.</param> | ||
|  |     public static void LoadInterstitial(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "load interstitial"); | ||
|  |         _MaxLoadInterstitial(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsInterstitialReady(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Check if interstitial ad is loaded and ready to be displayed. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the interstitial ad to check if it's ready to be displayed. Must not be null.</param> | ||
|  |     /// <returns>True if the ad is ready to be displayed</returns> | ||
|  |     public static bool IsInterstitialReady(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "check interstitial loaded"); | ||
|  |         return _MaxIsInterstitialReady(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxShowInterstitial(string adUnitIdentifier, string placement, string customData); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Present loaded interstitial for a given placement to tie ad events to. Note: if the interstitial is not ready to be displayed nothing will happen. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the interstitial to load. Must not be null.</param> | ||
|  |     /// <param name="placement">The placement to tie the showing ad's events to</param> | ||
|  |     /// <param name="customData">The custom data to tie the showing ad's events to. Maximum size is 8KB.</param> | ||
|  |     public static void ShowInterstitial(string adUnitIdentifier, string placement = null, string customData = null) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "show interstitial"); | ||
|  | 
 | ||
|  |         if (IsInterstitialReady(adUnitIdentifier)) | ||
|  |         { | ||
|  |             _MaxShowInterstitial(adUnitIdentifier, placement, customData); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             MaxSdkLogger.UserWarning("Not showing MAX Ads interstitial: ad not ready"); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetInterstitialExtraParameter(string adUnitIdentifier, string key, string value); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set an extra parameter for the ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the interstitial to set the extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the extra parameter.</param> | ||
|  |     public static void SetInterstitialExtraParameter(string adUnitIdentifier, string key, string value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set interstitial extra parameter"); | ||
|  |         _MaxSetInterstitialExtraParameter(adUnitIdentifier, key, value); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetInterstitialLocalExtraParameter(string adUnitIdentifier, string key, IntPtr value); | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetInterstitialLocalExtraParameterJSON(string adUnitIdentifier, string key, string json); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set a local extra parameter for the ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the interstitial to set the local extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the local extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the local extra parameter. Accepts the following types: <see cref="IntPtr"/>, <c>null</c>, <c>IList</c>, <c>IDictionary</c>, <c>string</c>, primitive types</param> | ||
|  |     public static void SetInterstitialLocalExtraParameter(string adUnitIdentifier, string key, object value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set interstitial local extra parameter"); | ||
|  | 
 | ||
|  |         if (value == null || value is IntPtr) | ||
|  |         { | ||
|  |             var intPtrValue = value == null ? IntPtr.Zero : (IntPtr) value; | ||
|  |             _MaxSetInterstitialLocalExtraParameter(adUnitIdentifier, key, intPtrValue); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             _MaxSetInterstitialLocalExtraParameterJSON(adUnitIdentifier, key, SerializeLocalExtraParameterValue(value)); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region App Open Ads | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxLoadAppOpenAd(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Start loading an app open ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the app open ad to load. Must not be null.</param> | ||
|  |     public static void LoadAppOpenAd(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "load app open ad"); | ||
|  |         _MaxLoadAppOpenAd(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsAppOpenAdReady(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Check if app open ad ad is loaded and ready to be displayed. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the app open ad ad to check if it's ready to be displayed. Must not be null.</param> | ||
|  |     /// <returns>True if the ad is ready to be displayed</returns> | ||
|  |     public static bool IsAppOpenAdReady(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "check app open ad loaded"); | ||
|  |         return _MaxIsAppOpenAdReady(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxShowAppOpenAd(string adUnitIdentifier, string placement, string customData); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Present loaded app open ad for a given placement to tie ad events to. Note: if the app open ad is not ready to be displayed nothing will happen. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the app open ad to load. Must not be null.</param> | ||
|  |     /// <param name="placement">The placement to tie the showing ad's events to</param> | ||
|  |     /// <param name="customData">The custom data to tie the showing ad's events to. Maximum size is 8KB.</param> | ||
|  |     public static void ShowAppOpenAd(string adUnitIdentifier, string placement = null, string customData = null) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "show app open ad"); | ||
|  | 
 | ||
|  |         if (IsAppOpenAdReady(adUnitIdentifier)) | ||
|  |         { | ||
|  |             _MaxShowAppOpenAd(adUnitIdentifier, placement, customData); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             MaxSdkLogger.UserWarning("Not showing MAX Ads app open ad: ad not ready"); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetAppOpenAdExtraParameter(string adUnitIdentifier, string key, string value); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set an extra parameter for the ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the app open ad to set the extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the extra parameter.</param> | ||
|  |     public static void SetAppOpenAdExtraParameter(string adUnitIdentifier, string key, string value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set app open ad extra parameter"); | ||
|  |         _MaxSetAppOpenAdExtraParameter(adUnitIdentifier, key, value); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetAppOpenAdLocalExtraParameter(string adUnitIdentifier, string key, IntPtr value); | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetAppOpenAdLocalExtraParameterJSON(string adUnitIdentifier, string key, string json); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set a local extra parameter for the ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the app open ad to set the local extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the local extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the local extra parameter. Accepts the following types: <see cref="IntPtr"/>, <c>null</c>, <c>IList</c>, <c>IDictionary</c>, <c>string</c>, primitive types</param> | ||
|  |     public static void SetAppOpenAdLocalExtraParameter(string adUnitIdentifier, string key, object value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set app open ad local extra parameter"); | ||
|  | 
 | ||
|  |         if (value == null || value is IntPtr) | ||
|  |         { | ||
|  |             var intPtrValue = value == null ? IntPtr.Zero : (IntPtr) value; | ||
|  |             _MaxSetAppOpenAdLocalExtraParameter(adUnitIdentifier, key, intPtrValue); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             _MaxSetAppOpenAdLocalExtraParameterJSON(adUnitIdentifier, key, SerializeLocalExtraParameterValue(value)); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region Rewarded | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxLoadRewardedAd(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Start loading an rewarded ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the rewarded ad to load. Must not be null.</param> | ||
|  |     public static void LoadRewardedAd(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "load rewarded ad"); | ||
|  |         _MaxLoadRewardedAd(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsRewardedAdReady(string adUnitIdentifier); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Check if rewarded ad ad is loaded and ready to be displayed. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the rewarded ad to check if it's ready to be displayed. Must not be null.</param> | ||
|  |     /// <returns>True if the ad is ready to be displayed</returns> | ||
|  |     public static bool IsRewardedAdReady(string adUnitIdentifier) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "check rewarded ad loaded"); | ||
|  |         return _MaxIsRewardedAdReady(adUnitIdentifier); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxShowRewardedAd(string adUnitIdentifier, string placement, string customData); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Present loaded rewarded ad for a given placement to tie ad events to. Note: if the rewarded ad is not ready to be displayed nothing will happen. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the interstitial to load. Must not be null.</param> | ||
|  |     /// <param name="placement">The placement to tie the showing ad's events to</param> | ||
|  |     /// <param name="customData">The custom data to tie the showing ad's events to. Maximum size is 8KB.</param> | ||
|  |     public static void ShowRewardedAd(string adUnitIdentifier, string placement = null, string customData = null) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "show rewarded ad"); | ||
|  | 
 | ||
|  |         if (IsRewardedAdReady(adUnitIdentifier)) | ||
|  |         { | ||
|  |             _MaxShowRewardedAd(adUnitIdentifier, placement, customData); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             MaxSdkLogger.UserWarning("Not showing MAX Ads rewarded ad: ad not ready"); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetRewardedAdExtraParameter(string adUnitIdentifier, string key, string value); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set an extra parameter for the ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the rewarded ad to set the extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the extra parameter.</param> | ||
|  |     public static void SetRewardedAdExtraParameter(string adUnitIdentifier, string key, string value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set rewarded extra parameter"); | ||
|  |         _MaxSetRewardedAdExtraParameter(adUnitIdentifier, key, value); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetRewardedAdLocalExtraParameter(string adUnitIdentifier, string key, IntPtr value); | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetRewardedAdLocalExtraParameterJSON(string adUnitIdentifier, string key, string json); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set a local extra parameter for the ad. | ||
|  |     /// </summary> | ||
|  |     /// <param name="adUnitIdentifier">Ad unit identifier of the rewarded ad to set the local extra parameter for. Must not be null.</param> | ||
|  |     /// <param name="key">The key for the local extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the local extra parameter. Accepts the following types: <see cref="IntPtr"/>, <c>null</c>, <c>IList</c>, <c>IDictionary</c>, <c>string</c>, primitive types</param> | ||
|  |     public static void SetRewardedAdLocalExtraParameter(string adUnitIdentifier, string key, object value) | ||
|  |     { | ||
|  |         ValidateAdUnitIdentifier(adUnitIdentifier, "set rewarded ad local extra parameter"); | ||
|  | 
 | ||
|  |         if (value == null || value is IntPtr) | ||
|  |         { | ||
|  |             var intPtrValue = value == null ? IntPtr.Zero : (IntPtr) value; | ||
|  |             _MaxSetRewardedAdLocalExtraParameter(adUnitIdentifier, key, intPtrValue); | ||
|  |         } | ||
|  |         else | ||
|  |         { | ||
|  |             _MaxSetRewardedAdLocalExtraParameterJSON(adUnitIdentifier, key, SerializeLocalExtraParameterValue(value)); | ||
|  |         } | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region Event Tracking | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxTrackEvent(string name, string parameters); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Track an event using AppLovin. | ||
|  |     /// </summary> | ||
|  |     /// <param name="name">An event from the list of pre-defined events may be found in MaxEvents.cs as part of the AppLovin SDK framework. Must not be null.</param> | ||
|  |     /// <param name="parameters">A dictionary containing key-value pairs further describing this event.</param> | ||
|  |     public static void TrackEvent(string name, IDictionary<string, string> parameters = null) | ||
|  |     { | ||
|  |         _MaxTrackEvent(name, Json.Serialize(parameters)); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region Settings | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetMuted(bool muted); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set whether to begin video ads in a muted state or not. | ||
|  |     /// | ||
|  |     /// Please call this method after the SDK has initialized. | ||
|  |     /// </summary> | ||
|  |     /// <param name="muted"><c>true</c> if video ads should being in muted state.</param> | ||
|  |     public static void SetMuted(bool muted) | ||
|  |     { | ||
|  |         _MaxSetMuted(muted); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsMuted(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Whether video ads begin in a muted state or not. Defaults to <c>false</c>. | ||
|  |     /// | ||
|  |     /// Note: Returns <c>false</c> if the SDK is not initialized. | ||
|  |     /// </summary> | ||
|  |     /// <returns><c>true</c> if video ads begin in muted state.</returns> | ||
|  |     public static bool IsMuted() | ||
|  |     { | ||
|  |         return _MaxIsMuted(); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxSetVerboseLogging(bool enabled); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Toggle verbose logging of AppLovin SDK. If enabled AppLovin messages will appear in standard application log accessible via console. All log messages will have "AppLovinSdk" tag. | ||
|  |     /// </summary> | ||
|  |     /// <param name="enabled"><c>true</c> if verbose logging should be enabled.</param> | ||
|  |     public static void SetVerboseLogging(bool enabled) | ||
|  |     { | ||
|  |         _MaxSetVerboseLogging(enabled); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxIsVerboseLoggingEnabled(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     ///  Whether or not verbose logging is enabled. | ||
|  |     /// </summary> | ||
|  |     /// <returns><c>true</c> if verbose logging is enabled.</returns> | ||
|  |     public static bool IsVerboseLoggingEnabled() | ||
|  |     { | ||
|  |         return _MaxIsVerboseLoggingEnabled(); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxSetCreativeDebuggerEnabled(bool enabled); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Whether the creative debugger will be displayed on fullscreen ads after flipping the device screen down twice. Defaults to true. | ||
|  |     /// </summary> | ||
|  |     /// <param name="enabled"><c>true</c> if the creative debugger should be enabled.</param> | ||
|  |     public static void SetCreativeDebuggerEnabled(bool enabled) | ||
|  |     { | ||
|  |         _MaxSetCreativeDebuggerEnabled(enabled); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetTestDeviceAdvertisingIdentifiers(string[] advertisingIdentifiers, int size); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Enable devices to receive test ads, by passing in the advertising identifier (IDFA/GAID) of each test device. | ||
|  |     /// Refer to AppLovin logs for the IDFA/GAID of your current device. | ||
|  |     /// </summary> | ||
|  |     /// <param name="advertisingIdentifiers">String list of advertising identifiers from devices to receive test ads.</param> | ||
|  |     public static void SetTestDeviceAdvertisingIdentifiers(string[] advertisingIdentifiers) | ||
|  |     { | ||
|  |         if (IsInitialized()) | ||
|  |         { | ||
|  |             MaxSdkLogger.UserError("Test Device Advertising Identifiers must be set before SDK initialization."); | ||
|  |             return; | ||
|  |         } | ||
|  | 
 | ||
|  |         _MaxSetTestDeviceAdvertisingIdentifiers(advertisingIdentifiers, advertisingIdentifiers.Length); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern bool _MaxSetExceptionHandlerEnabled(bool enabled); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Whether or not the native AppLovin SDKs listen to exceptions. Defaults to <c>true</c>. | ||
|  |     /// </summary> | ||
|  |     /// <param name="enabled"><c>true</c> if the native AppLovin SDKs should not listen to exceptions.</param> | ||
|  |     public static void SetExceptionHandlerEnabled(bool enabled) | ||
|  |     { | ||
|  |         _MaxSetExceptionHandlerEnabled(enabled); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetExtraParameter(string key, string value); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Set an extra parameter to pass to the AppLovin server. | ||
|  |     /// </summary> | ||
|  |     /// <param name="key">The key for the extra parameter. Must not be null.</param> | ||
|  |     /// <param name="value">The value for the extra parameter. May be null.</param> | ||
|  |     public static void SetExtraParameter(string key, string value) | ||
|  |     { | ||
|  |         HandleExtraParameter(key, value); | ||
|  | 
 | ||
|  |         _MaxSetExtraParameter(key, value); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern IntPtr _MaxGetSafeAreaInsets(); | ||
|  | 
 | ||
|  |     /// <summary> | ||
|  |     /// Get the native insets in pixels for the safe area. | ||
|  |     /// These insets are used to position ads within the safe area of the screen. | ||
|  |     /// </summary> | ||
|  |     public static SafeAreaInsets GetSafeAreaInsets() | ||
|  |     { | ||
|  |         // Use an int array instead of json serialization for performance | ||
|  |         var insetsPtr = _MaxGetSafeAreaInsets(); | ||
|  |         var insets = new int[4]; | ||
|  |         Marshal.Copy(insetsPtr, insets, 0, 4); | ||
|  | 
 | ||
|  |         // Convert from points to pixels | ||
|  |         var screenDensity = MaxSdkUtils.GetScreenDensity(); | ||
|  |         for (var i = 0; i < insets.Length; i++) | ||
|  |         { | ||
|  |             insets[i] *= (int) screenDensity; | ||
|  |         } | ||
|  | 
 | ||
|  |         return new SafeAreaInsets(insets); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region Private | ||
|  | 
 | ||
|  |     [MonoPInvokeCallback(typeof(ALUnityBackgroundCallback))] | ||
|  |     internal static void BackgroundCallback(string propsStr) | ||
|  |     { | ||
|  |         HandleBackgroundCallback(propsStr); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  |     #region Obsolete | ||
|  | 
 | ||
|  |     [Obsolete("This API has been deprecated and will be removed in a future release. Please use CreateBanner(string adUnitIdentifier, AdViewConfiguration configuration) instead.")] | ||
|  |     public static void CreateBanner(string adUnitIdentifier, BannerPosition bannerPosition) | ||
|  |     { | ||
|  |         // AdViewPosition and BannerPosition share identical enum values, so casting is safe | ||
|  |         CreateBanner(adUnitIdentifier, new AdViewConfiguration((AdViewPosition) bannerPosition)); | ||
|  |     } | ||
|  | 
 | ||
|  |     [Obsolete("This API has been deprecated and will be removed in a future release. Please use CreateBanner(string adUnitIdentifier, AdViewConfiguration configuration) instead.")] | ||
|  |     public static void CreateBanner(string adUnitIdentifier, float x, float y) | ||
|  |     { | ||
|  |         CreateBanner(adUnitIdentifier, new AdViewConfiguration(x, y)); | ||
|  |     } | ||
|  | 
 | ||
|  |     [Obsolete("This API has been deprecated and will be removed in a future release. Please use UpdateBannerPosition(string adUnitIdentifier, AdViewPosition bannerPosition) instead.")] | ||
|  |     public static void UpdateBannerPosition(string adUnitIdentifier, BannerPosition bannerPosition) | ||
|  |     { | ||
|  |         // AdViewPosition and BannerPosition share identical enum values, so casting is safe | ||
|  |         UpdateBannerPosition(adUnitIdentifier, (AdViewPosition) bannerPosition); | ||
|  |     } | ||
|  | 
 | ||
|  |     [Obsolete("This API has been deprecated and will be removed in a future release. Please use CreateMRec(string adUnitIdentifier, AdViewConfiguration configuration) instead.")] | ||
|  |     public static void CreateMRec(string adUnitIdentifier, AdViewPosition mrecPosition) | ||
|  |     { | ||
|  |         CreateMRec(adUnitIdentifier, new AdViewConfiguration(mrecPosition)); | ||
|  |     } | ||
|  | 
 | ||
|  |     [Obsolete("This API has been deprecated and will be removed in a future release. Please use CreateMRec(string adUnitIdentifier, AdViewConfiguration configuration) instead.")] | ||
|  |     public static void CreateMRec(string adUnitIdentifier, float x, float y) | ||
|  |     { | ||
|  |         CreateMRec(adUnitIdentifier, new AdViewConfiguration(x, y)); | ||
|  |     } | ||
|  | 
 | ||
|  |     [DllImport("__Internal")] | ||
|  |     private static extern void _MaxSetSdkKey(string sdkKey); | ||
|  | 
 | ||
|  |     [Obsolete("This API has been deprecated and will be removed in a future release. Please set your SDK key in the AppLovin Integration Manager.")] | ||
|  |     public static void SetSdkKey(string sdkKey) | ||
|  |     { | ||
|  |         _MaxSetSdkKey(sdkKey); | ||
|  |         Debug.LogWarning("MaxSdk.SetSdkKey() has been deprecated and will be removed in a future release. Please set your SDK key in the AppLovin Integration Manager."); | ||
|  |     } | ||
|  | 
 | ||
|  |     #endregion | ||
|  | 
 | ||
|  | #endif | ||
|  | } |