Breadcrumbs

Mobile App Integration

The Utiq Mobile SDK provides a consistent way to integrate Utiq services into native Android and iOS applications.

The Android SDK is distributed through GitHub Packages and supports Kotlin and Java on Android API level 24 or later and the iOS SDK is distributed through Swift Package Manager or as the published binary framework and supports Swift on iOS 12 or later.

To enable the Utiq technology in your app, we require all the items listed in the Consent Experience on Mobile App page to be implemented ahead of go-live.

Note, regarding Apple ATT, the responsibility of if / what identifiers are used is with the wrapping application. The Utiq SDK will not return adtechpass when the user opted in for ATT.

Mobile App Checklist

This is a checklist to show you the onboarding process for a native app.

Note that examples of Android have been used within links, as demonstration. Please relate to the similar functions on iOS operating system.

  1. Implement Utiq Consent Experience on your CMP

  2. Create a native Manage Utiq page and add menu link leading to the page

    1. In Manage Utiq page, use Utiq.rejectConsent() on one-click-revoke feature

  3. Include Utiq text in Privacy Policy page

  4. Install Utiq SDK within your app, with the API token provided by Utiq

    1. If CMP consent does not exist for Utiq, do not call any of the ID fetching SDK functions

    2. If CMP consent exists for Utiq, Get Utiq IDs & Consent Sync

    3. If CMP consent exists for Utiq, and user revokes, then ‘Reject’ Utiq consent

  5. Test the integration with UtiqOptions().enableLogging() and monitor for errors

  6. On production build remove enableLogging()

  7. Make sure you always use the latest Utiq SDK following our release notes

Notes

  • We need you to provide us with a desired app friendly name, as it will appear on https://consenthub.utiq.com/

  • After we configure your app in our platform, we will provide an SDK Token which is needed for initializing the SDK

  • For testing, send us the public IP address your test device connects from and we will whitelist it, so the device is treated as an eligible Telco connection