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.

Option 1 — Server-side activation (recommended for first integrations)

Bidease can enable Test Mode per bundle. 👉 Contact your Bidease manager to activate or deactivate it during QA.

Option 2 — Code activation (publisher-side)

Add additional pod to enable test ads:

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

⚠️ Important:

  • 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 8 days ago