Advanced integration

As of November 13, 2023, Ogury Choice Manager is deprecated, meaning it will no longer be supported or updated.

Consequently, no new consent notices will be delivered through Ogury Choice Manager's APIs. Therefore, it is strongly advised against using Ogury Choice Manager in new versions of applications. In case you have migrated to a new Consent Management Platform (CMP), ensure that Ogury and its partners are included as vendors.

For earlier versions of applications still using Ogury Choice Manager, the API will maintain its functionality, continuing to return consent for users who have previously responded to a consent notice. This will remain in effect until their consent expires.

The Ogury SDK provides additional methods to handle specific cases. These methods are covered in this article.

Check the availability of the edit method

The edit option might not be available and then calling the edit method will return an error in the following cases:

• if the user is not located in the EU, i.e. not in a country where the GDPR applies;

• if the user has already paid to access your app using the Fair Choice feature;

• as a result of a specific configuration on the Ogury Dashboard;

Before displaying the edit button, you should check this option with the following method:

Swift

OguryChoiceManager.shared().editAvailable()

Objective-C

[[OguryChoiceManager sharedManager] editAvailable];

We recommend to use this method once the synchronization triggered by ask method has completed. Otherwise this method returns true by default.

Check if the GDPR applies

To check if the GDPR applies in the region of the user, you can call the following method:

Swift

OguryChoiceManager.shared().gdprApplies()

Objective-C

[[OguryChoiceManager sharedManager] gdprApplies];

We recommend to use this method only in the completion block of the ask and edit methods to get the updated value of the consent signal.

Special Features

Precise Geographic Location Data Feature

Your users can enable or disable collection and processing of their precise geographic location with Ogury Choice Manager.

You can use the following call to check if the user has consented to the collection of his geographic location:

Swift

OguryChoiceManager.shared().tcfV2.isSpecialFeatureAccepted(.preciseGeolocation)

Objective-C

[[[OguryChoiceManager sharedManager] tcfV2] isSpecialFeatureAccepted:OguryChoiceManagerSpecialFeaturePrecicesGeolocation];

We recommend to use this method only in the completion block of the ask and edit methods to get the updated value of the consent signal.

If there is no consent signal for a given user, this method returns false as default value. In this case, you can start Ogury SDK and other vendors' SDKs as if the user had not provided their consent. The consent notice will be displayed at the next ask call and the consent status will then be updated.

Scan devices characteristics

Your users can enable or disable scan, collection and processing of devices characteristics with Ogury Choice Manager.

You can use the following call to check if the user has consented to the scan and collection of devices characteristics:

Swift

OguryChoiceManager.shared().tcfV2.isSpecialFeatureAccepted(.scanDeviceCharacteriscs)

Objective-C

[[[OguryChoiceManager sharedManager] tcfV2] isSpecialFeatureAccepted:OguryChoiceManagerSpecialFeatureScanDeviceCharacteriscs];

We recommend to use this method only in the completion block of the ask and edit methods to get the updated value of the consent signal.

If there is no consent signal for a given user, this method returns false as default value. In this case, you can start Ogury SDK and other vendors' SDKs as if the user had not provided their consent. The consent notice will be displayed at the next ask call and the consent status will then be updated.