Guides
Start typing to search…

iOS

1. SDK Integration

To integrate the Bidease SDK into your Xcode project using CocoaPods, add the following to your Podfile:

platform :ios, '12.0'
target 'MyAppTarget' do
  use_frameworks!

  pod 'BideaseSDK/AppLovinMaxAdapter'
end

Then run the following commands in your macOS terminal (or via CocoaPods.app):

$ cd path_to_Podfile
$ pod update

⚠️ Make sure to always use the latest available SDK versions from Bidease.


Test mode

Once you’ve implemented the SDK, you can test ads before release.

Add additional pod to enable test ads:

pod 'BideaseSDK/AppLovinMaxAdapter'
pod 'BideaseSDK/TestMode'

⚠️ Important:

  • Test on US geo during QA to ensure proper ad delivery and fill rates.
  • Test Mode provides nearly 100% fill for QA testing, but must be disabled before submitting the app to the store.
  • Ensure IDFA/GAID tracking is enabled during QA so the Bidease team can review logs and assist with troubleshooting if needed.

2. Add Required Keys

In your Xcode project settings, navigate to: YourProject ➡️ Info ➡️ Custom iOS Target Properties. Right-click on any row in the table and choose Show Raw Keys/Values. Then add the following:

  1. Add the key NSUserTrackingUsageDescription with the value: Your data will be used to deliver personalized ads to you.
  2. Add the key LSApplicationQueriesSchemes as an array with the following values: fb, instagram, tumblr, twitter, itms-app, itms-apps, itms-appss
  3. Locate the key NSAppTransportSecurity:
    1. If it doesn’t exist, create it.
    2. Expand the section (triangle icon) and add these subkeys:
      1. NSAllowsArbitraryLoads → YES
      2. NSAllowsArbitraryLoadsForMedia → YES
      3. NSAllowsArbitraryLoadsInWebContent → YES
  4. Add SKAdNetworkItem identifiers into the SKAdNetworkItems array. You can copy the required identifiers from the following file: SKAdNetworkItems.

The final setup in your Info.plist should look similar to the example below:

3. Add Custom SDK Network

In your MAX Dashboard, go to Mediation ➡️ Manage ➡️ Networks. Scroll to the bottom of the page and click Click here to add a Custom Network.

Fill in the fields as follows:

  • Network Type: choose SDK.
  • Name: Bidease
  • iOS Adapter Class Name: BideaseConnectAppLovinMaxAdapter

Press Save to create the SDK network.

4. Manage ads

Log in to your MAX account and navigate to: MAX ➡️ Manage ➡️ Ad Units. Select the ad unit where you want to enable Bidease.

In the Custom Networks section choose Custom Network (SDK) – Bidease and enable the Status toggle.

Configure the fields as follows:

  • Placement ID: use the format AdFormat_ecpm_X.X , where ecpm is the required separator and X.X is the floor price value (any number).
    • Example: Interstitial_ecpm_1.3 ➡️ floor price = $1.3
    • Example: Banner_ecpm_0.5 ➡️ floor price = $0.5
  • CPM Price: enter the same floor price as in the Placement ID.
  • Custom Parameters: leave blank.
  • App ID: leave blank.

Please allow 30–60 minutes for changes to take effect.

Next steps


Updated 11 days ago