Mediation

Integrate Network SDKs

Partner Adapter Integration πŸ”—

Mediation adapters are required to use other ad networks with Mediation.

Adapter Versioning Scheme πŸ”—

The partner adapter versions uses floating pegs and are formatted as follows:

<chartboost_mediation_sdk_major_version>.<partner_sdk_version>.<adapter_revision>
  • Chartboost Mediation SDK Major Version: The major version of the Chartboost Mediation SDK that the adapter is compatible with.
  • Partner SDK Version: 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: 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.

Examples:

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 5.7.2.5.1.0 5 7.2.5.1 0

Adapter Integration πŸ”—

Utilize our Chartboost Mediation Adapters below to compare which partners are ideal for you to integrate with. You can filter by ad format from the top right menu and compare selected partners. Click into the chosen partner for the latest supported partner adapter versions and integration guide or visit their adapter repository.

Be sure you are navigated to the iOS specific adapters from the top right menu.

For CocoaPods users, Mediation adapters can be downloaded, along with their dependent ad network SDKs, by adding the following to your Podfile:

# 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 Exchange (Fyber)
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 Liftoff Monetize (Vungle)
pod 'ChartboostMediationAdapterVungle'
  
# 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 MobileFuse
pod 'ChartboostMediationAdapterMobileFuse'

# Chartboost Mediation Adapter for Pangle
pod 'ChartboostMediationAdapterPangle'
  
# Chartboost Mediation Adapter for UnityAds
pod 'ChartboostMediationAdapterUnityAds'
  

Adapter Repositories πŸ”—

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

Partner SDK Integration πŸ”—

Partner SDK Integration Docs Additional Integration Notes
AdMob/Google Bidding
  • For AdMob SDK 10.0.0+ and Google Bidding SDK 10.0.0+, Google SDK requires iOS 12 to serve ads.
  • For Google SDK versions 11+, iOS 13 is required in order to receive ads.
  • Amazon Publisher Services
    AppLovin
    Bidmachine To integrate with Bidmachine SDK, contact your Bidmachine account manager.
    Chartboost Monetization
    Digital Turbine Exchange (Fyber)
    HyprMX
    InMobi
    ironSource
    Liftoff Monetize (Vungle)
    Meta Audience Network Starting with Meta Audience Network 5.4.x, there are additional frameworks that their SDKs require: FBBSDKCoreKit_Basics and the AudioToolbox framework.
    CocoaPods automatically integrates Meta Audience Network SDK, therefore manual import is unnecessary.
    Mintegral
    Pangle
    Unity Ads

    Partner Consents πŸ”—

    All privacy and consent information is configured via the Chartboost Core SDK’s Consent Management Platform.

    The Mediation SDK will utilize the TCFv2 string as part of auction requests, and will forward consent changes to the partner adapters.

    The following partners utilize complex non-IAB compliant privacy and consent signals that cannot be extrapolated from Core SDK consent signals. Last resort APIs will be exposed via that partner adapter’s AdapterConfiguration class and must be manually set.

    HyprMX πŸ”—

    // Set consent status directly on the adapter configuration
    HyprMXAdapterConfiguration.setConsentStatusOverride(CONSENT_GIVEN)
    

    Pangle πŸ”—

    // Set consent status directly on the adapter configuration
    PangleAdapterConfiguration.setGdprConsentOverride(consent) // this is an int
    PangleAdapterConfiguration.setDoNotSellOverride(doNotSell) // this is an int
    

    Unity Ads πŸ”—

    // Set consent status directly on the adapter configuration
    UnityAdsAdapterConfiguration.setGdprConsentOverride(context, true)
    UnityAdsAdapterConfiguration.setPrivacyConsentOverride(context, true)
    

    Vungle πŸ”—

    // Set consent status directly on the adapter configuration
    VungleAdapterConfiguration.setGdprStatusOverride(true)
    VungleAdapterConfiguration.setCcpaStatusOverride(true)