Chartboost.CSharp.Mediation.Unity.Adapter.AmazonPublisherServices 4.0.0

Amazon Publisher Services Unity Ad Adapter

Ad adapter for Amazon Publisher Services, to be utilized along the APS Unity Plugin.

Installation

This package is meant to be integrating when using Amazon Publisher Services as an ad adapter.

"dependencies": {
    "com.chartboost.mediation.unity.aps": "1.0.0",
    ...
},
"scopedRegistries": [
{
    "name": "NpmJS",
    "url": "https://registry.npmjs.org",
    "scopes": [
    "com.chartboost"
    ]
}
]

Demo App

A demo application is available in the followingrepository.

Dependencies

Note
We recommend to delete Assets/Amazon/Scripts/Editor/AmazonDependencies.xml and use the AmazonPublisherServicesAdapterDependencies.xml file included in the APS Adapter.

Using AmazonDependencies.xml and Adding AmazonPublisherServicesSDK to All Targets

In some scenarios your application might fail to load the AmazonPublisherServicesSDK, this is due to the default dependency included in the APS Unity plugin not adding the AmazonPublisherServicesSDK addToAllTargets flag.

To resolve, open, Assets/Amazon/Scripts/Editor/AmazonDependencies.xml

And change:

<iosPod name="AmazonPublisherServicesSDK" version="~> 4.7.2"/>

to

<iosPod name="AmazonPublisherServicesSDK" version="~> 4.7.2" addToAllTargets="true"/>

Usage of AmazonPublisherServicesAdapter APIs

Chartboost is not permitted to wrap the Amazon APS initialization or bid request methods directly. The adapter handles APS initialization and prebidding only when the managed prebidding flag is enabled. For more information please contact the Amazon APS support team at https://aps.amazon.com/aps/contact-us/.

As such, developers are meant to follow the guidelines in the APS Unity Documentation.

In order to pass prebidding information back to the Chartboost Mediation Unity SDK we have provided the following example:

Creating a Pre-Bidding Listener

Developers will have to call the APS Plugin and pass the information to the Chartboost Mediation SDK, the PreBiddingListener can be used to organize your logic and easily pass the required data, see example below:

public class CustomAmazonPublisherServicesPreBiddingListener : PreBiddingListener
    {
        private const string TAG = "[APS PreBidding Listener]";
        
        public override Task<AmazonPublisherServicesAdapterPreBidAdInfo> OnPreBid(AmazonPublisherServicesAdapterPreBidRequest request)
        {
            AdRequest adRequest = null;
            var amazonSetting = request.AmazonSettings;
            var width = amazonSetting.Width ?? 0;
            var height = amazonSetting.Height ?? 0;
            var amazonPlacement = amazonSetting.PartnerPlacement;
                 
            Debug.Log($"{TAG} Format: {request.Format}, Chartboost Placement: {request.ChartboostPlacement}, Amazon Placement: {amazonPlacement}");

            switch (request.Format)
            {
                case "rewarded":
                    adRequest = new APSVideoAdRequest(width, height, amazonPlacement);
                    break;

                case "interstitial":
                case "rewarded_interstitial":
                    adRequest = new APSInterstitialAdRequest(amazonPlacement);
                    break;

                case "banner":
                case "adaptive_banner":
                    adRequest = new APSBannerAdRequest(width, height, amazonPlacement);
                    break;
                
                default:
                    Debug.LogWarning($"{TAG} Specified type is not valid, returning null values.");
                    return Task.FromResult(new AmazonPublisherServicesAdapterPreBidAdInfo(null, null));
            }

            var taskCompletionSource = new TaskCompletionSource<AmazonPublisherServicesAdapterPreBidAdInfo>();
            
            adRequest.onSuccess += response =>
            {
                Debug.Log($"{TAG} Response succeeded for: CBP: {request.ChartboostPlacement} - AMZP: {amazonPlacement}!");
                #if UNITY_IOS
                taskCompletionSource.SetResult(new AmazonPublisherServicesAdapterPreBidAdInfo(response.GetPricePoint(), response.GetMediationHints()));
                #elif UNITY_ANDROID
                taskCompletionSource.SetResult(new AmazonPublisherServicesAdapterPreBidAdInfo(response.GetPricePoint(), response.GetBidInfo()));
                #else
                taskCompletionSource.SetResult(new AmazonPublisherServicesAdapterPreBidAdInfo(null, null));   
                #endif
            };

            adRequest.onFailedWithError += error =>
            {
                Debug.LogError($"{TAG} Failed with Error: {error.GetMessage()} and Code: {error.GetCode()}");
                taskCompletionSource.SetResult(new AmazonPublisherServicesAdapterPreBidAdInfo(null, null));
            };

            adRequest.LoadAd();
            return taskCompletionSource.Task;
        }
    }

Setting the Pre-Bidding Listener

// Publisher Initializes the AmazonPubliserServices Unity Plugin
Amazon.Initialize("YOUR_AMAZON_API_KEY_GOES_HERE");

// Plugins + Adapter Can be configured as needed.
Amazon.EnableTesting(true);
Amazon.EnableLogging(true);
AmazonPublisherServicesAdapter.TestMode = true;
AmazonPublisherServicesAdapter.VerboseLogging = true;

// Create instance for your Custom Pre-Bidding Listener
AmazonPublisherServicesAdapter.PreBiddingListener = new CustomAmazonPublisherServicesPreBiddingListener();

// Initialize the Chartboost Mediation Unity SDK.
ChartboostMediation.StartWithOptions(ChartboostMediationSettings.AppId, ChartboostMediationSettings.AppSignature);