Skip to main content

Migrating to Criteo iOS SDK v4.0

Commerce Grid DocumentationIntegration Guides In-AppApp SDK (iOS)

Overview

CocoaPods Imports

Criteo iOS SDK v4.0 is now distributed via CocoaPods through source instead of binary.

If you've been using semantic import syntax to import Criteo SDK, as such: @import CriteoPublisherSdk;, you will need to do either of the following:

  • Enable use_frameworks! in your Podfile so that CocoaPods produce frameworks from source as before, keeping the same imports working, OR

  • Rename all Criteo imports in your project into standard CocoaPods imports, like so:
    #import <CriteoPublisherSdk/CriteoPublisherSdk.h>

Minimum iOS Version

Criteo iOS SDK v4.0 now requires minimum iOS deployment target on your project to be 9.0

Swift Runtime

Criteo iOS SDK v4.0 now contains Swift files, which means that if your project is Objective-C only, you must now have at least one .swift (even empty) file for Xcode to link against Swift runtime. Bridging header is not required.

Live Bidding

App Bidding with Ad Servers

For App Bidding integrations, setBidsForRequest:withAdUnit: has been replaced with a combination of loadBidForAdUnit: and enrichAdObject:withBid:. Please see the documentation of each ad server integrations for how to load and set Criteo bids on your Ad objects.

App Bidding for In-House Auction

On App Bidding for In-House Auction integrations, getBidResponseForAdUnit: has been replaced by loadBidForAdUnit:. Bid availability is represented with non-null CRBid object.

CRBidToken has also been removed. Pass the CRBid object directly to the loadAdWithBid: method that replaces loadAdWithBidToken: method.

Interstitial Ads

CRInterstitialDelegate

interstitialIsReadyToPresent: has been removed and merged to interstitialDidReceiveAd:. This method will be called when the Interstitial ad is successfully loaded, prefetched and ready to be displayed. You may now rely on this method to display Criteo Interstitial ad.

interstitial:didFailToReceiveAdContentWithError: has been removed and merged into interstitial:didFailToReceiveAdWithError:. This method is now called when the Interstitial ad fails to load or prefetch.

Mediation Adapters

If you're integrating our Google or MoPub mediation adapters via CocoaPods, you will need to update their pod names:

  • Google: CriteoGoogleMediationAdapters to CriteoPublisherSdk/GoogleAdapter

  • MoPub: CriteoMoPubMediationAdapters to CriteoPublisherSdk/MoPubAdapter