GFPAdConfiguration Options

GFPAdConfiguration is an object used to specify app-wide settings at SDK initialization or at runtime.
It can be accessed at any time via GFPAdManager.adConfiguration().

Prerequisites

• Getting Started

Options Summary

Property	Type	Default	Description
bannerAdRequestTimeout	NSTimeInterval	60s	Banner ad request timeout
videoAdRequestTimeout	NSTimeInterval	60s	Video ad request timeout
unifiedAdRequestTimeout	NSTimeInterval	60s	Unified (banner + native) ad request timeout
rewardedAdRequestTimeout	NSTimeInterval	60s	Rewarded ad request timeout
interstitialAdRequestTimeout	NSTimeInterval	60s	Interstitial ad request timeout
preferredLanguage	GFPLanguageType	.none	Language for ad UI components
adInterfaceStyle	GFPAdInterfaceStyle	.light	Ad UI style (light / dark / system)
customParam	[String: String]?	nil	Global custom parameters
muteAudio	Bool	true	Mute ad audio (applies to C2S AP and S2S reward ads)
useLoudness	Bool	false	Enable Loudness Normalization for video ads
manageAudioSession	Bool	false	Let the SDK manage the audio session during outstream ad video playback
useDefaultUA	Bool	false	Use the SDK's built-in default User-Agent for ad requests
externalUserAgent	String	—	User-Agent injected from outside the SDK
logLevel	GFPLogLevel	.none	SDK console log level
disableCrashReport	Bool	false	Disable CrashReport from external DSP SDKs (e.g. DFP)
useDefaultSafariBrowser	Bool	false	Use the default in-app browser for S2S ad landing
disableAdID	Bool	false	Disable IDFA collection
disableLocationInfo	Bool	false	Disable location information collection
privacySetting	GFPPrivacySetting?	nil	Privacy settings for GDPR / CCPA / GPP
adProviderConfigList	[GFPAdProviderSetting]	[]	Test mode settings per ad provider
phase	GFPPhaseType	.real	Ad server environment (test / production)

---

Timeout Settings

Sets the request timeout in seconds for each ad type.

Swift

let config = GFPAdManager.adConfiguration()
config.bannerAdRequestTimeout = 30
config.videoAdRequestTimeout = 30
config.unifiedAdRequestTimeout = 30
config.rewardedAdRequestTimeout = 30
config.interstitialAdRequestTimeout = 30

Objective-C

GFPAdConfiguration *config = [GFPAdManager adConfiguration];
config.bannerAdRequestTimeout = 30;
config.videoAdRequestTimeout = 30;
config.unifiedAdRequestTimeout = 30;
config.rewardedAdRequestTimeout = 30;
config.interstitialAdRequestTimeout = 30;

info

Setting requestTimeoutInterval directly on each ad manager (GFPBannerView, GFPRewardedAdManager, etc.) applies an individual timeout only to that instance.

---

Language Settings

Specifies the language for UI components of ads served via S2S.
When set to none, rendering is based on the device language; if the language is not supported, English is used.

Supported languages: Korean (ko), English (en), Thai (th), French (fr), Spanish (es), Indonesian (id), Traditional Chinese (zh_Hant), Simplified Chinese (zh_Hans), Japanese (ja), German (de)

Swift

GFPAdManager.adConfiguration().preferredLanguage = .ko

Objective-C

[GFPAdManager adConfiguration].preferredLanguage = GFPLanguageType_ko;

info

This must be set before loading an ad. If changed after loading, the language of already-loaded ads will not change — you must reload the ad after changing the language.

---

UI Style

Sets the style of ad UI components (such as the Admute icon).

Value	Description
.light	Light mode (default)
.dark	Dark mode
.system	Follows the device system setting

Swift

GFPAdManager.adConfiguration().adInterfaceStyle = .light
GFPAdManager.adConfiguration().adInterfaceStyle = .dark
GFPAdManager.adConfiguration().adInterfaceStyle = .system

Objective-C

[GFPAdManager adConfiguration].adInterfaceStyle = GFPAdInterfaceStyleLight;
[GFPAdManager adConfiguration].adInterfaceStyle = GFPAdInterfaceStyleDark;
[GFPAdManager adConfiguration].adInterfaceStyle = GFPAdInterfaceStyleSystem;

---

Global CustomParam Settings

Sets custom parameters to be applied globally to all ad placements. Both keys and values must be strings.

When a key conflicts with GFPAdParam.customUserParam, the priority is as follows:

GFPAdParam.customUserParam > GFPAdConfiguration.customParam

Swift

GFPAdManager.adConfiguration().customParam = ["key1": "value1", "key2": "value2"]

Objective-C

[GFPAdManager adConfiguration].customParam = @{@"key1": @"value1", @"key2": @"value2"};

---

Mute / Volume

Ad Audio Mute

Sets whether to mute audio for C2S ads and S2S rewarded ads (excludes instream and outstream).

Swift

GFPAdManager.adConfiguration().muteAudio = true  // 기본값
GFPAdManager.adConfiguration().muteAudio = false

Objective-C

[GFPAdManager adConfiguration].muteAudio = YES;  // 기본값
[GFPAdManager adConfiguration].muteAudio = NO;

Loudness (Automatic Volume Adjustment)

Sets whether to use Loudness Normalization during video ad playback.

Swift

GFPAdManager.adConfiguration().useLoudness = true

Objective-C

[GFPAdManager adConfiguration].useLoudness = YES;

