Ad adapter for Amazon Publisher Services, to be utilized along the APS Unity Plugin.
This package is meant to be integrating when using Amazon Publisher Services as an ad adapter.
Using the public npm registry
In order to add the Chartboost Mediation Unity SDK - AmazonPublisherServices Adapter to your project using the npm package, add the following to your Unity Project's manifest.json file. The scoped registry section is required in order to fetch packages from the NpmJS registry.
"dependencies": {
"com.chartboost.mediation.unity.aps": "4.0.1",
...
},
"scopedRegistries": [
{
"name": "NpmJS",
"url": "https://registry.npmjs.org",
"scopes": [
"com.chartboost"
]
}
]Using the public NuGet package
To add the Chartboost Mediation Unity SDK - AmazonPublisherServices Adapter to your project using the NuGet package, you will first need to add the NugetForUnity package into your Unity Project.
This can be done by adding the following to your Unity Project's manifest.json
"dependencies": {
"com.github-glitchenzo.nugetforunity": "https://github.com/GlitchEnzo/NuGetForUnity.git?path=/src/NuGetForUnity",
...
},Once NugetForUnity is installed, search for Chartboost.CSharp.Mediation.Unity.Adapter.AmazonPublisherServices in the search bar of Nuget Explorer window(Nuget -> Manage Nuget Packages).
You should be able to see the Chartboost.CSharp.Mediation.Unity.Adapter.AmazonPublisherServices package. Choose the appropriate version and install.
A demo application is available in the following repository.
Note
We recommend to deleteAssets/Amazon/Scripts/Editor/AmazonDependencies.xmland use theAmazonPublisherServicesAdapterDependencies.xmlfile included in the APS Adapter.
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"/>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:
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;
}
}// 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);
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent