Didomi - Developers documentation
  • Introduction
  • SDKs
    • Introduction
    • Web SDK
      • Getting started
      • Tags and vendors management
        • Tags management
          • Events & Variables
            • Deprecated
            • Custom events
          • Tag managers
            • Adobe Launch/DTM
            • Eulerian
            • Google Tag Manager
              • Configure the Didomi / GTM integration
              • Didomi's GTM template
            • Tealium
            • Other tag managers
        • Custom Didomi <script> tags
        • Third-party integrations
          • Google Ad Manager / AdSense
            • GDPR via Non-Personalized Ads
              • Share consent and load/refresh ads
              • Share consent without loading or refreshing ads
            • US states laws
          • Google Consent Mode V2
          • Kameleoon
          • Piano Analytics (AT Internet)
          • Prebid
            • GDPR via IAB TCF
            • US states laws
          • Salesforce DMP (Krux)
        • IAB frameworks
        • Programmatic API
      • Configuration
        • Bots (SEO & Performance tools)
        • Configuration by URL
        • Cookies and storage
        • Custom domains for events
        • Notice
          • Behavior
          • Interactions
          • Look and feel
        • Preferences
        • Theme
      • AB tests
      • Custom domain
        • Domain delegation
        • Reverse proxy
      • Share consents between domains
      • Share consents across devices
      • Pass user choices in query string
      • Serve Didomi assets from your domain
      • Reference
        • API
          • Deprecated
        • Events
      • Performance
    • Mobile and TV SDKs
      • Android and Android TV
        • Setup
        • Logging
        • Reference
          • API
            • Deprecated
          • Events
        • Versions
      • iOS and tvOS
        • Setup
        • Logging
        • App Tracking Transparency (iOS 14.5+)
        • Reference
          • API
            • Deprecated
          • Events
        • Versions
      • Unity
        • Setup
        • Reference
        • Versions
        • Troubleshooting
      • React Native
        • Setup
        • Reference
          • Deprecated
        • Versions
      • Flutter
        • Setup
        • Reference
        • Versions
      • Consent notice
        • Getting started
        • Customize the notice
        • Customize the preferences popup
        • Customize the theme & UI
        • Load notice by ID
      • Third-party SDKs
      • Share consents across devices
      • Share consent with WebViews
      • Google Consent Mode v2
      • FAQ
    • AMP SDK
      • Blocking Behaviors
        • Load immediately on page load
        • Load only after consent (positive or negative)
        • Load only after positive consent
      • Consent status for vendors
    • Help & Support
  • API
    • Introduction
      • Authentication
      • Errors
      • Pagination
      • Filters
      • Caching
      • Rate limiting
      • Quotas
      • Translations
    • Data Manager
      • Regulations
      • Configuration Tree
      • Purposes
        • Purposes & Vendors Numerical IDs
      • Preferences Library
      • User Rights
    • Widgets
      • Consent notices
        • Notices
        • Configurations
        • Multi-Regulation Configurations
          • Migration of Existing Notices and API Updates
        • Deployments
        • Tutorials
          • Create and publish a consent notice
          • Create and publish a multi-regulation consent notice
      • Privacy widgets
        • Create a widget
        • Retrieve widgets
        • Edit a widget
          • Content & Design
            • Themes & Shapes
            • Components
              • auth
              • dsar_form
              • footer
              • header
              • preference
              • preference_value
              • save
              • section
              • sections
            • Options
          • Purposes & preferences
          • Settings
        • Deploy a Widget
          • Use your own subdomain
          • Use your own domain
          • Implement an embeddable widget on your website
        • Authentication
          • Manage authentication providers
          • Authenticate your end-user
        • Archive a widget
        • Headless widgets
          • Public Methods
          • Custom elements
          • Custom events
          • Event listeners
        • Tutorial
          • Launch a Preference Center from a mobile app
    • Compliance Reports
      • Properties
      • Reports
      • CSV format reference
      • Websites
    • Consents and Preferences
      • Events
        • Generate IAB TCF consent string
      • Links
      • Proofs
      • Tokens
      • Secrets
      • Users
      • Tutorial
        • Collect and operate data
    • Privacy Requests
      • Requests
      • Notes
      • Links
      • Emails
  • Integrations
    • Introduction
      • Quotas
    • Generic integrations
      • Batch export
        • Destinations
          • AWS S3 Bucket (owned by Didomi)
          • GCP Storage Bucket
        • Exported data
          • Notices consents
        • Logs
      • Webhooks
      • Batch import
      • Analytics export
        • Destinations
          • AWS S3 Bucket (owned by Didomi)
          • GCP Storage Bucket
    • Third-party apps
      • CMP integrations
        • Didomi-mParticle integration for your CMP
        • Deploy Didomi’s SDK for your Adobe Commerce website
      • Preference Management Platform integrations
        • Actito
        • Adobe Campaign Classic
        • Adobe Experience Cloud
        • Adobe Marketo Engage
        • Adobe Source Connector
        • Braze
        • Dotdigital
        • Hubspot
        • Mailchimp
        • Microsoft Dynamics 365
        • Salesforce Marketing Cloud
        • Salesforce Sales & Service Cloud
        • Selligent
        • Brevo (ex Sendinblue)
    • Tutorials
      • Configure a HTTP webhook
      • Configure a batch export
      • Configure an analytics export
    • Emailing
      • Configurations
        • Actito Email
        • Actito SMS
        • Adobe Campaign Classic
        • Adobe Campaign Standard
      • Emails
        • Templates
        • Manage your templates
