# Integrate Network SDKs

## Partner Network Supported SDK Versions

Please visit our [Chartboost Mediation Adapter Integration Manager](https://adapters.chartboost.com/) for the latest partner network supported SDK versions. The specific network's supported ad formats and adapter integration instructions are also provided there.

<div class="alert alert-info" role="alert">
  <b>Note:</b><br>
  <li><b>Amazon Publisher Services</b> and <b>Pangle</b> network are currently in private beta. Please reach out to Chartboost to inquire.</li>
  <li>For <b>AdMob SDK 10.0.0+</b> and <b>Google Bidding SDK 10.0.0+</b>, Google SDK requires iOS 12 to serve ads.</li>
</div>


## Mediation 4.0.0 Changes

As part of the Marketing team’s efforts to clearly articulate the use cases and customers we support by being more descriptive with our product branding, **Helium is being rebranded as Chartboost Mediation.**

Starting in **4.0.0**, the Chartboost Mediation brand will be used in place of Helium for new additions. In the coming 4.X releases, the old Helium branding will be deprecated and the new Chartboost Mediation branding will be used to give publishers a smoother transition.

### Adapter Separation

Beginning with Chartboost Mediation SDK 4.0.0, the partner network adapters will no longer be bundled with the main Chartboost Mediation SDK distribution. This decoupling of the Helium SDK releases from the partner network adapter releases will allow for more rapid iterations of the adapters as the adapters will reside in their own open-source repositories.

The supported open-source adapter repositories are:





<table>
	<thead>
		<tr>
			<th>Partner Network</th>
			<th>iOS Repository</th>
		</tr>
	</thead>
	<tbody>
		
		
		<tr>
			<td>AdMob</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-admob">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-admob</a></td>
		</tr>
		
		
		<tr>
			<td>Amazon Publisher Services</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-amazon-publisher-services">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-amazon-publisher-services</a></td>
		</tr>
		
		
		<tr>
			<td>AppLovin</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-applovin">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-applovin</a></td>
		</tr>
		
		
		<tr>
			<td>BidMachine</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-bidmachine">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-bidmachine</a></td>
		</tr>
		
		
		<tr>
			<td>Chartboost Monetization</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-chartboost">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-chartboost</a></td>
		</tr>
		
		
		<tr>
			<td>Digital Turbine Exchange (Fyber)</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-digital-turbine-exchange">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-digital-turbine-exchange</a></td>
		</tr>
		
		
		<tr>
			<td>Google Bidding</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-google-bidding">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-google-bidding</a></td>
		</tr>
		
		
		<tr>
			<td>HyprMX</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-hyprmx">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-hyprmx</a></td>
		</tr>
		
		
		<tr>
			<td>InMobi</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-inmobi">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-inmobi</a></td>
		</tr>
		
		
		<tr>
			<td>Liftoff Monetize (Vungle)</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-vungle">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-vungle</a></td>
		</tr>
		
		
		<tr>
			<td>ironSource</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-ironsource">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-ironsource</a></td>
		</tr>
		
		
		<tr>
			<td>Meta Audience Network</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-meta-audience-network">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-meta-audience-network</a></td>
		</tr>
		
		
		<tr>
			<td>Mintegral</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-mintegral">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-mintegral</a></td>
		</tr>
		
		
		<tr>
			<td>MobileFuse</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-mobilefuse">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-mobilefuse</a></td>
		</tr>
		
		
		<tr>
			<td>Pangle</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-pangle">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-pangle</a></td>
		</tr>
		
		
		<tr>
			<td>Unity Ads</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-unity-ads">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-unity-ads</a></td>
		</tr>
		
		
		<tr>
			<td>Verve</td>
			<td><a href="https://github.com/ChartBoost/chartboost-mediation-ios-adapter-verve">https://github.com/ChartBoost/chartboost-mediation-ios-adapter-verve</a></td>
		</tr>
		
	</tbody>
</table>



### Adapter Versioning Scheme

With Chartboost Mediation 4.0.0, the partner adapter versions are as follows:

```
<chartboost_mediation_sdk_major_version>.<partner_sdk_version>.<adapter_revision>
```

Our adapter versioning uses floating pegs.

#### Chartboost Mediation SDK Major Version

This is the major version of the Chartboost Mediation SDK that the adapter is compatible with.

#### Partner SDK Version

This is the full partner SDK version that the adapter is compatible with. Note that this could be the traditional `major.minor.patch` version scheme, but there are some partners that have a `major.minor.patch.revision` version scheme.

#### Adapter Revision

This is the version of the adapter. Typically this will start at 0 and will increment as there are hotfixes that are specific to this version of the adapter.

#### Examples

The following are some examples of adapter versions for Chartboost Mediation SDK 4.0.0.

| Partner    | Adapter Version | Chartboost Mediation SDK Major Version | Compatible Partner SDK Version | Adapter Revision |
| :--------- | :-------------- | :------------------------------------- | :----------------------------- | :--------------- |
| AdMob   | 4.21.5.0.2      | 4                                      | 21.5.0                          | 2                |
| IronSource | 4.7.2.5.1.0     | 4                                      | 7.2.5.1                        | 0                |



## Adding Ad Network SDKs

Mediation Adapters are required to use other Ad Networks with Mediation. If you're using CocoaPods, they can be downloaded (along with their dependent Ad Network SDKs) by adding the following to your Podfile:

```ruby
# Chartboost Mediation Adapter for AdMob
pod 'ChartboostMediationAdapterAdMob'

# Chartboost Mediation Adapter for Amazon Publisher Services
pod 'ChartboostMediationAdapterAmazonPublisherServices'
  
# Chartboost Mediation Adapter for AppLovin
pod 'ChartboostMediationAdapterAppLovin'

# Chartboost Mediation Adapter for Chartboost
pod 'ChartboostMediationAdapterChartboost'

# Chartboost Mediation Adapter for Digital Turbine
pod 'ChartboostMediationAdapterDigitalTurbineExchange'

# Chartboost Mediation Adapter for Google Bidding
pod 'ChartboostMediationAdapterGoogleBidding'

# Chartboost Mediation Adapter for HyprMX
pod 'ChartboostMediationAdapterHyprMX'
  
# Chartboost Mediation Adapter for InMobi
pod 'ChartboostMediationAdapterInMobi'
  
# Chartboost Mediation Adapter for ironSource
pod 'ChartboostMediationAdapterIronSource'
  
# Chartboost Mediation Adapter for Meta Audience Network
pod 'ChartboostMediationAdapterMetaAudienceNetwork'

# Chartboost Mediation Adapter for Mintegral
pod 'ChartboostMediationAdapterMintegral'

# Chartboost Mediation Adapter for Pangle
pod 'ChartboostMediationAdapterPangle'
  
# Chartboost Mediation Adapter for UnityAds
pod 'ChartboostMediationAdapterUnityAds'
  
# Chartboost Mediation Adapter for Vungle
pod 'ChartboostMediationAdapterVungle'
```



### AdMob

To integrate with AdMob iOS SDK, refer to [AdMob SDK integration](https://developers.google.com/admob/ios/quick-start) documentation.

### Amazon Publisher Services

Amazon Publisher Services network is currently in private beta. Please reach out to Chartboost to inquire.

### AppLovin

To integrate with AppLovin iOS SDK, refer to [AppLovin SDK integration](https://dash.applovin.com/docs/integration#iosIntegration)  documentation.

### Chartboost

To integrate with Chartboost iOS SDK, refer to [Chartboost SDK integration](en/monetization/integrate/ios/get-started/) documentation.

### Digital Turbine

To integrate with Digital Turbine (formerly Fyber) iOS SDK, refer to [Digital Turbine SDK integration](https://developer.digitalturbine.com/hc/en-us/articles/360010915618-Integrating-the-iOS-SDK)  documentation.

### HyprMX

To integrate with HyprMX iOS SDK, refer to [HyprMX SDK integration](https://documentation.hyprmx.com/ios-hyprmx-sdk/) documentation.

### InMobi

To integrate with InMobi iOS SDK, refer to [InMobi SDK integration](https://support.inmobi.com/monetize/sdk-documentation/ios-guidelines/overview-ios-guidelines) documentation.

### ironSource

To integrate with ironSource iOS SDK, refer to [ironSource SDK integration](https://developers.ironsrc.com/ironsource-mobile/ios/ios-sdk) documentation.

### Meta Audience Network

Starting with [Meta Audience Network 5.4.x](https://developers.facebook.com/docs/audience-network/changelog-ios#5_4_0), there are additional frameworks that their SDKs require: **FBBSDKCoreKit_Basics** and the **AudioToolbox** framework. The **FBBSDKCoreKit_Basics** can be found here while the AudioToolbox can be added from Xcode.

- [FBBSDKCoreKit_Basics](https://github.com/facebook/facebook-objc-sdk/releases)
- [FBAudienceNetwork](https://developers.facebook.com/docs/audience-network/download#ios)
- AudioToolbox

CocoaPods automatically integrates Meta Audience Network SDK, therefore manual import is unnecessary.

### Mintegral

To integrate with Mintegral iOS SDK, refer to [Mintegral SDK integration](https://www.mintegral.com/en/publisher-platform/ios-sdk-integration_en/) documentation.

### Pangle

To integrate with Pangle iOS SDK, refer to [Pangle's SDK integration](https://www.pangleglobal.com/integration/integrate-pangle-sdk-for-ios) documentation.


### Unity Ads

To integrate with Unity Ads iOS SDK, refer to [Unity Ads SDK implementation](https://unityads.unity3d.com/help/ios/integration-guide-ios#basic-implementation)  documentation.

### Vungle

To integrate with Vungle iOS SDK, refer to [Vungle SDK integration](https://support.vungle.com/hc/en-us/articles/360002925791)  documentation.



<!-- New starting 4.7.0 -->

## Setting Individual Partner Consents

Partner consent can be set on an individual basis using the following API. Using these partner consents will override the global GDPR and CCPA consent used for the Chartboost Mediation SDK with the partner-specific values.

When a consent value for a partner is not present in this dictionary, then general signals provided by calls to ``setUserHasGivenConsent(_:)`` and ``setCCPAConsent(_:)`` are used as fallback.


```swift
public var partnerConsents: [PartnerIdentifier: Bool]
```

iOS exposes `partnerConsents` as a standard Dictionary type. Thus, all the usual Dictionary operations are available when using `partnerConsents`.


### Getting Current Partner Consents
```swift
let consents = Helium.shared().partnerConsents
print(consents)
```

### Setting Single Partner Consent 
```swift
Helium.shared().partnerConsents["admob"] = true
Helium.shared().partnerConsents["mintegral"] = false
```
### Setting Multiple Partner Consent
```swift
Helium.shared().partnerConsents.merge(["admob": true, "mintegral": false], , uniquingKeysWith: { old, new in new })
```

### Individually Remove Partner Consents
```swift
Helium.shared().partnerConsents["admob"] = nil
Helium.shared().partnerConsents["mintegral"] = nil
Helium.shared().partnerConsents["vungle"] = nil
```

### Replacing Consent

To replace consent with an entirely new set of values:
```swift
Helium.shared().partnerConsents = ["vungle": true, "mintegral": true]
```

### Remove All Partner Consent
Globally set consents will re-apply if partner consents are cleared.
```swift
Helium.shared().partnerConsents.removeAll()
Helium.shared().partnerConsents = [:]  // this is equivalent to the previous line
```

### Partner Identifiers

| Partner                    | Partner ID           |
|----------------------------|----------------------|
| AdMob                      | admob                |
| Amazon Publisher Services  | amazon_aps           |
| AppLovin                   | applovin             |
| BidMachine                 | bidmachine           |
| Chartboost                 | chartboost           |
| Digital Turbine Exchange   | fyber                |
| Google Bidding (Google Ads)| google_googlebidding |
| HyprMX                     | hyprmx               |
| InMobi                     | inmobi               |
| ironSource                 | ironsource           |
| Liftoff Monetize (Vungle)  | vungle               |
| Meta Audience Network      | facebook             |
| Mintegral                  | mintegral            |
| MobileFuse                 | mobilefuse           |
| Pangle                     | pangle               | 
| UnityAds                   | unity                |
| Verve                      | verve                |

<!-- end partner consents -->