No description, website, or topics provided.
Latest commit 9678140 Nov 29, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Adds issue template Nov 29, 2018
Canary 5.4.1 Nov 28, 2018
MoPubResources 5.4.1 Nov 28, 2018
MoPubSDK.xcodeproj 5.4.1 Nov 28, 2018
MoPubSDK 5.4.1 Nov 28, 2018
MoPubSDKFramework 5.4.1 Nov 28, 2018
MoPubSDKTests 5.4.1 Nov 28, 2018
MoPubSampleApp 5.4.1 Nov 28, 2018
Scripts 5.4.0 Oct 1, 2018
.gitignore Updates .gitignore and adds podspec to repository Oct 3, 2018
.gitmodules Remove remnant files (#230) Nov 10, 2017
CHANGELOG.md 5.4.1 Nov 28, 2018
LICENSE 3.2.0 Oct 17, 2014
README.md Updates README.md Nov 29, 2018
mopub-ios-sdk.podspec 5.4.1 Nov 28, 2018

README.md

MoPub iOS SDK

Thanks for taking a look at MoPub! We take pride in having an easy-to-use, flexible monetization solution that works across multiple platforms.

Sign up for an account at http://app.mopub.com/.

Need Help?

You can find integration documentation on our wiki and additional help documentation on our developer help site.

To file an issue with our team, email support@mopub.com.

New Pull Requests?

Thank you for submitting pull requests to the MoPub iOS GitHub repository. Our team regularly monitors and investigates all submissions for inclusion in our official SDK releases. Please note that MoPub does not directly merge these pull requests at this time. Please reach out to your account team or support@mopub.com if you have further questions.

Disclosure

MoPub SDK 4.16 and above integrates technology from our partners Integral Ad Science, Inc. (“IAS”) and Moat, Inc. (“Moat”) in order to support viewability measurement and other proprietary reporting that IAS and Moat provide to their advertiser and publisher clients. You have the option to remove or disable this technology by following the opt-out instructions below.

If you do not remove or disable IAS's and/or Moat’s technology in accordance with these instructions, you agree that IAS's privacy policy and license and Moat’s privacy policy, terms, and license, respectively, apply to your integration of these partners' technologies into your application.

Installation

The MoPub SDK supports multiple methods for installing the library in a project.

The current version of the SDK is 5.4.1

Installation with CocoaPods

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects, which automates and simplifies the process of using 3rd-party libraries like the MoPub SDK in your projects. You can install it with the following command:

$ gem install cocoapods

Podfile To integrate MoPub SDK into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

target 'MyApp' do
  pod 'mopub-ios-sdk', '~> 5.0'
end

Then, run the following command:

$ pod install

Manual Integration with Dynamic Framework

MoPub provides a prepackaged archive of the dynamic framework:

  • MoPub SDK Framework.zip

    Includes everything you need to serve HTML, MRAID, and Native MoPub advertisements. Third party ad networks are not included.

Add the dynamic framework to the target's Embedded Binaries section of the General tab.

Manual Integration with Source Code

MoPub provides two prepackaged archives of source code:

  • MoPub Base SDK.zip

    Includes everything you need to serve HTML, MRAID, and Native MoPub advertisements. Third party ad networks are not included.

  • MoPub Base SDK Excluding Native.zip

    Includes everything you need to serve HTML and MRAID advertisements. Third party ad networks and Native MoPub advertisements are not included.

Integrate

Integration instructions are available on the wiki.

New in this Version

Please view the changelog for details.

  • Bug Fixes
    • Changed the MoPubSampleApp+Framework target to MoPubSampleApp in the Objective-C Sample App.
    • Fixed crash when MPTableViewAdPlacer makes multiple ad requests within a short amount of time.
    • Fixed bug with the internal state of rewarded video when the video fails to play.

See the Getting Started Guide for instructions on setting up ATS in your app.

Upgrading to SDK 5.0

Please see the Getting Started Guide for instructions on upgrading from SDK 4.X to SDK 5.0.

For GDPR-specific upgrading instructions, also see the GDPR Integration Guide.

Disabling Viewability Measurement

There are a few options for opting out of viewability measurement:

Opting Out in a Manual Integration

Before dragging the MoPubSDK folder into your Xcode project, simply delete the “Moat” folder to opt out of Moat or the “Avid” folder to opt out of IAS in MoPubSDK/Viewability/. If you would like to opt out of both, delete both folders.

Opting Out in a CocoaPods Integration

Including pod 'mopub-ios-sdk' in your Podfile will include both IAS and Moat SDKs, as well as the MoPub SDK. In order to opt out:

  • pod 'mopub-ios-sdk/Avid' will include the IAS SDK, but not the Moat SDK, as well as the MoPub SDK.
  • pod 'mopub-ios-sdk/Moat' will include the Moat SDK, but not the IAS SDK, as well as the MoPub SDK.
  • pod 'mopub-ios-sdk/Core' will only include the MoPub SDK, with viewability measurement totally disabled.

Make sure to run pod update once your Podfile is set up to your preferences.

Software Disable

If you would like to opt out of viewability measurement but do not want to modify the MoPub SDK, a function is provided for your convenience. As soon as possible after calling - (void)initializeSdkWithConfiguration:completion:, call [[MoPub sharedInstance] disableViewability:(vendors)]. In place of “(vendors)”, MPViewabilityOptionIAS will disable IAS but leave Moat enabled, MPViewabilityOptionMoat will disable Moat but leave IAS enabled, and MPViewabilityOptionAll will disable all viewability measurement.

Requirements

  • iOS 8.0 and up
  • Xcode 9.0 and up

License

We have launched a new license as of version 3.2.0. To view the full license, visit http://www.mopub.com/legal/sdk-license-agreement/