Audio Session Management (since 8.27.0)

Lets the SDK manage the AVAudioSession category while outstream ad videos (native, rich, rewarded, interstitial) are playing. (Default: false) This prevents audio from other apps (e.g. music apps) from being interrupted by muted ad video playback.

When multiple ad videos play at the same time, the SDK aggregates their playback states to decide a single category.

Playback State	Audio Session Category
All playing videos are muted	Ambient (mixes with audio from other apps)
At least one video is unmuted	SoloAmbient (ad sound only, respects the silent switch)
All videos stopped	Restores the category used before management started and notifies other apps so their interrupted audio can resume

Swift

GFPAdManager.adConfiguration().manageAudioSession = true

Objective-C

[GFPAdManager adConfiguration].manageAudioSession = YES;

info

• Not applied to instream and IMA ads.
• If your app manages the audio session itself, leave this option false and, if needed, control the audio session in the adPlayerWillPlay:isMuted: callback of GFPVideoEventDelegate.
• If a video is unmuted and then muted again during playback, the category switches to Ambient, but audio from other apps that was already interrupted resumes only after ad video playback ends.

GFPAudioSessionManagerDelegate

If you need to control your app's own audio (TTS, background music, etc.) while using this option, set the delegate of GFPAudioSessionManager.

Method	Description
audioSessionManagerWillPlayAudio:	Called right before an ad video plays unmuted and interrupts audio from other apps. Use it to pause your app's own audio.
audioSessionManagerDidStopPlayingAudio:	Called after all ad video playback has ended and the audio session has been restored to its state before management started. Use it to resume your app's own audio.

Swift

GFPAudioSessionManager.sharedInstance.delegate = self

func audioSessionManagerWillPlayAudio(_ manager: GFPAudioSessionManager) {
    // Pause your app's own audio
}

func audioSessionManagerDidStopPlayingAudio(_ manager: GFPAudioSessionManager) {
    // Resume your app's own audio
}

Objective-C

[GFPAudioSessionManager sharedInstance].delegate = self;

- (void)audioSessionManagerWillPlayAudio:(GFPAudioSessionManager *)manager {
    // Pause your app's own audio
}

- (void)audioSessionManagerDidStopPlayingAudio:(GFPAudioSessionManager *)manager {
    // Resume your app's own audio
}

---

User-Agent

Use SDK Default UA

Requests ads using the Default User-Agent defined within the SDK.

Swift

GFPAdManager.adConfiguration().useDefaultUA = true

Objective-C

[GFPAdManager adConfiguration].useDefaultUA = YES;

Inject External User-Agent

Injects the User-Agent used by the app's WebView into the SDK.

Swift

GFPAdManager.adConfiguration().externalUserAgent = "MyApp/1.0 ..."

Objective-C

[GFPAdManager adConfiguration].externalUserAgent = @"MyApp/1.0 ...";

---

Log Level

Sets the SDK console log output level. Only logs at or above the specified level are printed.

Value	Description
.none	No log output (default)
.trace	Detailed trace logs
.debug	Debug logs
.info	Informational logs
.error	Error logs
.critical	Critical error logs

Swift

GFPAdManager.adConfiguration().logLevel = .debug

Objective-C

[GFPAdManager adConfiguration].logLevel = GFPLogLevelDebug;

---

Privacy / Permission Settings

Disable IDFA Collection

If your app's policy prohibits the use of IDFA, this disables IDFA collection regardless of the device's permission status.

Swift

GFPAdManager.adConfiguration().disableAdID = true

Objective-C

[GFPAdManager adConfiguration].disableAdID = YES;

Disable Location Information Collection

Prevents the SDK from using location information even if the service has obtained location permission.

Swift

GFPAdManager.adConfiguration().disableLocationInfo = true

Objective-C

[GFPAdManager adConfiguration].disableLocationInfo = YES;

Privacy Settings (GDPR / CCPA / GPP)

Applies settings required by privacy regulations such as GDPR, CCPA, and GPP.

Swift

let privacy = GFPPrivacySetting(underAgeOfConsent: nil, childDirected: NSNumber(value: false))
GFPAdManager.adConfiguration().privacySetting = privacy

Objective-C

GFPPrivacySetting *privacy = [[GFPPrivacySetting alloc] initWithUnderAgeOfConsent:nil
                                                                    childDirected:@NO];
[GFPAdManager adConfiguration].privacySetting = privacy;

---

Other Settings

Disable CrashReport

Disables the CrashReport feature from external DSP SDKs (e.g. DFP).

Swift

GFPAdManager.adConfiguration().disableCrashReport = true

Objective-C

[GFPAdManager adConfiguration].disableCrashReport = YES;

Use Default In-App Browser

Uses the SDK's built-in in-app browser when landing on S2S ad destinations.

Swift

GFPAdManager.adConfiguration().useDefaultSafariBrowser = true

Objective-C

[GFPAdManager adConfiguration].useDefaultSafariBrowser = YES;

Ad Provider Test Mode

Configures specific ad providers to receive test ads.

Swift

GFPAdManager.adConfiguration().adProviderConfigList = [
    .type(.DFP, testMode: true),
    .type(.FAN, testMode: true)
]

Objective-C

[GFPAdManager adConfiguration].adProviderConfigList = @[
    [GFPAdProviderSetting type:GFPAdProviderSettingTypeDFP testMode:YES],
    [GFPAdProviderSetting type:GFPAdProviderSettingTypeFAN testMode:YES]
];