Get started with iOS Header Bidder SDK for GAM

Step 1: Add the following lines to the Podfile.

The Podfile should now look similar to this:

Step 2: Save the Podfile, then do the following:

1. Open the Terminal application.

2. Change to your app’s project directory; for example:

   cd /Developer/Projects/MyApp/

3. Now execute the following command:

   pod install --repo-update

   Integrate manually

   Before you begin, check the compatibility matrix to make sure you’re using the appropriate handler for your project’s requirements.

   Compatibility matrix

   The Adapex header bidder handler for GAM is the bridge between the Adapex header bidder SDK and an ad server SDK. To ensure you’re using the appropriate handler for your project’s requirements, check the Adapex and GAM version compatibility matrix. 

   If the latest handler doesn’t support the GAM SDK version you’re using, download the appropriate handler before proceeding.

   Follow these steps to perform a manual integration.

   Step 1. Download the Adapex SDK zip file.

   • Download and unzip the header bidder SDK v2.6.2 .
   • Include the AdapexSDK  folder in your Xcode project, select Copy items if needed,  and Create groups while including them.

   Step 2. Download the Handlers. 

   • Download and unzip Adapex Handlers v3.0.1.
   • Include the AdapexDFP folder in your Xcode project, and select Copy items if needed and  Create groups while including.

   Step 3. Add the following required Adapex header bidder SDK frameworks to your project:

   • Foundation.framework
   • UIKit.framework
   • MessageUI.framework
   • CoreLocation.framework
   • EventKitUI.framework
   • EventKit.framework
   • AdSupport.framework
   • SystemConfiguration.framework
   • CoreGraphics.framework
   • CoreTelephony.framework
   • WebKit.framework

   Step 4. Add the -ObjC linker flag to your project’s Build Settings > Targets > Linking > Other Linker Flags:

   

   App transport security (ATS)

   Our header bidder SDK defaults to secure ad calls and delivers only secure ads using App Transport Security (ATS), an iOS feature that encrypts data in transit using HTTPS, instead of HTTP. ATS enforces a minimum security level for communications between mobile apps and web services that support them. Software development kits (SDKs) for iOS 9.0 or greater enable ATS by default, but developers can opt-out by setting the app’s NSAllowsArbitraryLoads key to True.

   If you configure the Adapex header bidder SDK to serve non-secure ads:

   As described in Advanced topics > Configure SSL, then opt-out of ATS as shown in the example below.

   The following log message appears when you request a non-ATS compliant ad via HTTP in your app running iOS 9 or greater:

   App Transport Security has blocked a cleartext HTTP (http://) resource load since it is insecure. Temporary exceptions can be configured via your app’s Info.plist file.

   To allow non-secure ads over http, disable ATS by including the following entry in your app’s Info.plist file:

   App Transport Security Settings

   1 2 3 4 5

   <key>NSAppTransportSecurity</key> <dict>     <key>NSAllowsArbitraryLoads</key>     <true/> </dict>

   iOS 14 integration

   iOS 14 brings several changes to enhance the ad experience for mobile users. See the following section to request App Tracking Transparency(ATT) authorization and to configure SKAdNetwork in your app.

   Request App Tracking Transparency (ATT) authorization

   To display the App Tracking Transparency authorization request to access the IDFA, update your  Info.plist  to add the  NSUserTrackingUsageDescription  key with a custom message describing your intended IDFA usage. For example:

   Privacy – Tracking Usage Description

   1 2	<key>NSUserTrackingUsageDescription</key> <string>The Advertising Identifier helps deliver ads that are relevant to your interests.</string>

   

   The usage description appears in the App Tracking Transparency dialog box.

   To present the authorization request, call  requestTrackingAuthorizationWithCompletionHandler: . The best practice is to wait for the completion callback prior to loading ads so that if the user grants the ATT permission, the ad server SDK can immediately use the IDFA in ad requests.

   Objective-CSwift

   1 2 3 4 5 6 7 8 9

   #import <AppTrackingTransparency/AppTrackingTransparency.h> #import <AdSupport/AdSupport.h>   if(@available(iOS 14, *)) {     [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {         // Use trackingAuthorizationStatus to determine the app-tracking permission status.         // See ATTrackingManager.AuthorizationStatus for status enums.     }]; }

   For more information about the possible status values see,  ATTrackingManager.AuthorizationStatus .

   Best practices

   • Add a priming message preceding the call to requestTrackingAuthorizationWithCompletionHandler: to better explain the permission and data usage to users.
   • Request the ad only after post-authorization callback. This lets Adapex wrapper SDK immediately access and pass the IDFA in the ad request if that user approved the IDFA access request. 

   Configure SKAdNetwork settings to track conversions

   The Adapex header bidder SDK is compatible with iOS 14 and supports Apple’s SKAdNetwork 2.0, which allows mobile apps to install attribution for demand partners buying in-app inventory from iOS 14, while also preserving user privacy. 

   To enable install attribution, you must update the SKAdNetworkItems key with additional network ID dictionary entries in your app’s  Info.plist .

   Get the latest SKAdNetwork ad network IDs

   Include ad network IDs in your information property list:

   1. Select Info.plist in the Xcode Project navigator.

   2. Click the Add button (+) beside a key in the property list editor, then press Return.

   3. Type the key name,  SKAdNetworkItems.

   4. Choose Array from the pop-up menu in the Type column, then enter the dictionary entries as shown below.

      1 2 3 4 5 6 7 8 9 10

      <array>  <dict>    <key>SKAdNetworkIdentifier</key>    <string>example100.skadnetwork</string>  </dict>  <dict>    <key>SKAdNetworkIdentifier</key>    <string>example200.skadnetwork</string>  </dict> </array>

   If users tap an ad that attempts an API call for an ad network that doesn’t have an entry in the Info.plist, the system won’t initiate install validation. Also, note that missing this step can negatively affect the fill rate.

   Supported ad formats

   Now that you’ve integrated the Adapex header bidder iOS SDK, you’re ready to begin implementing ads in your app. Our wrapper iOS SDK currently supports two ad formats:

   Banner :

   Mobile banner ads usually appear as a short strip spanning the width of the app page or screen, positioned above or below the app content. Banner ads can be static or animated images, any mobile-compatible rich media ad format, or in-banner video.

   Native and Banner:

   Native ads are native assets rendered via an app’s native UI components to provide a consistent visual design. Though the header bidder SDK doesn’t support native ads separately, you can combine native and banner requests to support native inventory through the SDK’s header bidding feature.

   Interstitial :

   Mobile interstitial ads fill the screen or page and require the user to dismiss the ad before they can view/access the app’s main content. Interstitial ads also support static or animated full-screen images, any mobile-compatible rich media ad format, or full-screen video.

   Rewarded :

   Mobile rewarded ads fill the screen or page and require the user to dismiss the ad before they can view/access the app’s main content. Rewarded ads support only full-screen video ad formats. Once video playback completes the user receives in-app rewards