Getting Started

Supported Versions

• iOS 13.0 or later
• Xcode 12.0 or later

danger

Starting from NAMSDK 4.3.0, Xcode 12.0 or later is required. (iOS 14 support)

danger

When using external ads, using the latest version of Xcode is recommended.

• Starting from NAMSDK 6.0.0, Xcode 14.1 or later is required when using DFP.
• Starting from NAMSDK 7.0.0, Xcode 15 or later is required when using Unity or IronSource.
• Starting from NAMSDK 8.0.0, Xcode 16 or later is required.

Integrating the Ad SDK

Adding CocoaPods Dependencies

Add NAMSDK to the Podfile generated after running pod init. Add Mediation Pods for the ad providers you want to integrate alongside the NAMSDK Pod.

target 'MyApplication' do
    pod 'NAMSDK'                        # SDK core
    pod 'NAMSDK/MediationNDA'           # Naver Banner/Native ads
    pod 'NAMSDK/MediationNDAVideo'      # Naver Video ads
    pod 'NAMSDK/MediationNDARich'       # Naver Premium ads (since 7.2.0)

    pod 'NAMSDKMediationDFP'           # Google DFP         (since 8.0.0)
    pod 'NAMSDKMediationFAN'           # Facebook FAN       (since 8.0.0)
    pod 'NAMSDKMediationInMobi'        # InMobi             (since 8.0.0)
    pod 'NAMSDKMediationUnity'         # Unity              (since 8.0.0)
    pod 'NAMSDKMediationAppLovin'      # AppLovin           (since 8.0.0)
    pod 'NAMSDKMediationVungle'        # Vungle             (since 8.0.0)
    pod 'NAMSDKMediationDT'            # Digital Turbine    (since 8.0.0)
    pod 'NAMSDKMediationIronSource'    # Iron Source        (since 8.0.0)
    pod 'NAMSDKMediationAPS'           # APS                (since 8.0.0)
    pod 'NAMSDKMediationLAN'           # LAN                (since 8.0.0)
    pod 'NAMSDKMediationChartBoost'    # ChartBoost         (since 8.4.0)
    pod 'NAMSDKMediationBidMachine'    # BidMachine         (since 8.4.0)
    pod 'NAMSDKMediationPangle'        # Pangle             (since 8.13.0)
end

Adding Swift Package Manager Dependencies

info

SPM is available starting from NAMSDK version 8.10.0 and above.

danger

SPM cannot be used when using external mediation. If you are using external mediation, it is recommended to integrate via CocoaPods.

Add the NAMSDK package dependency to your project.

1. In Xcode, click File > Add Package Dependencies.
2. In the Search or Enter Package URL field at the top right, search for the NAMSDK Swift package GitHub repository.

https://github.com/naver/nam-sdk-ios

3. Select the Swift package version you want to use.
4. In Xcode, go to App Target > Build Settings > Other Linker Flags and add the -ObjC option.

List of Supported Ad Providers

When Using CocoaPods

Internal Ad Providers

Ad Provider Name	Supported Ad Types	CocoaPods Setting
Naver	Banner, Native (NS, NN)	pod NAMSDK/MediationNDA
Naver	Video	pod NAMSDK/MediationNDAVideo
Naver	Native Rich Reward	pod NAMSDK/MediationNDARich

External Ad Providers

danger

Please verify version compatibility between NAMSDK and NAMSDKMediation on the Mediation Network Version page before applying.

Ad Provider Name	Supported Ad Types	CocoaPods Setting
Google DFP	Banner, Native, Interstitial, Reward	pod NAMSDKMediationDFP
Facebook	Banner, Native, Interstitial, Reward	pod NAMSDKMediationFAN
InMobi	Banner, Native	pod NAMSDKMediationInMobi
Unity	Banner, Interstitial, Reward	pod NAMSDKMediationUnity
AppLovin	Banner, Native, Interstitial, Reward	pod NAMSDKMediationAppLovin
Vungle	Interstitial, Reward	pod NAMSDKMediationVungle
DigitalTurbine	Banner, Interstitial, Reward	pod NAMSDKMediationDT
IronSource	Interstitial, Reward	pod NAMSDKMediationIronSource
APS	Reward	pod NAMSDKMediationAPS
LAN	Native (NS, NN), Interstitial, Reward	pod NAMSDKMediationLAN
ChartBoost	Banner, Interstitial, Reward	pod NAMSDKMediationChartBoost
BidMachine	Banner, Interstitial, Reward	pod NAMSDKMediationBidMachine
Pangle	Banner, Native, Interstitial, Reward	pod NAMSDKMediationPangle

