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

1. Download：https://pub-block.s3.ap-east-1.amazonaws.com/base/202306/4fd9e3ee1bfc0c6b.zip

2. Unzip the SDK frameworks, then import the following frameworks into your Xcode project:

   • Adx3Framework.framework

3. 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)

Swift

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)
    }
}

Objective-C

#import "Adx3Framework/Adx3Ad.h"

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [[Adx3AdManager sharedManager] initWithAppId:@"Your App ID" success:^(BOOL isSuccess) {
       //result handler
    }];
    return YES;
}

- (void)applicationDidBecomeActive:(UIApplication *)application {
    [[Adx3AdManager sharedManager] applicationDidBecomeActive:application];
}

- (void)applicationDidEnterBackground:(UIApplication *)application {
    [[Adx3AdManager sharedManager] applicationDidEnterBackground:application];
}

@end

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.

Implement an App Open Ads

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.

Implement an Interstitial

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.

Implement a Banner

Rewarded

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

Implement a Rewarded

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.

Implement a Native

Multiple

Ads customized for lists or waterfall layouts

Implement a Multiple