iOS Appendix B

·    kADFNativeAdStatusNone

·    kADFNativeAdStatusLoading

·    kADFNativeAdStatusReady

·    kADFNativeAdStatusFailed

·    kADFNativeAdStatusClicked

Method Parameters:

·         siteID: pass the site id which you got from adfalcon website.

·         adTemplate: pass your ad template class.

·         viewController: pass the view controller which contains the native ad.

Method Parameters:

·         ADFTargetingParams: Ad Request Targeting Parameters

You should at minimum bind one of the mandatory native ad assets (icon, title or MainAsset) depending on the native ad template design in-place.

Optionally, the binder allows setting additional parameters of the native ad assets such as the width and height of the icon and image, the maximum length of the title otherwise the binder will infer this information from the UIView’s properties.

Binding views to native ad assets is achieved using the binder object of ADFNativeAdBinder class by calling the appropriate binding method (setIconImageView, setTitleLabel, setMainAssetView and setExtraData).

This is used if the app is willing to entirely take over the extra data display and presentation.

didFailWithErrorCode:(int) code message:(NSString*) message;

Method Parameters:

·         ADFNativeAd: Native ad object

·         customData: The Ad Custom data object in the format agreed on between the publisher and the advertiser; normally this is in JSON format.

Return Value:

Returns YES if the action has been handled successfully, otherwise return NO.

-(void) setIconImageView:(UIImageView*) imageView minSize:(CGSize) minSize;

The first method is used to pass the template’s icon image view. The SDK will determine the image view size and return the best size for your icon.

Or you can use the overloaded method to explicitly set the minimum size of the requested icon.

The size of any icon must be a square i.e. the width is equal to the height.

Recommended minimum width and height of the Icon UIImageView is 50×50.

-(void) setTitleLabel:(UILabel *)label maxLength:(CGFloat) maxLength;

The first method is used to pass the label view of the template’s title. The SDK will infer the maximum length of the label based on UILabel properties.

Or you can use the overloaded method to explicitly set the maximum length of the title.

It is recommended that the UILabel is laid out to display at least 25 characters.

-(void) setMainAssetView:(UIView *) view minSize:(CGSize) minSize;

The MainAsset is a UIView which is used as a container view for the actual native ad main asset which can be:

·         Image, or

·         XHTML (HTML+JavaScript), or

·         Video

The SDK will automatically create the adequate UIView type that match the native ad main asset.

The first method is used to pass the main asset’s view, the SDK will use it to infer the minimum adequate width and height.

Or you can use the overloaded method to explicitly set the minimum required size for the main asset.

The main asset UIView width and height aspect ratio should always be W/H=1.91. It is recommended to use 320×167 points.

-(void) setExtraDataView:(UIView *) view dataID:(NSInteger) dataID maxLength:(CGFloat) maxLength;

-(void) setExtraDataLabel:(UILabel *) label dataID:(NSInteger) dataID maxLength:(CGFloat) maxLength

-(void) setExtraDataImageView:(UIImageView *) imageView dataID:(NSInteger) dataID minSize:(CGSize) minSize

All extra data views are optional which means native ad can be returned even if they don’t include the requested extra data assets. Additionally, the SDK will hide any extra data view that is not included in the returned native ad.

The first method is used to pass the view with its data id, the SDK will use the view properties to infer any needed additional parameters, such text max length, or images height and width.

The overloaded method is used to explicitly set any additional parameters.

Below is a list of supported data asset types of native ads:

An AdChoices icon must be displayed in your ad to enable the user to learn about interest-based advertising.

The SDK will decide when it is needed to display the icon and will also handle the tap event on the view by opening an opt-out page in the browser.

The size of the view: 20×20.

You must place the view in any one of the four corners of the ad template; upper right hand corner is recommended.