APS migration guide
Migrate to APS Ad Units APIs with LevelPlay for Unity, utilizing the Ad Units APIs for existing APS integrations.
Read time 2 minutesLast updated 4 hours ago
Important
The following documentation discusses products or services (“Third-party Products”) not developed, owned, or operated by Unity.
This information might be outdated or incomplete and is provided for your convenience.
Your use of any Third-party Product is subject to its own terms.
Unity makes no warranties regarding these products and isn't liable for any damages or losses arising from their use, including issues related to content, advertising, or materials from Third-party providers.
Step 1: Verify and download your APS configuration
- Navigate to your APS account.
- Download the CSV configuration file, for the relevant application.
- Before downloading, make any necessary changes to the configuration. You can always return to your APS account to make further changes.
Step 2: Update the APS settings on the LevelPlay platform
- Go to the instance page for your desired app within the LevelPlay platform.
- Update the APS settings by uploading your downloaded CSV configuration file. Click the "Replace" button.
- The APS app settings page interface will refresh.
Step 3: Update APS data in LevelPlay dashboard
- Note that the "Slot Name," "Price Points," and "Size" fields are automatically populated.
- Fill in the following fields for each Slot Name:
- UUID
- APS Format
- Size
- You may need to refer to the APS site to obtain this information.
- After completing the UUID, APS Format, and Size fields, click the "SAVE" button.
Step 4. Import the APS Unity plugin
- Download the APS Unity plugin from the APS website.
- Make sure your Unity project is opened and import the package.
- In the Unity menu bar, select Amazon, then Manage SDKs to open the Amazon SDK manager:
- Do NOT install the ironSource adapter from APS
Step 5. Integrate the Android and iOS adapters manually
Replace dependency XML of APS
Add the custom version of ISAPSAdapterDependencies.xml to Assets > LevelPlay > Editor. If the integration already exists, first delete the file and then add the custom version. Do NOT use the LevelPlay Network Manager to integrate the APS dependencies.Step 6. Init APS SDK
The APS network requires that you initialize both the ironSource and APS SDKs to display APS ads. Initialize the APS SDK as soon as your application is opened and before initializing the ironSource SDK. Use the APS App ID defined in Step 2 of the APS setup.For more details on integration, please refer to the APS Resources for Unity.Amazon.Initialize(amazonApiKey);
Step 7. Remove Prior Load Logic
This adapter no longer requires sharing APS bid info with LevelPlay mediation. Please remove the following code:- The loading of the APS ad request before each ad unit load.
- The calling of setNetworkData to share the APS bid info with LevelPlay.
Troubleshooting Build Issues
-
If the APS adapter is not present in the Android build, please add the maven URL to the BuildConfig.java file under dependencyResolutionManagement.
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS) repositories { google() mavenCentral() maven { url "https://s3.amazonaws.com/ssa.public/ironsource-mobile/android-adapters" }}
- When building for iOS, make sure your target minimum iOS version is set to 12.0.