Getting Started Guide
Get Started
To display Adx3 ads, the first step is to integrate the Adx3 Mobile Ads SDK into the app. After integrating the ad SDK, you can continue to implement one or more supported ad formats.
Prerequisites
Use Xcode 13.4.1 or higher
Target iOS 10.0 or higher
Recommendation: Management terminal background application SDK and advertising slot ID
Import the Mobile Ads SDK
Unzip the SDK frameworks, then import the following frameworks into your Xcode project:
Adx3Framework.framework
Add the
-ObjC
linker flag to Other Linker Flags in your project's build settings:
Update your Info.plist
Update your app'sInfo.plist
file to add the following key:
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
Initialize the Mobile Ads SDK
Before loading the ad, please call the initWithAppId:(NSString *)appId success:(isSuccess)success method on [Adx3AdManager sharedManager]. This method will initialize the SDK, and after the initialization is complete, call back the result of the initialization. This only needs to be done once, preferably at the app startup. It is recommended that you call initWithAppId:(NSString *)appId success:(isSuccess)success as early as possible The following example shows how to call the initWithAppId:initWithAppId: (NSString *)appId success:(isSuccess)success method in the Applegate
Example AppDelegate.m (excerpt)
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
Adx3AdManager.shared().initWithAppId("Your App ID") { isSuccess in
//result handler
}
// Override point for customization after application launch.
return true
}
func applicationDidBecomeActive(_ application: UIApplication) {
Adx3AdManager.shared().applicationDidBecomeActive(application)
}
func applicationDidEnterBackground(_ application: UIApplication) {
Adx3AdManager.shared().applicationDidEnterBackground(application)
}
}
Select an ad format
App Open

App open ads are a special ad format for publishers who want to load ads on app launch. Users can close the open-screen advertisement at any time.
Interstitial

The full-screen ad covers the app UI until dismissed by the user. They are best displayed at natural pauses in the app's execution flow, such as between game levels or after the user has just completed a task.
Banner

Rectangular ads that appear at the top or bottom of a device's screen. Banner ads stay on the screen while the user interacts with the app and can automatically refresh after a period of time.
Rewarded

Ads that reward users for watching short videos and interacting with playable ads and surveys. Good for monetizing free-to-play users.
Native

Customizable ads that match the look and feel of your app. You decide how and where they're placed, so the layout is more consistent with your app's design.
Multiple

Ads customized for lists or waterfall layouts
Last updated