Supports iOS 8.0+
You will need a MobFox account.
Make sure AdSupport.framework
and libz.dylib
are included in your project's frameworks.
Set Embedded Content Contains Swift Code
to Yes.
Add to your Podfile:
pod 'MobFoxSDK','3.1.7b'
-
Download and unzip MobFox-SDK-Core-Lib or clone this repository.
-
For integrating static lib: Drag
MobFoxSDKCore.embeddedframework
from the Finder into your project, orMobFoxSDKCoreBitCode.embeddedframework
to enabling Bitcode. For dynamic lib: DragMobFoxSDKCoreDynamic.embeddedframework
from the Finder into your project, orMobFoxSDKCoreDynamicBitCode.embeddedframework
to enabling Bitcode.
One of the changes in iOS9 is a default setting that requires apps to make network connections only over SSL, this is known as App Transport Security. MobFox is facilitating the transition to support this change for each of our demand partners in order to ensure they are compliant. In the meantime, developers who want to release apps that support iOS9, will need to disable ATS in order to ensure MobFox continues to work as expected. To do so, developers should add the following to their plist:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
Developers can also edit the plist directly by adding NSAppTransportSecurity
key of dictionary type with a dictionary element of NSAllowsArbitraryLoads
of boolean type set to Yes
.
In the future MobFox will provide an additional parameter for requesting only secure ads. We will inform our publishers via the Control Panel.
More information about this change can be found on Apple's website: https://developer.apple.com/library/prerelease/ios/technotes/App-Transport-Security-Technote/index.html#//apple_ref/doc/uid/TP40016240
For further questions about iOS9 and ATS, please create a ticket at https://account.mobfox.com/www/cp/create_ticket.php
#import <MobFoxSDKCore/MobFoxSDKCore.h>
Or if using a different build of the SDK use the corresponding include:
//For MobFoxSDKCoreBitCode.embeddedframework use
#import <MobFoxSDKCoreBitCode/MobFoxSDKCoreBitCode.h>
//For MobFoxSDKCoreDynamic.embeddedframework use
#import <MobFoxSDKCoreDynamic/MobFoxSDKCoreDynamic.h>
//For MobFoxSDKCoreDynamicBitCode.embeddedframework use
#import <MobFoxSDKCoreDynamicBitCode/MobFoxSDKCoreDynamicBitCode.h>
In order to ensure the best ad is ready when you wish to display it, please init the MobFox ad as soon as possible in your code:
//define the position and dimensions of your ad
CGRect adRect = CGRectMake(0, 200, 320, 50);
//init your ad
MobFoxAd* mobfoxAd = [[MobFoxAd alloc] init:@"your-publication-hash" withFrame:adRect];
//add it to your view
[self.view addSubview: mobfoxAd];
Setting additional parameters on the ad object that can help you get better targeted ads or help you with reporting:
@property (nonatomic, copy) NSString* longitude;
@property (nonatomic, copy) NSString* latitude;
@property (nonatomic, copy) NSString* demo_gender; //"m/f"
@property (nonatomic, copy) NSString* demo_age;
@property (nonatomic, copy) NSString* s_subid;
@property (nonatomic, copy) NSString* sub_name;
@property (nonatomic, copy) NSString* sub_domain;
@property (nonatomic, copy) NSString* sub_storeurl;
@property (nonatomic, copy) NSString* v_dur_min;
@property (nonatomic, copy) NSString* v_dur_max;
@property (nonatomic, copy) NSString* r_floor;
@property (nonatomic, assign) BOOL no_markup;
//set this (in seconds) to make the ad refresh
@property (nonatomic, assign) NSNumber* refresh;
More information can be found here: http://dev.mobfox.com/index.php?title=Ad_Request_API#Request_Parameters
In order to be notified when certain ad events occur you can register a delegate:
//The delegate should implement the following protocol:
@protocol MobFoxAdDelegate <NSObject>
@optional
//called when ad is displayed
- (void)MobFoxAdDidLoad:(MobFoxAd *)banner;
//called when an ad cannot be displayed
- (void)MobFoxAdDidFailToReceiveAdWithError:(NSError *)error;
//called when ad is closed/skipped
- (void)MobFoxAdClosed;
//called when ad is clicked
- (void)MobFoxAdClicked;
//called when if the ad is a video ad and it has finished playing
- (void)MobFoxAdFinished;
//called if the ad request returned custom events
- (void) MobFoxDelegateCustomEvents:(NSArray*) events;
@end
Set the delegate:
mobfoxAd.delegate = delegate;
Later when you wish to display the ad:
//call to display ad
[mobfoxAd loadAd];
In order to insure the best ad is ready when you wish to display it, please init the MobFox interstitial ad as soon as possible in your code:
//init the interstitial ad giving it your main/root controller
MobFoxInterstitialAd* mobfoxInterAd = [[MobFoxInterstitialAd alloc] init:@"your-publication-hash" withRootViewController:self];
Setting additional parameters on the internal ad object that can help you get better targeted ads or help you with reporting: For example:
mobfoxInterAd.demo_gender = @"f";
The available properties are:
@property (nonatomic, copy) NSString* longitude;
@property (nonatomic, copy) NSString* latitude;
@property (nonatomic, copy) NSString* demo_gender; //"m/f"
@property (nonatomic, copy) NSString* demo_age;
@property (nonatomic, copy) NSString* s_subid;
@property (nonatomic, copy) NSString* sub_name;
@property (nonatomic, copy) NSString* sub_domain;
@property (nonatomic, copy) NSString* sub_storeurl;
@property (nonatomic, copy) NSString* r_floor;
//set this (in seconds) to make the ad refresh
@property (nonatomic, assign) NSNumber* refresh;
@property (nonatomic, copy) NSNumber* v_dur_min;
@property (nonatomic, copy) NSNumber* v_dur_max;
More information can be found here: http://dev.mobfox.com/index.php?title=Ad_Request_API#Request_Parameters
In order to be notified when certain ad events occur you can register a delegate:
//The delegate should implement the following protocol:
@protocol MobFoxInterstitialAdDelegate <NSObject>
@optional
//called when ad is displayed
- (void)MobFoxInterstitialAdDidLoad:(MobFoxInterstitialAd *)interstitial;
//called when an ad cannot be displayed
- (void)MobFoxInterstitialAdDidFailToReceiveAdWithError:(NSError *)error;
//called when ad is closed/skipped
- (void)MobFoxInterstitialAdClosed;
//called w mobfoxInterAd.delegate = self;hen ad is clicked
- (void)MobFoxInterstitialAdClicked;
//called when if the ad is a video ad and it has finished playing
- (void)MobFoxInterstitialAdFinished;
@end
Set the delegate and preload the ad:
mobfoxInterAd.delegate = delegate;
[mobfoxInterAd loadAd];
Setting additional parametes on the ad object that can help you get better targeted ads or help you with reporting:
@property (nonatomic, copy) NSString* longitude;
@property (nonatomic, copy) NSString* latitude;
@property (nonatomic, copy) NSString* demo_gender; //"m/f"
@property (nonatomic, copy) NSString* demo_age;
@property (nonatomic, copy) NSString* s_subid;
@property (nonatomic, copy) NSString* sub_name;
@property (nonatomic, copy) NSString* sub_domain;
@property (nonatomic, copy) NSString* sub_storeurl;
@property (nonatomic, copy) NSString* v_dur_min;
@property (nonatomic, copy) NSString* v_dur_max;
@property (nonatomic, copy) NSString* r_floor;
More information can be found here: http://dev.mobfox.com/index.php?title=Ad_Request_API#Request_Parameters
Later when you wish to display the ad:
//best to show after delegate informs an ad was loaded
- (void)MobFoxInterstitialAdDidLoad:(MobFoxInterstitialAd *)interstitial{
if(mobfoxInterAd.ready){
[mobfoxInterAd show];
}
}
When you wish to dismiss the ad:
- (void)dismissAd;
This is a special type of ad as it returns a JSON object containing the ad data and it's the publisher's responsibility to display the ad assets, call the impression pixels and the click URL if clicked.
MobFoxNativeAd* nativeAd = [[MobFoxNativeAd alloc] init:@"your-publication-hash"];
//you must define a delegate to get the JSON response
//The delegate should implement the following protocol:
@protocol MobFoxNativeAdDelegate <NSObject>
//called when ad response is returned
- (void)MobFoxNativeAdDidLoad:(MobFoxNativeAd*)ad withAdData:(MobFoxNativeData *)adData;
//called when ad response cannot be returned
- (void)MobFoxNativeAdDidFailToReceiveAdWithError:(NSError *)error;
@end
nativeAd.delegate = delegate;
Setting additional parameters on the ad object that can help you get better targeted ads or help you with reporting:
@property (nonatomic, copy) NSString* longitude;
@property (nonatomic, copy) NSString* latitude;
@property (nonatomic, copy) NSString* demo_gender; //"m/f"
@property (nonatomic, copy) NSString* demo_age;
@property (nonatomic, copy) NSString* s_subid;
@property (nonatomic, copy) NSString* sub_name;
@property (nonatomic, copy) NSString* sub_domain;
@property (nonatomic, copy) NSString* sub_storeurl;
@property (nonatomic, copy) NSString* v_dur_min;
@property (nonatomic, copy) NSString* v_dur_max;
@property (nonatomic, copy) NSString* r_floor;
More information can be found here: http://dev.mobfox.com/index.php?title=Ad_Request_API_-_Native
The response MobFoxNativeData*
:
@interface MobFoxNativeData : NSObject
@property (nonatomic, strong) MobFoxNativeImage *icon;
@property (nonatomic, strong) MobFoxNativeImage *main;
@property (nonatomic, copy) NSString *assetHeadline;
@property (nonatomic, copy) NSString *assetDescription;
@property (nonatomic, copy) NSString *callToActionText;
@property (nonatomic, copy) NSString *advertiserName;
@property (nonatomic, copy) NSString *socialContext;
@property (nonatomic, copy) NSNumber *rating;
@property (nonatomic, copy) NSURL *clickURL;
@property (nonatomic, strong) NSMutableArray *trackersArray;
@end
You must call all trackers
when you decide to render the ad and navigate to the click_url
when the ad is clicked.
Please refer to MobFox Native API for full documentation.
[nativeAd loadAd];
When the native ad loads you must register the ad for interaction:
- (void)MobFoxNativeAdDidLoad:(MobFoxNativeAd*)ad withAdData:(MobFoxNativeData *)adData {
// Register interaction
[ad registerViewWithInteraction:view withViewController:viewController];
for (MobFoxNativeTracker *tracker in adData.trackersArray) {
if ([tracker.url absoluteString].length > 0)
{
// Fire tracking pixel
UIWebView* wv = [[UIWebView alloc] initWithFrame:CGRectZero];
NSString* userAgent = [wv stringByEvaluatingJavaScriptFromString:@"navigator.userAgent"];
NSLog(@"userAgent: %@", userAgent);
NSURLSessionConfiguration* conf = [NSURLSessionConfiguration defaultSessionConfiguration];
conf.HTTPAdditionalHeaders = @{ @"User-Agent" : userAgent };
NSURLSession* session = [NSURLSession sessionWithConfiguration:conf];
NSURLSessionDataTask* task = [session dataTaskWithURL:tracker.url completionHandler:
^(NSData *data,NSURLResponse *response, NSError *error){
if(error) NSLog(@"err %@",[error description]);
}];
[task resume];
}
}
}
This feature lets you use your accounts on other advertising platforms such as MoPub inside MobFox's SDK.
Adapters are the opposite of Custom Events, they let you use MobFox as a Custom Event in other networks. Currently AdMob and MoPub are supported.
The SDK will query the current location and set the longitude
and latitude
ad request parameters, as long as it permitted by the user (in Privacy, Location Services).
Including bitcode will allow Apple to re-optimize your app binary without the need to submit a new version of your app to the store. For using Bitcode declare the parameter Enable Bitcode
to YES
in project settings.