The Mobile App Consent is different from cookie consents on websites. Your users can consent to different purposes or statements. These are called consent items.
The consent items could be; You are 18 or above, you agree to terms and conditions, you agree to receive newsletters, and any other type of agreement you need with your app user.
Table of contents
Creating a Mobile App Consent in the Cookie Information Platform
Once Mobile App Consent has been enabled on your account you will be able to create your consent solution in the platform, similar to how you already do with Consent Solutions for domains.
You are able to:
Give your Mobile App Consent Solution a name
Specify which mobile application it is for
Specify whether the Mobile App Consent is for Android or iOS (or both)
Give a short description of what your mobile application is about
Creating a Mobile Consent Item (agreement) in the Cookie Information Platform
Once this is done, you will then be ready to add your first Consent Item ("agreement"). Remember that there's no limit to the number of Consent Items your Mobile Consent Solution can contain.
To create your first Consent Item, click on the orange button as shown:
You will then be presented with the following options:
Fill in the name of your Consent Item (e.g. Terms of Service, Use of Advertising, Newsletter, etc)
Select the language or languages that you would like the Consent Item to be available in
You'll then be able to give a short and long description of each item (both of which can be displayed to the user if you wish).
Implementing the Mobile App Consent SDK Into Your Mobile Application
Once your Consent Solution and Consent Items have been created, you'll be presented with the SDK for your chosen operating system.
To properly integrate the SDK, you'll need the help of a mobile application developer if you are not the one who is building and maintaining the application.
To get started with integrating the SDK, you'll need to add a dependency so that it is included in your project.
For Android you need to add the dependency in the file called:
If you're using Groovy DSL, then the line you'll need to add is:
If you're using Kotlin DSL, then the line you'll need to add is:
For instructions on how to initialize the SDK, sending consent to a server, as well as retrieving locally saved consent data, please see:
For iOS, the MobileConsentsSDK is available through CocoaPods.
To install the SDK, add the following line to your Podfile:
Once that's done, run the command:
For instructions on how to initialize the SDK, retrieve a Consent Solution, sending consent to a server, and retrieving locally saved consents data, please see:
How your server fits into the flow of a Mobile App Consent Solution
Your server is one of the last steps in the process and only used for ensuring authentication before the authorized consent request is sent to us.
Your server will receive the Consent Request from your mobile application in the format of JSON.
Implementing the Consent Request Server
Because it must be ensured that consent is legitimate when querying our API (so no one is able to pretend that it came from your application) the request can't be sent directly from your mobile application.
In order to achieve (and allow) secure authentication, Consent Requests are communicated server-to-server.
The server's role is to work as a proxy between your mobile application and the Cookie Information Consent API.
In most cases, there won't be any need to specifically set up a new server for the purpose of implementing Mobile App Consent - as you can always use the existing backend that your mobile application already possesses.
However, there are a few general requirements:
Your server must allow secure authentication
Your server must be http and able to talk to an endpoint
Your server must support oauth
Placing and Formatting Consent Items
How you would like to place and format your Consent Items is entirely up to you - you have free reign. By default, we do not add any styling or formatting (though they could be tickboxes, checkboxes, or toggles) because we're only providing the data.
However, it could look something like below:
Updating Consent When A User Declines Certain Agreements
Currently at this time, there isn't any automation around updating consent from a user as we do not have information on how particular Consent Items relate to specific parts of your application.
For this reason, data saved in local storage will be able to show you which consent items a user agreed to (or didn't). You can use this to then allow or restrict certain features of your application that require these consents.