Integrate Ad Quality SDK for iOS

Integrate the Ad Quality SDK into your iOS app to monitor and analyze ad performance, and initialize it with your app key.

읽는 시간 3분

최근 업데이트: 4달 전

Ad Quality helps you monitor and control the ad content your users see, so you can ensure it aligns with your app's goals and enhances user experience. Maximize your revenue potential while serving relevant ads that engage your audience.

참고

Starting with version 8.9.0, Ad Quality is integrated into the LevelPlay SDK and automatically initializes when LevelPlay is implemented. The steps outlined below apply if LevelPlay is not implemented in the build or if you are using a LevelPlay SDK version earlier than 8.9.0.

Prerequisites

Follow our step-by-step guide and configure your application in the LevelPlay platform

Step 1: Import the Ad Quality SDK to your app

CocoaPods

CocoaPods is a dependency manager for Objective-C and Swift; it automates and simplifies the SDK integration process. Refer to the CocoaPods Guide on Getting Started and Using CocoaPods for more information. To integrate our SDK with Cocoapods, enter the following line in your podfile:


pod 'IronSourceAdQualitySDK','9.3.1'

Step 2: Initialize the SDK

Initialize the Ad Quality SDK using your ironSource app key, which can be found in the Unity LevelPlay Platform.
Add the following code to your app's main thread, or on the same thread as your other ad network SDKs to initialize the Ad Quality SDK:

Add the following code to the viewDidLoad method of your main ViewController:


#import "IronSourceAdQuality.h" @implementation ViewController - (void)viewDidLoad {     [super viewDidLoad];     // Initialize     [[IronSourceAdQuality getInstance] initializeWithAppKey:appKey]; } @end

Step 3 (optional): Advanced SDK Initialization

참고

To use the configuration below – initialize Ad Quality SDK before initializing LevelPlay SDK.

Customize your integration settings to get even more functionality with these special configurations:

User ID: Use your own user IDs, instead of the default IDs from Ad Quality
Test mode: Test your Ad Quality SDK integration (default is false)
Log level: Choose a log level to debug code issues (default is INFO)

Use the code below to create your config object with a builder.


ISAdQualityConfig *adQualityConfig = [ISAdQualityConfig config];

User ID

The Ad Quality SDK provides two options for configuring your user IDs:

Use your own user IDs, and add them before or during initialization:


adQualityConfig.userId = userId;// The default user id is Ad Quality internal id.// The user id cannot be null and must be between 2 and 100 characters, otherwise it will be blocked.

Change the default user IDs after initializing the Ad Quality SDK, for cases for your ID's are set later.


[[IronSourceAdQuality getInstance] changeUserId:userId];// The default user id is Ad Quality internal id. // The user id cannot be null and must be between 2 and 100 characters, otherwise it will be blocked.

Test Mode


adQualityConfig.testMode = YES;// The default is NO - set to true only to test your Ad Quality integration

Log level


adQualityConfig.logLevel = IS_AD_QUALITY_LOG_LEVEL_INFO;// There are 5 different log levels:// IS_AD_QUALITY_LOG_LEVEL_ERROR,// IS_AD_QUALITY_LOG_LEVEL_WARNING,// IS_AD_QUALITY_LOG_LEVEL_INFO,// IS_AD_QUALITY_LOG_LEVEL_DEBUG,// IS_AD_QUALITY_LOG_LEVEL_VERBOSE// The default is IS_AD_QUALITY_LOG_LEVEL_INFO[[IronSourceAdQuality getInstance] initializeWithAppKey:appKey andConfig:adQualityConfig];

Step 4 (optional): Configure SDK callback events

참고

If you're using LevelPlay make sure you've init Ad Quality first to use the following functionalities.

In the same place where the Ad Quality SDK was initialized, implement iOS callbacks in a separate class. ISAdQualityInitDelegate:


#import "IronSourceAdQuality.h"@interface ViewController () : NSObject<ISAdQualityInitDelegate>@end@implementation ViewController- (void)viewDidLoad {  [super viewDidLoad];  ISAdQualityConfig *config = [ISAdQualityConfig config];  [config setAdQualityInitDelegate:self];  // Initialize  [[IronSourceAdQuality getInstance] initializeWithAppKey:appKey  andConfig:config];}- (void)adQualitySdkInitSuccess {   NSLog(@"adQualitySdkInitSuccess");}- (void)adQualitySdkInitFailed:(ISAdQualityInitError) error withMessage:(NSString *)message {   NSLog(@"adQualitySdkInitFailed %u message: %@", error, message);}@end

참고

The time it takes s to initialize the Ad Quality SDK depends on the number of ad network SDKs integrated into your app. Network connectivity issues may also cause delays. On average, initializations take between 3 to 4 seconds.

Step 5 (optional): Report impression-level ad revenue to Ad Quality SDK

참고

If you're using LevelPlay make sure you've init Ad Quality first to use the following functionalities

참고

The feature is support for fullscreen ads only. For LevelPlay, MAX and DT FairBid this data is being collected automatically

Ad Quality SDK 7.2.0+ supports impression-level ad revenue report: To report Impression-level ad revenue in the Ad Quality SDK, add the code snippet below to your SDK integration.

중요

sendCustomMediationRevenue

method should be called when the ad displayed, calling it out of ad lifecycle have no affect


 ISAdQualityCustomMediationRevenue *customMediationRevenue = [[ISAdQualityCustomMediationRevenue alloc] init];   customMediationRevenue.mediationNetwork = IS_AD_QUALITY_MEDIATION_NETWORK_SELF_MEDIATED;   customMediationRevenue.adType = IS_AD_QUALITY_AD_TYPE_REWARDED;   customMediationRevenue.placement = "placement";   customMediationRevenue.revenue = 0.12;   [[IronSourceAdQuality getInstance] sendCustomMediationRevenue:customMediationRevenue];

If you're using AdMob mediation, follow these steps:

Ask your AdMob account manager to enable AdMob impression-level LTV (iLTV)
Verify that you use GMA SDK 8.12.0 or higher for Android or iOS and that the version supports iLTV
Add the following code snippet to your Ad Quality SDK integration:


GADRewardedAd* rewardedAd;[GADRewardedAd loadWithAdUnitID:@"AD_UNIT_ID"request:requestcompletionHandler:^(GADRewardedAd *ad, NSError *error) {   if (error) {     NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);     return;   }   self.rewardedAd = ad;   self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull adValue){   ISAdQualityCustomMediationRevenue *customMediationRevenue = [[ISAdQualityCustomMediationRevenue alloc] init];   customMediationRevenue.mediationNetwork = IS_AD_QUALITY_MEDIATION_NETWORK_ADMOB;   customMediationRevenue.adType = IS_AD_QUALITY_AD_TYPE_REWARDED;   customMediationRevenue.placement = [rewardedAd adUnitID];   customMediationRevenue.revenue = adValue.value.doubleValue;   [[IronSourceAdQuality getInstance] sendCustomMediationRevenue:customMediationRevenue];  }}];

기술 자료

Development

User Acquisition

Monetization

산업 분야