Powered by GitBook
On this page
  • Web and AMP SDKs
  • Share GTM Preview with the Didomi Team
  • Mobile SDKs
  • Sample applications
  • Using Android Gradle Plugin 7.2.X and JaCoCo
  • Sharing apps with the Didomi team
  • Information for debugging mobile apps
  • CocoaPods integration issue when using custom Build Configurations
  • API Events endpoint contains wrong SDK version
  1. SDKs

Help & Support

PreviousConsent status for vendorsNextIntroduction

Last updated 1 year ago

Our team is available to help if you have any question regarding the use of our SDKs and their behavior. You can contact us at or .

In the event that we need to investigate a configuration issue or a potential bug, we will need you to provide the following information. Please provide as much as possible as it really helps us answering questions effectively.

Web and AMP SDKs

If you are experiencing issues with your websites and need Didomi to help with your integration, please provide the following information to our Support team:

  1. Issue

    • Platform(s) affected: desktop or mobile web, and browser(s) that are experiencing the issue

    • Description of the issue

    • Steps to reproduce the issue

    • Screenshot or screen capture of the issue

  2. Website (or test page) where the issue is happening. If you are doing internal testing, please provide access to the test page that can be used to replicate the issue.

  3. Consent notice configuration that you are using in the Didomi Console (URL or ID) for that website

Share GTM Preview with the Didomi Team

If you need to share your GTM Preview with the Didomi team for testing or review, please send the URL you will obtain following the process presented below.

  • Login into your Google Tag Manager account

  • Select the GTM container in use on your website

  • Click on the "Preview" button on the top right-hand corner

  • Copy the opening tab URL

  • Add your website URL to the email sent to Didomi team

Mobile SDKs

Sample applications

If you’re looking for guidance on getting started with mobile development with our SDKs, feel free to explore our sample apps repositories:

Using Android Gradle Plugin 7.2.X and JaCoCo

By using our SDK with JaCoCo and AGP 7.2.X or above, your application may crash with java.lang.VerifyError: Verifier rejected class io.didomi.sdk.Didomi error log message.

You need to upgrade AGP to the version 7.3.X or above then update your build script to replace isTestCoverageEnabled (deprecated from AGP 7.3.1) with enableUnitTestCoverage.

Do not enable enableAndroidTestCoverage while using our SDK. This is what triggers the crash.

Sharing apps with the Didomi team

If you need to share an app with the Didomi team for testing or review, please send one of the following formats to support@didomi.io:

  • APK or IPA archives

  • Play Store and App Store for production apps

Information for debugging mobile apps

If you are experiencing issues with your apps and need Didomi to help with your integration, please provide the following information to our Support team:

  1. Issue

    • Platform(s) affected: Android and/or iOS

    • Description of the issue

    • Steps to reproduce the issue

    • Screenshot or screen capture of the issue

    • Any stack trace of the issue involving code from the Didomi SDK

  2. Your application

    • Version of the SDK that you are using

    • Name of the app on the store, if it is available

    • Test version of the app that can be used to reproduce the issue (APK or similar)

    • Consent notice configuration that you are using in the Didomi Console (URL or ID) for that website

    • App ID if you are using the Didomi Console for creating your consent notice. didomi_config.json configuration file otherwise.

  3. SDK setup

    • Snippet of your call to any of the methods of the Didomi SDK including surrounding method and class name

CocoaPods integration issue when using custom Build Configurations

By default, when a new Xcode project is created, two Build Configurations are created by default: Debug and Release. If your project uses custom Build Configurations, you may face the following issue when integrating our XCFramework:

No such module 'Didomi'

In order to fix this issue, your Podfile needs to include the custom Build Configurations:

xcodeproj 'YourProject', 'Custom Debug' => :debug, 'Custom Release' => :release

API Events endpoint contains wrong SDK version

Didomi uses for testing apps and monitoring network traffic so we are not able to provide a specific list of device IDs that we are using for testing.

Snippet of your call to initialize including the surrounding method and class name as shown here ( / )

Snippet of your call(s) to setupUI including the surrounding method(s) and class name(s) ( / )

When API Events are sent, the SDK version is added to the endpoint URL. If the version number included in this URL is not the SDK version but your app's version number e.g.: you might need to set manageAppVersionAndBuildNumber to NO through the -exportOptionsPlist xcodebuild option.

support@didomi.io
send us a message in the Didomi Console
Android Sample App (Java)
Android Sample App (Jetpack Compose)
Android Sample App (Kotlin)
iOS Sample App (Objective-C)
iOS Sample App (Swift)
iOS Sample App (SwiftUI)
Browserstack
https://mobile-YOUR_APP_VERSION_NUMBER.api.privacy-center.org/events
iOS
iOS
Android
Android