FAQ

Integration questions

General

Q: What is the minimum version of iOS?

  • Minimum iOS version : 10

Q: What is the minimum version of Xcode?

  • Minimum Xcode version : 11
Q: What is the minimum version of CocoaPods?
  • Minimum CocoaPods version : 1.10.0

Q: How to get the version of the Ogury SDK ?

You can call the following method to get version of the Ogury SDK.
Swift
Objective-C
1
Ogury.getSdkVersion()
Copied!
1
[Ogury getSdkVersion];
Copied!

Ad formats

Q: Can I reuse instances of OguryInterstitialAd, OguryOptinVideoAd and OguryThumbnailAd?

Yes. Once the previous ad has been closed, you can call load to load another ad.

Q: Will Ogury SDK prefetch the next interstitial, rewarded or thumbnail ad?

No. You are responsible to load the ad using the dedicated load method

Ogury Choice Manager

Q: What is an End User License Agreement (EULA)?

The EULA (End User Licence Agreement) is Ogury's default consent collection system. It allows new users to express their choice on the ad targeting and personal data collection, for Ogury and its partner, in order to maximize your revenue. It is delivered as the first ad for each new user without any additional integration than Monetization one.

Q: What is a vendor?

A vendor is a third-party entity:
  • that accesses an end user's device or browser and collects personal data.
  • that receives end user's personal data and processes them.

Q: Where can I find the id for a partner?

Ogury vendor list is a structured JSON file. It contains a map vendors containing all vendors currently supported by Ogury Choice Manager. The key in the vendors map correspond to the id associated to the vendor.
Example: If you look for Ogury in the vendor list, you find the following entry:
1
{
2
"id": 277,
3
"name": "Ogury Ltd.",
4
"policyUrl": "https://www.ogury.com/privacy-policy/",
5
...
6
}
Copied!
The id for Ogury is: 277.
You can reset your IDFA in Settings > Privacy > Advertising.
The Ogury SDK will consider you as a new user and will display the consent notice to gather your consent on the next call to ask.
If you have activate the 'Show the consent notice only in the European area' option in your Consent settings. The Ogury SDK will behave as following for user localized outside of European area:
  • ask or edit methods will never display any consent notice.
  • response completion block will always be called with FULL_APPROVAL answer.
  • isAccepted and isPurposeAccepted will return true for every vendor/purpose.
Choice Manager determines the country of the user by using the IP. In order to fake your location inside the GDPR area and see the consent notice, you can use a VPN solution.
Yes. Ogury Choice Manager caches the user consent for a few hours to avoid hitting the network every times your application starts.

Fair Choice

Q: Can I use an existing product (in-app purchase) for Fair Choice?

Yes, the payment will be validated by Ogury back-end and the user will be detected as a paying user on the next successful ask request.

Q: Can I use the Fair Choice product (in-app purchase) in another location in my application?

Yes, no problem. A paying user, outside of the consent notice will be synchronized on the next successful ask request.

Q: I want to use a product (in-app purchase) available in a previous version of my app. How can I inform Ogury SDK that the current user already paid?

It is not necessary to inform the Ogury SDK in this case.
On the first call of an ask method, the Ogury SDK will forward the payment token available to Ogury server which will take care of validating it with the store for the product you chose to use for Fair Choice.
In case of a valid payment, the Ogury SDK will update its state to answer true when you use the hasPaid method and will not show any consent notice for this specific user.

Q: What do I need to do when the current user is in payment status?

When Ogury successfully validated the payment of a user, the hasPaid method in the SDK returns false. When it is the case you need to stop any personal data collection and stop sending any ad request.

Q: Can I propose rewarded ads even if the user has paid?

More details in Ogury Help Center.

Troubleshooting

Q: How I can retrieved topViewController when Thumbnail Ad is displayed?

Thumbnail Ad is show inside a UIWindow that are at the level of UIWindowLevelStatusBar. So a basic topViewController method can provide the Thumbnail Ad like the topViewController.
To avoid that, you must exclude the Thumbnail Ad UIWindow in the method. Thumbnail Ad UIWindow can be found by the name of it rootViewController : OGAThumbnailAdViewController.
This is example of a topViewController method implementation :
1
extension UIApplication {
2
3
class func topViewController() -> UIViewController? {
4
let windows = UIApplication.shared.windows
5
6
for window in windows {
7
if (window.isKeyWindow && NSStringFromClass(window.rootViewController?.classForCoder ?? UIViewController().classForCoder) != "OGAThumbnailAdViewController") {
8
return self.topViewController(controller: window.rootViewController)
9
}
10
}
11
12
return nil
13
}
14
15
class func topViewController(controller: UIViewController?) -> UIViewController? {
16
if let navigationController = controller as? UINavigationController {
17
return topViewController(controller: navigationController.visibleViewController)
18
}
19
20
if let tabController = controller as? UITabBarController {
21
if let selected = tabController.selectedViewController {
22
return topViewController(controller: selected)
23
}
24
}
25
26
if let presented = controller?.presentedViewController {
27
return topViewController(controller: presented)
28
}
29
30
return controller
31
}
32
}
33
Copied!
If you have any trouble during your integration please contact the Ogury support team at [email protected].