You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+21-25Lines changed: 21 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,9 +8,7 @@ Sign up for an account at [http://app.mopub.com/](http://app.mopub.com/).
8
8
9
9
You can find integration documentation on our [wiki](https://github.com/mopub/mopub-android-sdk/wiki/Getting-Started) and additional help documentation on our [developer help site](http://dev.twitter.com/mopub).
10
10
11
-
To file an issue with our team visit the [MoPub Forum](https://twittercommunity.com/c/fabric/mopub) or email [[email protected]](mailto:[email protected]).
12
-
13
-
**Please Note: We no longer accept GitHub Issues.**
11
+
To file an issue with our team visit the [MoPub Forum](https://twittercommunity.com/c/advertiser-api/mopub) or email [[email protected]](mailto:[email protected]).
14
12
15
13
## New Pull Requests?
16
14
@@ -39,7 +37,7 @@ The MoPub SDK is available via:
39
37
}
40
38
41
39
dependencies {
42
-
implementation('com.mopub:mopub-sdk:5.4.0@aar') {
40
+
implementation('com.mopub:mopub-sdk:5.9.1@aar') {
43
41
transitive = true
44
42
}
45
43
}
@@ -61,27 +59,27 @@ The MoPub SDK is available via:
The MoPub SDK is also distributed as zipped source code that you can include in your application. MoPub provides two prepackaged archives of source code:
92
+
The MoPub SDK is also distributed as zipped source code that you can include in your application:
95
93
96
94
**[MoPub Android SDK.zip](http://bit.ly/YUdWhH)**
97
95
_Includes everything you need to serve MoPub ads. No third party ad networks are included._
@@ -109,25 +107,23 @@ The MoPub SDK is available via:
109
107
## New in this Version
110
108
Please view the [changelog](https://github.com/mopub/mopub-android-sdk/blob/master/CHANGELOG.md) for a complete list of additions, fixes, and enhancements in the latest release.
111
109
112
-
- Upgraded target SDK version to 28 and support libraries to 28.0.0.
113
-
- Upgraded ExoPlayer dependency to 2.8.3.
114
-
- Moved `AdvancedBiddingInitializationAsyncTask` and `RefreshAdvertisingInfoAsyncTask` to the parallel executor.
115
-
- MRAID `isViewable` now more closely follows our impression tracking instead of the ad being marked viewable as soon as it loads.
110
+
- **Bug Fixes**
111
+
- Now sends ad width in pixels instead of dips when setting a `MoPubAdSize`.
116
112
117
113
## Requirements
118
114
119
115
- Android 4.1 (API Version 16) and up (**Updated in 4.12.0**)
120
-
- android-support-v4.jar, r28 (**Updated in 5.4.0**)
121
-
- android-support-annotations.jar, r28 (**Updated in 5.4.0**)
122
-
- android-support-v7-recyclerview.jar, r28 (**Updated in 5.4.0**)
123
-
- MoPub Volley Library (mopub-volley-2.0.0.jar - available on JCenter) (**Updated in 5.0.0**)
124
-
- **Recommended** Google Play Services 15.0.1
116
+
- androidx.legacy:legacy-support-v4:1.0.0 (**Updated in 5.9.0**)
117
+
- androidx.annotation:annotation:1.1.0 (**Updated in 5.9.0**)
118
+
- androidx.recyclerview:recyclerview:1.0.0 (**Updated in 5.9.0**)
119
+
- MoPub Volley Library (mopub-volley-2.1.0.jar - available on JCenter) (**Updated in 5.6.0**)
120
+
- **Recommended** Google Play Services (com.google.android.gms:play-services-ads-identifier:16.0.0 and com.google.android.gms:play-services-base:16.0.1) (**Updated in 5.6.0**)
125
121
126
122
## Upgrading to SDK 5.0
127
123
128
124
Please see the [Getting Started Guide](https://developers.mopub.com/docs/android/getting-started/) for instructions on upgrading from SDK 4.X to SDK 5.0.
129
125
130
-
For GDPR-specific upgrading instructions, also see the [GDPR Integration Guide](https://developers.mopub.com/docs/publisher/gdpr).
126
+
For GDPR-specific upgrading instructions, also see the [GDPR Integration Guide](https://developers.mopub.com/docs/publisher/gdpr-guide).
131
127
132
128
## <a name="upgradeRepositoryViewability"></a>Upgrading from 4.15.0 and Prior
133
129
In 4.16.0, dependencies were added to viewability libraries provided by AVID and Moat. Apps upgrading from previous versions must add
@@ -141,7 +137,7 @@ Normally, to add the MoPub SDK to your app via JCenter, your `build.gradle` woul
141
137
142
138
```
143
139
dependencies {
144
-
implementation('com.mopub:mopub-sdk:5.4.0@aar') {
140
+
implementation('com.mopub:mopub-sdk:5.9.1@aar') {
145
141
transitive = true
146
142
}
147
143
}
@@ -150,7 +146,7 @@ Update to the following to exclude one or both viewability vendors:
150
146
151
147
```
152
148
dependencies {
153
-
implementation('com.mopub:mopub-sdk:5.4.0@aar') {
149
+
implementation('com.mopub:mopub-sdk:5.9.1@aar') {
154
150
transitive = true
155
151
exclude module: 'libAvid-mopub' // To exclude AVID
156
152
exclude module: 'moat-mobile-app-kit' // To exclude Moat
@@ -165,7 +161,7 @@ mopub.avidEnabled=false
165
161
mopub.moatEnabled=false
166
162
```
167
163
##### Disable via API
168
-
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. At any point, call `MoPub.disableViewability(vendor);`. This method can can be called with any of the enum values available in `ExternalViewabilitySessionManager.ViewabilityVendor`: `AVID` will disable AVID but leave Moat enabled, `MOAT` will disable Moat but leave AVID enabled, and `ALL` will disable all viewability measurement.
164
+
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. At any point, call `MoPub.disableViewability(vendor);`. This method can be called with any of the enum values available in `ExternalViewabilitySessionManager.ViewabilityVendor`: `AVID` will disable AVID but leave Moat enabled, `MOAT` will disable Moat but leave AVID enabled, and `ALL` will disable all viewability measurement.
169
165
170
166
## Working with Android 6.0 Runtime Permissions
171
167
If your app's target SDK is 23 or higher _**and**_ the user's device is running Android 6.0 or higher, you are responsible for supporting [runtime permissions](http://developer.android.com/training/permissions/requesting.html), one of the [changes](http://developer.android.com/about/versions/marshmallow/android-6.0-changes.html) introduced in Android 6.0 (API level 23). In addition to listing any dangerous permissions your app needs in the manifest, your app also has to explicitly request the dangerous permission(s) during runtime by calling method `requestPermissions()` in the [`ActivityCompat`](http://developer.android.com/reference/android/support/v4/app/ActivityCompat.html) class.
@@ -174,7 +170,7 @@ If your app's target SDK is 23 or higher _**and**_ the user's device is running
174
170
- Dangerous permission [`ACCESS_COARSE_LOCATION`](http://developer.android.com/reference/android/Manifest.permission.html#ACCESS_COARSE_LOCATION) is needed to pass network location data to MoPub.
175
171
- Dangerous permission [`ACCESS_FINE_LOCATION`](http://developer.android.com/reference/android/Manifest.permission.html#ACCESS_FINE_LOCATION) is needed to pass GPS location data to MoPub.
176
172
- Granting `ACCESS_FINE_LOCATION` also allows network location data to be passed to MoPub without the need to also grant `ACCESS_COARSE_LOCATION`.
177
-
- Dangerous permission [`WRITE_EXTERNAL_STORAGE`](http://developer.android.com/reference/android/Manifest.permission.html#WRITE_EXTERNAL_STORAGE) is optional and only required for MRAID 2.0 storePicture ads.
173
+
- _**Note:** SDK Version 5.9.0 removes the requirement for the dangerous permission [`WRITE_EXTERNAL_STORAGE`](http://developer.android.com/reference/android/Manifest.permission.html#WRITE_EXTERNAL_STORAGE)._
178
174
- _**Note:** The user can deny granting any dangerous permissions during runtime, so please make sure your app can handle this properly._
179
175
- _**Note:** The user can revoke any permissions granted previously by going to your app's Settings screen, so please make sure your app can handle this properly._
180
176
@@ -187,4 +183,4 @@ If your app's target SDK is 23 or higher _**and**_ the user's device is running
187
183
188
184
## License
189
185
190
-
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/](http://www.mopub.com/legal/sdk-license-agreement/).
186
+
To view the full license, visit [http://www.mopub.com/legal/sdk-license-agreement/](http://www.mopub.com/legal/sdk-license-agreement/).
0 commit comments