Get Started

Integrating the Google Mobile Ads SDK into an app is the first step toward displaying ads and earning revenue. Once you've integrated the SDK, you can proceed to implement one or more of the supported ad formats.

Prerequisites

• Use Xcode 11 or higher
• Target iOS 8.0 or higher

Note: Beginning with iOS 9, iOS apps use App Transport Security (ATS), a data-in-transit security feature that enforces encrypted connections. See App Transport Security to configure your info.plist before continuing to ensure your ads are not impacted by ATS.

Import the Mobile Ads SDK

CocoaPods (preferred)

The simplest way to import the SDK into an iOS project is to use CocoaPods. Open your project's Podfile and add this line to your app's target:

pod 'Google-Mobile-Ads-SDK'

Then from the command line run:

pod install --repo-update

If you're new to CocoaPods, see their official documentation for info on how to create and use Podfiles.

Manual download

1. Download and unzip the SDK framework directly, and import the following frameworks into your Xcode project:

   • GoogleAppMeasurement.framework
   • GoogleMobileAds.framework
   • GoogleUtilities.framework
   • nanopb.framework
   • PromisesObjC.xcframework

2. Add the -ObjC linker flag to Other Linker Flags in your project's build settings:

   

Update your Info.plist

Declare that your app is an Ad Manager app by adding the GADIsAdManagerApp key with a <true/> value to your app's Info.plist.

<key>GADIsAdManagerApp</key>
<true/>

Or, edit it in the property list editor:

Warning: This step is required as of Google Mobile Ads SDK version 7.42.0. Failure to add add this Info.plist entry results in a crash with the message: The Google Mobile Ads SDK was initialized incorrectly.

Select an ad format

The Mobile Ads SDK is now imported and initialized, and you're ready to implement an ad. Ad Manager offers a number of different ad formats, so you can choose the one that best fits your app's user experience.

Banner

Rectangular ads that appear at the top or bottom of the device screen. Banner ads stay on screen while users are interacting with the app, and can refresh automatically after a certain period of time. If you're new to mobile advertising, they're a great place to start.

Implement a Banner

Interstitial

Full-screen ads that cover the interface of an app until closed by the user. They're best used at natural pauses in the flow of an app's execution, such as between levels of a game or just after a task is completed.

Implement an Interstitial

Native

Customizable ads that match the look and feel of your app. You decide how and where they're placed, so the layout is more consistent with your app's design.

Google Ad Manager offers two ways to implement native ads: Native Styles and Custom Rendering.

Native Styles has been designed to make the implementation of native ads as easy as possible, and it's a great choice if you are new to the format. Custom Rendering has been designed to maximize the freedom you have in creating your presentations.

Implement Native Styles

Implement Custom Rendering

Rewarded

Ads that reward users for watching short videos and interacting with playable ads and surveys. Good for monetizing free-to-play users.

Implement Rewarded Ads

Implement Rewarded Ads (new APIs)