When Using SPM

Ad Provider Name	Supported Ad Types
Naver	Banner, Native (NS, NN)
Naver	Video
Naver	Native Rich Reward

ATS (App Transport Security) Settings

App Transport Security (ATS), introduced in iOS 9, configures apps to make network requests only over HTTPS by default. To allow ads from ad partners that use HTTP, add the following to your Info.plist file.

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

Notes When Integrating Google DFP

When integrating Google DFP, you must additionally add the following to your Info.plist file. Otherwise, the operation will halt with a message such as "The Google Mobile Ads SDK was initialized incorrectly."

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

Starting from Google DFP version 10, additional configuration is required as follows.

danger

• Required for the Ad Manager app ID of all Ad Manager apps in Info.plist, and it must be in the format ca-app-pub-################~##########. For more details, refer to the Info.plist update guide.
• https://developers.google.com/ad-manager/mobile-ads-sdk/ios/migration?hl=ko#requirement_of_ad_manager_app_id

Deprecated

Adding CocoaPods Dependencies (~v7)

Add NAMSDK to the Podfile generated after running pod init. Add Mediation Pods for the ad providers you want to integrate alongside the NAMSDK Pod.

target 'MyApplication' do
    pod 'NAMSDK'                        # SDK core
    pod 'NAMSDK/MediationNDA'           # Naver Banner/Native ads
    pod 'NAMSDK/MediationNDAVideo'      # Naver Video ads
    pod 'NAMSDK/MediationNDARich'       # Naver Premium ads (since 7.2.0)
    pod 'NAMSDK/MediationDFP'           # Google DFP
    pod 'NAMSDK/MediationFAN'           # Facebook FAN
    pod 'NAMSDK/MediationInMobi'        # InMobi
    pod 'NAMSDK/MediationUnity'         # Unity
    pod 'NAMSDK/MediationAppLovin'      # AppLovin (since 5.0.0)
    pod 'NAMSDK/MediationVungle'        # Vungle (since 6.0.0)
    pod 'NAMSDK/MediationDT'            # Digital Turbine (since 6.5.0)
    pod 'NAMSDK/MediationIronSource'    # Iron Source (since 7.2.0)
    pod 'NAMSDK/MediationAPS'           # APS (since 7.2.0)
    pod 'NAMSDK/MediationLAN'           # LAN (since 7.7.0)
end

List of Supported Ad Providers (~v7)

Ad Provider Name	Supported Ad Types	CocoaPods Setting
Naver	Banner, Native (NS, NN)	pod NAMSDK/MediationNDA
Naver	Video	pod NAMSDK/MediationNDAVideo
Naver	Native Rich Reward	pod NAMSDK/MediationNDARich
Google DFP	Banner, Native, Interstitial, Reward	pod NAMSDK/MediationDFP
Facebook	Banner, Native, Interstitial, Reward	pod NAMSDK/MediationFAN
InMobi	Banner, Native	pod NAMSDK/MediationInMobi
Unity	Banner, Interstitial, Reward	pod NAMSDK/MediationUnity
AppLovin	Banner, Native, Interstitial, Reward	pod NAMSDK/MediationAppLovin
Vungle	Banner, Native, Interstitial, Reward	pod NAMSDK/MediationVungle
DigitalTurbine	Banner, Interstitial, Reward	pod NAMSDK/MediationDT
IronSource	Interstitial, Reward	pod NAMSDK/MediationIronSource
APS	Reward	pod NAMSDK/MediationAPS
LAN	Native (NS, NN), Interstitial, Reward	pod NAMSDK/MediationLAN

---

Developers DA.SSP.SDK개발