Native Ads

To integrate Native Ads, ensure you have integrated the DT Exchange IASDKCore Libraries. Configure the native ad spot, create an Ad Request, and then load the ad and map the assets to your native view components.

Importing the SDK

Import the following IASDKCore module into your desired view controller:

Objective-C

#import <IASDKCore/IASDKCore.h>

Creating the Ad Request Object

Initialize an IAAdRequest and provide the spotID and a timeout value:

Objective-C

IAAdRequest *adRequest =
[IAAdRequest build:^(id _Nonnull builder) {
    // Configure ad request if needed
	builder.spotID = @”NATIVE AD SPOT ID”;
	builder.timeout = 15;
}];

Declaring Your View Controller

Declare that your view controller conforms to the IANativeAdDelegate Protocol:

Objective-C

@interface ViewController() <IANativeAdDelegate>

For more information, see Unit Content Delegate Protocols.

Initializing the Placement

Initialize the IANativeAdSpot (placement) and pass your adRequest object:

Objective-C

nativeAdSpot = [IANativeAdSpot build:^(IANativeAdSpot *builder) {
  builder.adRequest = adRequest;
  builder.delegate = self;
  builder.userInfo = @{
    @"placementIdentifier" : parameters.thirdPartyAdPlacementIdentifier
  };  // Optional
}];

Fetching the Ad

Native Ads are available only through SDK Bidding. In SDK Bidding, DT Exchange must first generate a token for the Mediation SDK to use when sending the request to server.

Generating the Token

The token can be generated upon SDK initialization.

Objective-C

NSString *biddingToken = FMPBiddingManager.sharedInstance.biddingToken;

Return type: NSString *

If an error occurs, the returned value is nil.

Loading the Ad

If DT Exchange wins the auction, load the ad with the signaldata (adm) that was received from the server:

Objective-C

__weak typeof(self) weakSelf = self;
[self.nativeAdSpot
    loadAdWithMarkup:bidResponse
      withCompletion:^(IANativeAdAssets *nativeAdAssets, NSError *error) {
        if (nativeAdAssets != nil) {
          NSString *title = nativeAdAssets.adTitle;
          NSString *adDescription = nativeAdAssets.adDescription;
          NSString *callToActionText = nativeAdAssets.callToActionText;
          UIView *appIcon = nativeAdAssets.appIcon;
          UIView *mediaView = nativeAdAssets.mediaView;
          NSString *advertiserName = nativeAdAssets.advertiserName;
          NSNumber *rating = nativeAdAssets.rating;
          NSNumber *mediaAspectRatio = nativeAdAssets.mediaAspectRatio;
        } else if (error != nil) {
          NSLog(@"Error: %@", error);
        }
      }];

For a complete list of Native Ads asset types, see the oRTB Specfication for Native Ads.

Registering Views for Interaction

You must register the views that will respond to user interaction, such as clicks. It is recommended to use the provided ViewTag enumeration for mapping views.

Objective-C

@objc public enum ViewTag: Int {
    case title = 1
    case mediaView = 2 // both main image and video share this tag
    case icon = 4
    case description = 5
    case rating = 6
    case cta = 7
    case root = 8
}

After setting the tags on your views, register them with the ad assets:

Objective-C

container.tag = ViewTagRoot;
mediaViewHolder.tag = ViewTagMediaView;
iconHolder.tag = ViewTagIcon;
adTitle.tag = ViewTagTitle;
ratingLabel.tag = ViewTagLabel;
adDescription.tag = ViewTagDescription;
ctaButton.tag = ViewTagCta;

// Register Views for Interaction
[nativeAdAssets registerViewForInteraction:container
    mediaView:mediaViewHolder
    iconView:iconHolder
    clickableViews:@[
        adTitle,
        ratingLabel,
        adDescription,
        ctaButton
]];