Documentation

Support

APS migration guide

Migrate to APS Ad Units APIs with LevelPlay for iOS, utilizing the Ad Units APIs for existing APS integrations.
Read time 2 minutesLast updated 2 days ago

This guide provides step-by-step instructions on integrating the Amazon Publisher Services (APS) network with LevelPlay, utilizing the Ad Units APIs for existing APS integrations. Min SDK Version: 8.8.0+

Step 1: Verify and download your APS configuration

  1. Navigate to your APS account.
  2. Download the CSV configuration file, for the relevant application.
  3. 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

  1. Go to the instance page for your desired app within the LevelPlay platform.
  2. Update the APS settings by uploading your downloaded CSV configuration file. Click the "Replace" button.
  3. 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. Download APS adapter

Add APS adapter manually

Download the XCFramework file and unzip it. Drag and drop the ISAPSAdapter.xcframework folder into your Xcode project and add it to the relevant target. Make sure to remove any prior references to an APS adapter from the podfile.

Add APS SDK dependencies

Add the APS SDK dependency to the podfile.
pod 'AmazonPublisherServicesSDK', '5.2.0'
For more details on APS integration, please refer to the APS Resources for iOS.

Step 5. Update SKAdNetworkItems and Info.plist

Make sure to define APS SKAdNetworkItems to your Info.plist, by using this code:
<key>SKAdNetworkItems</key><array><dict><key>SKAdNetworkIdentifier</key><string>p78axxw29g.skadnetwork</string></dict></array>

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 APS App ID, defined in Step 2 of the APS setup. Objective-C:
[[DTBAds sharedInstance] setAppKey: @"APS_app_id"];
Swift:
DTBAds.sharedInstance().setAppKey("APS_app_id")

Step 7. Remove Prior Load Logic

This adapter no longer requires sharing APS bid info with LevelPlay mediation. Please remove the following code:
  1. The loading of the APS ad request before each ad unit load.
  2. The calling of setNetworkData to share the APS bid info with LevelPlay.

Troubleshooting Build Issues

Make sure your target minimum iOS version is set to 12.0.