If your mobile app sometimes opens WebViews or Chrome Custom Tabs to display specific content to the user, you should ensure that consent is passed from your app the website loaded in the WebView or Chrome Custom Tab. That will ensure that the user does not have to give consent again in WebViews or Chrome Custom Tabs.

The setup is the following:

• Collect consent in your app with the Didomi native SDKs

• Launch a WebView or a Chrome Custom Tab with the Didomi Web SDK embedded in it

• Inject JavaScript into the WebView to pass consent information from the native app

This guide assumes that you have already setup the Didomi native SDKs in your Android or iOS app, and that you have setup our Web SDK in the HTML pages loaded into your WebViews or Chrome Custom Tabs.

Web SDK configuration in the WebView or Chrome Custom Tab

You need to embed the Didomi Web SDK in the HTML page that is loaded by the WebView or the Chrome Custom Tab so that it can collect the consent information passed from the app and share it with vendors.

The list of vendors configured in the web SDK in the WebView should be a subset of the list of vendors configured in the mobile app. That will ensure that the WebView has all the consent information it needs and does not re-collect consent. Examples:

Other parameters of the web SDK can be configured freely, in particular with respect to the IAB framework and tags management.

Inject consent information into the WebView or Chrome Custom Tab

Passing consent to a WebView or to a Chrome Custom Tab is a slightly different operation. Read below for specific instructions based on the method you are using.

WebViews (Android and iOS)

The consent status can be passed to the Web SDK by embedding JavaScript code into your WebView.

The Android and iOS SDKs automatically generate the required JavaScript code for you with the getJavaScriptForWebView method. Call that method and embed the returned string into your WebView:

Didomi.getInstance().onReady(() -> {
    String didomiJavaScriptCode = Didomi.getInstance().getJavaScriptForWebView();
    webView.evaluateJavascript(
        didomiJavaScriptCode,
        @TargetApi(Build.VERSION_CODES.HONEYCOMB)
        @Override
        public void onReceiveValue(String s) {}
    );
});

Didomi.shared.onReady {
    let didomiJavaScriptCode = Didomi.shared.getJavaScriptForWebView()
    webView.evaluateJavaScript(didomiJavaScriptCode, completionHandler: nil)
}

Chrome Custom Tabs (Android only)

Android SDK

As Chrome Custom Tabs do not allow embedding JavaScript into a web page, the consent status of the user can be passed to the Web SDK by appending a query string parameter to the URL loaded by the Chrome Custom Tab. That query string parameter will contain the current status of the user and will be read by the Web SDK.

Didomi.getInstance().onReady(() -> {
    String didomiQueryString = Didomi.getInstance().getQueryStringForWebView();
    String url = "https://www.website.com/?" + didomiQueryString;
});

The getQueryStringForWebView method returns a query string parameter with the format didomiConfig.user.externalConsent.value=.... It can be appended to your URL after a ? or a & if your URL already contains a query string.

Example of a full URL: https://www.website.com/?didomiConfig.user.externalConsent.value=...

Web SDK

The Web SDK needs to be configured to read the user consent from the query string as that behavior is disabled by default. To do so, update your custom JSON or your local didomiConfig with:

{
  user: {
    externalConsent: {
      enabled: true
    }
  }
}

Hide the notice in the WebView or Chrome Custom Tab

The notice should automatically get hidden in the WebView as consent is passed from the mobile app to the website. However, it might happen that the notice gets displayed for a very short time before being hidden.

To avoid that visual glitch, you can disable the notice in your WebView or Chrome Custom Tab to make sure that it never shows by appending didomiConfig.notice.enable=false to the query string of the URL that you are loading:

{{YOUR_WEBSITE_URL}}?didomiConfig.notice.enable=false

If the notice still shows in the WebView or Chrome Custom Tab when navigating to another page, ensure that the list of vendors and purposes is the same between the mobile app and the website that is loaded in the WebView or Chrome Custom Tab.